ServBay Cross-Platform Migratiehandleiding

Wanneer u uw apparaat upgradet of wisselt tussen verschillende platforms (bijvoorbeeld van een Intel Mac naar een Apple Silicon Mac, of van macOS naar Windows), is het voor een soepele en efficiënte werking van uw ServBay lokale ontwikkelomgeving op het nieuwe apparaat noodzakelijk om een specifiek migratieproces te volgen. Deze handleiding geeft u de gedetailleerde stappen.

Waarom is een speciaal migratieproces nodig?

ServBay is een cross-platform lokale ontwikkelomgeving die zowel macOS als Windows ondersteunt. Op macOS heeft de hoofdapplicatie een universele architectuur en is hierdoor native compatibel met zowel Intel- als Apple Silicon (M-serie) chips.

De kernsoftwarepakketten die ServBay levert (zoals PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, enzovoort) zijn echter gecompileerd en geoptimaliseerd voor een specifieke besturingssysteem en CPU-architectuur. Dit betekent:

• macOS Intel-versies van pakketten werken niet op Apple Silicon Macs.
• macOS-pakketten werken niet op Windows.
• Windows-pakketten werken niet op macOS.

Daarom kunt u bij het wisselen tussen platformen of architecturen niet simpelweg de ServBay-map kopiëren. Alle geïnstalleerde pakketten moeten worden vervangen en uw persoonlijke data en configuraties gemigreerd.

Gedetailleerde migratiestappen

Volg onderstaande stappen secuur voor een volledige en correcte datamigratie.

Stap 1: ServBay volledig stoppen en afsluiten

Op uw oude Intel Mac: Klik op het ServBay-icoon in de menubalk bovenaan het scherm en selecteer vanuit het menu Stop alle diensten en sluit af. Dit is cruciaal om ervoor te zorgen dat alle databestanden correct worden afgesloten vóór de back-up.

Stap 2: Back-up van ServBay-datamap maken

macOS:

1. Open Finder en ga naar de /Applications-map.
2. Zoek de map genaamd ServBay (let op: dit is niet de applicatie ServBay.app zelf).
3. Hernoem deze map naar ServBay.bak.

Windows:

1. Open Windows Verkenner en ga naar de C:\-map.
2. Zoek daar de map ServBay.
3. Hernoem deze map naar ServBay.bak.

Deze map bevat al uw websitebestanden, databases, SSL-certificaten, back-ups en configuratiebestanden.

Stap 3: ServBay opnieuw installeren op het nieuwe apparaat

1. Kopieer de volledige ServBay.bak-map van uw oude apparaat naar uw nieuwe:
   • macOS: Kopieer naar /Applications
   • Windows: Kopieer naar C:\
2. Download en installeer de nieuwste versie van de ServBay hoofdapp op het nieuwe apparaat.
3. Bij het eerste openen van ServBay wordt u begeleid door een nieuw installatieproces. Volg de aanwijzingen en rond de installatie af. Hierna wordt een nieuwe ServBay-map aangemaakt:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Stap 4: Herinstalleren van alle benodigde pakketten

1. Open ServBay op uw nieuwe apparaat.
2. Ga in het linker navigatiemenu naar Pakketten (Packages).
3. Herinstalleer alle pakketten die u op het oude apparaat gebruikte (bijvoorbeeld PHP 8.2, MySQL 8.0, Nginx 1.25, enz.).
4. Belangrijk: Installeer alleen de pakketten in deze stap; activeer ze nog niet.

Stap 5: ServBay opnieuw volledig stoppen en afsluiten

Na het installeren van alle pakketten: Klik opnieuw op het ServBay-icoon in de menubalk en selecteer Stop alle diensten en sluit af.

Stap 6: Kerngegevens en configuratie migreren

Nu heeft u twee verbonden mappen op uw apparaat:

• macOS:
  • /Applications/ServBay.bak (back-up van oude apparaat)
  • /Applications/ServBay (nieuw geïnstalleerde versie)
• Windows:
  • C:\ServBay.bak (back-up van oude apparaat)
  • C:\ServBay (nieuw geïnstalleerde versie)

Voer de volgende kopieeracties uit:

Open de back-upmap en kopieer onderstaande submappen naar de nieuwe ServBay-map. Kies om alle gelijknamige bestanden en mappen te overschrijven:

• backup: bevat al uw handmatige en automatische back-upbestanden.
• data: bevat uw websiteconfiguraties en applicatie-instellingen.
• db: bevat al uw databasebestanden (MySQL, MariaDB, PostgreSQL).
• ssl: bevat al uw SSL-certificaatbestanden.
• www: bevat al uw websiteprojectbestanden.

Let op: deze stap is cruciaal en herstelt al uw data.

Stap 7: Neem contact op met de technische support om configuratiebestand te converteren (essentieel)

Door verschillende platformen en architecturen moeten de oude configuratiebestanden worden geconverteerd voor de nieuwe omgeving.

1. Zoek het oude configuratiebestand op uw nieuwe apparaat:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Stuur dit config.data-bestand naar de ServBay technische support (bijvoorbeeld via Discord, Telegram, WeChat of e-mail).
3. Het supportteam converteert dit bestand zodat het geschikt is voor het nieuwe platform en stuurt het terug.
4. Overschrijf vervolgens het bestand in de nieuwe ServBay-map met het geconverteerde bestand:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Stap 8: ServBay Root CA opnieuw installeren

1. Open de ServBay-applicatie.
2. Ga naar Instellingen (Settings) via het menu aan de linkerkant.
3. Zoek op de instellingenpagina de optie ServBay Root CA en klik op de knop ServBay Root CA opnieuw installeren.

Stap 9: Herstart alle diensten

1. Ga naar het Pakketten (Packages)-menu in de navigatiekolom aan de linkerkant.
2. Herstart elk geïnstalleerd pakket individueel: klik eerst op de schakelaar om het uit te schakelen, klik vervolgens opnieuw om het in te schakelen. Zo starten alle diensten op met uw overgezette data en configuraties.

Stap 10: Migratie voltooid

U heeft nu de complete ServBay-datamigratie afgerond! ServBay zou op uw nieuwe apparaat moeten werken. Controleer uw websites, databases en overige diensten om te zien of alles naar verwachting functioneert.

Veelgestelde vragen (FAQ)

• Q: Kan ik stap voor het converteren van het config.data-bestand door technische support overslaan?
  • A: Nee, dat is niet mogelijk. Het config.data-bestand bevat essentiële platform- en architectuur-specifieke configuraties. Het overslaan van deze stap verhinderd dat ServBay uw websites, databases en andere diensten correct kan laden of zelfs starten.
• Q: Wat als ik niet meer weet welke pakketten ik eerder geïnstalleerd had?
  • A: U kunt dit navragen bij het technische supportteam tijdens het converteren van het config.data-bestand. Het bestand bevat informatie over de eerder geïnstalleerde pakketten.
• Q: Wat moet ik doen als mijn website na migratie niet bereikbaar is?
  • A: Controleer stap voor stap:
    1. Zorg dat u in stap 9 alle relevante pakketten (zoals Nginx/Apache en de juiste PHP-versies) opnieuw heeft herstart.
    2. Controleer of de websiteconfiguratie in ServBay correct is.
    3. Bekijk de logbestanden van de desbetreffende pakketten voor specifieke foutmeldingen.