Гайд по кросплатформенній міграції даних ServBay

Якщо ви оновлюєте пристрій або переходите на іншу платформу (наприклад, з Intel Mac на Apple Silicon Mac, чи з macOS на Windows), щоб ServBay працював коректно та ефективно на новому обладнанні, необхідно дотримуватись спеціального процесу міграції. Ця інструкція детально описує всі потрібні кроки.

Чому потрібен окремий процес міграції?

ServBay — це кросплатформене локальне середовище розробки, сумісне з macOS і Windows. Основна програма ServBay підтримує універсальну архітектуру, тобто нативно працює як на Intel, так і на Apple Silicon (М-серії) Mac.

Втім, основні пакети ServBay (PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache тощо) компілюються та оптимізуються під конкретну операційну систему й архітектуру процесора. Це означає:

• пакети macOS для Intel не працюватимуть на Mac з Apple Silicon,
• macOS-пакети не працюють на Windows,
• пакети Windows не працюють на macOS.

Тож при переході між платформами чи архітектурами недостатньо просто скопіювати всю папку ServBay — необхідно оновити всі встановлені пакети й перенести ваші особисті дані та налаштування.

Детальні кроки міграції

Дотримуйтесь інструкцій нижче для забезпечення цілісності та коректності ваших даних під час міграції.

Крок 1: Повністю зупиніть і закрийте ServBay

На старому Mac з Intel натисніть іконку ServBay у верхній меню-панелі екрану та оберіть Зупинити всі сервіси й вийти. Це ключовий етап для безпечного закриття всіх файлів перед резервним копіюванням.

Крок 2: Створіть резервну копію папки даних ServBay

macOS:

1. Відкрийте Finder і перейдіть до каталогу /Applications.
2. Знайдіть папку ServBay (зверніть увагу: це папка, а не лише додаток ServBay.app).
3. Перейменуйте її на ServBay.bak.

Windows:

1. Відкрийте провідник файлів та перейдіть до каталогу C:\.
2. Знайдіть папку ServBay.
3. Перейменуйте її на ServBay.bak.

Ця папка містить усі ваші файли сайтів, бази даних, SSL сертифікати, резервні копії та конфігурації.

Крок 3: Встановіть ServBay на новому пристрої

1. Повністю скопіюйте папку ServBay.bak зі старого пристрою на новий:
   • macOS: скопіюйте у /Applications
   • Windows: скопіюйте у C:\
2. На новому пристрої завантажте й встановіть останню версію основної програми ServBay.
3. При першому запуску ServBay ви пройдете нову процедуру встановлення — слідуйте інструкціям. Після цього буде створено нову папку ServBay:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Крок 4: Перевстановіть усі необхідні пакети

1. Відкрийте ServBay на новому пристрої.
2. Перейдіть до розділу Пакети (Packages) у лівій панелі навігації.
3. Перевстановіть ті пакети, які використовували раніше (наприклад, PHP 8.2, MySQL 8.0, Nginx 1.25 тощо).
4. Важливо: На цьому етапі встановлюйте лише пакети — не вмикайте їх.

Крок 5: Ще раз повністю зупиніть і закрийте ServBay

Після встановлення всіх пакетів знову натисніть іконку ServBay у меню-панелі і оберіть Зупинити всі сервіси й вийти.

Крок 6: Перенесіть основні дані та конфігурації

Тепер на вашому пристрої існує дві пов’язані папки:

• macOS:
  • /Applications/ServBay.bak (резервна копія зі старого пристрою)
  • /Applications/ServBay (нова інсталяція)
• Windows:
  • C:\ServBay.bak (резервна копія зі старого пристрою)
  • C:\ServBay (нова інсталяція)

Виконайте наступні дії:

Відкрийте папку резервної копії й скопіюйте нижченаведені підкаталоги у нову папку ServBay, замінюючи всі файли й папки, якщо такі вже існують:

• backup — всі ваші ручні й автоматичні резервні копії.
• data — налаштування сайтів, програм, тощо.
• db — всі файли баз даних (MySQL, MariaDB, PostgreSQL).
• ssl — SSL-сертифікати.
• www — усі файлові проєкти ваших сайтів.

Примітка: Цей крок надзвичайно важливий — він відновлює всі ваші дані.

Крок 7: Зверніться до технічної підтримки для конвертації конфігурації (ключовий етап)

Через різницю платформ і архітектур необхідна конвертація старих конфігураційних файлів для роботи на новій платформі.

1. На новому пристрої знайдіть файл конфігурації з резервної копії:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Надішліть цей файл config.data офіційній технічній підтримці ServBay (наприклад, через Discord, Telegram, WeChat чи email).
3. Команда підтримки виконає конвертацію для нової платформи й архітектури та поверне вам оновлений файл.
4. Отриманий файл замініть у новій інсталяції ServBay:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Крок 8: Встановіть ServBay Root CA заново

1. Відкрийте програму ServBay.
2. Перейдіть до розділу Налаштування (Settings) у лівій панелі.
3. На сторінці налаштувань знайдіть пункт ServBay Root CA та натисніть кнопку Встановити ServBay Root CA заново.

Крок 9: Перезапустіть усі сервіси

1. Перейдіть до розділу Пакети (Packages) у лівій навігації.
2. Для кожного встановленого пакета виконайте перезапуск: спочатку вимкніть його за допомогою перемикача, потім увімкніть знову. Це гарантує, що всі сервіси стартують із вашими щойно перенесеними даними та налаштуваннями.

Крок 10: Завершення міграції

Вітаємо, міграція даних ServBay завершена! Тепер ви можете користуватись ServBay повноцінно на новому пристрої. Перевірте роботу ваших сайтів, баз даних та сервісів, щоб переконатись у правильності налаштування.

Часті питання (FAQ)

• Q: Чи можна пропустити етап звернення до техпідтримки щодо конвертації файлу config.data?
  • A: Ні, не можна. Файл config.data містить критичні налаштування, залежні від платформи та архітектури. Якщо пропустити цей етап, ServBay може некоректно завантажити ваші сайти, бази даних та сервіси, або навіть не запуститись.
• Q: Я забув, які пакети були встановлені раніше. Що робити?
  • A: Під час звернення до техпідтримки щодо файлу config.data, ви можете уточнити цей момент. Файл містить інформацію про перелік встановлених пакетів.
• Q: Після міграції мій сайт недоступний. Як це виправити?
  • A: Перевірте наступне по порядку:
    1. Переконайтесь, що у кроці 9 ви перезапустили всі потрібні пакети (Nginx/Apache та відповідні версії PHP).
    2. Перевірте, чи коректно налаштовано сайт у ServBay.
    3. Ознайомтесь із логами відповідних пакетів для пошуку конкретної помилки.