NetScaler Console on-prem を Citrix Cloud に移行する

最終公開日 : Oct 02, 2026

NetScaler ADM 13.0 64.35 以降のバージョン を Citrix Cloud に移行できます。NetScaler ADM が 12.1 以前のバージョンの場合は、まず 13.0 64.35 以降のバージョン にアップグレードしてから Citrix Cloud に移行する必要があります。詳細については、アップグレードセクションを参照してください。

注:

NetScaler® ADM サービスは、NetScaler Console サービスに名称変更されました。製品のUIとドキュメントは現在、これらの変更を反映するために更新中です。この間、古い名前と新しい名前が混在して参照される場合があります。この移行期間中のご理解に感謝いたします。

Citrix Cloud™ を介した NetScaler Console サービスにより、以下が可能になります。

約2週間ごとに最新の機能更新を含む、より迅速なリリース。
アプリケーションセキュリティとボット、パフォーマンス、使用状況に関する機械学習ベースの分析。
ピーク期間と閑散期間の分析、アプリケーションセキュリティとボットに関する機械学習ベースの分析、アプリケーションCPU分析など、現在 NetScaler Console サービスでのみサポートされているその他のさまざまな機能。

移行を成功させるには、以下を行う必要があります。

Citrix Cloud にアクセスできるように、NetScaler Console on-prem でインターネット接続があることを確認する
NetScaler エージェントを構成する
Citrix Cloud からクライアントおよびシークレットCSVファイルを取得する
NetScaler Console のライセンスを検証する
スクリプトを使用して移行する

NetScaler Console on-prem から NetScaler Console サービスに移行した後、再度 NetScaler Console on-prem を継続したい場合は、ロールバックスクリプトを使用できます。詳細については、NetScaler Console on-prem へのロールバックを参照してください。

NetScalerエージェントを構成する

NetScalerインスタンスとNetScaler Consoleサービス間の通信を有効にするには、エージェントを構成する必要があります。NetScalerエージェントは、デフォルトで最新ビルドに自動的にアップグレードされます。エージェントのアップグレードに特定の時間を選択することもできます。詳細については、「エージェントアップグレード設定の構成」を参照してください。

既存のNetScaler Consoleオンプレミス（スタンドアロンまたはHAペア）にエージェントが構成されていない場合、NetScaler Consoleサービス用に少なくとも1つのエージェントを構成する必要があります。
既存のNetScaler Consoleオンプレミス（スタンドアロンまたはHAペア）がマルチサイト展開用にオンプレミスエージェントで構成されている場合、NetScaler Consoleサービス用に同数のエージェントを構成する必要があります。

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

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

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

citrix.cloud.comにログオンします
ホームアイコンをクリックし、IDおよびアクセス管理を選択します
APIアクセスタブから、安全なクライアント名を入力し、クライアントの作成をクリックします。
IDとシークレットが生成されます。ダウンロードをクリックし、CSVファイルをNetScaler Consoleオンプレミスに保存します。

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

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

NetScalerサービスにはライセンスを取得する必要があります。

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

注

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

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

NetScaler Console 82.xビルドを使用すると、機能を選択して移行できます。
NetScaler Console 76.x以降のビルドの場合、移行スクリプト (servicemigrationtool.py および config_collect_onprem.py) はビルドの一部として提供されており、cd /mps/scripts で入手できます。
NetScaler Console 76.xより前のビルドの場合、移行スクリプトをダウンロードし、NetScaler Consoleオンプレミスにスクリプトをコピーする必要があります。

注

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

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

注

NetScaler Console HAペアの場合、プライマリノードにログオンします。
shell と入力し、Enter を押して bash モードに切り替えます。
クライアントIDとシークレットのCSVファイルをコピーします。たとえば、ファイルを/varディレクトリにコピーします。

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

注

NetScaler Console HAペアの場合、プライマリノードにCSVファイルをコピーします。
NetScaler Consoleオンプレミス13.0 82.xxバージョンの場合、移行を完了するには次のコマンドを実行します。
1. cd /mps/scripts
2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler Console VM>
たとえば、python servicemigrationtool.py /var/secureclient.csv

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

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

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

管理および監視 (M&M) 機能には、以下が含まれます:
- NetScalerインスタンス、タグ、インスタンスグループ、プロファイル、カスタムアプリ、構成ジョブ、SNMP、syslog構成。
- サイト、IPブロック、ネットワークレポート、分析しきい値、通知設定、データプルーニング設定。
- 構成監査テンプレート、ポーリング間隔、イベントルールと設定。
- RBACグループ、ロール、およびポリシー
Analytics 機能には、以下が含まれます:
- NetScalerインスタンスからのvserverごとのAppflow構成。
- SDWANデバイスごとのAppflow®構成。
注:
- 管理および監視 (M&M) 機能は、他の機能 (2、3、または 4) を選択した場合でも自動的に移行されます。
- 一度に指定できる機能は1つだけです。
- いずれかの機能の移行が完了した後、後で他の機能を移行したい場合、既に移行された機能はリストに表示されません。たとえば、最初に Analytics 機能を移行した場合、次回移行スクリプトを実行するときには、StyleBooks、Pooled Licensing、および All オプションのみが表示されます。
- プールライセンスを移行すると、vserverを含むすべてのタイプが移行されます。
NetScaler Consoleオンプレミス 13.0 76.xxバージョン の場合、移行を完了するには次のコマンドを実行します:
1. cd /mps/scripts
2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises NetScaler Console VM>
例えば、python servicemigrationtool.py /var/secureclient.csv
NetScaler Console on-prem 13.0 76.xx バージョン以前の場合:
1. 以下の場所から移行スクリプトをダウンロードします: https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz
  
  ダウンロードしたファイルには、2つのバンドルスクリプト servicemigrationtool_27.py と config_collect_onprem_27.py が含まれています。
2. 2つのスクリプトをNetScaler Console on-premに保存します。例えば、/var ディレクトリに保存します。
3. 移行するには、以下のコマンドを実行します:
  1. cd /var
  2. servicemigrationtool_27.py <path of ClientID/Secret File in NetScaler Console on-prem VM>
    
    例えば、python servicemigrationtool_27.py /var/secureclient.csv

スクリプトを実行すると、前提条件がチェックされ、移行が続行されます。スクリプトはまずライセンスの利用可能性を確認します。オンプレミスライセンスよりもNetScaler Consoleサービスライセンスが少ない場合にのみ、以下のメッセージが表示されます。

Y を選択すると、VIPをランダムにライセンス付与して移行が続行されます。N を選択すると、スクリプトは移行を停止します。

プールされたライセンスサーバーに対してサポートされていないNetScalerインスタンスバージョンを使用している場合、以下のメッセージが表示されます:

Yを選択すると、ライセンスサーバーを変更して移行プロセスが続行されます。Nを選択すると、スクリプトは残りの移行を続行するかどうかを尋ねます。Nを選択すると、スクリプトは移行を停止します。

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

すべてのNetScalerインスタンスとそのそれぞれの構成がNetScaler Consoleサービスに正常に移行されると、移行は成功です。移行が成功すると、オンプレミスのNetScaler Consoleは次のインスタンスイベントの処理を停止します。

SSL証明書
Syslogメッセージ
バックアップ
エージェントクラスター
パフォーマンスレポート
構成監査
Emonスケジューラ

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

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

前提条件

NetScaler Consoleオンプレミス（NetScaler Consoleサービスへの移行前）が次の場合は、:

プールライセンスサーバーとして使用する場合、NetScaler Console on-premに必要なプールライセンスがあることを確認してください。
NetScalerエージェントで構成されている場合、エージェントが「UP」ステータスで利用可能であることを確認してください。

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

注

ロールバック後、Analytics、SNMP、プールライセンスにおける同じ構成（移行前）がNetScaler Console on-premで再び利用可能になります。移行後にこれらの構成に変更を加えた場合、これらの変更はNetScaler Console on-premには反映されません。

NetScaler Console 82.xx以降のビルドの場合、ロールバックスクリプトはビルドの一部として利用可能で、/mps/scriptsでアクセスできます。
NetScaler Console 79.xxより前のビルドの場合、82.xビルドにアップグレードしてロールバックスクリプトを使用するか、ロールバックスクリプトをダウンロードしてNetScaler Console on-premにスクリプトをコピーすることができます。

SSHクライアントを使用して、NetScaler Console on-premにログオンします。
「shell」と入力し、Enterキーを押してbashモードに切り替えます。
NetScaler Console 13.0 82.xxビルドの場合、ロールバックを完了するには次のコマンドを実行します。
1. cd /mps/scripts
2. python rollback_to_onprem.py <path of ClientID/Secret File in NetScaler Console on-prem VM> を実行します。
  
  例: python rollback_to_onprem.py /var/ secureclient.csv.csv
  
  ツールがロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには「Y」と入力します。
  
  ロールバックが完了すると、次のメッセージが表示されます。
  
  ロールバック完了(/en-us/netscaler-application-delivery-management-software/media/rollback-complete.png)
82.xxビルドより前のNetScaler Consoleの場合：
1. 次の場所からロールバックスクリプトをダウンロードします。
  
  https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz
2. NetScaler Console 79.xxおよび76.xxビルドの場合、スクリプトを/mps/scriptsに保存し、次のコマンドを実行してロールバックします。
  1. cd /mps/scripts
  2. python rollback_to_onprem.py < path of client/secret csv file in NetScaler Console on-prem>
    
    例：python rollback_to_onprem.py /var/ secureclient.csv
3. 76.xxビルドより前のNetScaler Consoleの場合、スクリプトをNetScaler Consoleオンプレミスに保存します。たとえば、/varの場所に保存し、次のコマンドを実行してロールバックします。
  1. cd /var
  2. python rollback_to_onprem_27.py < path of client/secret csv file in NetScaler Console on-prem>
    
    例：python rollback_to_onprem_27.py /var/secureclient.csv
  ツールはロールバック操作を開始し、続行するかどうかを尋ねるプロンプトが表示されます。続行するには「Y」と入力します。