アップグレード計画ステータスおよび進捗のチェック

ソフトウェア・バージョン3.0.2-b892153以降では、Upgraderは「アップグレード計画」を一種のチェックリストとして使用して、すべてのアップグレード操作を実行します。これは、完全な管理クラスタ・アップグレードと個々のコンポーネント・アップグレードを意味します。「Oracle Private Cloud Appliance概要ガイド」では、この方法について、「アプライアンス管理の概要」章の"Upgrade"セクションの一部として詳しく説明します。

アップグレード計画は、Upgrader自体が最新バージョンにアップグレードされたときに生成されます。この計画は、アップグレード環境の準備中に、ラックに現在インストールされているコンポーネント、および共有ストレージにダウンロードされているターゲット・コンポーネントのバージョンと最新パッケージの比較に基づきます。結果のアップグレード・プランには、アップグレード・プロシージャを次のフェーズで実行する必要があるコンポーネントが表示されます。

すべてのコンポーネントを所定の順序でアップグレードする必要があります。アップグレード計画では、前のアップグレードが完了していない場合、コンポーネントのアップグレード手順を開始できません。最初にアップグレードする必要があるコンポーネントを管理者に知らせるエラー・メッセージ。

ノート:

一般に、新しいバージョンがシステムで使用可能になった場合は常にファームウェアをアップグレードできます。ファームウェアのアップグレードは、特定の順序で、ほかのコンポーネントとは独立して適用できます。 ZFS Storage Applianceは例外です: ファームウェアは、他のすべてのコンポーネントより前にアップグレードする必要があります。

アップグレード計画によって実施される操作の順序は次のとおりです:

アップグレード環境の準備(PreConfigをアップグレード)
Upgraderのアップグレード(PreUpgrade)
ZFS Storage Applianceファームウェア
コンピュート・ノード
管理ノードのホスト・オペレーティング・システム
MySQLクラスタ・データベース
シークレット・サービス(EtcdおよびVaultを含む)
Kubernetesコンテナ・オーケストレーション・パッケージ(プラットフォーム・レイヤー)
コンテナ化されたマイクロサービス
Oracle Cloud Infrastructureイメージ

アップグレード計画の確認

アップグレード環境の準備が完了すると、システムを最新の状態にするために必要なすべてのアップグレード操作がアップグレード計画にリストされます。アップグレード手順が正常に完了すると、アップグレード計画は最新のステータスで更新されます: アップグレードされたコンポーネントの場合、ソース・バージョンとターゲット・バージョンは同一であり、「アップグレードが必要」フラグは無効になります。

アップグレード計画の進行状況は、いつでも確認できます。これは、どのコンポーネントが最新で、どのコンポーネントをアップグレードする必要があるかを示します。アップグレード計画では、スナップショット・ビューが提供されます。このビューは、参照時に正確で役立ちます。アップグレード・アクティビティの詳細な進行状況を確認するには、かわりに「ジョブ・フレームワーク」を使用します。

アップグレード計画は、次の2つの方法で表示できます:

「サービスWeb UI」で、ナビゲーション・メニューの「メンテナンス」に移動し、「アップグレード計画」を選択します。

「サービスCLI」で、次のコマンドを入力します:

PCA-ADMIN> getUpgradePlan
Data: 
  id                          component    currentBuild     targetBuild      currentVersion                   targetVersion                              requireReboot   timeEstimation (min)   requireUpgrade   impactedInfra   
  --                          ---------    ------------     -----------      --------------                   -------------                              -------------   --------------------   --------------   -------------   
  generic                     zfssa        3.0.2-b1300385   3.0.2-b1300385   2013.06.05.8.73.1-2.73.5701.1    2013.06.05.8.73.1-2.73.5701.1              false           45                     false            host,compute    
  100.96.2.64                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
  100.96.2.65                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
  100.96.2.66                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
  100.96.2.33                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
  100.96.2.34                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
  100.96.2.35                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
  generic                     mysql        3.0.2-b1300385   3.0.2-b1300385   8.0.36-1.1                       8.0.36-1.1                                 false           15                     false            host            
  generic                     etcd         3.0.2-b1300385   3.0.2-b1300385   3.5.6                            3.5.6                                      false           5                      false            host            
  generic                     vault        3.0.2-b1300385   3.0.2-b1300385   v1.7.1-3.10.0.0.0.4.g5f2d5af     v1.7.1-3.10.0.0.0.4.g5f2d5af               false           5                      false            host            
  generic                     kubernetes   3.0.2-b1300385   3.0.2-b1300385   1.25.16-2                        1.25.16-2                                  false           60                     false            host,compute    
  generic                     platform     3.0.2-b1300130   3.0.2-b1300385   None                             None                                       false           40                     true             host,compute    
  Oracle-Linux-7.9            ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
  Oracle-Linux8-OKE-1.28.8    ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
  Oracle-Solaris-11           ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.08.26_0                               false           5                      true             host            
  Oracle-Linux8-OKE-1.27.12   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
  Oracle-Linux8-OKE-1.26.15   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
  Oracle-Linux-9              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
  Oracle-Linux-8              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
  100.96.0.33                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  100.96.0.34                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  100.96.0.35                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  100.96.0.64                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  100.96.0.65                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  100.96.0.66                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
  leaf                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
  spine                       switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
  mgmt                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute

ジョブ・フレームワークの参照

Upgraderはアプライアンス・コントローラ・ソフトウェアのジョブ・フレームワークと統合されています。各操作の結果、1つ以上のジョブをトリガーする作業リクエストが生成されます。これらの作業リクエストおよびジョブを問い合せることができます。ステータスおよび詳細プロパティは、システム上のアップグレード・アクティビティに関するインサイトを提供します。

「サービスCLI」コマンドを入力すると、ジョブIDおよび作業リクエストIDが返されます。これにより、ステータスの確認、詳細の取得、同じワークフロー内の関連ジョブの検索などを行うことができます。「サービスWeb UI」を使用してアップグレード(またはパッチ)リクエストを作成すると、これらのIDは画面に表示されませんが、「アップグレード・ジョブ」表で確認できます。そこから、作業リクエストおよびジョブにドリルダウンすることもできます。

「サービスWeb UI」の使用

「サービスWeb UI」からアップグレード操作を実行するには、メイン・ナビゲーション・メニューを使用して「メンテナンス」に移動し、「&パッチ適用のアップグレード」をクリックします。これにより、「アップグレード・ジョブ」ページが開きます。このページには、最新のアップグレード・ジョブがすべて表に表示され、右上隅にあるボタンをクリックして、新しいアップグレード(またはパッチ)リクエストを作成できます。

「アップグレード・ジョブ」表では、すべてのアップグレード・リクエストおよびジョブを参照できるため、これを使用して、現在、過去およびスケジュール済のアップグレード・アクティビティの進捗を追跡できます。

デフォルトの表ビューには、関連付けられたコマンド、ワークフロー・リクエスト、タイムスタンプおよび結果を含むジョブが表示されます。職務IDとリクエストIDは、より詳細な情報を含むページへのハイパーリンクです。

各表の行の右側にある「アクション」メニューには、ハイパーリンクに相当するオプションがあり、ジョブまたはリクエストIDをコピーすることもできます。
リクエストIDでフィルタすると、「アップグレード・ジョブ」表には、選択したアップグレード・リクエストの一部として作成されたジョブのみが表示されます。これを使用して、マルチ・コンポーネント・ワークフローを追跡し、完了または保留中のジョブを確認します。障害が発生した場合、予期したとおりに完了しなかったジョブを確認できます。

デフォルトの表ビューに戻るには、「フィルタのクリア」をクリックします。
ジョブの詳細を表示するには、「アップグレード・ジョブ」表でそのジョブIDをクリックします。アップグレード・ジョブの詳細ページには、ジョブ表に示されている情報に加えて、ログ・ファイルのロケーション、ジョブ実行の詳細、およびアップグレード・ジョブの一部として実行されるタスクのリストが含まれます。

アップグレード・ジョブが完了していない場合は、ページの右上隅にあるボタンをクリックして終了できます。
アップグレード・リクエストの詳細を表示するには、「アップグレード・ジョブ」表のリクエストIDをクリックします。「アップグレード・ステータス」詳細ページには、ジョブ表に示されている情報に加えて、ソースとターゲットのビルド、ワークフローの詳細、および関連するアップグレード・ジョブのリストが含まれます。

アップグレード・ジョブ・リストは、リクエストIDでフィルタされたメインの「アップグレード・ジョブ」表と同じです。また、ジョブIDをクリックして各ジョブの詳細ページにアクセスすることもできます。

「アップグレード・ステータス」ページの「リソース」セクションには、ジョブ・リストに加えて、ジョブが完了したコンポーネントおよび保留中のコンポーネントを表示できます。

「サービスCLI」の使用

「サービスCLI」からアップグレード操作を実行すると、リクエストが作成されます。ジョブIDとアップグレード・リクエストIDがすぐに返されます。これらのIDを使用して、ジョブおよびリクエストを問い合せ、必要な詳細を検索します。

「サービスCLI」で作業する場合、アップグレード・ワークフロー・サービスからのリクエストIDは、アップグレード・アクティビティに関する情報にアクセスするための主要な要素です。コマンドの入力時にリクエストIDに気付かなかった場合、または以前のワークフローからデータを検索する場合は、getUpgradeRequestsコマンドを使用して、調査するデータを検索します。
```
PCA-ADMIN> getUpgradeRequests
Data:
  id
  --
  PREUPGRADE-61b56867-7966-4096-9c74-08efe8d2d0ad
  UWS-496e26aa-2923-46f1-a485-c086a005077a
  UWS-da5d70ba-09ea-4ef0-b8ea-84d9f44c5e62
  PREUPGRADE-a6aa2c0e-ceff-4de4-aa23-de7d21b06668
[...]
```

正しいアップグレード・リクエストIDを使用して、アップグレード・ワークフローのステータスおよび進行状況を確認できます。 getUpgradeStatusコマンドを使用して、ジョブ・リスト、完了済および保留中のコンポーネントなどのワークフローの詳細を表示します。

PCA-ADMIN> getUpgradeStatus requestId=UWS-910dd8fd-28b3-4f97-a909-02c26085266c
Data:
  Request id = UWS-910dd8fd-28b3-4f97-a909-02c26085266c
  Status = Failed
  Composition ID = fullrack
  Type = ISO
  Previous Build = 3.0.2-b1333709
  Target Build = 3.0.2-b1337789
  Jobs 1 = 1741252377283-zfssa-81712
  Jobs 2 = 1741253904337-compute-72870
[...]
  Jobs 13 = 1741269765197-platform-663307
  Completed Components 1 = zfssa(generic)
  Completed Components 2 = compute(100.96.2.64)
[...]
  Pending Components 1 = compute(100.96.2.68)
  Pending Components 2 = host(100.96.2.33)
[...]

アップグレード・リクエストIDを使用して、リクエストに関連付けられたジョブをリストし、ステータス、進行状況および潜在的な問題をスキャンすることもできます。 getUpgradeJobsコマンドを使用して、ジョブ・リストを表示します。

PCA-ADMIN> getUpgradeJobs requestId=UWS-910dd8fd-28b3-4f97-a909-02c26085266c
Data:
  id                                Upgrade Request Id                         Command Name   Result
  --                                ------------------                         ------------   ------
  1741269765197-platform-663307     UWS-910dd8fd-28b3-4f97-a909-02c26085266c   platform       Failed
  1741269703036-kubernetes-656961   UWS-910dd8fd-28b3-4f97-a909-02c26085266c   kubernetes     Passed
  1741267992739-host-422432         UWS-910dd8fd-28b3-4f97-a909-02c26085266c   host           Passed
  1741266155984-host-161315         UWS-910dd8fd-28b3-4f97-a909-02c26085266c   host           Passed
  1741264266152-host-11547          UWS-910dd8fd-28b3-4f97-a909-02c26085266c   host           Passed
  1741264201476-compute-87720       UWS-910dd8fd-28b3-4f97-a909-02c26085266c   compute        Passed
  1741264136546-compute-81124       UWS-910dd8fd-28b3-4f97-a909-02c26085266c   compute        Passed
  1741264070151-compute-74130       UWS-910dd8fd-28b3-4f97-a909-02c26085266c   compute        Passed
  1741252377283-zfssa-81712         UWS-910dd8fd-28b3-4f97-a909-02c26085266c   zfssa          Passed

失敗を調査したり、特定のジョブに関する詳細情報を表示するには、getUpgradeJobコマンドを使用します。ジョブの詳細には、ログ・ファイルへのパス、完全なタスク・リストおよび実行中に取得されたエラー・メッセージが含まれます。

PCA-ADMIN> getUpgradeJob upgradeJobId=1741269765197-platform-663307
Data:
  Upgrade Request Id = UWS-910dd8fd-28b3-4f97-a909-02c26085266c
  Composition Id = fullrack
  Name = platform
  Pid = 663307
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_platform_services_2025_03_06-14.02.45.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,[...]}
  Status = Failed
  Execution Time(sec) = 4068
  Tasks 1 - Name = Validate Upgrader Version
[...]
  Tasks 31 - Name = Network Controllers Upgrade
  Tasks 31 - Description = Upgrade Network Controllers.
  Tasks 31 - Message = [{'name': 'auxiliary-metadata', 'version': 2, [...]
      Error: UPGRADE FAILED: release pcaswitchmgr failed, and has been rolled back due to atomic being set: 
      pre-upgrade hooks failed: timed out waiting for the condition }]
  Tasks 31 - Status = Failed
  Tasks 31 - Reason Phrase = Failed
  Tasks 31 - Execution Time(sec) = 1834
[...]