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など）は、それぞれのOSやCPUアーキテクチャに合わせてコンパイル・最適化されています。そのため、

• macOS Intel版パッケージはApple Silicon Macで動作しません
• 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／メールなど）へ送付してください。
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. 関連パッケージのログファイルを確認し、具体的なエラーメッセージを特定する