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

前提条件

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

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

1. NetScalerでのアップグレード前の手順
   • アップグレード前にカスタマイズされたファイルをバックアップする
   • アップグレード前にカスタマイズされたファイルのシンボリックリンクを削除する
2. ADMを使用してNetScalerをアップグレードします。アップグレードするには、ページ冒頭の指示に従ってください。
3. NetScalerでのアップグレード後の手順
   • アップグレード後にカスタマイズを復元する(https://docs.citrix.com/ja-jp/citrix-adc/current-release/upgrade-downgrade-citrix-adc-appliance/upgrade-considerations-customized-files.html#apply-customizations-to-upgraded-file-and-add-persistency-after-upgrade)

NetScaler高可用性ペア

• セカンダリノードが最初にアップグレードされます。
• 両方のノードが正常にアップグレードされるまで、ノードの同期と伝播は無効になります。
• 高可用性ペアのアップグレードが正常に完了すると、実行履歴にエラーメッセージが表示されます。このメッセージは、高可用性ペア内のノードが異なるビルドまたはバージョンである場合に表示されます。これは、プライマリノードとセカンダリノード間の同期が無効になっていることを示します。

1. アップグレードジョブを作成し、いずれかのノードで直ちに実行するか、後でスケジュールします。
2. 残りのノードで実行するアップグレードジョブを後でスケジュールします。このジョブは、最初のノードのアップグレード後にスケジュールするようにしてください。

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ディスク容量のクリーンアップ」を参照してください(#clean-up-the-adc-disk-space)。
   
   • ポリシーチェック: NetScaler Consoleがサポートされていないクラシックポリシーを検出した場合、アップグレードジョブを作成するために、そのようなポリシーを削除できます。
   重要:
   クラスターIPアドレスを指定した場合、NetScaler Consoleは、指定されたインスタンスに対してのみアップグレード前検証を実行し、他のクラスターノードに対しては実行しません。
   アップグレード中にプライマリノードとセカンダリノード間の不一致を表示するには、高可用性ノードを選択し、詳細をクリックします。
   
   • HAのプライマリノードで見つかった構成の不一致 - NetScaler®高可用性ペアのセカンダリノードで見つかったが、プライマリノードにはないすべての構成を表示します。
   • HAのセカンダリノードで見つかった構成の不一致 - NetScaler高可用性ペアのプライマリノードで見つかったが、セカンダリノードにはないすべての構成を表示します。
   注:
   構成の不一致セクションに表示される可能性のある以下の不一致は無視できます。
   • IPアドレスなどのデバイス固有の設定。
   • 暗号化されたパスワードまたは証明書。これらは、パスワードが同じであってもノード間で異なる場合があります。
   不一致を確認し、関連性がない場合は無視することを選択できます。

6. 検証スクリプトで、インスタンスのアップグレード前後に実行するスクリプトを指定します。次のいずれかを実行できます。
   • デフォルト検証スクリプト - このオプションを選択すると、事前定義された検証スクリプトが実行されます。これらのスクリプトは、アップグレードジョブの前後両方で実行され、検証スクリプトの差分レポートが生成されます。
     注:
     これらの事前定義されたコマンドセットを変更または編集することはできません。

   • カスタム検証スクリプト - このオプションを選択すると、独自の検証スクリプトが実行されます。スクリプトをアップグレード前またはアップグレード後に実行するかどうかを指定できます。差分レポートは、アップグレードの前後で同じスクリプトが選択されている場合にのみ生成されます。
   
   各構成のコマンドセットを知るには、詳細表示をクリックします。 詳細については、「カスタムスクリプトの使用」を参照してください。
7. タスクのスケジュールで、次のいずれかのオプションを選択します。
   • 今すぐアップグレード: アップグレードジョブはすぐに実行されます。
   • 後でスケジュール: このオプションを選択すると、このアップグレードジョブを後で実行できます。インスタンスをアップグレードする実行日と開始時刻を指定します。
   NetScalerの高可用性ペアを2段階でアップグレードする場合は、高可用性ノードの2段階アップグレードを実行を選択します。
   高可用性ペア内の別のインスタンスをアップグレードする実行日と開始時刻を指定します。
   
   詳細については、「NetScaler高可用性ペア」(#adc-high-availability-pair)を参照してください。
8. ジョブの作成で、次の詳細を指定します。
   アップグレードジョブをスケジュールする場合、インスタンスにイメージをアップロードするタイミングを指定できます。
   • 今すぐアップロード: このオプションを選択すると、イメージがすぐにアップロードされます。ただし、アップグレードジョブはスケジュールされた時刻に実行されます。
   • 実行時にアップロード: このオプションを選択すると、アップグレードジョブの実行時にイメージがアップロードされます。
   高可用性ペアの場合、イメージをアップロードするノードを指定できます。
   • プライマリノードとセカンダリノードの両方にアップロード: ビルドイメージファイルをプライマリノードとセカンダリノードの両方にアップロードします。
   • セカンダリノードのみにアップロード: ビルドイメージファイルをセカンダリノードのみにアップロードします。セカンダリノードがアップグレードされると、フェイルオーバーが発生し、以前プライマリノードだった新しいセカンダリノードにビルドイメージファイルがアップロードされます。
   
   高可用性ペアで利用可能なスケジューリングシナリオの詳細については、「NetScaler高可用性ペアのアップグレードジョブのスケジュール」(#scheduling-upgrade-jobs-for-an-adc-high-availability-pair)を参照してください。
   その他のアップグレードオプションの詳細については、「NetScalerアップグレードオプション」(#adc-upgrade-options)を参照してください。
9. ジョブの作成をクリックします。

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

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

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. Pre-upgrade validation タブには、次のセクションが表示されます。
   • アップグレード準備完了インスタンス。これらのインスタンスのアップグレードを続行できます。
   • アップグレードがブロックされているインスタンス。これらのNetScalerインスタンスは、アップグレード前の検証エラーのため、アップグレードがブロックされています。
     エラーを確認して修正し、「アップグレード準備完了に移動」をクリックしてアップグレードできます。インスタンスでディスク容量不足が発生した場合は、ディスク容量を確認してクリーンアップできます。「NetScalerディスク容量のクリーンアップ」(#clean-up-the-adc-disk-space)を参照してください。
   • ポリシーチェック: NetScaler Consoleがサポートされていないクラシックポリシーを検出した場合、そのようなポリシーを削除してアップグレードジョブを作成できます。
   
   「次へ」をクリックします。
4. 「タスクのスケジュール」で、次のいずれかのオプションを選択します。
   • 今すぐアップグレード: アップグレードジョブはすぐに実行されます。
   • 後でスケジュール: このオプションを選択すると、このアップグレードジョブを後で実行できます。インスタンスをアップグレードしたいときに、「実行日」と「開始時刻」を指定します。
   
   「再試行」をクリックします。

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

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

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

• アップグレード前後のインスタンスバージョン。
• アップグレード前後のインターフェース、高可用性ノード、仮想サーバー、およびサービスの状態。
• 仮想サーバーとサービスの統計。
• 動的ルート。

• アップグレード前: 指定されたスクリプトはインスタンスのアップグレード前に実行されます。
• アップグレード後フェイルオーバー前 (HAに適用): このステージは高可用性展開にのみ適用されます。指定されたスクリプトはノードのアップグレード後に実行されますが、フェイルオーバー前です。
• アップグレード後 (スタンドアロンに適用) / アップグレード後フェイルオーバー後 (HAに適用): 指定されたスクリプトはスタンドアロン展開でインスタンスのアップグレード後に実行されます。高可用性展開では、スクリプトはノードのアップグレードとそのフェイルオーバー後に実行されます。

• ファイルからコマンドをインポート: ローカルコンピューターからコマンド入力ファイルを選択します。
• コマンドを入力: GUIに直接コマンドを入力します。

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

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

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

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

1. インフラストラクチャ > 構成ジョブ > メンテナンスジョブ に移動します。
2. 差分レポートをダウンロードするアップグレードジョブを選択します。
3. 「Diff Reports」をクリックします。
4. 「Diff Reports」で、選択したアップグレードジョブの統合差分レポートをダウンロードします。
   このページでは、以下のいずれかの差分レポートタイプをダウンロードできます。
   • アップグレード前とアップグレード後（フェイルオーバー前）の差分レポート
   • アップグレード前とアップグレード後の差分レポート
   NetScalerアップグレードジョブの差分レポートをダウンロード(/en-us/netscaler-console-service/media/diff-reports-page.png)