ドメイン移行ツール

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:8分
  • ドメイン移行ツールを使用して、ドメインセパレーションされた環境から独自の専用インスタンスに顧客を移動させます。

    ドメイン移行ツールプラグイン

    ドメイン移行ツールプラグイン (com.glide.domain.migration_tool) により、ドメインセパレーションされた環境からより柔軟な専用インスタンスに顧客が移動するタスクを簡素化することができます。ServiceNow AI Platform の機能を最大限に活用するために、顧客は別のインスタンスに移行することもできます。ドメインセパレーションプラグインがインストールされていても、データとプロセスの分離プロパティはオフになっています。
    注:
    使用するには、クローンされたインスタンスを要求し、ドメイン移行ツールプラグインのアクティベーションを要求する必要があります。
    ドメイン移行ツールは、ドメインセパレーションされたインスタンスでデータとプロセスの両方の分離が有効になっている場合にのみ実行されます。
    • glide.sys.domain.partitioning データプロパティは true に設定する必要があります。
    • glide.sys.domain.delegated_administration プロセスプロパティは true に設定する必要があります。

    移行ツールの機能

    • 移行プロセスの多く、特にデータのクリーンアップを自動化します。
    • ドメインセパレーションされたインスタンスを新しい専用インスタンスに移行します。
    • 専用インスタンスからデータを削除します。
      注:
      このツールは、グローバル、ターゲットドメイン、または追加のデータドメイン (指定されている場合) のデータを削除しません。
    • プロセスデータを折りたたむか、折りたたむことができない場合はプロセスデータを削除します。
    • ターゲットドメインに表示されるプロセスレコードを保持します。
    • sys_choice、sys_ui_list、および sys_ui_related_list 特殊テーブルを更新します。
    • ドメインセパレーションプラグインによって追加されたレコードをクリーンアップします。
      • ビジネスルール
      • UI アクション
      • スケジュール済みジョブ
      • インストレーションイグジット
      • ナビゲーションモジュール
    • ドメインセパレーションを無効にし、クローンされたインスタンスからドメインを削除します。
      • クローンされたインスタンスで次のプロパティを false に設定します。
        • glide.sys.domain.partitioning
        • glide.sys.domain.delegated_administration
        • glide.sys.domain.enabled
      • ターゲットドメインと指定された追加のデータドメインを除くすべてのドメインを削除します。
    • domain_migration_tool_status テーブルの [ステータス] フィールドを更新します。
      表 : 1. テーブルの個々のステータス
      ステータス 説明
      処理待ち 移行中のドメインセパレーションテーブルのデフォルトのステータステーブルは移行される予定ですが、まだ移行が開始されていません。
      失敗 テーブルレベルのエラー。移行プロセスがエラーで終了した場合、このステータスはどのテーブルにエラーがあるかを示します。
      実行中 現在移行中のテーブルのステータス。1 つのテーブルのみがこのステータスになり、現在移行中です。
      成功 正常に移行されたテーブルのステータス。
      正常に完了しました 移行プロセスはエラーなしで終了しました。
      エラーで終了 移行プロセスはエラーで終了しました。
    • 進捗状況とステータスを syslog_domain に記録します。

      移行に関連するすべてのログエントリのソースは MigrationTool です。

      • 各データテーブルと残りのデータテーブルをログに記録します。
      • 各プロセステーブルと、現在非アクティブ化または削除されているドメインのレコードをログに記録します。

    移行ツールに含まれない機能

    • インスタンスをクローンします。
    • 別のドメインセパレーションインスタンスを作成します。
    • ツールを実行する前にデータまたはプロセス分離プロパティが無効になっている場合は、レコード (データまたはプロセス) を移行します。
    • ソースインスタンスのデータを変更します。
    • グローバル、ターゲットドメイン、または追加のデータドメイン (指定されている場合) のデータを削除します。

    ツールの実行後に行う必要があること

    ドメイン移行ツールは、目的のドメイン (ターゲットドメイン、追加のデータドメイン、およびグローバルドメイン) 以外のデータの削除を自動化します。残りの構成をすべて評価して、それらが適切であり、専用のインスタンスに対して機能することを確認する必要があります。たとえば、レコードのドメインフィールドを設定するビジネスルールがある場合、このビジネスルールは役に立たないため、無効にすることができます。

    ドメインセパレーションされたインスタンスを専用インスタンスに移行する

    ドメインセパレーションされた環境から独自の専用インスタンス環境に顧客を移動します。

    始める前に

    必要なロール:admin

    手順

    1. security_admin ロールに昇格させます。
      詳細については、「特権ロールへの昇格」を参照してください。
    2. 移動先 すべて > ドメイン管理 > ドメイン移行ツール.
      domain_migration_tool_status.list にもアクセスします。
    3. [新規] をクリックします。
    4. フォームに入力します。
      フィールド 説明
      ターゲットドメイン 移行するプロセスとデータの両方に使用するドメインを指定します。[追加データドメイン] フィールドで指定されている場合を除き、子ではなくターゲットドメインのみが保持されます。
      追加のデータドメイン 必要に応じて、移行する追加のデータドメインを指定します。ターゲットドメインとそのすべての子を移行する場合は、すべての子を指定する必要があります。
    5. [送信] を選択します。
    6. 送信したフォームを開きます。
    7. 移動先 すべて > ドメインセパレーションセンター > 監査の設定
      詳細については、「ドメインセパレーションセンター」を参照してください。
    8. [ドメインセパレーションテーブルのスキーマの検証 (Validate Domain Separated Table Schema)] 監査を [アクティブ] に設定し、スケジュールをアサインします。
      これは、ドメインセパレーションされたテーブルの健全性について事前にチェックするための予防的なドメイン監査です。これにより、移行を実行する前にエラーを修正できます。
    9. スキーマを含む監査スケジュールを実行します。
      詳細については、「直ちに監査を実行する」を参照してください。
    10. 監査から返された問題に対処します。
      スキーマチェックのエラーの例。
    11. [移行開始] を選択します。
      • 実行トラッカーの進捗状況バーとドメイン移行ツールがトリガーされます。ドメイン移行の進捗状況バー。
      • 現在進行中のテーブルが、正常に移行されたテーブルの割合の合計とともに表示されます。
      • すべてのドメインセパレーションテーブルが、移行ステータス、各テーブルの合計レコード数、および移行されたレコードの数とともに記録されるテーブル。
      • 移行に失敗したテーブルの数も記録されます。
      • [ステータス] は、ツールがその機能を実行するときに更新されます。
      • 進捗状況バーを閉じても、ドメインの移行はバックグラウンドで実行されています。sys_execution_tracker テーブルにアクセスし、[テーブルで実行中の移行 (Running Migration on Tables)] を探して、バックグラウンドで実行されている移行プロセスを確認します。

      ドメイン移行ツールのステータスには、次のフィールドが表示されます。

      表 : 2. ドメイン移行ツールのステータスフィールド
      フィールド 説明
      ステータス 移行ステータスを表示します。
      • データテーブルを移行しています...(Migrating data tables...):進行中のステータス。
      • 移行に成功しました (Migration successful):移行が成功した後の更新されたステータス。
      • ドメインセパレーションされたテーブルの 1 つで不適切な構成が観測されました (Misconfiguration is observed on one of the domain separated tables):データ移行の失敗を示します。スキーマエラーが検出されました。移行は開始されません。[ドメインセパレーションテーブルのスキーマの検証 (Validate Domain Separated Table Schema)] 監査を実行します。監査は失敗し、スキーマ標準に従っていないテーブルが表示されます。
      • テーブルの再アクセスでエラーが発生して終了しました (Finished with Errors in Revisit Tables):スキーマの移行に対処するためにテーブルの数が表示されます。[再アクセステーブル数] でエラーを特定し、スキーマの問題に対処します。
      • テーブルのドメイン移行に失敗しました...(Domain Migration Failed for Tables...):失敗したテーブルからターゲット以外のレコードを手動で削除する必要があります。
      • 正常に完了しました:すべてのテーブルが移行されました。
      ターゲットドメイン 移行のために選択されたターゲットドメイン。
      追加のデータドメイン 複数の移行ドメインが選択されている場合に入力します。
      再アクセステーブル数 このフィールドは、テーブルの移行に失敗した場合にのみ入力されます。エラーがない場合、この数はゼロです。この場合、テーブルに再アクセスして移行を再試行します。エラーがない場合は、テーブルに再アクセスしたり、移行を再試行したりする必要はありません。
      現在の進捗中のテーブル 現在移行中のテーブルの名前を表示します。移行が成功すると、このフィールドは空になります。
    12. [ドメイン移行ツールのステータス] ページで [ここをクリック] リンクを選択して、実行トラッカーを開きます。ドメイン移行ツールの進捗状況バーを再び開くためのリンク。

      sys_execution_tracker テーブルにアクセスし、[テーブルで実行中の移行 (Running Migration on Tables)] を探して、バックグラウンドで実行されている移行プロセスを確認することもできます。

    13. [関連リンク] セクションの [ステータスを表示] を選択すると、移行中にいつでも進捗状況バーにアクセスできます。実行トラッカーに [ステータスを表示] リンクを表示します。

      テーブルがスキーマチェックに失敗した場合、ドメインセパレーションテーブルの全体的な移行ステータスは [失敗] になります。全体的な移行ステータスが失敗と表示されます。

      対応するテーブルごとに失敗したエントリがあります。

      移行に失敗したテーブルを表示します。

      移行の残りの部分は続行され、失敗したすべてのテーブルのサマリーと再アクセステーブル数の合計数が、ドメイン移行ツールのステータスに入力されます。失敗したテーブルの数と、必要なテーブルの再アクセス数が表示されます。

      移行が完了すると、[ステータス][正常に完了しました] になります。成功した移行ステータスを表示します。