Hoe ServBay-data migreren van een Intel-chip naar een Apple Silicon (M-serie) Mac

Allereerst gefeliciteerd met je nieuwe Mac met Apple Silicon-chip! Om ervoor te zorgen dat je ServBay lokale ontwikkelomgeving soepel en efficiënt draait op je nieuwe apparaat, dien je een specifiek migratieproces te volgen. Deze gids biedt je stapsgewijze instructies.

Waarom is een speciaal migratieproces nodig?

De ServBay hoofdapplicatie heeft een universele architectuur en is native compatibel met zowel Intel- als Apple Silicon (M-serie) chips.

Echter, de kernsoftwarepakketten van ServBay (zoals PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, enzovoorts) zijn gecompileerd en geoptimaliseerd voor een specifieke CPU-architectuur. Dit betekent dat pakketten die geoptimaliseerd zijn voor Intel-chips niet direct werken op M-serie chips, en omgekeerd.

Dus wanneer je een Intel Mac vervangt door een M-serie Mac, kun je niet simpelweg de volledige ServBay-map kopiëren. Je moet alle geïnstalleerde pakketten vervangen en je persoonlijke data en instellingen migreren.

Gedetailleerde migratiestappen

Volg de onderstaande stappen nauwkeurig om de integriteit en correctheid van je datamigratie te waarborgen.

Stap 1: ServBay volledig stoppen en afsluiten

Stop op je oude Intel Mac ServBay door bovenin de menubalk op het ServBay-icoon te klikken en kies uit het menu Stop alle services en afsluiten. Dit is een cruciale stap om ervoor te zorgen dat alle databestanden correct zijn afgesloten voor het maken van een back-up.

Stap 2: Back-up van ServBay-datamap maken

1. Open de Finder en ga naar de /Applications-map.
2. Zoek de map genaamd ServBay (let op: dit is niet de ServBay.app).
3. Hernoem deze map naar ServBay.bak. Deze map bevat al je websitebestanden, databases, SSL-certificaten, back-ups en configuraties.

Stap 3: Nieuwe installatie van ServBay op de nieuwe Mac

1. Kopieer de complete map ServBay.bak van je oude Mac naar de /Applications-map op de nieuwe M-serie Mac.
2. Download en installeer de nieuwste versie van de ServBay hoofdapplicatie op je nieuwe Mac.
3. Open voor het eerst ServBay.app, deze zal je door het installatieproces leiden. Volg de instructies om de installatie te voltooien. Na voltooiing wordt er een nieuwe ServBay-map aangemaakt in de /Applications-map.

Stap 4: Herinstalleer alle benodigde softwarepakketten

1. Open ServBay op je nieuwe Mac.
2. Ga naar de Pakketten (Packages) in de navigatie aan de linkerkant.
3. Installeer opnieuw alle pakketten die je eerder gebruikte op je oude Mac (zoals PHP 8.2, MySQL 8.0, Nginx 1.25, enzovoorts).
4. Belangrijk: Alleen installeren, nog niet inschakelen.

Stap 5: ServBay opnieuw volledig stoppen en afsluiten

Nadat alle pakketten zijn geïnstalleerd, klik opnieuw op het ServBay-icoon in de menubalk en kies Stop alle services en afsluiten.

Stap 6: Kerngegevens en configuraties migreren

Nu dienen er twee relevante mappen in je /Applications/-map te staan:

• /Applications/ServBay.bak (backup van je oude Mac)
• /Applications/ServBay (nieuwe installatie op je nieuwe Mac)

Voer de volgende kopieerstappen uit:

Open de map /Applications/ServBay.bak en kopieer de onderstaande submappen naar de nieuwe /Applications/ServBay-map. Kies daarbij voor overschrijven van alle gelijknamige bestanden en mappen:

• backup: bevat al je handmatige en automatische back-upbestanden.
• data: bevat je website-instellingen, applicatieconfiguraties, enzovoorts.
• db: bevat al je databasebestanden (MySQL, MariaDB, PostgreSQL).
• ssl: bevat al je SSL-certificaatbestanden.
• www: bevat al je websiteprojectbestanden.

Opmerking: deze stap is zeer belangrijk, hiermee herstel je al je data.

Stap 7: Neem contact op met de technische support voor conversie van het configuratiebestand (essentiële stap)

Vanwege de verschillen in CPU-architectuur kan het oude configuratiebestand niet direct gebruikt worden op het nieuwe systeem.

1. Zoek op je nieuwe Mac het geback-upte configuratiebestand: /Applications/ServBay.bak/data/servbay/config.data.
2. Stuur dit config.data bestand naar het ServBay technische supportteam (bijvoorbeeld via de officiële Discord, Telegram, WeChat of e-mail).
3. Het supportteam converteert dit bestand zodat het compatibel is met de M-serie architectuur en stuurt het terug.
4. Zodra je het bestand terug ontvangt, overschrijf je het op de volgende locatie: /Applications/ServBay/data/servbay/config.data.

Stap 8: Installeer ServBay Root CA opnieuw

1. Open de ServBay-applicatie.
2. Ga in de linker navigatiebalk naar Instellingen (Settings).
3. Zoek op de instellingenpagina naar de optie ServBay Root CA en klik op de knop ServBay Root CA opnieuw installeren.

Stap 9: Herstart alle services

1. Ga in de linker navigatiebalk naar Pakketten (Packages).
2. Herstart elk van je geïnstalleerde pakketten één voor één: schakel een pakket eerst uit via de schakelaar en vervolgens weer in. Zo wordt elk pakket gestart met de gemigreerde data en configuratie.

Stap 10: Migratie voltooid

De migratie van al je ServBay-data is nu voltooid! Je kunt nu ServBay gebruiken op je nieuwe M-serie Mac. Controleer of je websites, databases en andere services naar behoren werken.

Veelgestelde vragen (FAQ)

• Q: Kan ik de stap met het conversiebestand (config.data) via support overslaan?
  • A: Nee. Het config.data-bestand bevat essentiële informatie gekoppeld aan de hardware-architectuur. Deze stap overslaan kan ertoe leiden dat ServBay je websites, databases en andere diensten niet correct laadt, of zelfs helemaal niet start.
• Q: Wat als ik niet meer weet welke pakketten ik eerder had geïnstalleerd?
  • A: Je kunt dit navragen bij de technische support tijdens de conversie van je config.data. In het bestand staat welke pakketten je eerder gebruikte.
• Q: Mijn website is na de migratie niet bereikbaar, wat nu?
  • A: Check a.u.b. het volgende in deze volgorde:
    1. Zorg ervoor dat je in stap 9 alle benodigde pakketten opnieuw hebt gestart (zoals Nginx/Apache en de juiste PHP-versie).
    2. Controleer of de website-instellingen in ServBay correct zijn.
    3. Bekijk de logbestanden van de relevante pakketten om eventuele foutmeldingen te achterhalen.