ホスティング記述ファイルは、YAML または JSON フォーマットで記述でき、移行元サーバから移行するクライアント、契約、アドオンドメイン、メールボックスなどが列挙されています。ホスティング記述ファイルのサンプルはこちらを参照してください。本トピックでは、使用頻度の高いさまざまなパラメータを構成して移行を成功へと導く方法を説明します。

ウェブコンテンツデータへのパスを指定する

移行元サーバと移行先サーバの両方におけるウェブコンテンツデータへのパスを指定するには、subscriptions セクションで以下のパラメータを使用します。

• source_webspace_root - 顧客が使用できるすべてのファイルを格納する移行元サーバのディレクトリの絶対パス。契約レベルでのみ指定できます（例： /home/vhosts/example.com）。
• source_document_root - HTTP 経由で提供するファイルのみ格納するディレクトリの絶対パス。契約レベル、アドオンドメインレベル、またはサブドメインレベルで指定できます（例： /home/vhosts/example.com/httpdocs）。
• target_document_root - HTTP 経由で提供するファイルを格納する移行先サーバのディレクトリ。移行先サーバでの契約のルートディレクトリを基準とする相対パスで指定します。契約レベル、アドオンドメインレベル、またはサブドメインレベルで指定できます（例： data/www。ドメイン名が example.com で、Plesk の仮想ホストディレクトリが /var/www/vhosts である場合、移行先でのドキュメントルートディレクトリの絶対パスは /var/www/vhosts/example.com/data/www となります）。指定しないと、Plesk のデフォルト値が使用されます。

特定のディレクトリまたはファイルを移行対象外にする必要がある場合は、source_webspace_root パラメータと source_document_root パラメータで exclude ディレクティブを使用します。例：

subscriptions:
  - name: example.com
    source_webspace_root:
      path: /home/vhosts/example.com
      exclude:
        - /bin
        - /logs

exclude ルールを記述する構文は、rsync ツールで使用する構文と同じです。詳しくは、rsync のマニュアル の「Include/Exclude Pattern Rules」セクションを参照してください。

移行元サーバの特定のディレクトリにあるウェブコンテンツを、移行先サーバのどのディレクトリに格納するか明確に設定するには、ウェブファイルマッピングを使用します。例：

subscriptions:
  - name: example.com
    target_document_root: data/www
    web_files:
      - source: /home/vhosts/example.com
        target: "{webspace_root}"
      - source: /home/vhosts/example.com/httpdocs
        target: "{document_root}"

target ディレクティブには、移行先サーバでの絶対パスか、以下の表のテンプレート変数を 1 つ以上含むフォーマット文字列を指定します。

以下は、web_files ノードが契約ノードの直下にある場合のテンプレート変数と、それらが契約に対してどのような意味を持つのかを示します。

以下は、web_files ノードがアドオンドメインまたはサブドメインノードの直下にある場合のテンプレート変数と、それらがアドオンドメインおよびサブドメインに対してどのような意味を持つのかを示します。

メールコンテンツデータへのパスを指定する

移行元サーバから移行先サーバへメールコンテンツを移行するメカニズムは、Linux と Windows で異なります。

Linux では、移行するメールボックスについての情報を mail_users セクションに指定する必要があります。

mail_users:
- name: johndoe
  password: 123qwe
  directory: /var/qmail/mailnames/johndoe

ここで「directory」には、移行元サーバでメールボックスコンテンツが格納されているディレクトリ、または移行先サーバへ手動で移行した後にメールボックスコンテンツが配置されたディレクトリの絶対パスを指定します。

Windows では、ホスティング記述ファイルには何も指定する必要がありません。すべてのメールコンテンツは Plesk のバックアップおよび復元メカニズムを使用して移行されます。

データベースへのパスを指定する

Plesk Migrator では、他のパネルからの移行時に、MySQL/MariaDB および Microsoft SQL Server データベースをコピーすることができます。データベースコンテンツのコピーには 2 つの方法があります。

• データベースサーバへのアクセス権が付与されている場合、コンテンツを直接コピーする。
• データベースダンプファイルからコンテンツを復元する。

データベースサーバからコンテンツを直接コピーするには、Plesk マイグレータの構成ファイルにサーバを記述し、サーバへのアクセス情報も指定する必要があります。databases セクションで server パラメータを使用します。

databases:
  - server: mysql-db
    name: wordpress_9
    users:
    - login: exdbuser1
      password: 123qwe
  - server: mssql-db
    name: drupal_2
    users:
    - login: exdbuser2
      password: 123qwe

または

- name: wordpress_9
  dump: wordpress_9.sql
  users:
    - login: exdbuser1

データベースダンプファイルからコンテンツを復元するには、ダンプを特定のフォーマットで作成する必要があります。

• MySQL の場合、ダンプは mysqldump ユーティリティなどで作成できます。
• Microsoft SQL Server の場合、T-SQL の「BACKUP」コンストラクトを使用します。

ダンプを復元するには、以下のように dump オプションを指定します。

- name: wordpress_9
  dump: wordpress_9.sql
  user:
    login: exdbuser1