アップグレード

最終公開日 : Sep 25, 2026
NetScaler ADMの各リリースでは、機能が強化された新しい機能や更新された機能が提供されます。Citrixでは、新しい機能やバグ修正を利用するために、NetScaler ADMを最新リリースにアップグレードすることをお勧めします。機能強化、既知の問題、バグ修正の包括的なリストは、すべてのリリース発表に付随するリリースノートに含まれています。アップグレードを開始する前に、ライセンスフレームワークと使用できるライセンスの種類を理解することも重要です。NetScaler ADMのライセンス情報については、ライセンスを参照してください。
アップグレードパスの情報は、Citrix Upgrade Guideでも入手できます。

アップグレードする前に

NetScaler ADMダウンロードページからアップグレードパッケージをダウンロードし、この記事の指示に従ってシステムを最新の13.1ビルドにアップグレードしてください。アップグレードプロセスが開始されると、ADMは再起動し、既存の接続は終了され、アップグレードが完了すると再接続されます。既存の構成は保持されますが、アップグレードが完了するまでNetScaler ADMはデータを処理しません。
重要
NetScaler ADMのバージョンとビルドは、NetScalerのバージョンとビルドと同等かそれ以上である必要があります。たとえば、NetScaler ADM 12.1 Build 50.39をインストールしている場合は、NetScaler 12.1 Build 50.28/50.31以前がインストールされていることを確認してください。
13.1へのアップグレードに関する注意点:
  • バージョン11.1またはバージョン12.0 56.x以前のビルドからアップグレードする場合は、次の手順を実行します。
    1. 既存のバージョンから12.0ビルド57.24にアップグレードします。
    2. バージョン12.1の最新ビルドにアップグレードします。
    3. バージョン13.1にアップグレードします。
  • 12.0ビルド57.24以降からアップグレードする場合は、まず12.1にアップグレードしてから13.1にアップグレードします。
  • 12.1からアップグレードする場合は、直接13.1にアップグレードできます。
  • 13.0 64.xxより前のバージョンからアップグレードする場合は、より良いユーザーエクスペリエンスのために、まず13.0 64.xxにアップグレードしてから13.1にアップグレードしてください。

13.1-xx.xx 以降へのアップグレードに関する重要な注意事項

ADM ソフトウェアをバージョン 13.1-xx.xx にアップグレードすると、ADM データベースも移行されます。このデータ移行は、ADM が PostgreSQL バージョン 10.11 を使用するようになったために発生します。
注
ADM ソフトウェアのダウングレードはサポートされていません。ダウングレードを試みないでください。
推奨される注意事項:
  • 13.1-xx.xx 以降にアップグレードする場合は、NetScaler ADM サーバーのスナップショットを取得してください。
  • アップグレードする前に、NetScaler® ADM サーバーをバックアップしてください。
  • アップグレード後、NetScaler ADM サーバーと管理対象インスタンス間の接続を再確立する必要がある場合があります。続行すると接続が失敗する可能性があることを確認プロンプトが警告します。
  • 13.1.9.x から 13.1.30.x までのいずれかのバージョンにアップグレードすると、NetScaler ADM は既存の StyleBooks ConfigPacks を以前のバージョンにロールバックします。
    この問題を回避するには、13.1.33.50 ビルドにアップグレードしてください。
  • 高可用性セットアップの NetScaler ADM サーバーの場合、アップグレード中はどちらのノードでも構成変更を行わないでください。
    警告
    アップグレードプロセスが正常に完了するまでブラウザを更新しないでください。アップグレードが完了するまでのおおよその時間は GUI で確認してください。
  • アップグレード後、高可用性ペアのアクティブノードが変更される可能性があります。

単一の NetScaler ADM サーバーを 13.1-12.x にアップグレードする

  1. 管理者資格情報を使用してNetScaler ADMにログオンします。
  2. Settings > Administration に移動します。System Maintenance の下にある Upgrade NetScaler ADM をクリックします。
    NetScaler ADMのアップグレード(/en-us/netscaler-application-delivery-management-software/media/adm-upgrade-to-13-1-12.png)
  3. Upgrade NetScaler ADM ページで、アップグレード後にイメージファイルを削除するには、Clean software image on successful upgrade チェックボックスをオンにします。このオプションを選択すると、アップグレード時にNetScaler ADMイメージファイルが自動的に削除されます。
    注
    このオプションはデフォルトで選択されています。アップグレードプロセスを開始する前にこのチェックボックスをオンにしなかった場合、イメージを手動で削除する必要があります。
    アップグレードファイルの選択(/en-us/netscaler-application-delivery-management-software/media/upgrade-netscaler-mas-select.png)
  4. その後、Local (ローカルマシン) または Appliance のいずれかを選択して、新しいイメージファイルをアップロードできます。ビルドファイルはNetScaler ADM仮想アプライアンスに存在する必要があります。
  5. OK をクリックします。
  6. Upgrade ADM ページには、ファイル名、選択されたバージョン、完了までの推定時間などの詳細が表示されます。Upgrade をクリックします。
    アップグレード(/en-us/netscaler-application-delivery-management-software/media/upgrade-12-x-message.png)
    アップグレードプロセスが開始されます。
構成が移行された後、ADM GUIにログオンできます。ログオンすると、履歴データがバックグラウンドで移行を開始し、その間もADMでの作業を続行できます。
13-0-67-x 初回ログオン(/en-us/netscaler-application-delivery-management-software/media/first-logon-13-0-67-x.png)
履歴データ移行中、一部の古いデータが利用できない場合があります。データベースの移行にかかる時間は、データのサイズとテーブルの数によって異なります。
ADM GUIを使用してデータベース移行を監視できます。「View upgrade progress」をクリックすると、「Database Migration Status」が表示されます。
13-0-67-x の初回ログオン
アップグレードが完了すると、デフォルトの無料ライセンスが2つに減らされるというメッセージが表示されます。詳細については、「View Details」をクリックしてください。
アップグレード後

単一のNetScaler ADMサーバーを13.1-4.xまたは13.1-9.xにアップグレードする

  1. 管理者資格情報を使用してNetScaler ADMにログオンします。
  2. System \> System Administration に移動します。「System Administration」の見出しの下にある「Upgrade NetScaler ADM」をクリックします。
    NetScaler ADMのアップグレード
  3. Upgrade NetScaler ADM ページで、「Clean software image on successful upgrade」チェックボックスを選択して、アップグレード後にイメージファイルを削除します。このオプションを選択すると、アップグレード時にNetScaler ADMイメージファイルが自動的に削除されます。
    注
    このオプションはデフォルトで選択されています。アップグレードプロセスを開始する前にこのチェックボックスを選択しなかった場合、イメージを手動で削除する必要があります。
    アップグレードファイルの選択
  4. その後、「Local」（ローカルマシン）または「Appliance」のいずれかを選択して、新しいイメージファイルをアップロードできます。ビルドファイルはNetScaler ADM仮想アプライアンスに存在する必要があります。
    イメージのアップロード
  5. OK をクリックします。
    確認ダイアログボックスが表示されます。「はい」をクリックします。
    アップグレードプロセスが開始されます。
設定が移行された後、ADM GUIにログオンできます。ログオンすると、履歴データがバックグラウンドで移行を開始し、その間もADMでの作業を続行できます。
13-0-67-x 初回ログオン
履歴データ移行中、一部の古いデータが利用できない場合があります。データベースの移行にかかる時間は、データのサイズとテーブルの数によって異なります。
ADM GUIを使用してデータベースの移行を監視できます。「アップグレードの進行状況を表示」をクリックすると、「データベース移行ステータス」が表示されます。
13-0-67-x 初回ログオン

データベース移行の問題のトラブルシューティング

13.1-xx.xx以降へのアップグレードプロセス中に、Web Insightの履歴データの移行が停止しているように見えることがあります。そのような場合は、データ移行の詳細を確認するには、次の手順を実行します。
ADMシェルプロンプトにログオンし、次のコマンドを実行して進行状況の詳細を確認します。

    cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
以下に、出力例を示します
    bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
    Tue Oct  6 07:41:55 GMT 2020
    157 out of 127346 done in 54 seconds
    File
     /var/mps/db_upgrade/hist_table_mig_data/Web_Insight/af_app_client_server_resp_second_l3p_d7_dump
    bash-3.2#
この例では、af_app_client_server_resp_second_l3p_d7 はアップグレード中のエントリです。そして、127,346個のエントリのうち157個が54秒で移行されました。

12.1リリースから13.1リリースへの高可用性ペアのアップグレード

高可用性モードのNetScaler ADMサーバーの場合、アクティブノードまたはフローティングIPアドレスのいずれかにアクセスしてアップグレードできます。いずれかのサーバーでアップグレードプロセスを開始すると、両方のNetScaler ADMサーバーが自動的に最新ビルドにアップグレードされます。

NetScaler ADMディザスタリカバリ展開のアップグレード

NetScaler ADMの災害復旧展開のアップグレードは、2段階のプロセスです。
  • プライマリサイトで高可用性モードに構成されているNetScaler ADMノードをアップグレードします。その後、災害復旧ノードをアップグレードする必要があります。
  • 災害復旧ノードをアップグレードする前に、高可用性で展開されているNetScaler ADMサーバーをアップグレードしていることを確認してください。

NetScaler ADM災害復旧ノードのアップグレード

  1. NetScalerサイトからNetScaler ADMアップグレードイメージファイルをダウンロードします。
  2. nsrecover資格情報を使用して、このファイルを災害復旧ノードにアップロードします。
  3. nsrecover資格情報を使用して、災害復旧ノードにログオンします。
  4. イメージファイルを配置したフォルダーに移動し、ファイルを解凍します。
  5. 次のスクリプトを実行します。
    ./インストールマス
    DRエージェント2のアップグレード

マルチサイト展開用のオンプレミスエージェントのアップグレード

NetScalerエージェント展開のアップグレードは3段階のプロセスです。 オンプレミスエージェントをアップグレードする前に、次のタスクを完了していることを確認してください。
  1. 高可用性で展開されているNetScaler ADMサーバーをアップグレードします。
  2. NetScaler ADM災害復旧ノードをアップグレードします。
    詳細については、NetScaler ADM 災害復旧展開のアップグレードを参照してください。

オンプレミスエージェントのアップグレード

  1. NetScalerサイトからNetScalerエージェントアップグレードイメージファイルをダウンロードします。
  2. nsrecover資格情報を使用して、このファイルをエージェントノードにアップロードします。
  3. 正しいエージェントアップグレードイメージをダウンロードしたことを確認してください。
  4. nsrecover資格情報を使用してオンプレミスエージェントにログオンします。
  5. イメージファイルを配置したフォルダに移動し、ファイルを解凍します。
    DRエージェント3のアップグレード
  6. 次のスクリプトを実行します。
    ./installmasagent
    DRエージェント4のアップグレード

NetScaler ADMサーバーにディスクを追加する

NetScaler ADMのストレージ要件がデフォルトのディスク容量（120 GB）を超える場合は、追加のディスクを接続できます。シングルサーバー展開と高可用性展開の両方で、ディスクを追加できます。
NetScaler ADMをリリースバージョン12.1～13.1Œからアップグレードする場合、以前のバージョンで追加ディスクに作成したパーティションは変更されません。パーティションが削除されたり、サイズ変更されたりすることはありません。
アップグレードされたビルドでも、ディスクを追加する手順は同じです。NetScaler ADMの新しいディスクパーティションツールを使用して、新しく追加されたディスクにパーティションを作成できるようになりました。このツールを使用して、既存のディスクのパーティションのサイズを変更することもできます。ディスクの追加方法と新しいディスクパーティションツールの使用方法の詳細については、NetScaler ADMにディスクを追加する方法を参照してください。

StyleBookを使用してOpenStackでNetScalerインスタンスをプロビジョニングする

NetScaler ADM 12.1ビルド49.23以降、OpenStackオーケストレーションワークフローのアーキテクチャが更新されました。このワークフローでは、NetScalerインスタンスを構成するためにNetScaler ADM StyleBookを使用するようになりました。バージョン12.0または12.1ビルド48.18からNetScaler ADM 13.1にアップグレードする場合、次の移行スクリプトを実行する必要があります。
/mps/scripts/migration_scripts/migrate_configurations.py
os-cs-lb-mon StyleBookおよび移行スクリプトの詳細については、Provisioning of NetScaler VPX instance on OpenStack using StyleBookを参照してください。