Przewodnik po migracji danych ServBay między platformami

Jeśli aktualizujesz swój komputer lub przechodzisz na inną platformę (np. z Maca Intel na Maca z Apple Silicon, albo z macOS na Windows), aby ServBay mógł działać bez zakłóceń i efektywnie na nowym urządzeniu, musisz wykonać określone kroki migracyjne. Ten przewodnik przeprowadzi Cię przez cały proces, krok po kroku.

Dlaczego wymagany jest specjalny proces migracji?

ServBay to lokalne środowisko deweloperskie obsługujące systemy macOS i Windows. Na macOS aplikacja główna posiada uniwersalną architekturę, natywnie wspierającą zarówno procesory Intel, jak i Apple Silicon (seria M).

Jednak podstawowe pakiety (jak PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache itd.) są specjalnie kompilowane i optymalizowane dla każdego systemu operacyjnego oraz architektury CPU. Oznacza to, że:

• Pakiety na macOS Intel nie uruchomią się na Macu z Apple Silicon
• Pakiety z macOS nie są kompatybilne z Windows
• Pakiety na Windows nie działają na macOS

Dlatego przechodząc między różnymi platformami lub architekturami, nie można po prostu skopiować całego katalogu ServBay. Trzeba zastąpić wszystkie zainstalowane pakiety oraz poprawnie przenieść dane i ustawienia użytkownika.

Szczegółowe kroki migracji

Przestrzegaj poniższych instrukcji, aby zachować pełną integralność i poprawność danych.

Krok 1: Wyłącz całkowicie ServBay i zamknij aplikację

Na starym Macu z Intelem kliknij ikonę ServBay w pasku menu (Menubar) u góry ekranu i wybierz z menu opcję Stop all services and quit. To ważny krok, aby przed kopią zapasową wszystkie pliki danych były prawidłowo zamknięte.

Krok 2: Utwórz kopię zapasową katalogu danych ServBay

macOS:

1. Otwórz Finder i przejdź do katalogu /Applications.
2. Odnajdź katalog o nazwie ServBay (uwaga: to nie jest aplikacja ServBay.app).
3. Zmień nazwę tego katalogu na ServBay.bak.

Windows:

1. Otwórz Eksplorator plików i przejdź do katalogu C:\.
2. Znajdź katalog o nazwie ServBay.
3. Zmień nazwę katalogu na ServBay.bak.

Ten katalog zawiera wszystkie Twoje pliki projektów, bazy danych, certyfikaty SSL, kopie zapasowe i ustawienia.

Krok 3: Zainstaluj ServBay na nowym urządzeniu

1. Skopiuj cały katalog ServBay.bak ze starego na nowe urządzenie:
   • macOS: do /Applications
   • Windows: do C:\
2. Na nowym urządzeniu pobierz i zainstaluj najnowszą wersję aplikacji ServBay.
3. Przy pierwszym uruchomieniu ServBay przeprowadzi Cię przez nową instalację. Po skonfigurowaniu utworzony zostanie nowy katalog ServBay:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Krok 4: Zainstaluj ponownie wszystkie potrzebne pakiety

1. Uruchom ServBay na nowym urządzeniu.
2. Przejdź do sekcji Pakiety (Packages) w lewym menu.
3. Ponownie zainstaluj wszystkie pakiety, których używałeś na poprzednim urządzeniu (np. PHP 8.2, MySQL 8.0, Nginx 1.25 itd.).
4. Ważne: Instaluj pakiety, ale na tym etapie nie musisz ich uruchamiać.

Krok 5: Ponownie wyłącz ServBay i zamknij program

Po zainstalowaniu wszystkich pakietów ponownie kliknij ikonę ServBay w pasku menu i wybierz Stop all services and quit.

Krok 6: Przenieś najważniejsze dane i ustawienia

Na nowym urządzeniu powinieneś mieć dwa katalogi:

• macOS:
  • /Applications/ServBay.bak (backup ze starego urządzenia)
  • /Applications/ServBay (świeża instalacja)
• Windows:
  • C:\ServBay.bak (backup ze starego urządzenia)
  • C:\ServBay (świeża instalacja)

Wykonaj następujące czynności:

Otwórz katalog backupu i skopiuj poniższe podkatalogi do nowej instalacji ServBay, wybierając nadpisanie wszystkich tych samych plików i folderów:

• backup: zawiera wszystkie kopie zapasowe (ręczne i automatyczne).
• data: zawiera konfiguracje stron, ustawienia aplikacji itp.
• db: zawiera pliki baz danych (MySQL, MariaDB, PostgreSQL).
• ssl: zawiera pliki certyfikatów SSL.
• www: zawiera pliki twoich projektów stron www.

Uwaga: Ten krok jest kluczowy — odtworzy Twoje wszystkie dane.

Krok 7: Skontaktuj się z pomocą techniczną w celu konwersji pliku konfiguracyjnego (krok krytyczny)

Ze względu na różnice platform i architektur, stare pliki konfiguracyjne wymagają konwersji.

1. Na nowym urządzeniu znajdź plik konfiguracyjny z backupu:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Prześlij plik config.data do zespołu wsparcia ServBay (np. poprzez Discord, Telegram, WeChat lub e-mail).
3. Zespół techniczny przekonwertuje plik tak, aby działał poprawnie na nowej platformie, i odeśle Ci go.
4. Otrzymany plik należy nadpisać w nowej instalacji ServBay:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Krok 8: Ponowna instalacja ServBay Root CA

1. Otwórz aplikację ServBay.
2. Przejdź do sekcji Ustawienia (Settings) w lewym menu.
3. Na stronie ustawień znajdź opcję ServBay Root CA i kliknij przycisk Zainstaluj ponownie ServBay Root CA.

Krok 9: Uruchom ponownie wszystkie usługi

1. Przejdź do sekcji Pakiety (Packages) w lewym menu.
2. Dla każdego pakietu, który zainstalowałeś, wykonaj restart: najpierw kliknij przełącznik, aby wyłączyć, a następnie znów, by włączyć pakiet. Dzięki temu wszystkie usługi wystartują z właśnie przeniesionymi danymi i konfiguracjami.

Krok 10: Migracja zakończona

Gotowe! Przeniosłeś wszystkie dane ServBay — możesz normalnie korzystać z ServBay na swoim nowym urządzeniu. Sprawdź, czy strony, bazy danych i pozostałe usługi działają jak należy.

Najczęściej zadawane pytania (FAQ)

• Q: Czy mogę pominąć etap konwersji pliku config.data przez wsparcie techniczne?
  • A: Nie. Plik config.data zawiera kluczowe ustawienia zależne od platformy i architektury. Jeśli pominiesz ten krok, ServBay może niepoprawnie ładować konfiguracje stron, baz danych i innych usług, a nawet nie uruchomić się.
• Q: Co zrobić, jeśli nie pamiętam, które pakiety były wcześniejsze?
  • A: W trakcie konwersji pliku config.data możesz zapytać wsparcie techniczne o listę pakietów — są one zapisane w pliku.
• Q: Strona nie działa po migracji — co zrobić?
  • A: Sprawdź kolejno:
    1. Czy w Kroku 9 restartowałeś wszystkie powiązane pakiety (np. Nginx/Apache oraz odpowiednią wersję PHP).
    2. Czy konfiguracja stron w ServBay jest poprawna.
    3. Przejrzyj logi danego pakietu i poszukaj szczegółowych informacji o błędach.