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

最終公開日 : Sep 25, 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へのロールバックを参照してください。

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

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

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

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

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

ADMサービス用のlicensesを取得する必要があります。
  • ADMサービスのVIPライセンスは、オンプレミスのVIPライセンス以上である必要があります。
    注
    VIPライセンスが少ない場合、仮想サーバーはランダムに選択され、ADMサービスのVIPレベル構成は失敗します。
  • ADMオンプレミス展開をライセンスサーバーとして使用している場合は、移行前にライセンスをADMサービスに再割り当てしてください。詳細については、Configure an ADM server only as the pooled license serverおよびHow to reallocate a license fileを参照してください。
  • オンプレミスADMでプールされたライセンスを使用している場合は、ADMサービス用のプールされたライセンスを取得し、ADCインスタンスにライセンスを割り当てる必要があります。詳細については、Configure Pooled Licensingを参照してください。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 version の場合、移行を完了するには次のコマンドを実行します。
    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からアクセスできます。
  • ADM 79.xxより前のビルドの場合、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」と入力します。