Руководство по кроссплатформенной миграции данных ServBay

Если вы обновляете компьютер или переходите между платформами (например, с Intel Mac на Apple Silicon Mac, либо с macOS на Windows), для корректной и эффективной работы вашей локальной среды разработки ServBay на новом устройстве необходимо выполнить определённую процедуру миграции. Данное руководство описывает все шаги подробно.

Почему необходим специальный порядок миграции?

ServBay — кроссплатформенная среда локальной разработки, поддерживающая macOS и Windows. На macOS основной приложение имеет универсальную архитектуру, что обеспечивает родную совместимость с чипами Intel и Apple Silicon (M-серии).

Однако программные пакеты, предоставляемые ServBay (например, PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache и другие), собраны и оптимизированы строго под определённую ОС и архитектуру процессора. Это значит, что:

• версии пакетов для macOS Intel не работают на Mac с Apple Silicon,
• macOS-пакеты несовместимы с Windows,
• Windows-пакеты не работают на macOS.

Поэтому, при смене платформы/архитектуры недостаточно просто скопировать весь каталог ServBay — потребуется заменить все установленные пакеты и перенести личные данные и настройки.

Подробная инструкция по миграции

Пожалуйста, следуйте приведённым ниже шагам для полной и корректной миграции данных.

Шаг 1: Полная остановка и выход из ServBay

На старом Intel Mac щёлкните по значку 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 и нажмите кнопку для повторной установки.

Шаг 9: Перезапустите все сервисы

1. Перейдите в раздел Пакеты (Packages) на левой панели.
2. Перезапустите каждый установленный пакет: сначала выключите, затем снова включите с помощью переключателя. Это гарантирует запуск сервисов с мигрированными данными и настройками.

Шаг 10: Миграция завершена

Теперь процесс миграции данных ServBay полностью завершён! Ваши сайты, базы данных и сервисы должны работать на новом устройстве. Проверьте работоспособность всех компонентов.

Часто задаваемые вопросы (FAQ)

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