Como Migrar os Dados do ServBay de um Mac com Chip Intel para um Mac com Apple Silicon (Série M)

Parabéns pela sua atualização para um novo Mac equipado com chip Apple Silicon! Para garantir que seu ambiente de desenvolvimento local do ServBay funcione de forma perfeita e eficiente no novo dispositivo, é necessário seguir um processo de migração específico. Este guia oferece um passo a passo detalhado para facilitar essa transição.

Por que é necessário um processo de migração especial?

O aplicativo principal do ServBay utiliza uma arquitetura universal e é compatível nativamente tanto com chips Intel quanto com Apple Silicon (série M).

No entanto, os principais pacotes fornecidos pelo ServBay (como PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, etc.) são compilados e otimizados para arquiteturas de CPU específicas. Isso significa que pacotes otimizados para chip Intel não podem ser executados diretamente em Macs com chip da série M, e vice-versa.

Assim, ao trocar um Mac Intel por um Mac da série M, não basta copiar o diretório inteiro do ServBay. É necessário substituir todos os pacotes instalados e migrar os seus dados e configurações pessoais.

Passo a Passo da Migração

Siga rigorosamente as etapas abaixo para garantir a integridade e a precisão da migração dos dados.

Passo 1: Pare completamente e saia do ServBay

No seu antigo Mac com chip Intel, clique no ícone do ServBay na barra de menu superior da tela e selecione Parar todos os serviços e sair no menu. Essa é uma etapa fundamental para garantir que todos os arquivos de dados estejam corretamente fechados antes do backup.

Passo 2: Faça backup do diretório de dados do ServBay

1. Abra o Finder e vá até o diretório /Applications.
2. Localize o diretório chamado ServBay (observe que não é o aplicativo ServBay.app em si).
3. Renomeie este diretório para ServBay.bak. Ele contém todos os seus arquivos de sites, bancos de dados, certificados SSL, backups e configurações.

Passo 3: Instale o ServBay do zero no novo Mac

1. Copie o diretório ServBay.bak inteiramente do seu antigo Mac para o diretório /Applications do novo Mac com chip série M.
2. No novo Mac, faça o download e instale a versão mais recente do aplicativo principal do ServBay.
3. Ao abrir o ServBay.app pela primeira vez, ele irá guiá-lo por um novo processo de instalação. Siga as instruções normalmente. Após a instalação, será criado um novo diretório ServBay em /Applications.

Passo 4: Reinstale todos os pacotes necessários

1. Abra o ServBay no novo Mac.
2. Acesse a área Pacotes (Packages) na barra de navegação à esquerda.
3. Reinstale todos os pacotes que você utilizava no antigo Mac (por exemplo, PHP 8.2, MySQL 8.0, Nginx 1.25 etc.).
4. Importante: Neste momento, apenas instale os pacotes — não ative nenhum deles ainda.

Passo 5: Pare novamente e saia completamente do ServBay

Após instalar todos os pacotes necessários, clique novamente no ícone do ServBay na barra de menu e selecione Parar todos os serviços e sair.

Passo 6: Migre os dados e configurações principais

Agora, você deve ter dois diretórios relevantes dentro de /Applications/:

• /Applications/ServBay.bak (backup migrado do antigo Mac)
• /Applications/ServBay (nova instalação no Mac novo)

Realize as cópias a seguir:

Abra o diretório /Applications/ServBay.bak e copie os seguintes subdiretórios para o novo diretório /Applications/ServBay, escolhendo sobrescrever todos os arquivos e pastas com nomes iguais:

• backup: seus arquivos de backup manuais e automáticos.
• data: arquivos de configuração de sites, configurações de aplicativos etc.
• db: todos os arquivos de bancos de dados (MySQL, MariaDB, PostgreSQL).
• ssl: todos os arquivos de certificados SSL.
• www: todos os arquivos dos projetos de sites.

Atenção: esta etapa é fundamental para restaurar todos os seus dados.

Passo 7: Contate o Suporte Técnico para Converter o Arquivo de Configuração (Etapa Crítica)

Devido à diferença de arquitetura do processador, arquivos de configuração antigos não funcionarão diretamente no novo Mac.

1. No novo Mac, localize o arquivo de configuração previamente feito backup: /Applications/ServBay.bak/data/servbay/config.data.
2. Envie este arquivo config.data para o suporte técnico oficial do ServBay (por exemplo, via Discord, Telegram, WeChat ou e-mail oficial).
3. A equipe de suporte converterá o arquivo para torná-lo compatível com a arquitetura do chip da série M e enviará o arquivo convertido de volta para você.
4. Recebendo o arquivo, substitua o arquivo correspondente no novo ServBay: /Applications/ServBay/data/servbay/config.data.

Passo 8: Reinstale a ServBay Root CA

1. Abra o aplicativo ServBay.
2. Acesse o menu Configurações (Settings) na barra de navegação à esquerda.
3. Na página de configurações, encontre a opção ServBay Root CA e clique no botão Reinstalar ServBay Root CA.

Passo 9: Reinicie todos os serviços

1. Volte à área Pacotes (Packages) na barra de navegação à esquerda.
2. Para cada pacote instalado, faça o processo de reinicialização: clique no interruptor para desativar e, em seguida, clique novamente para ativar. Isso garante que todos os serviços sejam iniciados usando os dados e configurações recém-migrados.

Passo 10: Migração concluída

Pronto! A migração dos seus dados do ServBay está completa. Agora você pode utilizar o ServBay normalmente no novo Mac com chip da série M. Verifique se seus sites, bancos de dados e serviços estão funcionando conforme o esperado.

Perguntas Frequentes (FAQ)

• P: Posso pular o passo de contato com o suporte técnico para converter o arquivo config.data?
  • R: Não. O arquivo config.data contém informações cruciais relacionadas à arquitetura de hardware. Pular esta etapa fará com que o ServBay não carregue corretamente suas configurações de sites, bancos de dados e outros serviços, podendo até impossibilitar a inicialização do sistema.
• P: E se eu não lembrar quais pacotes estavam instalados antes?
  • R: Você pode perguntar ao suporte técnico no momento da conversão do arquivo config.data, pois ele contém o histórico dos pacotes previamente instalados.
• P: E se, após a migração, meus sites não estiverem acessíveis?
  • R: Siga estas etapas para identificar o problema:
    1. Confirme que todos os pacotes relevantes (como Nginx/Apache e as versões correspondentes do PHP) foram reiniciados no passo 9.
    2. Verifique se as configurações dos sites no ServBay estão corretas.
    3. Consulte os arquivos de logs dos pacotes para identificar possíveis mensagens de erro específicas.