製品ドキュメント
NetScaler Console
14.1 - 最新リリース 13.1
PDFを表示

オンプレミスに展開されている NetScaler ADM を Citrix Cloud™ へ移行する

July 30, 2026
寄稿者: 
C C

オンプレミスの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」(/ja-jp/citrix-application-delivery-management-service/getting-started.html)セクションを参照してください。

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

エージェントを構成した後、Citrix CloudページからクライアントおよびシークレットCSVファイルを取得します。

  1. citrix.cloud.comにアクセスしてログインします

  2. ホームアイコンをクリックし、Identity and Access Managementを選択します

  3. API Accessタブで、安全なクライアント名を入力し、Create Clientをクリックします。

  4. IDとシークレットが生成されます。Downloadをクリックし、CSVファイルをオンプレミスADMに保存します。

    たとえば、CSVファイルを/varディレクトリに保存します。

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

ADMサービス用のライセンスを取得する必要があります。

  • ADMサービスのVIPライセンスは、オンプレミスのVIPライセンス以上である必要があります。

    注

    VIPライセンスが少ない場合、仮想サーバーがランダムに選択され、ADMサービスのVIPレベル構成が失敗します。

  • ADMオンプレミス展開をライセンスサーバーとして使用している場合は、移行前にライセンスをADMサービスに再割り当てしてください。詳細については、ADMサーバーをプールライセンスサーバーとしてのみ構成するおよびライセンスファイルを再割り当てする方法を参照してください。

  • オンプレミスADMでプールされたライセンスを使用している場合は、ADMサービス用のプールされたライセンスを取得し、ADCインスタンスにライセンスを割り当てる必要があります。詳細については、(/ja-jp/netscaler-application-delivery-management-software/13-1/license-server/adc-pooled-capacity/configuring-adc-pooled-capacity)を参照してください。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を追加(/ja-jp/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

    移行スクリプトを実行すると、ツールは次のオプションを表示します。

    機能ごとの移行オプション(/ja-jp/netscaler-application-delivery-management-software/media/migrate-options.png)

    指定した選択に基づいて、その機能のみがADMサービスに移行されます。

    例では、オプション1が選択されています。ツールは管理および監視 (M&M) の移行を完了し、次のメッセージを表示します。

    移行完了(/ja-jp/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. 13.0 76.xxバージョンより前のADMの場合:

    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 を選択すると、スクリプトは移行を停止します。

オンプレミスの構成に応じて、移行が完了するまでにかかるおおよその時間は数分から数時間です。移行が完了すると、次のメッセージが表示されます:

移行完了ステータス

すべての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. 79.xxおよび76.xxビルドのADMの場合、スクリプトを/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」と入力します。

オンプレミスに展開されている NetScaler ADM を Citrix Cloud™ へ移行する
July 30, 2026
寄稿者: 
C C
July 30, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.