Guia do Suporte — Migrar um cliente para a v4
Este guia explica, passo a passo, como colocar um cliente no novo sistema de atualização automática (v4). Depois disso, o sistema do cliente passa a se atualizar sozinho.
Resumo rápido
- Migrar o banco do cliente manualmente até a v4 (como já é feito hoje).
- No painel: Atualizações → Migrar cliente para v4 → buscar o cliente → Confirmar migração.
- Aguardar ~30 min e conferir em Status da Migração.
- Instalar o atualizador automático na máquina do cliente.
Antes de começar
- Acesso ao painel admin com permissão do menu Atualizações.
- Acesso remoto à máquina do cliente (como nas atualizações de hoje).
- Saber o nome do banco de dados do cliente no SQL Server (ex.:
SAIKOO_NOMEDOCLIENTE).
Passo 1 — Migrar o banco até a v4 (manual)
Esse é o único passo manual pesado, e é igual ao que já fazem hoje: atualizar o banco do cliente até a versão 4.0 (o "salto" das versões antigas para a v4).
Quando terminar, o banco do cliente estará na v4 — é esse ponto que vamos "marcar" no painel.
Passo 2 — Fazer a migração no painel
A Migração é o que diz ao sistema: "este cliente entrou na v4". A partir daí ele passa a ser atualizado automaticamente.
- No painel, abra Atualizações → Migrar cliente para v4.
- No topo, em "Versão de baseline", selecione a versão 4.0.0.0.
- No campo "Buscar cliente", digite o nome, código ou CNPJ do cliente. A lista aparece conforme você digita.
- Localize o cliente. Ao lado dele vai aparecer uma destas situações:
- Botão "Confirmar migração" → o cliente está disponível para migrar.
- "Concluído" (verde) → o cliente já foi migrado. Não faça nada.
- "Na fila" (azul) → o cutover já foi solicitado e está aguardando processamento. Não faça de novo.
- Se aparecer um campo "informe o nome do banco" ao lado do cliente, digite o nome do banco
dele no SQL Server (ex.:
SAIKOO_NOMEDOCLIENTE). Isso só aparece para clientes que ainda não têm a conexão cadastrada. - Clique em "Confirmar migração" e confirme na janela.
Vai aparecer a mensagem "Migração na fila". Pronto — sua parte acabou.
O que o sistema faz sozinho depois disso: prepara o controle de versão no banco do cliente, marca o cliente como migrado e aplica automaticamente todas as atualizações de banco até a versão publicada atual (ele não precisa passar versão por versão).
Passo 3 — Conferir se deu certo
O processamento acontece automaticamente em até 30 minutos.
- Abra Atualizações → Status da Migração.
- Procure o cliente na lista "Status por cliente". Ele deve aparecer com a versão de schema
preenchida (ex.:
v...) e sem erro. - Se quiser acompanhar, veja o painel "Fila de jobs":
- pendente → aguardando o processamento (aguarde).
- processando → rodando agora.
- concluído → deu tudo certo. ✅
- erro → algo falhou (veja "Problemas comuns" abaixo).
Passo 4 — Instalar o atualizador automático na máquina do cliente
Isso faz o sistema do cliente se atualizar sozinho toda vez que abrir.
Use o instalador Saikoo-Setup.exe na máquina do cliente — o mesmo procedimento serve tanto
para instalação nova quanto para quem já tem o sistema. O passo a passo completo está em
Como instalar ou atualizar.
A partir daí, sempre que abrir, aparece uma janelinha rápida ("Verificando... / Atualizando...") e o sistema abre já atualizado.
O que os status significam (na tela de Migração)
| Aparece assim | Significa | O que fazer |
|---|---|---|
| Botão Confirmar migração | Cliente ainda não migrado | Pode migrar |
| Concluído (verde) | Já migrado | Nada |
| Na fila (azul) | Migração já solicitada, aguardando | Aguardar (não repetir) |
Problemas comuns
- "Selecione a versão de baseline..." → você esqueceu de escolher a versão no topo antes de clicar em Confirmar. Selecione a versão e tente de novo.
- "Este cliente já foi migrado ou já está na fila" → não precisa fazer nada; ele já está no processo.
- Passou de 30 min e não concluiu / status "erro" → não repita o cutover. Anote o nome do cliente e avise o time de desenvolvimento (o erro fica registrado no Status).
- Cliente errado → confira sempre pelo nome + código/CNPJ na busca antes de confirmar. A migração mexe no banco daquele cliente.
Perguntas frequentes
Preciso instalar o atualizador no mesmo momento da migração? Não obrigatoriamente, mas é o ideal fazer os dois na mesma visita: migração no painel + atualizador na máquina.
Fiz a migração duas vezes sem querer. Sem problema — o sistema bloqueia a duplicidade; o segundo pedido é recusado ("já foi migrado ou já está na fila").
O cliente pulou várias versões (estava numa v4 antiga). Tudo bem — ao fazer a migração, o sistema aplica todas as atualizações pendentes até a versão atual automaticamente.