システムの準備完了状態の確認

アップグレードは、システムへの影響を限定して実行できます。ダウンタイムは不要で、基礎となるインフラストラクチャが段階的にアップグレードされている間、ユーザー・ワークロードは引き続き実行されます。ただし、システムのバックアップおよび環境内のリソースを確実に作成することをお薦めします。

障害ログ

アップグレードの準備をするときは、システム障害ログを確認します。アップグレードおよびパッチ適用に対する潜在的な影響に関する問題は、「アップグレード・フォルト」としてフラグが付けられ、アップグレードまたはパッチ・コマンドの実行が妨げられます。「サービスCLI」は、次の例に示すように、これらのフォルトのフィルタリング・オプションを提供します:

PCA-ADMIN> list fault fields upgradeFault,Status,Severity
Data:
  id                                     Upgrade Fault   Status    Severity
  --                                     -------------   ------    --------
  37f6cefe-f7d5-49a8-adff-76c1a020bcc8   False           Cleared   Critical
  2be57600-4dbd-40f0-a0f8-e4ffbb2c8468   True            Active    Critical
  297c770e-16e1-11ef-9e78-a8698c107234   True            Cleared   Major
  d27e0895-eb87-4e66-bd4b-f6500153cf64   True            Cleared   Critical
  77752a35-4cf7-49ed-88df-06158d846358   True            Active    Critical
  9ff4fe22-8ed6-463f-95b5-458d6a76d185   False           Active    Critical
  0a09204c-953e-4df3-912b-a2a175ce8c1a   True            Cleared   Critical
[...]

PCA-ADMIN> list fault where upgradeFault EQ True
Data:
  id                                     Name                                        Status    Severity
  --                                     ----                                        ------    --------
  2be57600-4dbd-40f0-a0f8-e4ffbb2c8468   pcamn01--PCA-8000-44--asrclient             Active    Critical
  297c770e-16e1-11ef-9e78-a8698c107234   ilom-pcacn001--PCA-8000-EA--ilom-pcacn001   Cleared   Major
  0a09204c-953e-4df3-912b-a2a175ce8c1a   pcamn01--PCA-8000-AH--mysql_cluster         Cleared   Critical
  f7da7c82-03bc-4383-95cf-542cefbb5d39   pcamn01--PCA-8000-CD--mysql_cluster         Cleared   Critical
  74fd23ac-3006-4ab6-9c50-544869ba78f9   pcamn02--PCA-8000-6C--registry              Cleared   Critical
  dc77b088-939d-4725-b45f-1072024b02ba   pcamn02--PCA-8000-0E--etcd                  Cleared   Critical
  d27e0895-eb87-4e66-bd4b-f6500153cf64   pcamn01--PCA-8000-22--vault                 Cleared   Critical
  77752a35-4cf7-49ed-88df-06158d846358   pcamn01--PCA-8000-93--mysql_cluster         Active    Critical

事前チェック

すべてのアップグレード操作の前に、事前チェックのセットがあります。これらはアップグレード・コードに組み込まれており、システムがアップグレードに必要な状態でない場合、エラーを報告します。アップグレードは、すべての事前チェックに合格した場合にのみ開始されます。

事前チェックを使用して、アップグレードの成功を妨げるシステム・ヘルスの問題を事前にテストできます。アップグレード環境を準備したら、「verify only」オプションを使用してアップグレード・コマンドのいずれかまたはすべてを実行します。

注意:

Oracleでは、フル・ラック・アップグレード・コマンドをverify-onlyモードで実行して、Private Cloud Applianceのアップグレードの準備ができていることをテストすることを強くお薦めします。出力には、修正処理およびアップグレードの計画に使用できる準備状況レポートが表示されます。

この検証の完了には時間がかかる場合があります。スケジュールされたウィンドウ内で実際のアップグレードを完了できるように、事前に十分に実行してください。

「サービスWeb UI」では、アップグレード・リクエストの作成時にチェック・ボックスを使用して検証専用オプションがアクティブ化されます。「サービスCLI」では、次の例に示すオプションのアップグレード・コマンド・パラメータを使用します:

PCA-ADMIN> upgradeRack type=ISO action=APPLY component=KUBERNETES verifyOnly=True
JobId: d14646fb-b2a9-445d-9702-b99ac605a993
Data: Service request has been submitted. Upgrade Job Id = 1744286305509-kubernetes_verify-2265363 Upgrade Request Id = UWS-7a4a52a4-dc7c-439c-9e32-9e61358d4e56

PCA-ADMIN> getUpgradeJobs
Data:
  id                                        Upgrade Request Id                                Command Name        Result
  --                                        ------------------                                ------------        ------
  1744286305509-kubernetes_verify-2265363   UWS-7a4a52a4-dc7c-439c-9e32-9e61358d4e56          kubernetes_verify   Passed

ラック・ワイド・ヘルス・チェック

フル・ラックのアップグレード・ワークフローには、アプライアンス全体にわたって一連の健全性検査を実行するためのコマンド・オプションが用意されています。最新のチェックは、アップグレードの準備の設定フェーズ(preUpgrade)が完了した後に利用できます。ラック全体のヘルス・チェックは、アップグレード前に実行するように設計されていますが、アップグレード・ジョブが進行中でないかぎり、いつでも潜在的な問題をスキャンできます。

「サービスWeb UI」の使用

ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード」&「パッチ適用」をクリックします。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
「Upgrade Rack」を選択し、次のアップグレード・リクエスト・パラメータを入力します:
- タイプ: アップグレードの場合は、「ISO」を選択します。「The ULN」オプションは、パッチ適用に適用されます。
- アクション: 「Health Check」を選択します。
「要求の作成」をクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
[すべてのチェックのステータス/結果を表示する方法を説明します]

「サービスCLI」の使用

ラック全体の健全性検査ワークフローを開始します。

PCA-ADMIN> upgradeRack action=HEALTHCHECK
JobId: de9eca17-e357-42c4-8aab-c73c311f787f
Data: Service request has been submitted. Upgrade Request Id = UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56

リクエストIDを使用して、ヘルス・チェック・ワークフローのステータスを確認します。

PCA-ADMIN> getUpgradeStatus requestId=UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56
Data: 
  Request id = UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56
  Status = Running
  Composition ID = fullrack
  Type = ISO
  Previous Build = 3.0.2-b1300130
  Target Build = 3.0.2-b1300385
  Jobs 1 = ...
  Jobs 2 = ...
  Jobs 3 = ...
  Completed Components 1 = ...
  Completed Components 2 = ...
  Completed Components 3 = ...
  Pending Components 1 = ...
  Pending Components 2 = ...
  Pending Components 3 = ...

オプションで、個々のアップグレード・ジョブのステータスを確認します。

ラック全体のヘルス・チェックはマルチ・コンポーネント・プロセスであるため、アップグレード・リクエストには複数のアップグレード・ジョブが関連付けられています。リクエストIDに基づいて、これらのジョブに対してフィルタできます。ジョブIDを使用して、各アップグレード・ジョブの詳細にドリルダウンできます。

PCA-ADMIN> getUpgradeJobs requestId=UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56
Data:
  id                                Upgrade Request Id                         Command Name   Result
  --                                ------------------                         ------------   ------
  1111111111111-component-000000    UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56   component      None
  1111111111111-component-000000    UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56   component      Passed
  1111111111111-component-000000    UWS-ab2e72d9-d937-4afb-b6eb-112c87988f56   component      Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1111111111111-component-000000
Data:
  Upgrade Request Id = UWS-8cbb37e3-1d9b-43bc-a793-2a84633fa718
  Composition Id = fullrack
  Name = component
  Pid = 000000
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_pcamn02_2025_01_21-21.22.11.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":null,"online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":"100.96.2.34","log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":"fullrack","request_id":"UWS-8cbb37e3-1d9b-43bc-a793-2a84633fa718","uln":null,"patch":"false"}
  Status = Passed
  Execution Time(sec) = 1736
[...]

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

[この手順を完了します]

障害ログまたは健全性検査のいずれかで問題が検出された場合は、計画されたアップグレード・ウィンドウの前に問題を解決し、実際のシステム・アップグレードを可能なかぎり流暢かつ短く保つことができます。

同時アップグレード操作はサポートされていないことに注意してください。アップグレード・ジョブは、新しいジョブを開始する前に完了する必要があります。