8.4.3.3 RoCEネットワーク・ファブリック・スイッチのpatchmgr構文

patchmgrを使用して、RoCEネットワーク・ファブリック・スイッチのソフトウェアを更新できます。

前提条件

patchmgrは、Oracle Linuxを実行しているOracle Exadataデータベース・サーバーまたはOracle Exadata以外のシステムである駆動システムで実行されます。これにより、中央のサーバーからpatchmgrを実行して、複数のOracle Exadataシステムを更新できます。

ノート:

Oracle Exadata System Softwareリリース19.3.9より前では、RoCEネットワーク・ファブリック・スイッチにパッチを適用するために、非rootユーザーとしてpatchmgrを実行する必要があります。

RoCEネットワーク・ファブリック・スイッチのpatchmgr構文


./patchmgr --roceswitches [roceswitch_list_file] 
    { --upgrade [--roceswitch-precheck] [--unkey] [--force] |
      --downgrade [--roceswitch-precheck] [--unkey] [--force] |
      --apply-config [--unkey] [--force] |
      --verify-config [ --newswitchlist new_list_file ] [--unkey] }
    [ -log_dir { absolute_path_to_log_directory | AUTO } ]

メイン引数

引数 説明
--roceswitches [roceswitch_list_file]

patchmgrがRoCEネットワーク・ファブリック・スイッチで機能することを指定します。

指定すると、スイッチのリスト・ファイルでRoCEネットワーク・ファブリック・スイッチが指定されます。

最も簡単な形式では、ファイルの各行には、1つのスイッチのホスト名またはIPアドレスが記載されています。この場合、各スイッチはシングルラックExadata環境のリーフ・スイッチと見なされます。次に例を示します:

rack1sw-rocea0
rack1sw-roceb0

各スイッチの構成タイプを指定するには、スイッチのリスト・ファイルで各スイッチのホスト名またはIPアドレスにコロン(:)とタグを付けます。次のタグがサポートされます。

  • leaf - シングル・ラック・システムのリーフ・スイッチを示します。タグが指定されていない場合、この構成タイプであると見なされます。
  • mspine - スパイン・スイッチを示します。1つのスパイン・スイッチ構成では、Exadata Secure RDMA Fabric Isolationがある場合とない場合の、シングル・ラック・システムとマルチラック・システムのすべてのスパイン・スイッチがサポートされます。
  • mleaf - マルチラックX8Mシステムのリーフ・スイッチを示します。
  • sfleaf - Exadata Secure RDMA Fabric Isolationのサポートが有効なシングル・ラック・システムのリーフ・スイッチを示します。
  • msfleaf - Exadata Secure RDMA Fabric Isolationのサポートが有効なマルチラックX8Mシステムのリーフ・スイッチを示します。
  • leaf23 - 23個のホスト・ポートを持つように構成されたシングル・ラック・システムのリーフ・スイッチを示します。この構成は、3つのデータベース・サーバーと11個のストレージ・サーバーを持つ8ソケット・システム(X8M-8以降)にのみ必要です。
  • mleaf23 - 23個のホスト・ポートを持つように構成されたマルチラック・システムのリーフ・スイッチを示します。この構成は、3つのデータベース・サーバーと11個のストレージ・サーバーを持つ8ソケットX8M-8システムにのみ必要です。
  • mleaf_u14 - 14個のスイッチ間リンクで構成されたマルチラック・システムのリーフ・スイッチを示します。これはX9M以降のモデル・システムの一般的なマルチラック・リーフ・スイッチ構成です。
  • msfleaf_u14 - Exadata Secure RDMA Fabric Isolationのサポートが有効になっている、14個のスイッチ間リンクで構成されたマルチラック・システムのリーフ・スイッチを示します。この構成は、Secure Fabricが有効になっているX9M以降のモデル・システムに必要です。
  • mleaf23_u13 - 23個のホスト・ポートと13個のスイッチ間リンクで構成されたマルチラック・システムのリーフ・スイッチを示します。この構成は、3つのデータベース・サーバーと11個のストレージ・サーバーを持つ8ソケットX9M-8システムにのみ必要です。

次に例を示します:

rack1sw-rocea0:leaf
rack1sw-roceb0:leaf

マルチラック構成の場合のみ、各スイッチに一意のループバック・オクテットも指定します。

ループバック・オクテットは、スイッチを一意に識別するスイッチ・ループバック・アドレスの最後のオクテットです。

各スイッチのループバック・オクテットを指定するには、ピリオド(.)と数値のループバック・オクテット値を、スイッチのリスト・ファイルのタグが付けられた各スイッチのエントリに追加します。

注意:

マルチラック構成のすべてのスイッチには、一意のループバック・オクテットが必要です。複数のスイッチが同じループバック・オクテットを使用すると、RoCEネットワーク・ファブリックは正しく機能しないため、システムが停止します。

リーフ・スイッチの場合、最初のループバック・オクテット値として101から開始し、次のように増分します:

  • 101 - ラック1の下位リーフ・スイッチ(次の例ではrack1sw-rocea0)

  • 102 - ラック1の上位リーフ・スイッチ(次の例ではrack1sw-roceb0)

  • 103 - ラック2の下位リーフ・スイッチ(次の例ではrack2sw-rocea0)

  • 104 - ラック2の上位リーフ・スイッチ(次の例ではrack2sw-roceb0)

  • 105 - ラック3の下位リーフ・スイッチ

  • 106 - ラック3の上位リーフ・スイッチなど。

スパイン・スイッチの場合、最初のループバック・オクテット値として201から開始し、次のように増分します:

  • 201 - ラック1のスパイン・スイッチ(次の例ではrack1sw-roces0)

  • 202 - ラック2のスパイン・スイッチ(次の例ではrack2sw-roces0)

  • 203 - ラック3のスパイン・スイッチ

  • 204 - ラック4のスパイン・スイッチなど。

たとえば、2ラックExadata X9Mシステムのスイッチのリスト・ファイルの内容は、次のようになります:

rack1sw-rocea0:mleaf_u14.101
rack1sw-roceb0:mleaf_u14.102
rack1sw-roces0:mspine.201
rack2sw-rocea0:mleaf_u14.103
rack2sw-roceb0:mleaf_u14.104
rack2sw-roces0:mspine.202

ファイル名を指定しない場合、このコマンドは、patchmgrを実行しているホストから検出されたすべてのRoCEネットワーク・ファブリック・スイッチで機能します。

--upgrade

RoCEネットワーク・ファブリック・スイッチのファームウェアをアップグレードします。

必要に応じて、スイッチ・アラートをOracle Auto Service Request (ASR)に伝播するクライアント・ソフトウェア・コンポーネントもインストールまたはアップグレードします。

ノート: 2022年8月のpatchmgrリリース以降、patchmgrRoCEネットワーク・ファブリックで追加の一連のチェックを実行します。これらのチェックは、ファームウェア・アップグレードの直前および--roceswitch-precheckオプションを使用した前提条件チェック時に行われます。これらのチェックにより、RoCEネットワーク・ファブリックの予期しない問題に関連する障害のリスクが軽減されます。たとえば、ストレージ・サーバー上のRoCEネットワーク・ファブリック・ポートのいずれかが停止している場合、唯一の動作可能なポートに接続されているスイッチがアップグレードのためにオフラインになると、ストレージ・サーバーは使用できなくなります。チェックが失敗した場合、patchmgrは問題を報告し、ただちに終了します。この場合、アップグレードを実行する前に、RoCEネットワーク・ファブリックの問題を修正する必要があります。

--downgrade

RoCEネットワーク・ファブリック・スイッチのファームウェアをダウングレードします。

ノート: 2022年8月のpatchmgrリリース以降、patchmgrRoCEネットワーク・ファブリックで追加の一連のチェックを実行します。これらのチェックは、ファームウェア・ダウングレードの直前および--roceswitch-precheckオプションを使用した前提条件チェック時に行われます。これらのチェックにより、RoCEネットワーク・ファブリックの予期しない問題に関連する障害のリスクが軽減されます。たとえば、ストレージ・サーバー上のRoCEネットワーク・ファブリック・ポートのいずれかが停止している場合、唯一の動作可能なポートに接続されているスイッチがアップグレードのためにオフラインになると、ストレージ・サーバーは使用できなくなります。チェックが失敗した場合、patchmgrは問題を報告し、ただちに終了します。この場合、ダウングレードを実行する前に、RoCEネットワーク・ファブリックの問題を修正する必要があります。

--apply-config

各スイッチにゴールデン構成テンプレートを適用します。

このオプションは、スイッチごとの構成タイプを指定するスイッチのリスト・ファイル内のタグに依存します。

--verify-config [ --newswitchlist new_list_file ]

各スイッチ構成をゴールデン構成に対して検証します。

検証は、--upgradeまたは--downgradeを使用するときに自動的に実行されます。このオプションを使用して、スタンドアロン操作として検証を実行できます。

指定した場合、--newswitchlistオプションによって、各スイッチの現在の構成に一致するエントリを含む、新しいスイッチのリスト・ファイルが生成されます。

サポートされているオプション

次のオプションは、RoCEネットワーク・ファブリック・スイッチの構成およびファームウェアの更新でサポートされています。

表8-5 RoCEネットワーク・ファブリック・スイッチのpatchmgrオプション

オプション 説明
--roceswitch-precheck リスト・ファイル内のRoCEネットワーク・ファブリック・スイッチでスイッチ・ファームウェアのアップグレードまたはダウングレード・シミュレーションを実行しますが、実際のインストールは実行しません。このオプションは、--upgradeまたは--downgradeとともに使用します。
--unkey

このオプションを--upgradeまたは--downgradeと組み合せると、RoCEネットワーク・ファブリック・スイッチへのパスワードなしSSHアクセスを有効にする構成設定が削除されます。

--force

このオプションを--upgradeまたは--downgradeと組み合せると、スイッチがすでにターゲット・ファームウェア・バージョンにある場合や、RoCEネットワーク・ファブリック・スイッチに重大でない障害が発生している場合でも、アップグレードまたはダウングレードを続行します。

このオプションを--apply-configと組み合せると、現在のスイッチ構成がスイッチのリスト・ファイルで指定された構成タイプと一致するかどうかを判別するチェックがバイパスされます。

-log_dir ( absolute_path_to_log_directory | AUTO )

patchmgrをroot以外のユーザーとして実行する場合は、-log_dirを使用して、ログ・ディレクトリへの絶対パスを指定するか、キーワードAUTOを使用します。AUTOを指定すると、patchmgrによって、patchmgrの起動元ディレクトリとノード・リスト・ファイルのコンテンツに基づいて、ログ・ディレクトリへのパスが生成および設定されます。

ノート: -log_dirの指定は、root以外のユーザーとしてパッチ・マネージャを実行する場合に必要であり、これを指定することによって複数のパッチ・マネージャ呼出しが有効になります。

使用上のノート

  • Oracle Exadata System Softwareリリース19.3以降では、オプションの先頭に--を付けます。このリリースより前のリリースでは、オプションの先頭に-を付けました。

例8-9 RoCEネットワーク・ファブリック・スイッチのファームウェアをアップグレードするためのpatchmgrの使用

この例では、すべての検出されたスイッチでアップグレードの前提条件チェックを実行してから、スイッチをアップグレードします。

$ ./patchmgr --roceswitches --upgrade --roceswitch-precheck

$ ./patchmgr --roceswitches --upgrade

例8-10 RoCEネットワーク・ファブリック・スイッチにゴールデン構成を適用するためのpatchmgrの使用

この例では、switches.lstファイルで指定されたとおりに、ゴールデン構成の設定をRoCEネットワーク・ファブリック・スイッチに適用します。この操作のログは/tmp/switchlogsに書き込まれます。

$ cat switches.lst
switch456-rocea0:leaf          
switch456-roceb0:leaf          

$ ./patchmgr --roceswitches switches.lst --apply-config –log_dir /tmp/switchlogs