A tela Migracao de sites traz sites de outro servidor para o miniCP por SSH. Ela cria as contas e os domínios, copia os arquivos e, se você quiser, os bancos MySQL. Cada migração vira uma tarefa que pode ser repetida para a sincronização final antes de trocar o DNS.
Acesse pelo menu Hospedagem > Migracao.
Tipos de origem
| Origem | O que o painel faz |
|---|---|
| CWP | Descobre as contas, cria usuários e domínios (mapeando a versão do PHP), copia as homes e, opcionalmente, os bancos. |
| cPanel | Igual ao CWP, lendo as contas do cPanel. |
| Generico (SSH) | Você navega no servidor remoto, escolhe um diretório e importa para um usuário do painel. |
Antes de começar
- Acesso SSH à origem como root (ou usuário com acesso de leitura às homes e ao MySQL).
- Para migrar bancos, o MySQL/MariaDB precisa estar instalado no miniCP.
- As versões de PHP usadas pelos sites devem estar instaladas no miniCP. Se a versão exata não existir, o painel usa a mais nova instalada e marca o domínio com
*defaultno log.
Atenção: a senha SSH nunca é guardada. Você digita de novo a cada operação.
Conectar na origem
No quadro Conexao com a origem:
| Campo | O que informar |
|---|---|
| Origem | CWP, cPanel ou Generico (SSH). |
| Host | Nome ou endereço do servidor de origem. |
| Porta SSH | Padrão 22. |
| Usuario SSH | Normalmente root. |
| Senha SSH | Senha do usuário SSH (não é salva). |
| API do CWP e Chave da API | Opcionais, só para CWP. Ajudam a listar as contas. |
Clique em Salvar conexao para guardar host, porta e usuário para a próxima vez.
Migrar contas do CWP ou cPanel
- Preencha a conexão e a senha SSH.
- Clique em Descobrir contas. O painel lista as contas da origem com tamanho, bancos e domínios (com a versão do PHP).
- Marque as contas que quer trazer, ou use Selecionar todas.
- Revise os bancos de cada conta clicando no botão de bancos da linha. Os bancos com nome
usuarioouusuario_*já vêm marcados. Inclua qualquer outro banco que o site use. - Deixe Migrar bancos marcado se quiser trazer os bancos.
- Clique em Migrar selecionadas.
O progresso aparece em tempo real na tela. Para cada conta, o painel:
- cria o usuário no miniCP com uma senha aleatória (guardada em arquivo, veja abaixo);
- cria os domínios e aliases, com pool PHP e vhost;
- copia a home inteira por rsync e ajusta o dono dos arquivos;
- importa os bancos marcados e recria os usuários MySQL com a mesma senha, para o site conectar sem mudar a configuração;
- recarrega o servidor web;
- salva uma tarefa de migração.
Cópia dos arquivos
A cópia não traz arquivos de dispositivo, FIFOs nem os bits setuid/setgid. Tudo chega ao miniCP e, em seguida, recebe o dono da conta de destino.
Domínios, aliases e document root
O document root e os aliases vindos da origem passam pela mesma validação da tela Dominios:
- um alias inválido, ou que já pertença a outro site do miniCP, é ignorado, com aviso no log;
- um document root inválido (com espaços,
..ou caracteres fora de letras, números,.,_,-e/) virapublic_html, com aviso no log.
Bancos de dados
- Um banco que já existe no miniCP e pertence a outra conta não é sobrescrito: a migração pula esse banco e avisa no log.
- Usuários MySQL que já existem no miniCP não são alterados (nem a senha, nem as permissões).
- Das permissões da origem, só entram as do próprio banco migrado. Permissões em
*.*ou em outro banco são ignoradas, com o aviso "permissao(oes) fora do banco ... ignorada(s)". - Se a importação de um banco falhar no meio, a tarefa fica marcada com erro.
- Os bancos migrados entram no registro do painel com a conta como dona. Assim, passam a entrar no backup agendado da conta, mesmo com nome fora do padrão
usuario_*.
Senha dos usuários criados
A senha gerada para cada usuário novo não aparece no log da migração. O log só indica onde ela foi guardada. As senhas ficam no arquivo /root/minicp-senhas-migracao.txt, que só o root lê, com uma linha por usuário criado: data, usuário e senha.
Para consultar, acesse o servidor por SSH como root:
cat /root/minicp-senhas-migracao.txt
Dica: troque a senha de cada usuário migrado em Usuarios e informe a nova ao cliente. Depois, apague as linhas que não precisa mais desse arquivo.
Se o usuário ou o domínio já existir no miniCP, ele é mantido e o passo é pulado.
O que não vem na migração
- E-mails (a pasta
mailé ignorada). - Pastas
tmp,logs,.cache, lixeira e arquivos internos do cPanel/CWP. - Certificados SSL: emita de novo no miniCP depois de apontar o DNS.
- Crons e configurações de DNS.
Importar um diretório (Generico)
- Escolha Generico (SSH) em Origem e preencha a conexão.
- Clique em Conectar e navegar.
- Navegue pelas pastas no quadro Diretorio remoto e clique em usar no diretório desejado.
- Em Importar para o usuario, escolha um usuário existente ou digite um novo. Um usuário novo é criado com senha aleatória, guardada no mesmo arquivo
/root/minicp-senhas-migracao.txt. - Ajuste a Pasta de destino (dentro da home). O padrão é
public_html. - Opcional: informe um domínio em Criar dominio e escolha o PHP.
- Clique em Importar e confirme.
No modo genérico não há migração de bancos. Exporte e importe os bancos à parte.
Sincronização final (tarefas)
Toda migração aparece em Tarefas de migracao, com origem, destino, última execução e número de execuções. Use isso para trazer o que mudou na origem antes de trocar o DNS.
- Na tarefa, clique em Repetir.
- Digite a Senha SSH da origem.
- Escolha as opções:
- Espelhar exclusoes (--delete): apaga no destino o que não existe mais na origem.
- Reimportar os bancos: importa de novo os bancos da tarefa, sobrescrevendo os dados do destino.
- Clique em Sincronizar.
Roteiro recomendado para a virada:
- Faça a migração inicial com o site ainda no ar na origem.
- Teste o site no miniCP (por exemplo, pelo arquivo hosts do seu computador).
- Coloque o site em manutenção na origem.
- Rode Repetir com Reimportar os bancos marcado.
- Aponte o DNS para o miniCP e emita o SSL.
Atenção: "Reimportar os bancos" sobrescreve tudo o que foi gravado no banco do miniCP desde a migração. Não use depois que o site já estiver recebendo pedidos no servidor novo.