Comment migrer les données ServBay d’un Mac Intel vers un Mac Apple Silicon (gamme M)

Félicitations pour la mise à niveau de votre Mac vers un modèle avec puce Apple Silicon ! Pour assurer un fonctionnement optimal et sans accroc de votre environnement de développement local ServBay sur votre nouvel appareil, il est essentiel de suivre un processus de migration spécifique. Ce guide vous accompagnera pas à pas tout au long du processus.

Pourquoi une procédure de migration particulière est-elle nécessaire ?

L’application principale ServBay possède une architecture universelle, compatible nativement avec les puces Intel et Apple Silicon (gamme M).

Cependant, les packages essentiels fournis par ServBay (comme PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, etc.) sont compilés et optimisés pour une architecture CPU spécifique. Un package optimisé pour Intel ne pourra donc pas fonctionner directement sur une puce Apple Silicon, et vice versa.

De ce fait, lors de la transition d’un Mac Intel vers un Mac Apple Silicon, il ne suffit pas de copier l’ensemble du dossier ServBay : tous les packages doivent être réinstallés et seuls vos données personnelles et configurations doivent être migrées.

Étapes détaillées de la migration

Veuillez suivre scrupuleusement les étapes ci-dessous afin d’assurer l’intégrité et la validité de vos données tout au long du transfert.

Étape 1 : Arrêter totalement ServBay et quitter l’application

Sur votre ancien Mac Intel, cliquez sur l’icône ServBay située dans la barre de menus (en haut de l’écran). Dans le menu, sélectionnez Arrêter tous les services et quitter. Cette étape garantit la fermeture correcte de tous les fichiers de données avant la sauvegarde.

Étape 2 : Sauvegarder le dossier de données ServBay

1. Ouvrez Finder et rendez-vous dans le dossier /Applications.
2. Repérez le dossier nommé ServBay (attention, il ne s’agit pas de l’application ServBay.app).
3. Renommez ce dossier en ServBay.bak. Ce répertoire contient tous vos fichiers de sites web, bases de données, certificats SSL, sauvegardes et configurations.

Étape 3 : Installer ServBay proprement sur le nouveau Mac

1. Copiez intégralement le dossier ServBay.bak de votre ancien Mac vers le dossier /Applications du nouveau Mac équipé d’un processeur M.
2. Téléchargez et installez la dernière version de l’application principale ServBay sur le Mac Apple Silicon.
3. Au premier lancement de ServBay.app, suivez le processus d’installation guidé. Une fois finalisé, un nouveau dossier ServBay sera créé dans /Applications.

Étape 4 : Réinstaller tous les packages nécessaires

1. Lancez ServBay sur votre nouveau Mac.
2. Accédez à l’interface Packages dans la barre latérale gauche.
3. Réinstallez tous les packages que vous utilisiez sur l’ancien Mac (par exemple PHP 8.2, MySQL 8.0, Nginx 1.25, etc.).
4. Important : À cette étape, installez simplement les packages — ne les activez pas tout de suite.

Étape 5 : De nouveau, arrêter et quitter complètement ServBay

Après avoir terminé l’installation de tous les packages, cliquez à nouveau sur l’icône ServBay dans la barre de menus, puis choisissez Arrêter tous les services et quitter.

Étape 6 : Migrer les données et configurations principales

Dans votre dossier /Applications/, vous devriez voir deux répertoires liés à ServBay :

• /Applications/ServBay.bak (la sauvegarde provenance de l’ancien Mac)
• /Applications/ServBay (la nouvelle installation sur le Mac à puce M)

Suivez les instructions de copie suivantes :

Ouvrez le dossier /Applications/ServBay.bak, puis copiez chacun des sous-dossiers suivants dans le nouveau dossier /Applications/ServBay, en acceptant de remplacer tous les fichiers ou dossiers du même nom :

• backup : toutes vos sauvegardes manuelles et automatiques.
• data : fichiers de configuration de vos sites, paramètres d’application, etc.
• db : vos bases de données (MySQL, MariaDB, PostgreSQL).
• ssl : vos certificats SSL.
• www : tous les fichiers de vos projets web.

Remarque : cette étape est cruciale — c’est ici que la restauration de toutes vos données s’effectue.

Étape 7 : Contacter le support technique pour convertir le fichier de configuration (étape essentielle)

En raison des différences d’architecture CPU, l’ancien fichier de configuration n’est pas compatible en l’état avec la nouvelle.

1. Sur le nouveau Mac, localisez le fichier de configuration sauvegardé : /Applications/ServBay.bak/data/servbay/config.data.
2. Envoyez ce fichier config.data au support technique officiel de ServBay (via Discord, Telegram, WeChat ou e-mail, par exemple).
3. L’équipe technique convertira le fichier pour le rendre compatible avec la puce Apple Silicon et vous le renverra.
4. Une fois le fichier reçu, écrasez le fichier correspondant dans le nouveau dossier : /Applications/ServBay/data/servbay/config.data.

Étape 8 : Réinstaller le certificat ServBay Root CA

1. Ouvrez l’application ServBay.
2. Rendez-vous dans la barre latérale gauche, dans Paramètres.
3. Sur la page de configuration, trouvez l’option ServBay Root CA et cliquez sur le bouton Réinstaller ServBay Root CA.

Étape 9 : Redémarrer tous les services

1. Accédez à l’interface Packages via la barre de navigation à gauche.
2. Pour chaque package installé, procédez à un redémarrage manuel : cliquez sur l’interrupteur pour désactiver, puis recliquez pour activer. Ainsi, chaque service sera redémarré en prenant en compte les données et configurations nouvellement migrées.

Étape 10 : Migration terminée

Voilà, la migration de vos données ServBay est terminée ! Vous pouvez maintenant utiliser ServBay sur votre nouveau Mac Apple Silicon comme auparavant. Vérifiez que vos sites, bases de données et services fonctionnent comme attendu.

FAQ (Questions fréquentes)

• Q : Puis-je ignorer l’étape de conversion du fichier config.data par le support technique ?
  • R : Non. Le fichier config.data contient des informations de configuration cruciales en lien avec l’architecture matérielle. Sans cette conversion, ServBay sera incapable de charger correctement vos sites, bases de données ou configurations et pourrait ne pas démarrer du tout.
• Q : Si j’ai oublié quels packages étaient installés auparavant, que faire ?
  • R : Lors de la demande de conversion du fichier config.data, demandez simplement au support technique : ce fichier contient la liste des packages précédemment installés.
• Q : Après la migration, mon site n’est pas accessible. Que faire ?
  • R : Vérifiez selon les étapes suivantes :
    1. Assurez-vous d’avoir bien redémarré tous les packages nécessaires à l’étape 9 (par exemple, Nginx/Apache et la version PHP associée).
    2. Vérifiez la configuration du site au sein de ServBay.
    3. Consultez les fichiers de logs des packages concernés pour identifier toute erreur.