パッチ適用環境の事前構成

パッチ適用操作はアップグレードと同じロジックに依存し、Upgraderサービスからも実行されますが、ISOイメージではなくULNチャネルを介して提供されるRPMパッケージを使用します。データ・センターのULNミラーが更新され、アプライアンスがミラーと同期されている場合は、一連の事前構成タスクを実行する必要があります。これらの操作によってシステムは変更されませんが、パッチ準備の次のフェーズで、適切なパッチ・ワークフロー設定のすべての要件が環境によって満たされるようになります。

事前構成時に、yum構成が更新されます。アップグレード前のアクティブなソフトウェア・バージョンが3.0.2-b1185392以上であるとすると、pca-prerequisiteスクリプトがインストールされ、実行されます。

ノート:

アクティブなソフトウェア・バージョンが3.0.2-b1185392より古い場合、前提条件となるスクリプトは実行されません。 upgradePreConfigおよびpreUpgradeコマンドは、新しいソフトウェア・パッケージ、最新のUpgraderコードおよびアップグレード計画がシステムおよびコンポーネントのアップグレードを実行するために配置されているが、ワークフローは異なることを確認します。

このスクリプトによって実行される操作は次のとおりです:

現在および新しいソフトウェア・バージョンの検証
最新のpreUpgrade機能のインストール
次の準備フェーズで使用するyamlファイルへの環境パラメータの書き込み
新しいアップグレード履歴ファイルの生成

この事前構成プロセス全体が、1つのコマンドでアプライアンス管理者によって起動されます。

プロビジョニングされていないコンピュート・ノード

Private Cloud Applianceにプロビジョニングされていないコンピュート・ノードが含まれている場合、アップグレードまたはパッチ適用中にエラーが発生し、後でプロビジョニングの問題が発生する可能性があります。したがって、レコードがノード・データベースに存在する場合、コンピュート・ノードをプロビジョニングしてフォルト・ドメインに追加する必要があります。そうしないと、アップグレードまたはパッチ適用プロセスが続行できません。

プロビジョニングできないコンピュート・ノードを持つシステム上のアプライアンス・ソフトウェアをアップグレードまたはパッチ適用する必要がある場合は、これらのデータベース・レコードを削除する必要があります。 Oracleに連絡してください。

プロビジョニングの詳細は、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」の章にある「コンピュート・ノード操作の実行」を参照してください。

前提条件バージョン

最新のUpgraderコードは、前提条件となるソフトウェア・バージョンをPrivate Cloud Applianceに自動的に適用します。アップグレードまたはパッチの準備の初期段階では、Upgraderサービスは、現在インストールされているアプライアンス・ソフトウェア・バージョンを新しいターゲット・バージョンに対して検証します。この項に記載されている準備プロセス(upgradePreConfig)は、検証が成功した場合にのみ続行されます。

アプライアンスが最低限必要なバージョンを実行していない場合、Upgraderはプロセスを終了し、環境を以前の状態にロールバックします。失敗したアップグレード・ジョブの詳細を表示します:

PCA-ADMIN> getupgradejob upgradeJobId=1700153626051-prepare-40046
Data:
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2023_11_16-16.53.46.log
  Arguments = [...]
  Status = Failed
[...]
  Tasks 23 - Name = Check Prerequisite Build Version
  Tasks 23 - Description = Check current build version not lower than prerequisite version
  Tasks 24 - Name = Check Prerequisite Build Version
  Tasks 24 - Message = (("Caught exception while checking prerequisite build number 
  Exception: Command: ['/usr/bin/python3', '/var/lib/pca-upgrader/prerequisite_build_validator.py', 
  'rack=PCA', 'upgrade=ISO'] failed (1): stderr: b'' stdout: b'PCA version is lower than prerequisite build, 
  must upgrade to prerequisite build 3.0.2-b892153 to proceed further upgrade\\n'",), {})
  Tasks 24 - Status = Failed

まず、アップグレード・ジョブ出力のエラー・メッセージで示される前提条件バージョンをインストールする必要があります。

「サービスWeb UI」の使用

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

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: PreConfigをアップグレードします。
アップグレード・リクエスト・パラメータを入力します:
- オプション: ULNと入力します。
- ロケーション: 完全修飾ドメイン名を使用して、データ・センター内のULNミラーへのパスを入力します。
- ISOチェックサム: このパラメータはISOイメージからのアップグレードに適用され、無視できます。
- ログ・レベル: オプションで、アップグレード・ログファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを指定するJSON文字列を追加します。
- 代替ULNチャネル: このパラメータは、リクエストに非標準ULNチャネルを強制的に使用します。 Oracleが明示的に指示しないかぎり、このオプションを使用しないでください。
「要求の作成」をクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。事前構成ステップは、このセクションの開始時に説明するように実行します。

「サービスCLI」の使用

データ・センターのULNミラーのURLを検索します。

upgrade preconfigurationコマンドを入力します。

構文(1行に入力):

upgradePreConfig 
option=ULN
location=<path-to-uln-mirror>

例:

upgradePreConfig option=ULN location=https://host.example.com/yum
Data:
  Service request has been submitted. Upgrade Job Id = 1692849609034-prepare-45676 Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf

リクエストIDとジョブIDを使用して、アップグレード・プロセスのステータスを確認します。

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1630938939109-compute-7545       UWS-61736806-7e5a-4648-9259-07c54c39cacb   compute       Passed
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed
  1692849609034-prepare-45676      UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   prepare       Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1692849609034-prepare-45676
Status: Success
Data:
  Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf
  Name = prepare
  Start Time = 2022-06-14T06:35:56
  End Time = 2022-11-06T06:35:58
  Pid = 45676
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2022_11_16-06.35.56.log
[...]

次のアップグレード準備フェーズに進みます。