Guide de migration multiplateforme des données ServBay

Lorsque vous changez d’appareil ou passez d’une plateforme à une autre (par exemple d’un Mac Intel à un Mac Apple Silicon, ou de macOS à Windows), il est crucial de suivre une procédure spécifique pour garantir que votre environnement local ServBay fonctionne parfaitement et efficacement sur le nouvel appareil. Ce guide vous détaille toutes les étapes à suivre.

Pourquoi une procédure de migration spécifique est-elle nécessaire ?

ServBay est un environnement de développement local multiplateforme, compatible avec macOS et Windows. Sur macOS, l’application principale dispose d’une architecture universelle, assurant la compatibilité native avec les puces Intel et Apple Silicon (série M).

Cependant, les packages principaux fournis par ServBay (PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, etc.) sont compilés et optimisés pour chaque système d’exploitation et architecture CPU. Cela signifie :

• Les packages macOS Intel ne fonctionnent pas sur Mac Apple Silicon
• Les packages macOS ne fonctionnent pas sur Windows
• Les packages Windows ne fonctionnent pas sur macOS

Ainsi, lors d’un changement de plateforme ou d’architecture, il ne suffit pas de copier le dossier ServBay : il faut remplacer tous les packages installés et migrer vos données et configurations personnelles.

Étapes détaillées de la migration

Veuillez suivre rigoureusement les étapes ci-dessous afin de garantir l’intégrité et la fiabilité de votre migration de données.

Étape 1 : Arrêtez et quittez entièrement ServBay

Sur votre ancien Mac Intel, cliquez sur l’icône ServBay dans la barre de menu en haut de l’écran, puis choisissez Arrêter tous les services et quitter depuis le menu. Cette étape est essentielle pour s’assurer que tous les fichiers de données sont correctement fermés avant la sauvegarde.

Étape 2 : Sauvegardez le répertoire de données ServBay

macOS :

1. Ouvrez le Finder et accédez au dossier /Applications.
2. Localisez le dossier nommé ServBay (attention, il ne s’agit pas du fichier d’application ServBay.app).
3. Renommez ce dossier en ServBay.bak.

Windows :

1. Ouvrez l’Explorateur de fichiers et rendez-vous dans le dossier C:\.
2. Localisez le dossier nommé ServBay.
3. Renommez ce dossier en ServBay.bak.

Ce dossier contient tous vos fichiers de site web, bases de données, certificats SSL, sauvegardes et fichiers de configuration.

Étape 3 : Installez ServBay sur le nouvel appareil

1. Copiez le dossier ServBay.bak dans son intégralité de l’ancien appareil vers le nouveau :
   • macOS : Copiez dans le dossier /Applications
   • Windows : Copiez dans le dossier C:\
2. Téléchargez et installez la dernière version du programme principal ServBay sur le nouvel appareil.
3. Lors du premier lancement, ServBay vous guidera à travers le processus d’installation. Suivez les instructions pour une installation classique. Une fois terminée, un nouveau dossier ServBay sera créé :
   • macOS : /Applications/ServBay
   • Windows : C:\ServBay

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

1. Ouvrez ServBay sur le nouvel appareil.
2. Dans la barre latérale gauche, rendez-vous sur la page Packages.
3. Réinstallez tous les packages que vous utilisiez précédemment (par exemple PHP 8.2, MySQL 8.0, Nginx 1.25, etc.).
4. Remarque importante : À cette étape, installez simplement les packages, sans les activer.

Étape 5 : Arrêtez et quittez à nouveau complètement ServBay

Après avoir installé tous les packages, cliquez à nouveau sur l’icône ServBay dans la barre de menu et sélectionnez Arrêter tous les services et quitter.

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

À ce stade, vous devez avoir deux dossiers sur votre appareil :

• macOS :
  • /Applications/ServBay.bak (sauvegarde transférée)
  • /Applications/ServBay (nouvelle installation)
• Windows :
  • C:\ServBay.bak (sauvegarde transférée)
  • C:\ServBay (nouvelle installation)

Effectuez les opérations suivantes :

Dans le dossier de sauvegarde, copiez les sous-dossiers suivants dans le nouveau dossier ServBay et choisissez d’écraser tous les fichiers et dossiers de même nom :

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

Attention : cette étape est très importante, elle permet de restaurer toutes vos données.

Étape 7 : Contactez le support technique pour convertir le fichier de configuration (étape cruciale)

Du fait des différences de plateformes et d’architectures, l’ancien fichier de configuration doit être converti afin d’être compatible.

1. Sur le nouvel appareil, localisez le fichier de configuration sauvegardé :
   • macOS : /Applications/ServBay.bak/data/servbay/config.data
   • Windows : C:\ServBay.bak\data\servbay\config.data
2. Envoyez ce fichier config.data à l’équipe de support technique officielle de ServBay (par Discord, Telegram, WeChat ou e-mail).
3. L’équipe technique convertira le fichier pour l’adapter à la nouvelle plateforme, puis vous le renverra.
4. Une fois réceptionné, écrasez le fichier à l’emplacement correspondant de la nouvelle installation :
   • macOS : /Applications/ServBay/data/servbay/config.data
   • Windows : C:\ServBay\data\servbay\config.data

Étape 8 : Réinstallez ServBay Root CA

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

Étape 9 : Redémarrez tous les services

1. Rendez-vous dans la page Packages de la barre latérale gauche.
2. Pour chacun des packages installés, effectuez un redémarrage individuel : cliquez d’abord sur l’interrupteur pour désactiver, puis cliquez de nouveau pour activer le service. Ce processus assure que tous les services démarrent en utilisant les données et configurations migrées.

Étape 10 : Finalisation de la migration

Votre migration des données ServBay est maintenant terminée ! Vous pouvez utiliser ServBay sur votre nouvel appareil et vérifier que vos sites web, bases de données et services fonctionnent comme prévu.

Foire aux questions (FAQ)

• 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 essentielles et spécifiques à la plateforme et l’architecture. Ignorer cette étape peut entraîner l’impossibilité pour ServBay de charger correctement vos sites, bases de données et configurations de service, voire empêcher le démarrage de ServBay.
• Q : Que faire si j’ai oublié quels packages j’avais installés ?
  • R : Vous pouvez demander cette information au support technique lors de la conversion du fichier config.data, car le fichier contient la liste de vos packages installés précédemment.
• Q : Que faire si mon site web n’est plus accessible après la migration ?
  • R : Vérifiez les points suivants dans l’ordre :
    1. Assurez-vous que vous avez redémarré tous les packages concernés lors de l’étape 9 (par exemple Nginx/Apache et la version de PHP associée).
    2. Vérifiez que la configuration de votre site dans ServBay est correcte.
    3. Consultez les fichiers journaux des packages concernés pour diagnostiquer les éventuelles erreurs.