アップグレード環境を事前構成

ISOファイルがMy Oracle Supportからダウンロードされ、HTTPを介してアプライアンスで使用可能になった場合は、一連の事前構成タスクを実行する必要があります。これらの操作によってシステムは変更されませんが、アップグレード準備の次のフェーズで、適切なアップグレード・ワークフロー設定のすべての要件が環境によって満たされるようになります。

事前構成中に、新しいアプライアンス・ソフトウェアISOがアプライアンス内部ストレージにダウンロードされます。 pca-prerequisiteスクリプトをインストールして実行できるように、プライマリISOがマウントされます。すべてのスクリプト操作が完了すると、ISOは再度アンマウントされます。

注意:

Upgraderでは、タイムアウトする前にISOイメージを最大10時間ダウンロードできます。これは、少なくとも20Mbpsの帯域幅で接続を介してダウンロードされる50GBのデータに対応します。ダウンロード接続がこの最小要件を満たしていることを確認してください。最適なパフォーマンスを得るには、帯域幅を広げることをお勧めします。

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

現在および新しいソフトウェア・バージョンの検証
最新のpreUpgrade機能のインストール
最新のUpgraderコードをアプライアンスにコピー
次の準備フェーズで使用する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をアップグレードします。
アップグレード・リクエスト・パラメータを入力します:
- オプション: ISOと入力します。
- ロケーション: ISOイメージが格納されているロケーションへのパスを入力します。このバージョンが複数のISOで構成されている場合は、プライマリpca-3.0.2-<build_no>.isoファイルを指します。
- ISOチェックサム: ISOイメージの整合性を検証するために必要なチェックサムを入力します。チェックサムは、<iso_image>.sha256sumという名前のファイルのISOイメージとともに提供されます。
- ログ・レベル: オプションで、アップグレード・ログファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを指定するJSON文字列を追加します。
- 代替ULNチャネル: このパラメータはパッチ適用に適用され、無視できます。
「要求の作成」をクリックします。

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

「サービスCLI」の使用

コマンドを実行するために必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
  
  ISOイメージが格納される場所のパスを入力します。このバージョンが複数のISOで構成されている場合は、プライマリpca-3.0.2-<build_no>.isoファイルを指します。
  
  すべてのISOコンテンツは、管理ノードからアクセス可能な共有ストレージに解凍されます。セカンダリISOイメージは自動的に検出および処理されます。ただし、同じソース・ディレクトリに格納する必要があります。
- ISOイメージの検証に使用されるチェックサム
  
  チェックサムはISOイメージとともに提供されます。そのファイル名は、.sha256sumが付加されたISOイメージ名です。チェックサムを使用して、ISOイメージ内のデータがそのままであり、このアップグレードに対して有効であることを確認します。

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

構文(1行に入力):

upgradePreConfig 
option=ISO
location=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradePreConfig  option=ISO \
location=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=4a7778d45b3996319ee67c772fbbc0320a9806a942490a1cfe6b37930372809e
Status: Success
JobId: 105524a2-24a2-4b52-91c4-5cd8832552d2
Data: Service request has been submitted. Upgrade Job Id = 1737483518274-prepare-28393 Upgrade Request Id = UWS-e37208d4-d433-4e16-8140-de38c0757c9d

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

PCA-ADMIN> getUpgradeJobs
Data: 
  id                            Upgrade Request Id                                Command Name   Result   
  --                            ------------------                                ------------   ------   
  1737483518274-prepare-28393   UWS-e37208d4-d433-4e16-8140-de38c0757c9d          prepare        Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1737483518274-prepare-28393
Status: Success
Data:
  Upgrade Request Id = UWS-e37208d4-d433-4e16-8140-de38c0757c9d
  Name = prepare
  Pid = 28393
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2025_01_21-18.18.38.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":"https://host.example.com/pca-<version>-<build>.iso","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":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":"4a7778d45b3996319ee67c772fbbc0320a9806a942490a1cfe6b37930372809e","composition_id":null,"request_id":"UWS-e37208d4-d433-4e16-8140-de38c0757c9d","uln":null,"patch":null}
  Status = Passed
  Execution Time(sec) = 776
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
[...]

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