製品ドキュメント
Application Delivery Management
14.1 - Current Release 13.1 13.0
PDFを表示

オンプレミス NetScaler ADM の Citrix Cloud™ への移行

December 12, 2025
寄稿者: 
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 サービス用に同数のエージェントを構成する必要があります。

エージェントの構成の詳細については、「はじめに」セクションを参照してください。

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

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

  1. citrix.cloud.com にログオンします。
  2. ホームアイコンをクリックし、[ID およびアクセス管理] を選択します。
  3. [API アクセス] タブから、安全なクライアント名を入力し、[クライアントの作成] をクリックします。

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

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

ADM サービスライセンスの検証

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

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

    注

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

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

  • オンプレミス ADM でプールされたライセンスを使用している場合は、ADM サービス用のプールされたライセンスを取得し、ADC インスタンスにライセンスを割り当てる必要があります。詳細については、「プールされたライセンスの構成」を参照してください。次のサポートされている ADC バージョンでは、ADM からのライセンス割り当てを変更できます。

    • 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) はビルドの一部として /mps/scripts で利用できます。

  • ADM 76.x 以前のビルドの場合、移行スクリプトをダウンロードし、オンプレミス ADM にコピーする必要があります。

    注

    移行中は、オンプレミス ADM にインターネット接続があることを確認してください。

  1. SSH クライアントを使用して、オンプレミス ADM にログオンします。

    注

    ADM HA ペアの場合は、プライマリノードにログオンします。

  2. shell と入力し、Enter キーを押して bash モードに切り替えます。

  3. クライアント ID とシークレット CSV ファイルをコピーします。たとえば、ファイルを /var ディレクトリにコピーします。

    CSV ファイルをコピーした後、CSV ファイルが存在するかどうかを検証できます。

    CSV の追加

    注

    ADM HA ペアの場合は、プライマリノードに CSV ファイルをコピーします。

  4. ADM 13.0 82.xx バージョンの場合、移行を完了するには次のコマンドを実行します。

    1. cd /mps/scripts

    2. python servicemigrationtool.py <オンプレミス NetScaler ADM VM 内の ClientID/Secret ファイルのパス>

    たとえば、python servicemigrationtool.py /var/secureclient.csv

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

    機能ごとの移行オプション

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

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

    移行完了

    管理および監視 (M&M) 機能には以下が含まれます。

    • ADC インスタンス、タグ、インスタンスグループ、プロファイル、カスタムアプリ、構成ジョブ、SNMP、syslog 構成
    • サイト、IP ブロック、ネットワークレポート、分析しきい値、通知設定、データプルーニング設定
    • 構成監査テンプレート、ポーリング間隔、イベントルールと設定
    • RBAC グループ、ロール、ポリシー

    分析機能には以下が含まれます。

    • ADC インスタンスからの vserver ごとの Appflow® 構成
    • SDWAN デバイスごとの Appflow 構成

    注:

    • 他の機能 (2、3、または 4) を選択した場合でも、管理および監視 (M&M) 機能は自動的に移行されます。
    • 一度に指定できる機能は 1 つだけです。
    • いずれかの機能の移行が完了した後、後で他の機能を移行したい場合、すでに移行された機能はリストに表示されません。たとえば、最初に分析機能の移行を完了した場合、次に移行スクリプトを実行すると、StyleBooks、プールされたライセンス、およびすべてのオプションのみが表示されます。
    • プールされたライセンスを移行すると、vserver を含むすべてのタイプが移行されます。

  5. ADM 13.0 76.xx バージョンの場合、移行を完了するには次のコマンドを実行します。

    1. cd /mps/scripts

    2. python servicemigrationtool.py <オンプレミス NetScaler ADM VM 内の ClientID/Secret ファイルのパス>

    たとえば、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 <オンプレミス ADM VM 内の ClientID/Secret ファイルのパス>

        たとえば、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」ステータスで利用可能であることを確認します。

ロールバックスクリプトの使用

注

ロールバック後、分析、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 <ADM オンプレミス VM 内の ClientID/Secret ファイルのパス>

      たとえば、python rollback_to_onprem.py /var/ secureclient.csv.csv

      ツールはロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには Y と入力します。

      ロールバックの続行

      ロールバックが完了すると、次のメッセージが表示されます。

      ロールバック完了

  4. ADM 82.xx ビルドより前のバージョン:

    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 <ADM オンプレミス内のクライアント/シークレット CSV ファイルのパス>

        たとえば、python rollback_to_onprem.py /var/ secureclient.csv

    3. ADM 76.xx ビルドより前のバージョンでは、スクリプトをオンプレミス ADM に保存します。たとえば、/var の場所に保存し、ロールバックするには次のコマンドを実行します。

      1. cd /var

      2. python rollback_to_onprem_27.py <ADM オンプレミス内のクライアント/シークレット CSV ファイルのパス>

        たとえば、python rollback_to_onprem_27.py /var/secureclient.csv

      ツールはロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには Y と入力します。

オンプレミス NetScaler ADM の Citrix Cloud™ への移行
December 12, 2025
寄稿者: 
C
December 12, 2025
寄稿者: 
C

この記事の概要

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