オンプレミス NetScaler ADM を Citrix Cloud™ に移行する

最終公開日 : Oct 02, 2026
オンプレミスの NetScaler ADM 13.0 64.35 以降のバージョン を Citrix Cloud に移行できます。ADM が 12.1 以前のバージョンの場合は、まず 13.0 64.35 以降のバージョン にアップグレードしてから Citrix Cloud に移行する必要があります。詳細については、アップグレード セクションを参照してください。
Citrix Cloud を介した ADM サービスでは、次の機能を利用できます。
  • 最新の機能アップデートを含む、約2週間ごとのより迅速なリリース。
  • アプリケーションセキュリティとボット、パフォーマンス、および使用状況に関する機械学習ベースの分析。
  • ピークおよび閑散期の分析、アプリケーションセキュリティとボット向けの機械学習ベースの分析、アプリケーション CPU 分析など、現在 ADM サービスでのみサポートされているその他さまざまな機能。
移行を成功させるには、次の操作を行う必要があります。
  • Citrix Cloud へのアクセスを可能にするため、オンプレミス ADM でインターネット接続があることを確認する
  • ADM サービスエージェントを構成する
  • Citrix Cloud からクライアントとシークレットの CSV ファイルを取得する
  • ADM サービスのライセンスを検証する
  • スクリプトを使用して移行する
オンプレミス ADM から ADM サービスに移行した後、再度オンプレミス ADM を継続したい場合は、ロールバックスクリプトを使用できます。詳細については、オンプレミス ADM へのロールバック を参照してください。
Related information
よくある質問トラブルシューティング

ADM サービスエージェントを構成する

NetScaler インスタンスと NetScaler ADM 間の通信を有効にするには、エージェントを構成する必要があります。NetScaler エージェントは、デフォルトで最新ビルドに自動的にアップグレードされます。エージェントのアップグレードに特定の時間を選択することもできます。詳細については、エージェントのアップグレード設定の構成 を参照してください。
  • 既存のオンプレミスADM (スタンドアロンまたはHAペア) にオンプレミスエージェントが構成されていない場合は、ADMサービス用に少なくとも1つのエージェントを構成する必要があります。
  • 既存のオンプレミスADM (スタンドアロンまたはHAペア) にマルチサイト展開用にオンプレミスエージェントが構成されている場合は、ADMサービス用に同数のエージェントを構成する必要があります。
エージェントの構成の詳細については、はじめにセクションを参照してください。

Citrix CloudからクライアントとシークレットのCSVファイルを取得する

エージェントを構成したら、Citrix CloudページからクライアントとシークレットのCSVファイルを取得します。
  1. citrix.cloud.comにログオンします
  2. ホームアイコンをクリックし、IDおよびアクセス管理を選択します。
  3. APIアクセスタブから、安全なクライアント名を入力し、クライアントの作成をクリックします。
  4. IDとシークレットが生成されます。ダウンロードをクリックし、オンプレミスADMにCSVファイルを保存します。
    たとえば、CSVファイルを/varディレクトリに保存します。

ADMサービスライセンスを検証する

ADMサービス用にライセンスを取得する必要があります。
  • ADMサービスのVIPライセンスは、オンプレミスVIPライセンス以上である必要があります。
    注
    VIPライセンスが少ない場合、仮想サーバーはランダムに選択され、ADMサービスのVIPレベルの構成は失敗します。
  • ADMオンプレミス展開をライセンスサーバーとして使用している場合は、移行前にライセンスをADMサービスに再割り当てしてください。詳細については、プールされたライセンスサーバーとしてのみADMサーバーを構成する および ライセンスファイルを再割り当てする方法 を参照してください。
  • オンプレミスADMでプールされたライセンスを使用している場合は、ADMサービス用のプールされたライセンスを取得し、ADCインスタンスにライセンスを割り当てる必要があります。詳細については、プールされたライセンスの構成 を参照してください。ADMからライセンス割り当てを変更できるサポート対象のADCバージョンは次のとおりです。
    • NetScaler SDX: 13.0 74.11 以降のバージョン。
    • NetScaler VPXおよびMPX: 13.0 47.24 以降のバージョン、12.1 58.14 以降のバージョン、および11.1 65.10 以降のバージョン。

スクリプトを使用した移行

  • ADM 82.xビルドを使用すると、機能を選択して移行できます。
  • ADM 76.x以降のビルドの場合、移行スクリプト (servicemigrationtool.py および config_collect_onprem.py) はビルドの一部として利用可能で、cd /mps/scripts で入手できます。
  • ADM 76.xより前のビルドの場合、移行スクリプトをダウンロードし、オンプレミスADMにスクリプトをコピーする必要があります。
    注
    移行中は、オンプレミスADMにインターネット接続があることを確認してください。
  1. SSHクライアントを使用して、オンプレミスADMにログオンします。
    注
    ADM HAペアの場合は、プライマリノードにログオンします。
  2. 「shell」と入力し、Enterキーを押してbashモードに切り替えます。
  3. クライアントIDとシークレットCSVファイルをコピーします。たとえば、ファイルを/varディレクトリにコピーします。
    CSVファイルをコピーした後、CSVファイルが存在するかどうかを検証できます。
    CSVを追加(/en-us/netscaler-application-delivery-management-software/media/csv-add-adm.png)
    注
    ADM HAペアの場合、プライマリノードにCSVファイルをコピーします。
  4. ADM 13.0 82.xxバージョンの場合、移行を完了するには次のコマンドを実行します。
    1. cd /mps/scripts
    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler ADM VM>
    例: python servicemigrationtool.py /var/secureclient.csv
    移行スクリプトを実行すると、ツールは次のオプションを表示します。
    機能ごとの移行オプション(/en-us/netscaler-application-delivery-management-software/media/migrate-options.png)
    指定した選択に基づいて、その機能のみがADMサービスに移行されます。
    例では、オプション1が選択されています。ツールは管理および監視 (M&M) の移行を完了し、次のメッセージを表示します。
    移行完了(/en-us/netscaler-application-delivery-management-software/media/migrate-option-complete.png)
    管理および監視 (M&M) 機能には以下が含まれます。
    • ADCインスタンス、タグ、インスタンスグループ、プロファイル、カスタムアプリ、構成ジョブ、SNMP、syslog構成。
    • サイト、IPブロック、ネットワークレポート、分析しきい値、通知設定、データプルーニング設定。
    • 設定監査テンプレート、ポーリング間隔、イベントルールと設定。
    • RBACグループ、ロール、およびポリシー
    Analytics機能には以下が含まれます。
    • ADCインスタンスからのvserverごとのAppflow®設定。
    • SDWANデバイスごとのAppflow設定。
    注:
    • 管理および監視 (M&M) 機能は、他の機能 (2、3、または 4) を選択した場合でも、自動的に移行されます。
    • 一度に指定できる機能は1つだけです。
    • いずれかの機能の移行が完了した後、後で他の機能を移行したい場合、すでに移行された機能はリストに表示されません。たとえば、最初にAnalytics機能の移行を完了した場合、次回移行スクリプトを実行するときには、StyleBooks、Pooled Licensing、およびAllオプションのみが表示されます。
    • プールライセンスを移行すると、vserverを含むすべてのタイプが移行されます。
  5. ADM 13.0 76.xxバージョンの場合、移行を完了するには次のコマンドを実行します。
    1. cd /mps/scripts
    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler ADM VM>
    例: python servicemigrationtool.py /var/secureclient.csv
  6. ADM 13.0 76.xx バージョン以前の場合:
    1. 以下の場所から移行スクリプトをダウンロードします。 https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz
      ダウンロードしたファイルには、servicemigrationtool_27.py と config_collect_onprem_27.py の2つのバンドルスクリプトが含まれています。
    2. 2つのスクリプトをオンプレミスADMに保存します。例えば、/var ディレクトリに保存します。
    3. 移行するには、以下のコマンドを実行します。
      1. cd /var
      2. servicemigrationtool_27.py <path of ClientID/Secret File in on-premises ADM VM>
        例えば、python servicemigrationtool_27.py /var/secureclient.csv
スクリプトを実行すると、前提条件がチェックされ、その後移行が続行されます。スクリプトはまずライセンスの利用可能性を確認します。オンプレミスライセンスよりもADMサービスライセンスが少ない場合にのみ、以下のメッセージが表示されます。
オンプレミスライセンスが少ない
Y を選択すると、VIPをランダムにライセンスすることで移行が続行されます。N を選択すると、スクリプトは移行を停止します。
プールライセンスサーバーにサポートされていないADCインスタンスバージョンがある場合、以下のメッセージが表示されます。
サポートされていないADCバージョン
Y を選択すると、ライセンスサーバーを変更することで移行プロセスが続行されます。N を選択すると、スクリプトは残りの移行を続行するかどうかを尋ねます。N を選択した場合、スクリプトは移行を停止します。
オンプレミスの構成によっては、移行が完了するまで数分から数時間かかります。移行が完了すると、以下のメッセージが表示されます。
移行完了ステータス(/en-us/netscaler-application-delivery-management-software/media/migration-complete-status.png)
すべてのADCインスタンスとそのそれぞれの構成がADMサービスに正常に移行されると、移行は成功です。移行が成功すると、オンプレミスのNetScaler® ADMは以下のインスタンスイベントの処理を停止します。
  • SSL証明書
  • Syslogメッセージ
  • バックアップ
  • エージェントクラスター
  • パフォーマンスレポート
  • 構成監査
  • Emonスケジューラ

オンプレミスADMへのロールバック

オンプレミスADMにロールバックする場合は、前提条件が満たされていることを確認してください。

前提条件

オンプレミスADM（ADMサービスへの移行前）が次のいずれかの場合：
  • プールされたライセンスサーバーとして使用されている場合は、オンプレミスADMに必要なプールされたライセンスがあることを確認してください。
  • オンプレミスADMエージェントで構成されている場合は、エージェントが「UP」ステータスで利用可能であることを確認してください。

ロールバックスクリプトを使用する

注
ロールバック後、Analytics、SNMP、プールされたライセンスの同じ構成（移行前）が、オンプレミスADMで再び利用可能になります。移行後にこれらの構成に変更を加えた場合、これらの変更はオンプレミスADMには反映されません。
  • ADM 82.xx以降のビルドの場合、ロールバックスクリプトはビルドの一部として利用可能で、/mps/scriptsでアクセスできます。
  • 79.xxより前のADMビルドの場合、82.xビルドにアップグレードしてロールバックスクリプトを使用するか、ロールバックスクリプトをダウンロードしてオンプレミスADMにコピーすることができます。
  1. SSHクライアントを使用して、オンプレミスADMにログオンします。
  2. 「shell」と入力し、Enterキーを押してbashモードに切り替えます。
  3. ADM 13.0 82.xxビルドの場合、ロールバックを完了するには、次のコマンドを実行します。
    1. cd /mps/scripts
    2. python rollback_to_onprem.py <path of ClientID/Secret File in ADM on-prem VM> を実行します
      例: python rollback_to_onprem.py /var/ secureclient.csv.csv
      ツールがロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには「Y」と入力します。
      ロールバックの続行
      ロールバックが完了すると、次のメッセージが表示されます。
      ロールバック完了
  4. 82.xxビルドより前のADMの場合:
    1. 以下の場所からロールバックスクリプトをダウンロードします:
      https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz
    2. ADM 79.xxおよび76.xxビルドの場合、スクリプトを/mps/scriptsに保存し、以下のコマンドを実行してロールバックします:
      1. cd /mps/scripts
      2. python rollback_to_onprem.py < path of client/secret csv file in ADM on-prem>
        例: python rollback_to_onprem.py /var/ secureclient.csv
    3. 76.xxビルドより前のADMの場合、スクリプトをオンプレミスADMに保存します。たとえば、/varの場所に保存し、以下のコマンドを実行してロールバックします:
      1. cd /var
      2. python rollback_to_onprem_27.py < path of client/secret csv file in ADM on-prem>
        例: python rollback_to_onprem_27.py /var/secureclient.csv
      ツールがロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには「Y」と入力します。