Guia de Migração de Dados do ServBay entre Plataformas

Ao atualizar seu dispositivo ou alternar entre diferentes plataformas (por exemplo, de um Mac Intel para um Mac Apple Silicon, ou de macOS para Windows), é fundamental seguir um processo específico de migração para garantir que seu ambiente de desenvolvimento local ServBay funcione perfeitamente e com eficiência no novo equipamento. Este guia oferece um passo a passo detalhado.

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

O ServBay é um ambiente de desenvolvimento local multiplataforma, compatível com macOS e Windows. No macOS, o aplicativo principal possui arquitetura universal, com compatibilidade nativa para chips Intel e Apple Silicon (linha M).

Entretanto, os principais pacotes de software disponibilizados pelo ServBay (como PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, entre outros) são compilados e otimizados para sistemas operacionais e arquiteturas de CPU específicas. Isso significa que:

• Pacotes da versão Intel do macOS não funcionam em Macs com Apple Silicon
• Pacotes do macOS não funcionam no Windows
• Pacotes do Windows não funcionam no macOS

Portanto, ao migrar entre plataformas ou arquiteturas, não basta copiar toda a pasta do ServBay. É necessário reinstalar todos os pacotes de software e migrar corretamente seus dados e configurações pessoais.

Etapas detalhadas da migração

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

Etapa 1: Pare completamente e saia do ServBay

No seu antigo Mac Intel, clique no ícone do ServBay na barra de menu (Menubar) no topo da tela e selecione Parar todos os serviços e sair. Este passo é fundamental para garantir que todos os arquivos de dados estejam devidamente fechados antes do backup.

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

macOS:

1. Abra o Finder e acesse o diretório /Applications.
2. Localize a pasta chamada ServBay (atenção, não é o aplicativo ServBay.app).
3. Renomeie esta pasta para ServBay.bak.

Windows:

1. Abra o Explorador de Arquivos e navegue até C:\.
2. Procure a pasta chamada ServBay.
3. Renomeie essa pasta para ServBay.bak.

Esta pasta contém todos os seus arquivos de sites, bancos de dados, certificados SSL, backups e configurações.

Etapa 3: Faça uma instalação limpa do ServBay no novo dispositivo

1. Copie toda a pasta ServBay.bak do dispositivo antigo para o novo:
   • macOS: copie para /Applications
   • Windows: copie para C:\
2. Baixe e instale a versão mais recente do ServBay no novo equipamento.
3. Ao abrir ServBay pela primeira vez, ele guiará você pelo processo de instalação. Siga as instruções para concluir a instalação, que irá criar uma nova pasta ServBay:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Etapa 4: Reinstale todos os pacotes necessários

1. Abra o ServBay no novo dispositivo.
2. No menu de navegação lateral, vá até a tela de Pacotes (Packages).
3. Com base no uso anterior, reinstale todos os pacotes usados anteriormente (como PHP 8.2, MySQL 8.0, Nginx 1.25, etc).
4. Importante: Neste momento, apenas instale os pacotes, não ative nenhum deles.

Etapa 5: Pare novamente e saia totalmente do ServBay

Após concluir a instalação dos pacotes, clique novamente no ícone do ServBay na barra de menu e escolha Parar todos os serviços e sair.

Etapa 6: Migre dados e configurações principais

Agora você terá duas pastas relevantes no dispositivo:

• macOS:
  • /Applications/ServBay.bak (backup migrado do antigo dispositivo)
  • /Applications/ServBay (nova instalação)
• Windows:
  • C:\ServBay.bak (backup migrado do antigo dispositivo)
  • C:\ServBay (nova instalação)

Realize as seguintes cópias:

Abra a pasta de backup e copie os seguintes subdiretórios para a nova instalação ServBay, escolhendo sobrescrever os arquivos e pastas de mesmo nome:

• backup: Todos os seus backups manuais e automáticos.
• data: Configurações de sites, apps e outras definições.
• db: Todos os bancos de dados (MySQL, MariaDB, PostgreSQL).
• ssl: Certificados SSL.
• www: Arquivos dos seus projetos de sites.

Atenção: Esta etapa é essencial para restaurar todos os seus dados.

Etapa 7: Entre em contato com o suporte técnico para a conversão do arquivo de configuração (passo crucial)

Devido às diferenças de plataforma e arquitetura, o arquivo de configuração antigo precisa ser convertido para uso no novo ambiente.

1. No novo dispositivo, localize o arquivo de configuração de backup:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Envie este arquivo config.data para o suporte técnico oficial do ServBay (pelo Discord, Telegram, WeChat ou e-mail).
3. A equipe de suporte converterá o arquivo para a nova plataforma e arquitetura, e enviará de volta o arquivo ajustado.
4. Ao receber o arquivo convertido, sobrescreva no local apropriado do novo ServBay:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Etapa 8: Reinstale o ServBay Root CA

1. Abra o aplicativo ServBay.
2. No menu lateral, acesse Configurações (Settings).
3. Na página de configurações, encontre a opção ServBay Root CA e clique em Reinstalar ServBay Root CA.

Etapa 9: Reinicie todos os serviços

1. No menu lateral, vá até Pacotes (Packages).
2. Para cada pacote instalado, faça o processo de reinicialização: primeiro desative usando o botão correspondente e, em seguida, ative novamente. Assim, todos os serviços irão iniciar utilizando os dados e configurações migrados.

Etapa 10: Migração concluída

Pronto! A migração dos seus dados do ServBay foi finalizada. Agora você pode usar normalmente o ServBay no novo dispositivo. Verifique se seus sites, bancos de dados e serviços estão funcionando conforme esperado.

Perguntas frequentes (FAQ)

• P: Posso pular o passo de contato com o suporte para a conversão do arquivo config.data?
  • R: Não pode. O arquivo config.data contém informações cruciais de configuração relacionadas à plataforma e arquitetura. Ignorar esta etapa pode fazer com que o ServBay não consiga carregar corretamente os sites, bancos de dados e outros serviços, ou até mesmo impossibilitar o funcionamento do sistema.
• P: E se eu não lembrar quais pacotes instalei anteriormente?
  • R: Ao entrar em contato com o suporte para a conversão do arquivo config.data, você pode perguntar sobre isso. O arquivo contém registros dos pacotes instalados.
• P: O que devo fazer se, após a migração, meus sites não estiverem acessíveis?
  • R: Verifique, na ordem:
    1. Certifique-se de reiniciar todos os pacotes necessários no passo 9 (ex.: Nginx/Apache e respectivas versões do PHP).
    2. Confirme as configurações dos sites no ServBay.
    3. Examine os logs dos pacotes envolvidos para identificar e corrigir possíveis erros.