ジョブを使用してNetScaler インスタンスをアップグレードする
NetScalerコンソールでは、1つまたは複数のNetScalerインスタンスをアップグレードできます。インスタンスをアップグレードする前に、ライセンスフレームワークとライセンスのタイプを知っておく必要があります。
注: クラシックポリシーのあるインスタンスをアップグレードする場合は、インスタンスをアップグレードする前に、NSPEPI ツールを使用してクラシックポリシーをアドバンスドポリシーに変換することをお勧めします。これは、NSPEPI ツールでサポートされている機能に適用されます。詳しくは、「 クラシックポリシーを使用する構成のアップグレードに関する考慮事項」を参照してください。
前提条件
NetScaler Consoleは、アップグレードするインスタンスに対して次の事前検証チェックを実行します。
-
ディスク容量の確認 -インスタンスのアップグレードに十分なディスク容量を確保するために、ディスク容量をクリーンアップします。ディスクの問題があれば解決します。
-
ディスクハードウェアの問題の確認 -ハードウェアの問題があれば解決します。
-
カスタマイズをチェックする -カスタマイズをバックアップし、インスタンスから削除します。バックアップしたカスタマイズは、インスタンスのアップグレード後に再適用できます。
-
ポリシーの問題-NetScalerはバージョン以降のクラシックポリシーを
13.1
サポートしていません。 インスタンスをこのバージョンにアップグレードする前に、クラシックポリシーを高度なポリシーに移行してください。詳しくは、「 クラシックポリシーと詳細ポリシー」を参照してください。
カスタマイズされたNetScaler構成のアップグレードに関する考慮事項
アップグレードの変更とカスタマイズ内容の両方を、アップグレードされたNetScaler ADCアプライアンスに適用することが重要です。そのため、/etcディレクトリにカスタマイズした構成ファイルがある場合は、Citrix ADCアプライアンスのアップグレードを続行する前に、「カスタマイズされた構成ファイルのアップグレードに関する考慮事項 」を参照してください。実行する必要がある大まかな手順は次のとおりです。
-
NetScalerのアップグレード前の手順
-
ADM を使用してNetScaler をアップグレードします。アップグレードするには、ページの冒頭にある指示に従ってください。
-
NetScalerのアップグレード後の手順
アップグレード前とアップグレード後の両方の手順は、各NetScalerインスタンスで実行する必要があります。ただし、ADMを使用してNetScalerをアップグレードする手順2では、脆弱なNetScalerインスタンスをすべて選択してまとめてアップグレードできます。
NetScaler の高可用性ペア
NetScaler高可用性ペアをアップグレードするときは、次の点に注意してください。
-
セカンダリノードが最初にアップグレードされます。
-
ノードの同期と伝播は、両方のノードが正常にアップグレードされるまで無効になります。
-
高可用性ペアのアップグレードが成功すると、実行履歴にエラーメッセージが表示されます。このメッセージは、高可用性ペアのノードが異なるビルドまたはバージョン上にある場合に表示されます。プライマリノードとセカンダリノード間の同期が無効になっていることを示します。
NetScalerの高可用性ペアは、次の2段階でアップグレードできます。
-
アップグレードジョブを作成し、いずれかのノードで直ちに実行するか、後でスケジュールします。
-
後で残りのノードで実行するようにアップグレードジョブをスケジュールします。最初のノードのアップグレード後に、必ずこのジョブをスケジュールしてください。
NetScaler クラスター
NetScalerクラスターをアップグレードする場合、アップグレード前の検証段階では、NetScaler Consoleは指定されたインスタンスのみを検証します。そのため、クラスタノードで次の問題を確認して解決してください。
-
カスタマイズ
-
ディスク使用率
-
ハードウェアの問題
NetScaler アップグレードジョブを作成する
NetScalerアップグレードジョブを作成するには、次の手順を実行します。
-
インフラストラクチャ > ジョブをアップグレードするに移動します。
-
[ メンテナンスジョブの作成]で、[ NetScaler(スタンドアロン/高可用性/クラスタ)のアップグレード ]を選択し、[ 続行]をクリックします。
注:
Autoscaleグループをアップグレードするには、「 Autoscale グループのアップグレード」を参照してください。
-
[インスタンスを選択 ] タブで、
-
[ ジョブ名] に任意の名前を指定します。
-
「 インスタンスを追加 」をクリックして、アップグレードするNetScalerインスタンスを追加します。
-
NetScalerの高可用性ペアをアップグレードするには、高可用性ペアのIPアドレス(「S」と「P」の上付き文字で表示)を選択します。
-
クラスターをアップグレードするには、クラスターの IP アドレス (「C」の上付き文字で示される) を選択します。
-
-
[OK] をクリックします。
-
-
「イメージの選択」タブで、イメージライブラリ 、ローカル、またはアプライアンスからNetScalerイメージを選択します。
-
イメージライブラリから選択:リストからNetScalerイメージを選択します。このオプションは、NetScalerダウンロードWebサイトで利用できるすべてのNetScalerイメージを一覧表示します。
NetScalerソフトウェアイメージには、星形のアイコンが付いた優先ビルドが表示されます。そして、ほとんどのダウンロードビルドにはブックマークアイコンが付いています。
-
ローカルまたはアプライアンスから選択:ローカルコンピューターまたはNetScalerアプライアンスからイメージをアップロードできます。NetScalerアプライアンスを選択すると、NetScalerコンソールのGUIに、に存在するインスタンスファイルが表示され
/var/mps/ns_images
ます。 NetScalerコンソールのGUIからイメージを選択します。 -
選択したイメージがすでに使用可能な場合は、NetScalerへのイメージのアップロードをスキップする -このオプションは、選択したイメージがNetScalerで使用できるかどうかをチェックします。アップグレードジョブでは、新しいイメージのアップロードがスキップされ、NetScalerで使用可能なイメージが使用されます。
-
アップグレードが成功したらNetScalerからソフトウェアイメージを消去する-このオプションは、インスタンスのアップグレード後にNetScalerインスタンスにアップロードされたイメージを消去します 。
[ Next ] をクリックして、選択したインスタンスでアップグレード前の検証を開始します。
注:
- ダウンロードしたNetScalerイメージはエージェントに保存され、にあり
/var/mps/adcimages
ます。 これらのキャッシュされたイメージは複数のNetScalerアップグレードに使用できるため、アップグレードのたびにイメージをダウンロードする必要がなくなります。 - NetScaler Consoleは、キャッシュされたNetScalerイメージを、イメージの最終変更時刻に基づいて3日ごとにクリアします。エージェントに一度にキャッシュされるのは、最新の 2 つのイメージファイルのみです。
-
- 「 アップグレード前の検証 」タブには、次のセクションが表示されます:
-
インスタンスはアップグレードの準備ができています。これらのインスタンスのアップグレードを続行できます。
-
インスタンスのアップグレードがブロックされました。これらの NetScaler インスタンスは、アップグレード前の検証エラーのためにアップグレードがブロックされています。
エラーを確認して修正し、[ アップグレードの準備完了] をクリックしてエラーをアップグレードできます 。インスタンスのディスク領域が不足している場合は、ディスク領域を確認してクリーンアップできます。 NetScalerのディスク容量のクリーンアップを参照してください。
- ポリシーチェック:NetScaler Consoleでサポートされていないクラシックポリシーが見つかった場合は、そのようなポリシーを削除してアップグレードジョブを作成できます。
重要:
クラスターIPアドレスを指定した場合、NetScaler Consoleは指定されたインスタンスでのみアップグレード前の検証を行い、他のクラスターノードでは検証しません。
アップグレード中のプライマリノードとセカンダリノードの不一致を表示するには、高可用性ノードを選択し、[詳細] をクリックします。
-
HAのプライマリノードで見つかった構成の不一致 -NetScaler高可用性ペアのセカンダリノードにはあるが、プライマリノードにはないすべての構成が表示されます。
-
HAのセカンダリノードで見つかった構成の不一致 -NetScaler高可用性ペアのプライマリノードにはあるが、セカンダリノードにはないすべての構成が表示されます。
注:
「設定の不一致」セクションに表示される可能性のある以下の不一致は無視してかまいません。
-
IP アドレスなどのデバイス固有の設定。
-
暗号化されたパスワードまたは証明書。パスワードが同じであってもノード間で異なる場合があります。
不一致を確認して、関連性のない場合は無視することもできます。
-
-
検証スクリプトで、インスタンスのアップグレードの前後に実行するスクリプトを指定します。次のいずれかを実行できます:
-
デフォルト検証スクリプト -このオプションを選択すると、定義済みの検証スクリプトが実行されます。これらのスクリプトはアップグレードジョブの前と後の両方で実行され、検証スクリプトの差分レポートが生成されます。
注:
これらの定義済みのコマンドセットは変更または編集できません。
-
カスタム検証スクリプト -このオプションを選択すると、独自の検証スクリプトを実行できます。スクリプトをアップグレードの前または後に実行するかどうかを指定できます。差分レポートは、アップグレードの前後に同じスクリプトが選択された場合にのみ生成されます。
各構成のコマンドセットを確認するには、「 詳細を表示」をクリックします。 詳細については、「 カスタムスクリプトを使用する」を参照してください。
-
-
「 タスクのスケジュール」で、次のいずれかのオプションを選択します:
-
今すぐアップグレード: アップグレードジョブはすぐに実行されます。
NetScalerの高可用性ペアを2段階でアップグレードする場合は、「 高可用性ノードに対して2段階アップグレードを実行する」を選択します。
高可用性ペアの別のインスタンスをアップグレードする場合は、[ Execution Date] と [Start Time] を指定します。
詳しくは、「 NetScaler高可用性ペア」を参照してください。
-
-
「 ジョブの作成」で、次の詳細を指定します:
アップグレードジョブをスケジュールする場合、インスタンスにイメージをアップロードするタイミングを指定できます。
-
今すぐアップロード: 画像をすぐにアップロードするには、このオプションを選択します。ただし、アップグレードジョブはスケジュールされた時間に実行されます。
-
[ 実行時にアップロード]: アップグレードジョブの実行時にイメージをアップロードするには、このオプションを選択します。
高可用性ペアの場合、イメージをアップロードするノードを指定できます。
-
プライマリノードとセカンダリノードの両方にアップロード:ビルドイメージファイルをプライマリノードとセカンダリノードの両方にアップロードします。
-
セカンダリノードのみにアップロード:ビルドイメージファイルをセカンダリノードのみにアップロードします。セカンダリノードがアップグレードされると、フェイルオーバーが発生し、ビルドイメージファイルが、以前はプライマリノードであった新しいセカンダリノードにアップロードされます。
高可用性ペアで利用できるスケジュールシナリオの詳細については、「 NetScaler高可用性ペアのアップグレードジョブのスケジュール設定」を参照してください。
その他のアップグレードオプションについて詳しくは、「 NetScalerのアップグレードオプション」を参照してください。
-
- [ ジョブの作成] をクリックします。
アップグレードジョブは [ インフラストラクチャ] > [アップグレードジョブ] に表示されます。既存のジョブを編集するときに、必須フィールドにすでに入力されている場合は、任意のタブに切り替えることができます。たとえば、[ 構成の選択 ] タブが表示されている場合は、[ ジョブプレビュー ] タブに切り替えることができます。
スケジュールされたアップグレードジョブを一時停止または再開する
スケジュールされたアップグレードジョブを一時停止することもできます。
この機能を使用するには、[ インフラストラクチャ] >[アップグレードジョブ] に移動し、既存のスケジュールされたアップグレードジョブを選択し、[ 停止 ] をクリックしてジョブを一時停止します。スケジュールされたアップグレードジョブを再開するには、「 再開」をクリックします。
注:
再開を決定した後でアップグレードジョブの予定時刻を過ぎた場合は、アップグレードジョブを再度作成する必要があります。
失敗したアップグレードジョブを再試行
-
[ インフラストラクチャ] > [アップグレードジョブ] で、失敗したアップグレードジョブを選択し、[ 再試行] をクリックします。または、 [アクションの選択] > [アップグレードジョブの再試行] に移動して、失敗したジョブを再試行することもできます 。
-
「インスタンスの選択」で、次の詳細を指定します。
-
ジョブ名 -アップグレードの名前を入力します。
-
アップグレードするNetScalerインスタンスをリストから選択します。インスタンスを削除するには、[ 削除] をクリックします。
[ 次へ ] をクリックして検証プロセスを開始します。
-
- 「 アップグレード前の検証 」タブには、次のセクションが表示されます:
-
インスタンスはアップグレードの準備ができています。これらのインスタンスのアップグレードを続行できます。
-
インスタンスのアップグレードがブロックされました。これらの NetScaler インスタンスは、アップグレード前の検証エラーのためにアップグレードがブロックされています。
エラーを確認して修正し、[ アップグレードの準備完了] をクリックしてエラーをアップグレードできます 。インスタンスのディスク領域が不足している場合は、ディスク領域を確認してクリーンアップできます。 NetScalerのディスク容量のクリーンアップを参照してください。
-
ポリシーチェック:NetScaler Consoleでサポートされていないクラシックポリシーが見つかった場合は、そのようなポリシーを削除してアップグレードジョブを作成できます。
[次へ] をクリックします。
-
-
「 タスクのスケジュール」で、次のいずれかのオプションを選択します:
-
今すぐアップグレード: アップグレードジョブはすぐに実行されます。
[再試行]をクリックします。
-
NetScalerのディスク容量をクリーンアップします
NetScalerインスタンスのアップグレード中にディスク容量不足の問題が発生した場合は、NetScalerコンソールGUI自体からディスク容量をクリーンアップしてください。
-
「 アップグレード前の検証 」タブの「 アップグレードがブロックされたインスタンス 」セクションには、ディスク容量が不足しているためにアップグレードに失敗したインスタンスが表示されます。ディスク容量に問題があるインスタンスを選択します。
-
[ ディスク容量の確認] をクリックします。
[ ディスク容量の詳細 ] ウィンドウが表示されます。このペインには、インスタンス、使用済みメモリ、および使用可能なメモリが表示されます。
-
ディスク容量の詳細ペインで 、クリーンアップが必要なインスタンスを選択し、次のいずれかを実行します。
-
ディスククリーンアップ -必要なフォルダまたはディレクトリに移動して削除し、ディスクの空き容量を増やします。
-
クイッククリーンアップ -複数のフォルダーを削除して、ディスク容量をすばやく空けます。表示される [ 確認 ] ペインで、削除するフォルダを選択し、[ はい] をクリックします。
-
ディスク容量を空けたら、インスタンスをアップグレードするのに十分なディスク容量があるかどうかを確認できます。「 アップグレードがブロックされたインスタンス 」セクションで、「 再検証」をクリックします。
次の例では、ディスク容量が使用可能です。これで、[ アップグレードの準備完了 ] をクリックしてインスタンスをアップグレードするか、[ 次へ ] をクリックして次のステップに進むことができます。
-
カスタムスクリプトを使用する
NetScalerアップグレードジョブの作成時にカスタムスクリプトを指定できます。カスタムスクリプトは、NetScalerインスタンスのアップグレード前とアップグレード後の変更を確認するために使用されます。例:
-
アップグレード前とアップグレード後のインスタンスのバージョン。
-
アップグレード前後のインターフェイス、高可用性ノード、仮想サーバ、およびサービスのステータス。
-
仮想サーバーとサービスの統計。
-
ダイナミックルート。
次のステージで実行するカスタムスクリプトを指定します。
-
アップグレード前: インスタンスをアップグレードする前に、指定されたスクリプトが実行されます。
-
アップグレード前のフェールオーバー後(HA に適用可能):このステージは、高可用性配置にのみ適用されます。指定されたスクリプトは、ノードのアップグレード後、フェールオーバーの前に実行されます。
-
アップグレード後(スタンドアロンに適用)/フェールオーバー後のアップグレード後(HA に適用可能): 指定されたスクリプトは、スタンドアロンデプロイでインスタンスをアップグレードした後に実行されます。高可用性展開では、スクリプトはノードとフェイルオーバーをアップグレードした後に実行されます。
注:
必要な段階でスクリプトまたはコマンドの実行を有効にしてください。そうしないと、指定されたスクリプトは実行されません。
相違レポートが生成されるのは、アップグレード前およびアップグレード後の段階で同じスクリプトを指定した場合だけです。そのため、アップグレード後の段階では、必ず [ アップグレード前と同じスクリプトを使用する ] を選択してください。「 NetScalerアップグレードジョブの統合差分レポートのダウンロード」を参照してください。
スクリプトファイルをインポートするか、NetScalerコンソールGUIでコマンドを直接入力できます。
- ファイルからコマンドをインポートする: ローカルコンピュータからコマンド入力ファイルを選択します。
- コマンドの入力:GUI に直接コマンドを入力します。
アップグレード後の段階では、アップグレード前の段階で指定したのと同じスクリプトを使用できます。
NetScaler アップグレードオプション
NetScalerアップグレードジョブを作成する際、[ ジョブの作成 ]タブで次のオプションを選択できます。
-
アップグレードを開始する前に、NetScalerインスタンスをバックアップしてください。: 選択したNetScalerインスタンスのバックアップを作成します。
-
アップグレード後も高可用性ノードのプライマリとセカンダリのステータスを維持する:各ノードのアップグレード後にアップグレードジョブがフェイルオーバーを開始するようにするには、このオプションを選択します。このようにして、アップグレードジョブはノードのプライマリとセカンダリのステータスを維持します。
-
アップグレードを開始する前にNetScaler構成を保存する-NetScalerインスタンスをアップグレードする前に 、実行中のNetScaler構成を保存します。
-
ISSUを有効にしてNetScaler HAペアでネットワークが停止しないようにする-ISSUは、NetScaler高可用性ペアでのダウンタイムなしのアップグレードを保証します 。このオプションは、アップグレード中に既存の接続を使用する移行機能を提供します。そのため、ダウンタイムなしでNetScaler高可用性ペアをアップグレードできます。ISSU 移行タイムアウトを分単位で指定します。
-
実行レポートを電子メールで受信 する-実行レポートを電子メールで送信します。電子メール配布リストを追加するには、「 電子メール配布リストを作成する」を参照してください。
-
slackによる実行レポートの受 信-実行レポートをslackで送信します。Slack プロフィールを追加するには、 Slack プロフィールを作成するを参照してください。
NetScaler 高可用性ペアのアップグレードジョブのスケジュール設定
次の表は、「 Schedule Task 」ページのさまざまなスケジューリングシナリオと、「 Create Job 」ページで使用できる対応するアップグレードオプションを示しています。
アップグレードジョブをいつ実行しますか? | ソフトウェアイメージをNetScalerにいつアップロードしますか? | ビルドイメージを HA ノードにどのようにアップロードしますか? |
---|---|---|
今すぐアップグレード | 該当なし | プライマリノードとセカンダリノードの両方にアップロード (デフォルトオプション) |
後でスケジュールする | 実行時にアップロード (デフォルトオプション) | プライマリノードとセカンダリノードの両方にアップロード (デフォルトオプション) |
今すぐアップロード | ||
後でスケジュールする ([ HA 内のノードの 2 段階アップグレードを実行する ] を選択した場合) | 実行時にアップロード (デフォルトオプション) | セカンダリノードのみにアップロード (デフォルトかつ唯一のオプション) |
今すぐアップロード |
NetScalerアップグレードジョブの統合差分レポートをダウンロードする
NetScaler コンソールでは、NetScaler アップグレードジョブの差分レポートをダウンロードできます。そのためには、 アップグレードジョブにカスタムスクリプトが必要です。差分レポートには、アップグレード前スクリプトとアップグレード後のスクリプトの出力の違いが含まれます。このレポートを使用すると、アップグレード後にNetScalerインスタンスにどのような変更が加えられたかを確認できます。
注:
差分レポートは、アップグレード前とアップグレード後の段階で同じスクリプトを指定した場合にのみ生成されます。
アップグレードジョブの相違レポートをダウンロードするには、次の手順を実行します。
-
インフラストラクチャ > 構成ジョブ > メンテナンスジョブに移動します。
-
差分レポートをダウンロードするアップグレードジョブを選択します。
-
「 相違レポート」をクリックします。
-
相違レポートで、選択したアップグレードジョブの統合差分レポートをダウンロードします。
このページでは、次の相違レポートの種類をダウンロードできます。
- アップグレード前とポストアップグレード前のフェイルオーバー差分レポート
- アップグレード前とアップグレード後の差分レポート