ジョブを使用してNetScalerインスタンスをアップグレードする

最終公開日 : Sep 25, 2026
NetScaler Consoleでは、1つまたは複数のNetScalerインスタンスをアップグレードできます。インスタンスをアップグレードする前に、ライセンスフレームワークとライセンスの種類を理解しておく必要があります。
注： クラシックポリシーを持つインスタンスをアップグレードする場合は、NSPEPIツールを使用して、インスタンスをアップグレードする前にクラシックポリシーをアドバンストポリシーに変換することをお勧めします。これは、NSPEPIツールでサポートされている機能に適用されます。詳細については、「クラシックポリシーを使用した構成のアップグレードに関する考慮事項」を参照してください。
Related information

前提条件

NetScaler Consoleは、アップグレードするインスタンスに対して以下の事前検証チェックを実行します。
  1. ディスク容量の確認 - インスタンスのアップグレードに十分なディスク容量を確保するために、ディスクスペースをクリーンアップします。問題がある場合はディスクの問題を解決します。
  2. ディスクハードウェアの問題の確認 - 問題がある場合はハードウェアの問題を解決します。
  3. カスタマイズの確認 - カスタマイズをバックアップし、インスタンスから削除します。インスタンスのアップグレード後に、バックアップしたカスタマイズを再適用できます。
  4. ポリシーの問題 - NetScalerは、13.1バージョン以降、クラシックポリシーをサポートしていません。このバージョンにインスタンスをアップグレードする前に、クラシックポリシーをアドバンストポリシーに移行してください。
    詳細については、「クラシックポリシーとアドバンストポリシー」を参照してください。
  5. STAYPRIMARYおよびSTAYSECONDARYノードの確認 - NetScaler HAの場合、STAYPRIMARYおよびSTAYSECONDARY状態のノードのアップグレードはブロックされます。これらのノードは事前検証チェックで識別され、アップグレードがブロックされたインスタンスの下にリストされます。
アップグレード前の検証レポート

カスタマイズされたNetScaler構成のアップグレードに関する考慮事項

アップグレードされたNetScalerアプライアンスには、アップグレードの変更とカスタマイズの両方が適用されることが重要です。したがって、/etcディレクトリにカスタマイズされた構成ファイルがある場合は、NetScalerアプライアンスのアップグレードを続行する前に、「カスタマイズされた構成ファイルのアップグレードに関する考慮事項」を参照してください。以下に、実行する必要がある大まかな手順を示します。
  1. NetScalerでのアップグレード前の手順
  2. ADMを使用してNetScalerをアップグレードします。アップグレードするには、ページ冒頭の指示に従ってください。
  3. NetScalerでのアップグレード後の手順
アップグレード前とアップグレード後の両方の手順は、各NetScalerインスタンスで実行する必要があります。ただし、ステップ2では、ADMを使用してNetScalerをアップグレードするために、脆弱なNetScalerインスタンスをすべて選択して同時にアップグレードできます。

NetScaler高可用性ペア

NetScaler高可用性ペアをアップグレードする際は、次の点に注意してください。
  • セカンダリノードが最初にアップグレードされます。
  • 両方のノードが正常にアップグレードされるまで、ノードの同期と伝播は無効になります。
  • 高可用性ペアのアップグレードが正常に完了すると、実行履歴にエラーメッセージが表示されます。このメッセージは、高可用性ペア内のノードが異なるビルドまたはバージョンである場合に表示されます。これは、プライマリノードとセカンダリノード間の同期が無効になっていることを示します。
NetScaler高可用性ペアは、次の2つの段階でアップグレードできます。
  1. アップグレードジョブを作成し、いずれかのノードで直ちに実行するか、後でスケジュールします。
  2. 残りのノードでアップグレードジョブを後で実行するようにスケジュールします。このジョブは、最初のノードのアップグレード後にスケジュールするようにしてください。

NetScalerクラスター

NetScalerクラスターをアップグレードする際、アップグレード前の検証段階では、NetScaler Consoleは指定されたインスタンスのみを検証します。したがって、クラスターノードで以下の問題を確認し、解決してください。
  • カスタマイズ
  • ディスク使用量
  • ハードウェアの問題

NetScalerアップグレードジョブの作成

NetScalerアップグレードジョブを作成するには、次の手順を実行します。
  1. Infrastructure > Upgrade Jobs に移動します。
    メンテナンスジョブの作成(/en-us/netscaler-console-service/media/upgrade-1.png)
  2. Create Maintenance Jobs で、Upgrade NetScaler (Standalone/High-Availability/Cluster) を選択し、Proceed をクリックします。
    アップグレードメンテナンスジョブの選択(/en-us/netscaler-console-service/media/upgrade-2.png)
    注:
    オートスケールグループをアップグレードするには、オートスケールグループのアップグレードを参照してください。
  3. Select Instances タブで、,
    1. Job Name に任意の名前を指定します。
    2. アップグレードするNetScalerインスタンスを追加するには、Add Instances をクリックします。
      • NetScaler高可用性ペアをアップグレードするには、高可用性ペアのIPアドレスを選択します（「S」と「P」の上付き文字で示されます）。
      • クラスターをアップグレードするには、クラスターIPアドレスを選択します（「C」の上付き文字で示されます）。
      アップグレードメンテナンスジョブにインスタンスを追加(/en-us/netscaler-console-service/media/upgrade-add-instances.png)
    3. OKをクリックします。
  4. イメージの選択タブで、イメージライブラリ、ローカル、またはアプライアンスからNetScalerイメージを選択します。
    • イメージライブラリから選択: リストからNetScalerイメージを選択します。このオプションには、NetScalerダウンロードWebサイトで利用可能なすべてのNetScalerイメージが表示されます。
      NetScalerイメージ(/en-us/netscaler-console-service/media/adc-images.png)
      NetScalerソフトウェアイメージには、星アイコンで推奨ビルドが表示されます。また、ブックマークアイコンで最もダウンロードされたビルドが表示されます。
    • ローカルまたはアプライアンスから選択: ローカルコンピューターまたはNetScalerアプライアンスからイメージをアップロードできます。NetScalerアプライアンスを選択すると、NetScaler Console GUIに/var/mps/ns_imagesにあるインスタンスファイルが表示されます。NetScaler Console GUIからイメージを選択します。
    • 選択したイメージがすでに利用可能な場合は、NetScalerへのイメージのアップロードをスキップする - このオプションは、選択したイメージがNetScalerで利用可能かどうかを確認します。アップグレードジョブは新しいイメージのアップロードをスキップし、NetScalerで利用可能なイメージを使用します。
    • アップグレード成功時にNetScalerからソフトウェアイメージをクリーンアップする - このオプションは、インスタンスのアップグレード後、NetScalerインスタンスにアップロードされたイメージをクリアします。
    次へをクリックして、選択したインスタンスのアップグレード前検証を開始します。
    注:
    • ダウンロードされたNetScalerイメージはエージェントに保存され、/var/mps/adcimagesに存在します。これらのキャッシュされたイメージは複数のNetScalerアップグレードに使用できるため、アップグレードのたびにイメージをダウンロードする必要がなくなります。
    • NetScaler Consoleは、イメージの最終変更時間に基づいて、キャッシュされたNetScalerイメージを3日ごとにクリアします。一度にエージェントにキャッシュされるのは、最新の2つのイメージファイルのみです。
  5. 「アップグレード前検証」タブには、次のセクションが表示されます。
    • アップグレード準備完了インスタンス。これらのインスタンスのアップグレードを続行できます。
    • アップグレードがブロックされたインスタンス。これらのNetScalerインスタンスは、アップグレード前の検証エラーのため、アップグレードがブロックされています。
      エラーを確認して修正し、アップグレード準備完了に移動をクリックしてアップグレードできます。インスタンスのディスク容量が不足している場合は、ディスク容量を確認してクリーンアップできます。「NetScalerディスク容量のクリーンアップ」を参照してください。
    アップグレード前検証レポート
    • ポリシーチェック: NetScaler Consoleがサポートされていないクラシックポリシーを検出した場合、アップグレードジョブを作成するためにそれらのポリシーを削除できます。
    重要:
    クラスターIPアドレスを指定した場合、NetScaler Consoleは指定されたインスタンスに対してのみアップグレード前検証を実行し、他のクラスターノードに対しては実行しません。
    アップグレード中にプライマリノードとセカンダリノード間の不一致を表示するには、高可用性ノードを選択し、詳細をクリックします。
    アップグレード前の詳細表示アップグレード前の構成差分レポート
    • HAのプライマリノードで見つかった構成の不一致 - NetScaler®高可用性ペアのセカンダリノードで見つかったが、プライマリノードにないすべての構成を表示します。
    • HAのセカンダリノードで見つかった構成の不一致 - NetScaler高可用性ペアのプライマリノードで見つかったが、セカンダリノードにないすべての構成を表示します。
    注:
    構成の不一致セクションに表示される可能性のある以下の不一致は無視できます。
    • IPアドレスなどのデバイス固有の構成。
    • 暗号化されたパスワードまたは証明書。パスワードが同じであっても、ノード間で異なる場合があります。
    不一致を確認し、関連性がない場合は無視することを選択できます。
  6. 検証スクリプトで、インスタンスのアップグレード前後に実行するスクリプトを指定します。次のいずれかを実行できます。
    • デフォルトの検証スクリプト - このオプションを選択すると、事前定義された検証スクリプトが実行されます。これらのスクリプトは、アップグレードジョブの前後両方で実行され、検証スクリプトの差分レポートが生成されます。
      注:
      これらの事前定義されたコマンドセットを変更または編集することはできません。
    • カスタム検証スクリプト - このオプションを選択すると、独自の検証スクリプトが実行されます。スクリプトをアップグレードの前または後に実行するかどうかを指定できます。差分レポートは、アップグレードの前後で同じスクリプトが選択されている場合にのみ生成されます。
    検証スクリプト(/en-us/netscaler-console-service/media/upgrade-validation-script.png)
    各構成のコマンドセットを知るには、詳細表示をクリックします。 詳細については、「カスタムスクリプトの使用」を参照してください。
  7. タスクのスケジュールで、次のいずれかのオプションを選択します。
    • 今すぐアップグレード: アップグレードジョブはすぐに実行されます。
    • 後でスケジュール: このオプションを選択すると、このアップグレードジョブを後で実行できます。インスタンスをアップグレードする実行日と開始時刻を指定します。
    NetScalerの高可用性ペアを2段階でアップグレードする場合は、高可用性ノードの2段階アップグレードを実行を選択します。
    高可用性ペア内の別のインスタンスをアップグレードする実行日と開始時刻を指定します。
    「NetScaler高可用性アップグレードの2段階」(/en-us/netscaler-console-service/media/upgrade-two-stage-on-adc-ha.png)
    詳細については、NetScaler高可用性ペアを参照してください。
  8. 「ジョブの作成」で、次の詳細を指定します。
    アップグレードジョブをスケジュールする場合、インスタンスにイメージをアップロードするタイミングを指定できます。
    • 「今すぐアップロード」：このオプションを選択すると、イメージがすぐにアップロードされます。ただし、アップグレードジョブはスケジュールされた時間に実行されます。
    • 「実行時にアップロード」：このオプションを選択すると、アップグレードジョブの実行時にイメージがアップロードされます。
    高可用性ペアの場合、イメージをアップロードするノードを指定できます。
    • 「プライマリノードとセカンダリノードの両方にアップロード」：ビルドイメージファイルをプライマリノードとセカンダリノードの両方にアップロードします。
    • 「セカンダリノードのみにアップロード」：ビルドイメージファイルをセカンダリノードのみにアップロードします。セカンダリノードがアップグレードされると、フェイルオーバーが発生し、ビルドイメージファイルは、以前プライマリノードであった新しいセカンダリノードにアップロードされます。
    「NetScaler高可用性ノードへのアップグレード」(/en-us/netscaler-console-service/media/adc-upgrade-options.png)
    高可用性ペアで利用可能なスケジューリングシナリオの詳細については、NetScaler高可用性ペアのアップグレードジョブのスケジュールを参照してください。
    その他のアップグレードオプションの詳細については、NetScalerアップグレードオプションを参照してください。
  9. 「ジョブの作成」をクリックします。
アップグレードジョブは、「インフラストラクチャ > アップグレードジョブ」に表示されます。既存のジョブを編集する場合、必要なフィールドがすでに記入されていれば、任意のタブに切り替えることができます。たとえば、「構成の選択」タブにいる場合、「ジョブプレビュー」タブに切り替えることができます。

スケジュールされたアップグレードジョブの一時停止または再開

スケジュールされたアップグレードジョブを一時停止することもできます。
この機能を使用するには、Infrastructure > Upgrade Jobs に移動し、既存のスケジュールされたアップグレードジョブを選択して、Stop をクリックしてジョブを一時停止します。スケジュールされたアップグレードジョブを再開するには、Resume をクリックします。
スケジュールされたジョブを停止または再開する(/en-us/netscaler-console-service/media/upgrade-job-pause-resume.png)
注:
アップグレードジョブを再開することを決定した後、スケジュールされた時間が過ぎていた場合、アップグレードジョブを再度作成する必要があります。

失敗したアップグレードジョブを再試行する

  1. Infrastructure > Upgrade Jobs で、失敗したアップグレードジョブを選択し、Retry をクリックします。または、Select Action > Retry Upgrade Job に移動して、失敗したジョブを再試行することもできます。
    失敗したジョブを再試行する(/en-us/netscaler-console-service/media/retry-failed-job-main-page.png)
  2. Select Instance で、次の詳細を指定します。
    • ジョブ名 - アップグレードの名前を入力します。
    • リストからアップグレードするNetScalerインスタンスを選択します。インスタンスを削除するには、Remove をクリックします。
    Next をクリックして検証プロセスを開始します。
    失敗したジョブを再試行する(/en-us/netscaler-console-service/media/retry-job-select-instance.png)
  3. アップグレード前検証タブには、次のセクションが表示されます。
    • アップグレード準備完了インスタンス。これらのインスタンスのアップグレードを続行できます。
    • アップグレードがブロックされたインスタンス。これらのNetScalerインスタンスは、アップグレード前の検証エラーのため、アップグレードがブロックされています。
      エラーを確認し、修正してから、アップグレード準備完了に移動をクリックしてアップグレードできます。インスタンスでディスク容量不足に直面した場合は、ディスク容量を確認してクリーンアップできます。参照: NetScalerディスク容量のクリーンアップ。
    • ポリシーチェック: NetScaler Consoleがサポートされていないクラシックポリシーを検出した場合、アップグレードジョブを作成するためにそれらのポリシーを削除できます。
    失敗したジョブを再試行
    次へをクリックします。
  4. タスクのスケジュールで、次のいずれかのオプションを選択します。
    • 今すぐアップグレード: アップグレードジョブはすぐに実行されます。
    • 後でスケジュール: このオプションを選択すると、このアップグレードジョブを後で実行できます。インスタンスをアップグレードする実行日と開始時刻を指定します。
    失敗したジョブを再試行
    再試行をクリックします。

NetScalerディスク容量のクリーンアップ

NetScalerインスタンスのアップグレード中にディスク容量不足の問題に直面した場合は、NetScaler Console GUIからディスク容量をクリーンアップしてください。
  1. アップグレード前検証タブのアップグレードがブロックされたインスタンスセクションには、ディスク容量不足のためにアップグレードに失敗したインスタンスが表示されます。ディスク容量の問題があるインスタンスを選択します。
  2. ディスク容量の確認をクリックします。
    ディスク容量の詳細ペインが表示されます。このペインには、インスタンス、使用済みメモリ、および利用可能なメモリが表示されます。
    「ディスク領域の詳細」(/en-us/netscaler-console-service/media/upgrade-instance-disk-cleanup.png)
  3. ディスク領域の詳細ペインで、クリーンアップが必要なインスタンスを選択し、次のいずれかを実行します。
    1. ディスククリーンアップ - 必要なフォルダーまたはディレクトリに移動し、それらを削除してディスク領域を解放します。
    2. クイッククリーンアップ - 複数のフォルダーを削除して、ディスク領域をすばやくクリーンアップします。表示される確認ペインで、削除するフォルダーを選択し、はいをクリックします。
      「クイッククリーンアップ」(/en-us/netscaler-console-service/media/upgrade-quick-cleanup-confirm.png)
    3. ディスク領域をクリーンアップした後、インスタンスをアップグレードするのに十分なディスク領域が利用可能になったかどうかを確認できます。アップグレードがブロックされているインスタンスセクションで、再検証をクリックします。
      次の例では、ディスク領域が利用可能です。これで、アップグレード準備完了に移動をクリックしてインスタンスをアップグレードするか、次へをクリックして次のステップに進むことができます。
      「クリーンアップの検証」(/en-us/netscaler-console-service/media/upgrade-cleanup-revalidate.png)

カスタムスクリプトを使用する

NetScalerアップグレードジョブの作成中にカスタムスクリプトを指定できます。カスタムスクリプトは、NetScalerインスタンスのアップグレード前後の変更を確認するために使用されます。例:
  • アップグレード前後のインスタンスバージョン。
  • アップグレード前後のインターフェース、高可用性ノード、仮想サーバー、およびサービスの状態。
  • 仮想サーバーとサービスの統計。
  • 動的ルート。
次の段階で実行するカスタムスクリプトを指定します。
  • アップグレード前: 指定されたスクリプトは、インスタンスをアップグレードする前に実行されます。
  • アップグレード後フェイルオーバー前 (HAに適用): このステージは、高可用性展開にのみ適用されます。指定されたスクリプトは、ノードのアップグレード後、フェイルオーバー前に実行されます。
  • アップグレード後 (スタンドアロンに適用) / アップグレード後フェイルオーバー後 (HAに適用): 指定されたスクリプトは、スタンドアロン展開でインスタンスをアップグレードした後に実行されます。高可用性展開では、スクリプトはノードのアップグレードとそのフェイルオーバー後に実行されます。
注:
  • 必要なステージでスクリプトまたはコマンドの実行を有効にしてください。そうしないと、指定されたスクリプトは実行されません。
  • 差分レポートは、アップグレード前とアップグレード後のステージで同じスクリプトを指定した場合にのみ生成されます。したがって、アップグレード後のステージでアップグレード前と同じスクリプトを使用を選択してください。詳細については、「NetScalerアップグレードジョブの統合差分レポートをダウンロードする」を参照してください。
スクリプトファイルをインポートするか、NetScaler Console GUIに直接コマンドを入力できます。
  • ファイルからコマンドをインポート: ローカルコンピューターからコマンド入力ファイルを選択します。
  • コマンドを入力: GUIに直接コマンドを入力します。
アップグレード後のステージでは、アップグレード前のステージで指定したスクリプトと同じスクリプトを使用できます。
カスタムスクリプト

NetScalerアップグレードオプション

NetScalerアップグレードジョブを作成する際に、ジョブの作成タブで次のオプションを選択できます。
  • アップグレードを開始する前にNetScalerインスタンスをバックアップする。: 選択したNetScalerインスタンスのバックアップを作成します。
  • アップグレード後も高可用性ノードのプライマリおよびセカンダリステータスを維持する: 各ノードのアップグレード後にアップグレードジョブでフェイルオーバーを開始する場合は、このオプションを選択します。これにより、アップグレードジョブはノードのプライマリおよびセカンダリステータスを維持します。
  • アップグレード開始前にNetScaler構成を保存 - NetScalerインスタンスをアップグレードする前に、実行中のNetScaler構成を保存します。
  • NetScaler HAペアでのネットワーク停止を回避するためにISSUを有効にする - ISSUは、NetScaler高可用性ペアでのゼロダウンタイムアップグレードを保証します。このオプションは、アップグレード中に既存の接続を維持する移行機能を提供します。そのため、ダウンタイムなしでNetScaler高可用性ペアをアップグレードできます。ISSU移行タイムアウトを分単位で指定します。
  • メールで実行レポートを受信する - 実行レポートをメールで送信します。メール配布リストを追加するには、「メール配布リストの作成」を参照してください。
  • Slackで実行レポートを受信する - 実行レポートをSlackで送信します。Slackプロファイルを追加するには、「Slackプロファイルの作成」を参照してください。

NetScaler高可用性ペアのアップグレードジョブのスケジュール設定

次の表に、タスクのスケジュールページでのさまざまなスケジュール設定シナリオと、ジョブの作成ページで利用可能な対応するアップグレードオプションを示します。
アップグレードジョブをいつ実行しますか？ ソフトウェアイメージをNetScalerにいつアップロードしますか？ ビルドイメージをHAノードにどのようにアップロードしますか？
今すぐアップグレード 該当なし プライマリノードとセカンダリノードの両方にアップロード (デフォルトオプション)
セカンダリノードのみにアップロード
後でスケジュール 実行時にアップロード（デフォルトオプション） プライマリノードとセカンダリノードの両方にアップロード（デフォルトオプション）
セカンダリノードのみにアップロード
今すぐアップロード 該当なし
後でスケジュール（「HAのノードに対して2段階アップグレードを実行」が選択されている場合） 実行時にアップロード（デフォルトオプション） セカンダリノードのみにアップロード（デフォルトかつ唯一のオプション）
今すぐアップロード 該当なし

NetScalerアップグレードジョブの統合差分レポートをダウンロードする

NetScaler Consoleでは、NetScalerアップグレードジョブの差分レポートをダウンロードできます。そのためには、アップグレードジョブにカスタムスクリプトが必要です。差分レポートには、アップグレード前スクリプトとアップグレード後スクリプトの出力間の違いが含まれています。このレポートを使用すると、アップグレード後にNetScalerインスタンスでどのような変更が発生したかを判断できます。
注:
差分レポートは、アップグレード前とアップグレード後の段階で同じスクリプトを指定した場合にのみ生成されます。
アップグレードジョブの差分レポートをダウンロードするには、次の手順を実行します。
  1. インフラストラクチャ > 構成ジョブ > メンテナンスジョブ に移動します。
  2. 差分レポートをダウンロードするアップグレードジョブを選択します。
  3. 「Diff Reports」をクリックします。
  4. 「Diff Reports」で、選択したアップグレードジョブの統合差分レポートをダウンロードします。
    このページでは、以下のいずれかの差分レポートタイプをダウンロードできます。
    • アップグレード前とアップグレード後（フェイルオーバー前）の差分レポート
    • アップグレード前とアップグレード後の差分レポート
    NetScalerアップグレードジョブの差分レポートをダウンロードする(/en-us/netscaler-console-service/media/diff-reports-page.png)