完全管理ノードのアップグレードの実行

5 完全管理ノードのアップグレードの実行

注意:

システム・アップグレードの準備ステップがすべて完了していることを確認します。手順は、「アプライアンスのアップグレードの準備」を参照してください。

完全な管理ノード・アップグレードは、1つのコマンドのみを使用して、3つの管理ノードすべてに必要なすべてのコンポーネントをアップグレードする便利な方法です。このプロセスの一環として、次のコンポーネントがこの特定の順序でアップグレードされます:

ホスト・オペレーティング・システム
クラスタ化されたMySQLデータベース
シークレット・サービス(EtcdおよびVaultを含む)
Kubernetesコンテナ・オーケストレーション・パッケージ
コンテナ化されたマイクロサービス
Oracle Cloud Infrastructureイメージ

注意:

新しいイメージがインポートされると、バックグラウンド・ジョブが起動され、実行中のOKEクラスタが、新しいイメージとともに提供される最新のCVE修正を受信するようになります。詳細は、「Oracle Cloud Infrastructureイメージのアップグレード」を参照してください。

ノート:

ソフトウェア・バージョン3.0.2-b892153以降では、アップグレード前のプロセス中に生成された「アップグレード計画」を使用して、アップグレードする必要がある特定のコンポーネントを判別します。コンポーネントがすでに必須バージョンである場合、スキップされます。必要に応じて、「サービスWeb UI」または「サービスCLI」コマンド・オプションを使用して、同じバージョンのアップグレードを強制できます。次に例を示します: upgradeKubernetes force=True。

「サービスWeb UI」の使用

ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。
「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択します。

完全な管理ノードのアップグレードの場合は、アップグレードMNを選択します。

注意:

Oracleでは、最初の実行でverify-onlyオプションを使用することを強くお薦めします。これにより、各コンポーネントの検証ジョブが開始されます。実際のアップグレードを開始する前に、すべての検証ジョブを完了する必要があります。これには合計で約45分かかる場合があります。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを指定するJSON文字列を追加します。
- 代替ULNチャネル: このパラメータはパッチ適用に適用され、無視できます。
- 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。
- 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。
「要求の作成」をクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。

ノート:

アップグレード後に、アップグレード計画で管理ノードをリブートして変更を有効にする必要があると指定した場合、リブートはアップグレード・プロセスの一部として実行されます。管理者アクションは必要ありません。

アプライアンスでソフトウェア・バージョン3.0.2-b892153以前が実行されている場合は、アップグレード・プロセスの一部としてすべての管理ノードがリブートされます。

「サービスCLI」の使用

アップグレード・コマンドを検証専用モードで実行します。

注意:

Oracleでは、最初の実行でverify-onlyオプション(verifyOnly=True)を使用することを強くお薦めします。これにより、各コンポーネントの検証ジョブが開始されます。実際のアップグレードを開始する前に、すべての検証ジョブを完了する必要があります。これには合計で約45分かかる場合があります。

アップグレード・リクエストを検証専用モードで起動します。

PCA-ADMIN> upgradeFullMN verifyOnly=True
Data: Service request has been submitted. Upgrade Request Id = UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056

関連するアップグレード・ジョブを検索し、IDを確認します。

PCA-ADMIN> getUpgradeJobs requestId=UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056
Data:
  id                                      upgradeRequestId                           commandName         result
  --                                      ----------------                           -----------         ------
  1698788901590-oci_verify-38799          UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   oci_verify          Passed
  1698788685720-platform_verify-34138     UWS-20f69d05-9c43-4617-80a4-8cf8db5b8446   platform_verify     Passed
  1698788568097-kubernetes_verify-32571   UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   kubernetes_verify   Passed
  1698788265717-vault_verify-27153        UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   vault_verify        Passed
  1698787959640-etcd_verify-26413         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   etcd_verify         Passed
  1698787657287-mysql_verify-19656        UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   mysql_verify        Passed
  1698787353293-host_verify-18867         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed
  1698787049308-host_verify-12573         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed
  1698786925154-host_verify-36612         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed

アップグレード・ジョブ詳細のステータスを確認してください。

PCA-ADMIN> getUpgradeJob upgradeJobId=1698787353293-host_verify-18867
Data:
  Upgrade Request Id = UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056
  Name = host_verify
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_pcamn03_verify_2023_06_16-13.07.11.log
  Status = Passed

アップグレードの検証が正常に完了したら、実際の完全管理ノードのアップグレードを開始します。
```
PCA-ADMIN> upgradeFullMN
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
Data:
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1634579161548-oci-47486          UWS-39329657-1051-4267-8c5a-9314f8e63a64   oci           Passed
  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
Data:
  Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64
  Composition Id = 1
  Name = host
  Start Time = 2023-05-24T07:04:12
  End Time = 2023-05-24T07:05:22
  Pid = 27088
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2023_05_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 = 2023-05-24T17:04:16
[...]

getUpgradeJobコマンドの出力には、アップグレード・プロシージャ中に実行されるタスクに関する詳細情報が表示されます。説明、タイムスタンプ、期間、成功または失敗が表示されます。アップグレード操作が失敗するたびに、コマンド出力にはどのタスクが失敗したかが示されます。詳細なトラブルシューティングでは、コマンド出力開始の近くにあるロケーションにログ・ファイルを検索できます。

ノート:

アップグレード後に、アップグレード計画で管理ノードをリブートして変更を有効にする必要があると指定した場合、リブートはアップグレード・プロセスの一部として実行されます。管理者アクションは必要ありません。

アプライアンスでソフトウェア・バージョン3.0.2-b892153以前が実行されている場合は、アップグレード・プロセスの一部としてすべての管理ノードがリブートされます。