NetScaler Console

ネットスケーラー コンソール オンプレミスをシトリックス クラウドに移行する

Citrix Cloud には、NetScaler ADM 13.0 64.35 以降のバージョン を移行できます。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ファイルを取得します。

  1. citrix.cloud.com にアクセスして、ログインしてください。

  2. ホームアイコンをクリックし、IDおよびアクセス管理を選択します

  3. APIアクセスタブから、安全なクライアント名を入力し、クライアントの作成をクリックします。

  4. 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オンプレミスにインターネット接続があることを確認してください。

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

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

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

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

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

    CSVを追加

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

  4. 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グループ、ロール、およびポリシー

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

    • Appflow configuration per vserver from NetScaler instances.

    • SDWANデバイスごとのAppflow®構成。

    注:

    • 「管理と監視 (M&M)」機能は、他の機能 (2、3、または 4) を選択した場合でも、自動的に移行されます。

    • 一度に指定できる機能は1つだけです。

    • いずれかの機能の移行が完了した後、後で別の機能を移行したい場合、すでに移行された機能はリストに表示されません。たとえば、最初に「分析」機能の移行を完了した場合、次回移行スクリプトを実行するときには、「StyleBooks」、「Pooled Licensing」、および「すべて」のオプションのみが表示されます。

    • プールライセンスを移行すると、vserverを含むすべてのタイプが移行されます。

  5. 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

  6. NetScaler Console オンプレミス 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.pyconfig_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インスタンスバージョンを使用している場合、以下のメッセージが表示されます:

サポートされていないNetScalerバージョン

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

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

移行完了ステータス(/ja-jp/netscaler-application-delivery-management-software/media/migration-complete-status.png)

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

  • SSL証明書

  • Syslogメッセージ

  • バックアップ

  • エージェントクラスター

  • パフォーマンスレポート

  • 構成の監査

  • Emonスケジューラ

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

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

前提条件

If your NetScaler Console on-prem (before migrating to NetScaler Console service) is:

  • プールされたライセンスサーバーとして使用される場合、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にスクリプトをコピーすることができます。

  1. SSHクライアントを使用して、NetScaler Console on-premにログオンします。

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

  3. 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」と入力します。

      ロールバックの続行

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

      ロールバックが完了しました

  4. 82.xxビルドより前のネットスケーラー コンソールの場合:

    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 on-premに保存します。たとえば、/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」と入力します。

ネットスケーラー コンソール オンプレミスをシトリックス クラウドに移行する