既存の ND クラスタをこのリリースへアップグレード

前提条件とガイドライン

既存のNexusダッシュボードクラスタをアップグレードする前に、次の手順を実行します。

  • アップグレードに影響する可能性のある動作、ガイドライン、および問題の変更については、ターゲット リリースのリリース ノートを必ずお読みください。

  • このリリースにアップグレードすると、クラスタで有効になっているサービスの数を変更できなくなることに注意してください。

    リリース 3.1.1 以降、各クラスタには、有効なサービスの組み合わせを定義する「展開モード」があり、サービスの組み合わせをクラスタの展開またはアップグレード後に変更することはできません。つまり、このリリースにアップグレードした後、クラスタを再展開せずにサービスの追加や削除を行うことはできません。クラスタ内のサービスを追加または削除する予定の場合は、本リリースにアップグレードする前に行うことをお勧めします。


    （注）  

    場合によっては、本リリースでサポートされている展開モードが、以前のリリースではサポートされていなかった場合があります（たとえば、Insights と Orchestrator の共存は、リリース 3.0.1 の仮想クラスタではサポートされていません）。このような場合、現在のクラスタに単一のサービス（Insights など）が展開されていて、アップグレード後に別のサービス（Orchestrator など）を追加するには、次の手順を実行します。

    1. 現在のクラスタ内の既存の Insights サービスを無効にします。

    2. 現在のクラスタに追加の Orchestrator サービスをインストールします。

    3. 現在のクラスタで Orchestrator サービスを有効にします。

      この時点で、Insights と Orchestrator の両方が現在のクラスタにあって、Insights は無効になり、Orchestrator は有効になります。現在のリリースでサポートされている設定でない場合は、両方のサービスを同時に有効にしないでください。

    4. Orchestrator サービスを無効にして、アップグレードを続行します。

  • 4 ノードまたは 5 ノードの物理クラスタで Nexus Dashboard Insights サービスを実行している場合は、通常どおりにクラスタとサービスをこのリリースにアップグレードし、4 ノードまたは 5 ノードクラスタを引き続き使用できます。

    Nexus Dashboard Insights を搭載したNexus Dashboard の本リリースで、グリーンフィールド展開を行う場合は、 3 ノードおよび 6 ノードのプロファイルのみがサポートされます。ただし、現在のスケールを変更せずに、既存の 4 ノードまたは 5 ノードクラスタを以前のリリースからアップグレードする場合は、本リリースで引き続き使用できます。

  • 物理的な Nexus Dashboard クラスタをアップグレードしている場合は、ノードにターゲットの Nexus Dashboard リリースでサポートされている最小の CIMC バージョンがあることを確認してください。

    サポートされている CIMC バージョンは、ターゲット リリースの Nexus Dashboard リリース ノート にリストされています。

    CIMC アップグレードについては、Nexus Dashboard ドキュメント ライブラリ の「トラブルシューティング」の記事で詳しく説明されています。

  • Linux KVM に展開された仮想 Nexus Dashboard クラスタをアップグレードする場合は、Virtual Machine Manager の UI で [ホスト CPU 設定のコピー（Copy host CPU configuration ）] オプションを有効にする必要があります。

    このリリースは、次のカーネルおよび KVM バージョンを搭載した CentOS 7.9 または Red Hat Enterprise Linux 8.6 をサポートします。

    • CentOS 7.9 の場合、Kernel バージョン 3.10.0-957.el7.x86_64 および KVM バージョン libvirt-4.5.0-23.el7_7.1.x86_64

    • RHEL 8.6 の場合、Kernel バージョン 4.18.0-372.9.1.el8.x86_64 および KVM バージョン libvert 8.0.0

  • VMware ESX に展開された仮想 Nexus Dashboard クラスタをアップグレードする場合は、ESX のバージョンがターゲット リリースで引き続きサポートされていることを確認します。

    このリリースは、VMware ESXi 7.0、7.0.1、7.0.2、7.0.3、8.0 をサポートしています。


    （注）  

    ESX サーバーをアップグレードする必要がある場合は、Nexus Dashboard をターゲット リリースにアップグレードする前に行う必要があります。ESX のアップグレードはこのドキュメントの範囲外ですが、簡単に説明すると次のとおりです。

    1. 既存の Nexus Dashboard ノード VM を実行している場合に通常行うように、ESX ホストの 1 つをアップグレードします。

    2. ホストがアップグレードされた後、Nexus Dashboard クラスタが正常に動作していることを確認します。

    3. 他の ESX ホストで 1 つずつアップグレードを繰り返します。

    4. すべての ESX ホストがアップグレードされ、既存の Nexus Dashboard クラスタが正常な状態になったら、このドキュメントの説明に従って、Nexus Dashboard をターゲット リリースにアップグレードします。

  • Nexus Dashboard リリース 3.0(1) またはそれ以降を実行して、リリース 3.2(1) に直接アップグレードする必要があります。

    それより前のバージョンの Nexus Dashboard を実行している場合は、それぞれの展開ガイドの説明に従って、最初にリリース 3.0(1) または 3.1(1) にアップグレードする必要があります。

  • 現在の Nexus ダッシュボードクラスタが正常であることを確認します。

    Nexus ダッシュボードの管理コンソール（Admin Console）の [概要（Overview）] ページでシステムのステータスを確認するか、rescue-user としてノードの1つにログインし、acs health コマンドを実行して All components are healthy が返ってくることを確認します。

  • リリース 3.0(1) からアップグレードする場合、このリリースにアップグレードする前に、クラスタで実行されているすべてのサービスを無効にする必要があります。

    リリース 3.1(1) からアップグレードする場合は、サービスを無効化にする必要はありません。

    リリース 3.1(1) の統合インストール イメージにより、既存のすべてのサービスのため、構成を保持しながら、この Nexus Dashboard リリースと互換性のあるバージョンに自動的にアップグレードされることに注意してください。また、アップグレードが完了すると、サービスは自動的に再度有効になります。

  • アップグレードを続行する前に、データを保護し、潜在的なリスクを最小限に抑えるために、アップグレードの前に Nexus ダッシュボードとサービスの構成バックアップを実行する必要があります。

  • アップグレードの進行中には、セカンダリまたはスタンバイノードを追加するなど、構成変更がクラスタに対して行われていないことを確認します。

  • Nexus Dashboard ではプラットフォームのダウングレードはサポートされていません。

    以前のリリースにダウングレードするには、新しいクラスタを展開してサービスを再インストールする必要があります。

サポート対象のアップグレード パス

Nexus Dashboard リリース3.1(1) より前では、プラットフォーム ソフトウェアと個々のサービスは、サポートされている特定のバージョンの組み合わせの範囲内で、相互に独立してアップグレードできました。そのため、以前のリリースのドキュメントには、各アップグレード段階ですべてのコンポーネント間の互換性を確保するために、複数のリリースにわたる特定のアップグレード パスが記載されていました。

この要件は、Nexus Dashboard と個々のサービス間のより緊密な結合により、各サービスの単一バージョンのみがプラットフォームの各バージョンと互換性があるため、削除されました。その結果、現在 Nexus Dashboard ソフトウェアの必要最小限のバージョン（前提条件とガイドライン に記載）を使用している限り、プラットフォームと現在有効になっているすべてのサービスの両方をこのリリースに直接アップグレードできます。

次の表に、特定の展開の組み合わせに関するシナリオの例をいくつか示します。

表 1.

現在の Nexus Dashboard リリース

互換性のあるサービス

（フォーム ファクタとクラスタ サイズによっては、これらのサービスの 1 つ以上が現在有効になっている場合があります）

アップグレードのワークフロー

3.0(1)

ファブリック コントローラ：12.1(3)

Orchestrator：4.2(x)

Insights：6.3(1)

次のセクションの説明に従って、リリース 3.1.1 に直接アップグレードします。

すべてのサービスは、プラットフォームとともに自動的にアップグレードされます。

2.3(2d)

ファブリック コントローラ：12.1(2)

Orchestrator：4.1(x)

Insights:：6.2(x)

  1. Orchestrator リリース4.1(1) 以前を実行している場合は、最初に Orchestrator サービスをリリース4.1(2) にアップグレードします。

    Orchestrator サービスを有効にしていない場合は、この手順をスキップします。

    （注）  

     

    Orchestrator サービスが有効になっているNexus Dashboardリリース2.3.2d からアップグレードする場合、 Nexus Dashboard 3.1(1) に直接アップグレードするには、Orchestrator サービスがバージョン4.1(2) 以降である必要があります。

  2. リリース 2.3(2d) からリリース 3.1(1) にアップグレードします。

    すべてのサービスは、プラットフォームとともに自動的にアップグレードされます。

2.3(2b)

ファブリック コントローラ：12.1(2)

Orchestrator：4.1(x)

Insights:：6.2(x)

  1. 『Nexus Dashboard 展開ガイド、リリース 2.3.x』の説明に従って、 Nexus Dashboard プラットフォームのみをリリース 2.3(2d) にアップグレードします。

  2. Orchestrator リリース4.1(1) 以前を実行している場合は、最初に Orchestrator サービスをリリース4.1(2) にアップグレードします。

    Orchestrator サービスを有効にしていない場合は、この手順をスキップします。

    （注）  

     

    Orchestrator サービスが有効になっているNexus Dashboardリリース2.3.2d からアップグレードする場合、 Nexus Dashboard 3.1(1) に直接アップグレードするには、Orchestrator サービスがバージョン4.1(2) 以降である必要があります。

  3. リリース2.3(2d) からリリース3.1(1) にアップグレードします。

    すべてのサービスは、プラットフォームとともに自動的にアップグレードされます。

2.3(2b) より前のリリース

ファブリック コントローラ：12.1(1) 以前

Orchestrator：4.0(2) 以前

インサイト：6.1(3) 以前

  1. 『 Nexus Dashboard 展開ガイド、リリース 2.3.x』の説明に従って、 Nexus Dashboard プラットフォームをリリース 2.3(2d) にアップグレードします。

  2. サービス固有のドキュメントに記載されているアップグレード パスまたは最小バージョン要件を使用して、以前に行ったように、個々のサービスを Nexus Dashboard リリース2.3(2d) と互換性のあるバージョンにアップグレードします。

  3. リリース 2.3(2d) からリリース 3.1(1) にアップグレードします。

    すべてのサービスは、プラットフォームとともに自動的にアップグレードされます。

Nexus ダッシュボードのアップグレード

ここでは、既存の Nexus ダッシュボード クラスタをアップグレードする方法について説明します。


（注）  

次の手順は、Nexus Dashboard リリース 3.0(1) からのアップグレード ワークフローを示しています。リリース 2.3(x) からアップグレードする場合、UI は若干異なる場合がありますが、アップグレードのワークフローと機能は同じです。

始める前に

手順

ステップ 1

Nexusダッシュボードイメージをダウンロードします。

  1. [ソフトウェア ダウンロード（Software Download）] ページを参照します。

    https://software.cisco.com/download/home/286327743/type/286328258

  2. ダウンロードするNexusダッシュボードのバージョンを選択します。

  3. ターゲットとするリリース用の Nexus ダッシュボード イメージをダウンロードします。

    （注）  

     

    アップグレード プロセスは、すべての Nexus ダッシュボード フォーム ファクタで同じで、Nexus ダッシュボード ISO イメージ（nd-dk9.<version>.iso）を使用します。言い換えると、最初の展開で仮想フォーム ファクターを使用していた場合（ESX での展開のための .ova イメージなど）やクラウド プロバイダーのマーケット プレースを使用していた場合であっても、アップグレードでは .iso イメージを使用する必要があります。

  4. イメージを自分の環境内の Web サーバーでホストします。

    環境内のサーバーでイメージをホストすることをお勧めします。イメージを Nexus Dashboard クラスタにアップロードする場合、イメージに直接 URL を指定するオプションがあります。そうすれば、プロセスは相当高速化されます。

ステップ 2

現在の Nexus ダッシュボードの管理コンソールに管理者ユーザーとしてログインします。

ステップ 3

クラスタにインストールされている既存のサービスを無効にします。

（注）  

 

クラスタのアップグレードをする前にすべてのサービスを無効化する必要があります。サービスを無効にしても、サービスを削除しないでください。無効化されたサービスは、アップグレード プロセスが完了すると自動的に再アクティブ化されます。

  1. メイン ナビゲーション メニューから、[サービス（Services）]（リリース 2.3.2）または [操作（Operate）] > [サービス（Services）]（リリース 3.0.1 以降）を選択します。

  2. サービスのタイルで、アクション（…）メニューをクリックし、[無効化（Disable）] を選択します。

  3. クラスタに展開されているすべてのサービスについて、この手順を繰り返します。

ステップ 4

クラスタから既存のアップグレード イメージを削除します。

クラスタを初めてアップグレードする場合は、この手順をスキップできます。

以前にクラスタを現在のバージョンにアップグレードしたことがある場合は、以前のアップグレード イメージをすべて削除する必要があります。

（注）  

 

リリース 2.3.2 では、このページは代わりに [操作（Operations）] > [ファームウェア管理（Firmware Management）] の下にあります。

  1. [管理（Admin）] > [ソフトウェア管理（Software Management）] に移動します。

  2. [イメージ] タブを選択します。

  3. 既存のアップグレード イメージの横にあるアクション メニュー（...）から、[イメージの削除（Delete Image）] を選択します。

  4. すべての既存のアップグレード イメージについて、この手順を繰り返します。

ステップ 5

新しいイメージをクラスタにアップロードします。

  1. [管理（Admin ）] > [ソフトウェアの管理（Software Management）]ページの [イメージ（Images）] タブで、[イメージの追加（Add Image）] をクリックします。

  2. [ソフトウェアイメージの追加（Add Software Image）] ウィンドウで、イメージがマシン上で [ローカル（Local）] であるか、Web サーバー上の [リモート（Remote）] であるかを選択します。

  3. [ファイルの選択（Choose file）] をクリックするか、最初の手順でダウンロードしたイメージの URL を入力します。

  4. [アップロード（Upload）] をクリックして、イメージを追加します。

  5. イメージ ステータスが「ダウンロード済み」に変わるのを待ちます。

    イメージが Nexus ダッシュボード クラスタにアップロードされ、解凍されて処理され、アップグレードに使用できるようになります。プロセス全体に数分かかる場合があり、[イメージ（Images）] タブでプロセスのステータスを確認できます。

ステップ 6

アップグレードをセットアップします。

  1. [管理（Admin）] > [ソフトウェア管理（Software Management）] に移動します。

    （注）  

     

    リリース 2.3.2 では、このページは代わりに [操作（Operations）] > [ファームウェア管理（Firmware Management）] の下にあります。

  2. [更新] タブを選択します。

  3. [更新の設定（Set Up Update）] をクリックします。

    （注）  

     

    以前にクラスタをアップグレードしたことがある場合、ページには代わりに以前のアップグレードの詳細が表示されます。その場合は、ページの右上にある [詳細の変更（Modify Details）] ボタンをクリックして、新しいアップグレード情報を提供します。

    [ファームウェアの更新（Update Firmware）] ダイアログボックスが開きます。

  4. [セットアップ（Setup）] > [バージョン選択（Version selection）] 画面で、アップロードしたファームウェア バージョンを選択し、[次へ（Next）] をクリックします。

  5. [セットアップ（Setup）] > [確認（Confirmation）] 画面で、詳細を確認し、[検証（Validate）] をクリックします。

    セットアップは、アップグレードを確実に成功させるために、いくつかの準備段階と検証段階を経ます。終了するまでに数分かかる場合があります。

  6. 検証が完了したら、[インストール（Install）] をクリックします。

    インストールの進行状況ウィンドウが表示されます。更新中は、この画面から移動できます。後で更新ステータスを確認するには、[ソフトウェア管理（Software Management）] 画面に移動し、[続行（Continue）] をクリックします。

    このステップには最大 20 分間かかります。これにより、必要な Kubernetes イメージとサービスがセットアップされますが、クラスタは新しいバージョンに切り替わりません。次の手順で新しいイメージをアクティブ化するまで、クラスタは既存のバージョンを実行し続けます。

ステップ 7

新しい画像をアクティブにします。

アップグレード画面から移動したことがない場合は、[アクティブ化（Activate）] をクリックして新しいイメージをアクティブ化します。

  1. 移動したことがある場合には、[管理（Admin）] > [ソフトウェア管理（Software Management）]に移動します。

    リリース 2.3.2 では、このページは代わりに [操作（Operations）] > [ファームウェア管理（Firmware Management）] の下にあります。

  2. [最終更新ステータス（Last Update Status）] タイルで、[続行（Continue）] をクリックします。

  3. [ファームウェア アップデート（Firmware Update）] > [インストール（Install）] 画面で、[アクティブ化（Activate）] をクリックします。

    [アクティブ化（Activate）] をクリックすると、クラスタはバックグラウンド サービスを停止します。これには数分かかる場合があります。その後、再起動します。アクティブ化の段階ですべてのノードが同時に再起動し、ノードの再起動後にすべてのクラスタサービスが開始されるので、GUI が使用可能になるまでにさらに最大 20 分かかる場合があることに注意してください。

    [概要（Overview）] ページで進行状況とサービスステータスを確認できます。

    アップグレードが完了すると、既存のサービスが [概要（Overview）] ページ に [正常（ Healthy）] と表示されます。

ステップ 8

(オプション) 新しい UCS-C225-M6 ハードウェアに移行します。

（注）  

 

Nexus ダッシュボード ノードを新しい UCS-C225-M6 サーバーに置き換える予定がない場合は、この手順をスキップできます。

UCS-C220-M5 ハードウェアを使用して展開された既存の Nexus ダッシュボード クラスタを移行するには、新しい UCS-C225-M6 ノードを stadby ノードとして既存のクラスタに追加し、古いノードの 1 つをフェイルオーバーするだけです。次に、古いクラスターの残りのノードについて、一度に 1 ノードずつプロセスを繰り返します。スタンバイ ノードの追加と使用については、Nexus Dashboard ドキュメント ライブラリの「インフラストラクチャ管理」の記事で詳しく説明されています。

アップグレードのトラブルシューティング

前のセクションで説明した、新しいイメージのアクティブ化段階で、すべてのノードが再起動した後、GUI にログインしてアップグレードワークフローのステータスを確認できます。最初は、クラスタの初期展開と同様のブートストラッププロセスを確認できます。ノードが起動すると、GUI の [概要（Overview）] ページでサービスのアクティブ化に関する追加情報を確認できます。

何らかの理由でアップグレードが失敗した場合、GUI にエラーと追加の回避策の手順が表示されます。それでも、GUI を使用して問題を解決できなかった場合は、 rescue-user としてノードにログインし、このセクションで説明されているコマンドを実行することで、手動でアップグレードを再試行できます。

手順

ステップ 1

すべての Nexus Dashboard クラスタ ノードに rescue-user としてログインします。

すべてのノードで同時にリカバリコマンドを実行する必要があるため、次の手順に進む前に各ノードにログインしてください。

ステップ 2

すべてのノードに rescue-user としてログインしていることを確認します。

ステップ 3

特定のシナリオに応じて必要なコマンドを実行します。

1 つ以上のノードが再起動せず、古いリリースがまだ実行されているためにアップグレードに失敗する場合は、手動アップグレードを試行できます。ただし、手動アップグレードには Cisco TAC のみが生成できるルートアクセスが必要なため、Cisco TAC に連絡して手動アップグレードのサポートを受ける必要があります。

ステップ 4

すべてのノードでインストーラが完了するまで待ちます。

ステップ 5

acs reboot コマンドを使用して、すべてのノードを同時に再起動します。

ノードの再起動後、UI にログインして、通常の UI ベースのアップグレードと同様にブートストラップの進行状況を確認できます。

ステップ 6

ノードのアップグレード タスクが完了したら、ノードが正常であり、UI にログインできることを確認します。

ブートストラップ プロセスが完了すると、通常どおりに Nexus Dashboard ダッシュボード UI を表示できます。

[概要（Overview）] ページでシステム全体の正常性を確認し、[管理（Manage）] > [ソフトウェアの管理（Software Management）]ページで現在の実行中バージョンを確認できます。

さらに、[分析（Analyze）] > [サービス ステータス（Service Status ）]ページで、サービスのステータスを確認します。