第7章 システムのアップグレード
この章では、管理者がOracle Private Cloud Applianceまたはそのコンポーネントの1つをアップグレードする方法について説明します。
「しない」:アプライアンス・コンポーネントに個々のパッケージをインストールまたはアップグレードします。 この章で説明するアップグレードのみがサポートされています。 セキュリティおよびその他の更新は、パッチを介して提供されます。 パッチ適用はアップグレード機能とは別に、ULNミラーを使用して、サポートされているパッケージを管理ノードの共有ストレージにダウンロードします。
アップグレードおよびパッチ適用機能の実装の詳細および技術的なバックグラウンド情報は、「Oracle Private Cloud Appliance概要ガイド」にあります。 「アプライアンス管理の概要」の章の「アップグレード」および「パッチ適用」の項を参照してください。
パッチ適用手順は、別のドキュメントに記載されています。 「Oracle Private Cloud Applianceパッチ適用ガイド」を参照してください。
7.1 アップグレード要件
アップグレード手順を開始する前に、必要な権限があり、ISOイメージを適切なロケーションにダウンロードしたことを確認してください。
7.1.1 権限の確認
アップグレードを実行するには、サービス・エンクレーブにログインするための管理者アカウントが必要です。 これらの認可グループのいずれかのメンバーである必要があります: SuperAdmin、AdminまたはDR Admin。 詳細は、「第3章 管理者アカウント管理」を参照してください。
Service CLIにログインすると、すべてのカスタム・コマンドを表示して、アップグレード・コマンドが使用可能であることを確認できます。 コマンドのリストは、アクセス・プロファイルに基づいてフィルタ処理されます。 アップグレード・コマンドがリストされている場合は、実行する権限があることを意味します。
PCA-ADMIN> showallcustomcmds Operation Name: <Related Object(s)> ----------------------------------- [...] getUpgradeJob: UpgradeJob getUpgradeJobs: UpgradeJobList getUpgradeRequests: UpgradeRequest killUpgradeJob: UpgradeJob [...] upgradeCN: UpgradeRequest upgradeEtcd: UpgradeRequest upgradeFullMN: UpgradeRequest upgradeHost: UpgradeRequest upgradeIlom: UpgradeRequest upgradeKubernetes: UpgradeRequest upgradeMySQL: UpgradeRequest upgradePlatform: UpgradeRequest upgradeSwitch: UpgradeRequest upgradeVault: UpgradeRequest upgradeZfssa: UpgradeRequest
7.1.2 ISOイメージの準備
Oracle Private Cloud Applianceのソフトウェア・バージョンおよびアップグレードは、My Oracle Supportを使用してダウンロードできます。 ISOファイルには、アプライアンスのハードウェアおよびソフトウェア・コンポーネントを特定のリリースにアップグレードするために必要なすべてのファイルとパッケージが含まれています。 ISOファイル内のすべてのアイテムが相互に動作することをテストされ、ラック・システムへの取り付けが認定されています。
ISOファイルを使用してアプライアンスをアップグレードできるようにするには、webサーバーがOracle Private Cloud Appliance管理ノードで使用可能にできるロケーションにファイルをダウンロードすることのみが必要です。 アプライアンスの内部管理ネットワークに接続された要塞ホストを設定した場合は、そのマシンにISOファイルを格納し、webサーバーを実行して、ISOファイルをhttp経由でアクセス可能にすると便利です。
アプライアンスでアップグレード・コマンドを実行すると、ISOファイルのパスをパラメータとして指定します。 この時点で、ISOファイルは3つすべての管理ノードにマウントされた共有ストレージにコピーされ、明確に定義されたディレクトリ構造に展開されます。 これらのステップは、事前に手動で実行する必要はありません。
7.1.3 システムが準備完了状態であることの確認
アップグレードは、システムへの影響を限定して実行できます。 ダウンタイムは不要で、基礎となるインフラストラクチャが段階的にアップグレードされている間、ユーザー・ワークロードは引き続き実行されます。 ただし、システムのバックアップおよび環境内のリソースを確実に作成することをお薦めします。
すべてのアップグレード操作の前に、事前チェックのセットがあります。 アップグレードは、すべての事前チェックに合格した場合にのみ開始されます。 事前チェックは手動で実行する必要はありません。アップグレード・コードに組み込まれており、システムがアップグレードに必要な状態でない場合はエラーをレポートします。
同時アップグレード操作はサポートされていないことに注意してください。 アップグレード・ジョブは、新しいジョブを開始する前に完了する必要があります。
7.2 完全管理ノードのアップグレードの実行
完全な管理ノード・アップグレードは、1つのコマンドのみを使用して、3つの管理ノードすべてに必要なすべてのコンポーネントをアップグレードする便利な方法です。 このプロセスの一環として、次のコンポーネントがこの特定の順序でアップグレードされます:
-
ホスト・オペレーティング・システム
-
MySQLクラスタ・データベース
-
シークレット・サービス(EtcdとVaultを含む)
-
Kubernetesコンテナ・オーケストレーション・パッケージ
-
コンテナ化されたマイクロサービス
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択します。
完全な管理ノードのアップグレードの場合は、アップグレードMNを選択します。
-
アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ISOチェックサム: ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: ISOイメージが保存されるロケーションへのパスを入力します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
コマンドを実行するために必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeFullMN imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
例:
PCA-ADMIN> upgradeFullMN \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeFullMN imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-24 06:56:31,871 UTC Data: Service request has been submitted. Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64 -
リクエストIDを使用して、アップグレード・プロセスのステータスを確認します。
完全な管理ノード・アップグレードはマルチ・コンポーネント・アップグレード・プロセスであるため、アップグレード・リクエストに複数のアップグレード・ジョブが関連付けられています。 リクエストIDに基づいて、これらのジョブに対してフィルタできます。 ジョブIDを使用して、各アップグレード・ジョブの詳細にドリルダウンできます。
PCA-ADMIN> getUpgradeJobs requestId=UWS-39329657-1051-4267-8c5a-9314f8e63a64 Command: getUpgradeJobs requestId=UWS-39329657-1051-4267-8c5a-9314f8e63a64 Status: Success Time: 2021-09-24 17:32:31,595 UTC Data: id upgradeRequestId commandName result -- ---------------- ----------- ------ 1634578760906-platform-66082 UWS-39329657-1051-4267-8c5a-9314f8e63a64 platform Passed 1634578263434-kubernetes-63574 UWS-39329657-1051-4267-8c5a-9314f8e63a64 kubernetes Passed 1634578012353-vault-51696 UWS-39329657-1051-4267-8c5a-9314f8e63a64 vault Passed 1634577380954-etcd-46337 UWS-39329657-1051-4267-8c5a-9314f8e63a64 etcd Passed 1634577341291-mysql-40127 UWS-39329657-1051-4267-8c5a-9314f8e63a64 mysql Passed 1634576985926-host-36556 UWS-39329657-1051-4267-8c5a-9314f8e63a64 host Passed 1634576652071-host-27088 UWS-39329657-1051-4267-8c5a-9314f8e63a64 host Passed 1634576191050-host-24909 UWS-39329657-1051-4267-8c5a-9314f8e63a64 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1634576652071-host-27088 Command: getUpgradeJob upgradeJobId=1634576652071-host-27088 Status: Success Time: 2021-09-24 17:35:59,946 UTC Data: Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64 Composition Id = 1 Name = host Start Time = 2021-09-24T07:04:12 End Time = 2021-09-24T07:05:22 Pid = 27088 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2021_09_24-07.04.12.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.35","result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"file:///nfs/shared_storage/pca-3.0.1-b544818.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":"1","request_id":"UWS-39329657-1051-4267-8c5a-9314f8e63a64","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 139 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-10-18T17:04:16 [...]
getUpgradeJob
コマンドの出力には、アップグレード・プロシージャ中に実行されるタスクに関する詳細情報が表示されます。 説明、タイムスタンプ、期間、成功または失敗が表示されます。 アップグレード操作が失敗するたびに、コマンド出力にはどのタスクが失敗したかが示されます。 詳細なトラブルシューティングでは、コマンド出力開始の近くにあるロケーションにログ・ファイルを検索できます。
7.3 個々のコンポーネントのアップグレード
粒度の細かいアップグレード・メカニズムを使用すると、個々のハードウェアおよびソフトウェア・コンポーネントのアップグレード手順を実行できます。 管理ノードのアップグレードに含まれるコンポーネントのほかに、さまざまな種類のファームウェア、およびコンピュート・ノード上のオペレーティング・システムやアプライアンス固有のソフトウェアをアップグレードすることもできます。
7.3.1 管理ノード・オペレーティング・システムのアップグレード
管理ノードのOracle Linuxホスト・オペレーティング・システムは、一度に1つのノードずつアップグレードする必要があります。すべての管理ノードのローリング・アップグレードはできません。 カーネル・パッケージおよびシステム・パッケージの更新を含むこのアップグレード・プロセスは、常にクラスタの仮想IPを保持する管理ノードから開始する必要があります。 したがって、3つの管理ノード・クラスタで2つの管理ノードをアップグレードした場合、クラスタ仮想IPをアップグレード済みの管理ノードの1つに再割り当てし、そのノードから最終的なアップグレード・コマンドを実行する必要があります。
管理ノードは、それぞれ1つの内部IPアドレスをコマンド・パラメータとして使用して、一度に1つずつアップグレードする必要があります。 ホストIPアドレスを取得するには、サービスCLIコマンドshow ManagementNode name=<node_name>
を使用して、出力でIp Address
を探します。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: ホストをアップグレードします。
-
アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ホストIP: 内部管理ネットワークで管理ノードに割り当てられたIPアドレスを入力します。 これは、内部の100.96.2.0/23範囲のIPアドレスです。
-
ISOチェックサム: ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: ISOイメージが保存されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
コマンドを実行するために必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
ホスト・オペレーティング・システムをアップグレードする予定の管理ノードのIPアドレス
-
-
管理クラスタの仮想IPを保持する管理ノードからサービスCLIを実行します。
-
管理ノードのいずれかにログオンし、クラスタのステータスを確認します。
# ssh root@pcamn01 # pcs status Cluster name: mncluster Stack: corosync Current DC: pcamn02 (version 1.1.23-1.0.1.el7-9acf116022) - partition with quorum Online: [ pcamn01 pcamn02 pcamn03 ] Full list of resources: scsi_fencing (stonith:fence_scsi): Stopped (disabled) Resource Group: mgmt-rg vip-mgmt-int (ocf::heartbeat:IPaddr2): Started pcamn02 vip-mgmt-host (ocf::heartbeat:IPaddr2): Started pcamn02 vip-mgmt-ilom (ocf::heartbeat:IPaddr2): Started pcamn02 vip-mgmt-lb (ocf::heartbeat:IPaddr2): Started pcamn02 vip-mgmt-ext (ocf::heartbeat:IPaddr2): Started pcamn02 l1api (systemd:l1api): Started pcamn02 haproxy (ocf::heartbeat:haproxy): Started pcamn02 pca-node-state (systemd:pca_node_state): Started pcamn02 dhcp (ocf::heartbeat:dhcpd): Started pcamn02 hw-monitor (systemd:hw_monitor): Started pcamn02 Daemon Status: corosync: active/enabled pacemaker: active/enabled pcsd: active/enabled
この例では、コマンド出力は、ホスト名が
pcamn02
のノードが現在クラスタ仮想IPを保持していることを示しています。 -
仮想IPを使用して管理ノードにログインし、サービスCLIを起動します。
# ssh pcamn02 # ssh admin@localhost -p 30006 PCA-ADMIN>
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeHost imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
hostIp=<management-node-ip>
例:
PCA-ADMIN> upgradeHost hostIp=100.96.2.35 \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeHost hostIp=100.96.2.35 imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-25 05:47:02,735 UTC Data: Service request has been submitted. Upgrade Job Id = 1632990827394-host-56156 Upgrade Request Id = UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632990827394-host-56156 UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632990827394-host-56156 Command: getUpgradeJob upgradeJobId=1632990827394-host-56156 Status: Success Time: 2021-09-25 05:54:28,054 UTC Data: Upgrade Request Id = UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 Composition Id = 1 Name = host Start Time = 2021-09-25T05:47:02 End Time = 2021-09-25T05:48:38 Pid = 56156 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2021_09_25-05.47.02.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.35","result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":"1","request_id":"UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 96 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-09-25T05:47:02 Tasks 2 - Name = Validate Image Location [...]
-
最初の管理ノードのホスト・オペレーティング・システムのアップグレードが正常に完了したら、次の管理ノードに対して同じコマンドを実行します。
PCA-ADMIN> upgradeHost hostIp=100.96.2.33 \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 -
2番目の管理ノードのホスト・オペレーティング・システムのアップグレードが正常に完了したら、サービスCLIを終了し、クラスタの仮想IPをアップグレードされたノードのいずれかに移動します。
PCA-ADMIN> exit Connection to localhost closed. # pcs resource move mgmt-rg pcamn01 # pcs status Cluster name: mncluster Stack: corosync [...] scsi_fencing (stonith:fence_scsi): Stopped (disabled) Resource Group: mgmt-rg vip-mgmt-int (ocf::heartbeat:IPaddr2): Started pcamn01 vip-mgmt-host (ocf::heartbeat:IPaddr2): Started pcamn01 [...]
クラスタ仮想IPを別の管理ノードに移動する場合は、数秒のみかかります。
-
仮想IPを使用して管理ノードにログインし、サービスCLIを起動して、最終的な管理ノードのホスト・オペレーティング・システムのアップグレードを実行します。
# ssh pcamn01 # ssh admin@localhost -p 30006 PCA-ADMIN> upgradeHost hostIp=100.96.2.34 \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7このアップグレードが正常に完了すると、すべての管理ノードのオペレーティング・システムが最新です。
7.3.2 MySQLクラスタ・データベースのアップグレード
MySQLクラスタ・データベースは、管理ノードのホスト・オペレーティング・システムとは別にアップグレードされます。MySQLパッケージは、意図的にOracle Linuxアップグレードとは別に保持されます。
管理ノードのホスト・オペレーティング・システムのアップグレード後にデータベースのアップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで展開されているため、ISOパスとチェックサムは、データベース・アップグレード・コマンドの必須パラメータとは見なされません。 ただし、データベース・アップグレードの前にホスト・オペレーティング・システムのアップグレードがない場合は、データベース・アップグレードを起動できるようにISOパスおよびチェックサム・パラメータを含める必要があります。
MySQLクラスタ・データベースのアップグレードはローリング・アップグレードです: 1つのコマンドで、3つの管理ノードそれぞれでアップグレードが実行されます。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: MySQLをアップグレードします。
-
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeMySQL imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
例:
PCA-ADMIN> upgradeMySQL \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeMySQL imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-25 09:21:16,264 UTC Data: Service request has been submitted. Upgrade Job Id = 1632995409822-mysql-83013 Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力:
upgradeMySQL
。 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632995409822-mysql-83013 UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1 mysql Passed 1632926926773-host-32993 UWS-fef3b663-45b7-4177-a041-26f73e68848d host Passed 1632990827394-host-56156 UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 host Passed 1632990493570-host-6646 UWS-4c78f3ef-ac42-4f32-9483-bb43a309faa3 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632995409822-mysql-83013 Command: getUpgradeJob upgradeJobId=1632995409822-mysql-83013 Status: Success Time: 2021-09-25 09:24:27,874 UTC Data: Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1 Name = mysql Start Time = 2021-09-25T09:21:16 End Time = 2021-09-25T09:22:04 Pid = 83013 Host = pcamn01 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_mysql_cluster_2021_09_25-09.21.16.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 48 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-09-25T09:21:16 [...]
7.3.3 シークレット・サービスのアップグレード
シークレット・サービスには、個別にアップグレードする必要がある2つのコンポーネントが含まれています: EtcdとVault。 それらをアップグレードする順序は関係ありません。
管理ノードのホスト・オペレーティング・システムのアップグレード後にシークレット・サービスのアップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで展開されているため、ISOパスとチェックサムは、シークレット・サービスのアップグレード・コマンドの必須パラメータとは見なされません。 ただし、ホスト・オペレーティング・システムのアップグレードがまだ実行されていない場合は、ISOパスおよびチェックサム・パラメータを含める必要があります。
EtcdとVaultのアップグレードは、ローリング・アップグレードです: 各アップグレードは、3つの管理ノードすべてで1つのコマンドで実行されます。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: Etcdをアップグレードします。
-
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
Etcdのアップグレードが正常に完了したら、この手順を繰り返してボールトのアップグレード・リクエストを作成します。
-
管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
-
2つのアップグレード・コマンドを入力します。 1つのアップグレードが終了するまで待ってから、2番目のコマンドを入力します。
構文(1行に入力):
upgradeEtcd imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
upgradeVault imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
例:
PCA-ADMIN> upgradeEtcd \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeEtcd imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-25 10:24:52,177 UTC Data: Service request has been submitted. Upgrade Job Id = 1632826770954-etcd-26973 Upgrade Request Id = UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284 PCA-ADMIN> upgradeVault \ imageLocation="http://host.example.com/pca-<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeVault imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-25 10:38:25,417 UTC Data: Service request has been submitted. Upgrade Job Id = 1632850933353-vault-16966 Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータなしでコマンドを入力するだけです:
upgradeEtcd
およびupgradeVault
。 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632995409822-mysql-83013 UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1 mysql Passed 1632850933353-vault-16966 UWS-352df3d1-c21f-441b-8f6e-9381ac075906 vault Passed 1632826770954-etcd-26973 UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284 etcd Passed 1632926926773-host-32993 UWS-fef3b663-45b7-4177-a041-26f73e68848d host Passed 1632990827394-host-56156 UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 host Passed 1632990493570-host-6646 UWS-4c78f3ef-ac42-4f32-9483-bb43a309faa3 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632850933353-vault-16966 Command: getUpgradeJob upgradeJobId=1632850933353-vault-16966 Status: Success Time: 2021-09-25 10:39:31,308 UTC Data: Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906 Name = vault Start Time = 2021-09-25T10:38:25 End Time = 2021-09-25T10:39:07 Pid = 16966 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_vault_2021_09_25-10.38.25.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-352df3d1-c21f-441b-8f6e-9381ac075906","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 42 Tasks 1 - Name = Check Vault Running Status Tasks 1 - Description = Check vault service running status is healthy Tasks 1 - Time = 2021-09-25T10:38:25 [...]
7.3.4 ファームウェアのアップグレード
ファームウェアは、すべてのコンポーネントILOM、ZFS Storage Appliance、およびスイッチのISOイメージに含まれています。 アップグレードするコンポーネント・タイプについて、次の指示を選択します。
ILOMのアップグレード
ILOMのアップグレードは、管理ノードおよびコンピュート・ノードに適用できます。 ファームウェア・パッケージはコンポーネント・タイプごとに異なる可能性があるため、ファームウェア・ディレクトリから正しいパッケージを選択してください。 各内部IPアドレスをコマンド・パラメータとして使用して、ILOMを一度に1つずつアップグレードする必要があります。
ILOM IPアドレスを取得するには、サービスCLIコマンドshow ComputeNode name=<node_name>
またはshow ManagementNode name=<node_name>
を使用して、出力でILOM Ip Address
を探します。
管理仮想IPアドレスを保持する管理ノードのILOM、つまりクラスタ内のプライマリ・ロールをアップグレードしないでください。 ILOMをアップグレードするには、まず、クラスタ内の別のノードがプライマリ・ロールを引き継ぐために、問題の管理ノードをリブートします。 ノードが完全にリブートしたら、ILOMのアップグレードを続行できます。
クラスタ内のプライマリ・ロールを持つ管理ノードを確認するには、任意の管理ノードにログインし、コマンドpcs status
を実行します。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: Ilomをアップグレードします。
-
アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ホストIP: ILOMネットワークにコンポーネントに割り当てられたIPアドレスを入力します。 これは、内部の100.96.0.0/23範囲のIPアドレスです。
-
イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ILOMファームウェアは、解凍されたISOイメージの
/pca_firmware/
サブディレクトリに<component>
/*.pkg
ファイルとして格納されます。 -
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
コマンドを実行するために必要な情報を収集します:
-
ファームウェアをアップグレードするILOMのIPアドレス
-
展開されたISOイメージ内のファームウェア・パッケージ・ファイルへのパス
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeIlom imageLocation=
<path-to-firmware>
hostIp=<ilom-ip>
例:
PCA-ADMIN> upgradeIlom \ imageLocation="http://host.example.com/iso/pca_firmware/X9-2/.../ILOM-
<version>
-ORACLE_SERVER_X9-2-rom.pkg" \ hostIp=100.96.0.66 Command: upgradeIlom imageLocation="http://host.example.com/iso/pca_firmware/X9-2/.../ILOM-<version>-ORACLE_SERVER_X9-2-rom.pkg" hostIp=100.96.0.66 Status: Success Time: 2021-09-24 11:18:31,044 UTC Data: Service request has been submitted. Upgrade Job Id = 1620921089806-ilom-21480 Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1620921089806-ilom-21480 UWS-732d6fce-9f06-4329-b972-d093bee40010 ilom Passed 1632926926773-host-32993 UWS-fef3b663-45b7-4177-a041-26f73e68848d host Passed 1632990827394-host-56156 UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 host Passed 1632990493570-host-6646 UWS-4c78f3ef-ac42-4f32-9483-bb43a309faa3 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1620921089806-ilom-21480 Command: getUpgradeJob 1620921089806-ilom-21480 Status: Success Time: 2021-09-24 11:24:49,243 UTC Data: Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010 Name = ilom Start Time = 2021-09-24 11:18:32 End Time = 2021-09-24 11:21:18 Pid = 21480 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_ilom_firmware_2021_09_24-11.18.31.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.0.66","result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"file:///nfs/shared_storage/pca_firmware/X9-2/.../ILOM-5_0_2_21_r140740-ORACLE_SERVER_X9-2-rom.pkg","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-732d6fce-9f06-4329-b972-d093bee40010","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 166 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-09-24T11:18:32 [...]
アップグレードの最後に、ILOM自体が自動的にリブートされます。 ただし、すべての変更を有効にするには、サーバー・コンポーネントもリブートする必要があります。 ILOMの正常なアップグレード後に管理ノードまたはコンピュート・ノードを手動でリブートするのは、管理者の責任です。
ZFS Storage Applianceオペレーティング・ソフトウェアのアップグレード
アプライアンスZFS Storage Applianceのオペレーティング・ソフトウェアをアップグレードするには、アンパックされたISOイメージ内のファームウェア・パッケージへのパスを指定するだけで済みます。 ストレージ・コントローラのIPアドレスがわかっているため、1つのアップグレード・コマンドによって両方のコントローラのローリング・アップグレードが開始されます。 2つのコントローラに新しいILOMファームウェア・バージョンが含まれている場合は、ストレージ・アプライアンスのアップグレード・プロセスの一部としてインストールされます。
アップグレードの進行中にストレージ構成を変更しないでください。 コントローラでさまざまなソフトウェアバージョンが実行されている場合は、どちらかのコントローラの構成を変更しても、そのピアコントローラには伝播されません。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: Zfssaをアップグレードします。
-
アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ZFS Storage Applianceオペレーティング・ソフトウェアは、解凍されたISOイメージの
/pca_firmware/zfs/
サブディレクトリに*.pkg
ファイルとして格納されます。 -
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
コマンドを実行するために必要な情報を収集: 開梱されたISOイメージ内のAK-NASファームウェア・パッケージへのパス。
-
アップグレード・コマンドを入力します。
構文:
upgradeZfssa imageLocation=
<path-to-firmware>
例:
PCA-ADMIN> upgradeZfssa imageLocation="file:///nfs/shared_storage/pca_firmware/zfs/ak-nas-
<version>
.pkg" Command: upgradeZfssa imageLocation="file:///nfs/shared_storage/pca_firmware/zfs/ak-nas-<version>
.pkg" Status: Success Time: 2021-09-27 11:15:07,453 UTC Data: Service request has been submitted. Upgrade Job Id = 1632914107346-zfssa-83002 Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632914107346-zfssa-83002 UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9 zfssa Passed 1632926926773-host-32993 UWS-fef3b663-45b7-4177-a041-26f73e68848d host Passed 1632990827394-host-56156 UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755 host Passed 1632990493570-host-6646 UWS-4c78f3ef-ac42-4f32-9483-bb43a309faa3 host Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632914107346-zfssa-83002 Command: getUpgradeJob upgradeJobId=1632914107346-zfssa-83002 Status: Success Time: 2021-09-27 11:42:10,729 UTC Data: Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9 Name = zfssa Start Time = 2021-09-29T11:15:07 End Time = 2021-09-29T11:26:42 Pid = 83002 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_zfssa_ak_2021_09_29-11.15.07.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"file:///nfs/shared_storage/pca_firmware/zfs/ak-nas-2021.08.27-1.0x-nondebug.pkg","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 697 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-09-29T11:15:08 [...]
スイッチ・ソフトウェアのアップグレード
アプライアンス・ラックには、Cisco Nexusスイッチの3つのカテゴリが含まれています: 管理スイッチ、2つのリーフ・スイッチ、および2つのスパイン・スイッチ。 すべて同じCisco NX-OSネットワーク・オペレーティング・ソフトウェアを実行します。 優先されるアップグレード順序は次のとおりです: 最初にリーフ・スイッチ、次にスパイン・スイッチ、最後に管理スイッチ。
ファームウェアをアップグレードする場合は、各アップグレード・コマンドで同じバイナリ・ファイルを使用します。 スイッチのカテゴリごとに1つのコマンドだけが必要です。つまり、リーフ・スイッチとスパイン・スイッチはペアでアップグレードされます。
ネットワーク・オペレーティング・ソフトウェアの一部のバージョンは、2つのファイルで構成されています: バイナリ・ファイルおよび追加のEPLD (電子プログラム可能ロジック・デバイス)イメージ。 新しいファームウェアにEPLDファイルが含まれている場合は、そのファイルがアップグレード・リクエストにも追加されていることを確認します。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: アップグレード・スイッチ。
-
アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
EPLD: このファームウェア・バージョンに必要な場合は、EPLDイメージ・ファイルが格納されているロケーションへのパスを入力します。 EPLDファイルが存在する場合、EPLDファイルは、解凍されたISOイメージの
/pca_firmware/network/cisco/
サブディレクトリにNX-OSオペレーティング・ソフトウェアとともに格納される*.img
ファイルです。 -
イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 Cisco NX-OSネットワーク・オペレーティング・ソフトウェアは、解凍されたISOイメージの
/pca_firmware/network/cisco/
サブディレクトリに*.bin
ファイルとして格納されます。 -
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
スイッチ・タイプ: アップグレードするスイッチ・タイプを選択します。 優先されるアップグレード順序は次のとおりです: 最初にリーフ・スイッチ、次にスパイン・スイッチ、最後に管理スイッチ。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
アップグレードが正常に完了したが、システム内のほかのスイッチをアップグレードする必要がある場合は、アップグレードが必要なほかのタイプのスイッチに対してこの手順を繰り返します。
-
コマンドを実行するために必要な情報を収集します:
-
アップグレードするウィッチのタイプ(スパイン、リーフ、管理)
-
開梱されたISOイメージ内のファームウェア・バイナリ・ファイルへのパス
-
新しいファームウェア・バージョンに存在する場合、解凍されたISOイメージ内のEPLDアップグレード・ファイルへのパス
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeSwitch switchType=[MGMT, SPINE, LEAF] imageLocation=
<path-to-firmware>
(epld=<path-to-epld-file>
)例:
PCA-ADMIN> upgradeSwitch switchType=LEAF \ imageLocation="http://host.example.com/iso/pca_firmware/network/cisco/nxos.
<version>
.bin" \ epld="http://host.example.com/iso/pca_firmware/network/cisco/n9000-epld.<version>
.img" Command: upgradeSwitch switchType=LEAF imageLocation="file:///nfs/shared_storage/pca_firmware/network/cisco/nxos.<version>
.bin" epld="file:///nfs/shared_storage/pca_firmware/network/cisco/n9000-epld.<version>
.img" Status: Success Time: 2021-09-24 14:16:54,704 UTC Data: Service request has been submitted. Upgrade Job Id = 1630511206512-cisco-20299 Upgrade Request Id = UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632914107346-zfssa-83002 UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9 zfssa Passed 1630511206512-cisco-20299 UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3 cisco Passed 1620921089806-ilom-21480 UWS-732d6fce-9f06-4329-b972-d093bee40010 ilom Passed PCA-ADMIN> getupgradeJob upgradeJobId=1630511206512-cisco-20299 Command: getupgradeJob upgradeJobId=1630511206512-cisco-20299 Status: Success Time: 2021-09-24 15:48:08,455 UTC Data: Upgrade Request Id = UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3 Name = cisco Start Time = 2021-09-24T14:46:46 End Time = 2021-09-24T14:59:44 Pid = 20299 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_cisco_firmware_2021_09_24-14.46.46.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":"LEAF","precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"file:///nfs/shared_storage/pca_firmware/network/cisco/nxos.9.3.2.bin","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 777 Tasks 1 - Name = Validate Image Location Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named Tasks 1 - Time = 2021-09-24T14:46:47 [...]
7.3.5 Kubernetesクラスタのアップグレード
Kubernetesコンテナ・オーケストレーション環境のアップグレードも、オペレーティング・システムとは別に保持されます。 単一のコマンドで、kubeadm、kubectlおよびkubeletなどのすべてのKubernetesパッケージが、3つの管理ノードおよびすべてのコンピュート・ノードでアップグレードされます。 このアップグレードには、Kubernetesコンテナで実行されているマイクロサービスは含まれません。
依存関係の理由から、管理ノードのホスト・オペレーティング・システムの後にKubernetesをアップグレードする必要があります。 そのため、共有ストレージでアップグレードISOイメージがすでに解凍されています。Kubernetesアップグレード・コマンドに必須パラメータはありません。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: Kubernetesをアップグレードします。
-
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeKubernetes imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
例:
PCA-ADMIN> upgradeKubernetes \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeKubernetes imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-26 17:20:09,423 UTC Data: Service request has been submitted. Upgrade Job Id = 1632849609034-kubernetes-35545 Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力:
upgradeKubernetes
。 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632849609034-kubernetes-35545 UWS-edfa3b32-c32a-4b67-8df5-2357096052bf kubernetes Passed 1632826770954-etcd-26973 UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284 etcd Passed 1632850933353-vault-16966 UWS-352df3d1-c21f-441b-8f6e-9381ac075906 vault Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632849609034-kubernetes-35545 Command: getUpgradeJob upgradeJobId=1632849609034-kubernetes-35545 Status: Success Time: 2021-09-26 17:43:38,443 UTC Data: Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf Name = kubernetes Start Time = 2021-09-26T17:20:09 End Time = 2021-09-26T17:21:52 Pid = 35545 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_kubernetes_cluster_2021_09_26-17.20.09.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-edfa3b32-c32a-4b67-8df5-2357096052bf","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 249 Tasks 1 - Name = Retrieving Cluster Status Tasks 1 - Description = Retrieving cluster status and upgrade data from the kubernetes nodes Tasks 1 - Time = 2021-09-26T17:20:10 [...]
7.3.6 マイクロサービスのアップグレード
マイクロサービス・アップグレードは、プラットフォーム・レイヤーの内部サービス、およびインフラストラクチャ・サービス・レイヤーを通じて公開される管理レベルとユーザー・レベルのサービスの両方をカバーします。
コンテナ化されたマイクロサービスには、独自のアップグレード・メカニズムがあります。 ISOイメージで新しいHelmデプロイメント・チャートとコンテナ・イメージが見つかった場合、サービスはアップグレードされます。 アップグレード・プロセス中に新しいデプロイメント・チャートが検出されると、サービスを実行しているポッドが新しいコンテナ・イメージで再起動されます。
管理ノードのホスト・オペレーティング・システムのアップグレード後にマイクロサービス・アップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで解凍されているため、マイクロサービス・アップグレード・コマンドのISOパスおよびチェックサムは必須パラメータとはみなされません。 ただし、ホスト・オペレーティング・システムのアップグレードがまだ実行されていない場合は、ISOパスおよびチェックサム・パラメータを含める必要があります。
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: プラットフォームをアップグレードします。
-
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradePlatform imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
例:
PCA-ADMIN> upgradePlatform \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradePlatform imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-26 20:48:41,452 UTC Data: Service request has been submitted. Upgrade Job Id = 1632850650836-platform-68465 Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力:
upgradePlatform
。 -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1632850650836-platform-68465 UWS-26dba234-9b52-426d-836c-ac11f37e717f platform Passed 1632849609034-kubernetes-35545 UWS-edfa3b32-c32a-4b67-8df5-2357096052bf kubernetes Passed 1632826770954-etcd-26973 UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284 etcd Passed 1632850933353-vault-16966 UWS-352df3d1-c21f-441b-8f6e-9381ac075906 vault Passed PCA-ADMIN> getUpgradeJob upgradeJobId=1632850650836-platform-68465 Command: getUpgradeJob 1632850650836-platform-68465 Status: Success Time: 2021-09-26 21:03:16,264 UTC Data: Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f Name = kubernetes Start Time = 2021-09-26T20:48:41 End Time = 2021-09-26T20:59:34 Pid = 68465 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_platform_services_2021_09_26-20.48.41.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-26dba234-9b52-426d-836c-ac11f37e717f","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 653 Tasks 1 - Name = Check All Ingress Endpoints Tasks 1 - Description = Check whether all ingress endpoints are up and running Tasks 1 - Time = 2021-09-26T20:48:42 [...]
7.3.7 コンピュート・ノードのアップグレード
コンピュート・ノードのアップグレードは、管理ノードのホスト・オペレーティング・システムのアップグレードに似ています: これにより、最新のOracle Linuxカーネルおよびユーザー領域パッケージと、アプライアンス固有の最適化によるovm-agent
パッケージがインストールされます。 コンピュート・ノードは一度に1つずつロックおよびアップグレードする必要があります。同時アップグレードはサポートされていません。 アップグレードが成功したら、コンピュート・ノードがリブートされたときに、管理者は手動でロックを削除して、ノードを通常の操作に戻すことができるようにする必要があります。
コンピュート・ノードのホストIPアドレスを取得するには、サービスCLIコマンドshow ComputeNode name=<node_name>
を使用して、出力でIp Address
を探します。
-
アップグレードしようとしているコンピュート・ノードのプロビジョニング・ロックとメンテナンス・ロックを設定します。
詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
-
ナビゲーション・メニューで、Rack Unitsをクリックします。 「ラック・ユニット」表で、アップグレードするコンピュート・ノードの名前をクリックして詳細ページを表示します。
-
コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、プロビジョニング・ロック・コマンドを選択します。
-
プロビジョニング・ロックが設定されたら、Controlsを再度クリックし、Maintenance Lockコマンドを選択します。
-
-
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
-
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。
Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: CNをアップグレード。
-
アップグレード・リクエスト・パラメータを入力します:
-
ホストIP: 内部管理ネットワークでコンピュート・ノードに割り当てられたIPアドレスを入力します。 これは、内部の100.96.2.0/23範囲のIPアドレスです。
-
ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は
.sha512sum
が付加されたISOイメージ名です。 -
イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
-
ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。
-
拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
-
-
Create Requestをクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
-
コンピュート・ノードが正常にアップグレードされたら、プロビジョニング・ロックおよびメンテナンス・ロックを解放します。
詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
-
コンピュート・ノードの詳細ページを開きます。
-
コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、Maintenance Unlockコマンドを選択します。
-
メンテナンス・ロックが解放されたら、制御を再度クリックし、プロビジョニング・ロック解除コマンドを選択します。
-
-
コマンドを実行するために必要な情報を収集します:
-
アップグレード元のISOイメージのロケーション
-
ISOイメージが有効であることを検証するために使用されるチェックサム
-
アップグレードするコンピュート・ノードのIPアドレス
-
-
アップグレードしようとしているコンピュート・ノードのプロビジョニング・ロックとメンテナンス・ロックを設定します。
詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
PCA-ADMIN> list ComputeNode Data: id name provisioningState provisioningType -- ---- ----------------- ---------------- 363a26f4-fa34-4e4c-8e17-a1671a0b77d1 pcacn001 Provisioned KVM 9e8745c7-52e3-4aae-984c-e198869ee2cc pcacn002 Provisioned KVM 56a9ecda-2402-427f-92d1-7f9be57dba36 pcacn003 Provisioned KVM PCA-ADMIN> provisioningLock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1 PCA-ADMIN> maintenanceLock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1
-
アップグレード・コマンドを入力します。
構文(1行に入力):
upgradeCN imageLocation=
<path-to-iso>
isoChecksum=<iso-file-checksum>
hostIp=<compute-node-ip>
例:
PCA-ADMIN> upgradeCN hostIp=100.96.2.64 \ imageLocation="http://host.example.com/pca-
<version>
-<build>
.iso" \ isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Command: upgradeCN hostIp=100.96.2.64 imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7 Status: Success Time: 2021-09-26 06:35:38,884 UTC Data: Service request has been submitted. Upgrade Job Id = 1630938939109-compute-7545 Upgrade Request Id = UWS-61736806-7e5a-4648-9259-07c54c39cacb -
リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。
PCA-ADMIN> getUpgradeJobs id upgradeRequestId commandName result -- ---------------- ----------- ------ 1630938939109-compute-7545 UWS-61736806-7e5a-4648-9259-07c54c39cacb compute Passed 1632850650836-platform-68465 UWS-26dba234-9b52-426d-836c-ac11f37e717f platform Passed 1632849609034-kubernetes-35545 UWS-edfa3b32-c32a-4b67-8df5-2357096052bf kubernetes Passed PCA-ADMIN> getupgradejob upgradeJobId=1630938939109-compute-7545 Command: getupgradejob upgradeJobId=1630938939109-compute-7545 Status: Success Time: 2021-09-26 08:15:03,208 UTC Data: Upgrade Request Id = UWS-61736806-7e5a-4648-9259-07c54c39cacb Name = compute Start Time = 2021-09-26T06:35:39 End Time = 2021-09-26T06:45:55 Pid = 7545 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_compute_2021_09_26-06.35.39.log Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.64","result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":null,"epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-61736806-7e5a-4648-9259-07c54c39cacb","display_task_plan":false,"dry_run_tasks":false} Status = Passed Execution Time(sec) = 616 Tasks 1 - Name = Copy Scripts Tasks 1 - Description = Copy scripts to shared storage Tasks 1 - Time = 2021-09-26T06:35:39 [...]
-
コンピュート・ノードのアップグレードが正常に完了し、ノードがリブートしたら、ロックを解除します。
詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
PCA-ADMIN> maintenanceUnlock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1 PCA-ADMIN> provisioningUnlock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1
-
次のコンピュート・ノードに進み、この手順を繰り返します。