アップグレード用の新規ソフトウェア・ソースの設定
Upgraderのコードは、他のシステム・サービスと同様に定期的に変更されます。 アップグレード準備の設定フェーズでは、すべてのアップグレード・コマンドが最新バージョンで実行されるように、最初にUpgraderが最新であることが保証されます。 Upgraderが使用可能な最新バージョンでないことがシステムで検出された場合、アップグレード操作は実行できません。
最新バージョンのUpgraderが稼働している場合、新しいアプライアンス・ソフトウェアのソースは、システム・アップグレード手順で使用するように設定されます。 現在のソフトウェア・イメージがバックアップされ、新しいソフトウェアISOが適切なディレクトリ構造の管理クラスタ共有ストレージに解凍されます: OSベース・イメージ、アプライアンス・ソフトウェアRPMパッケージ、新しいコンピュート・インスタンス・イメージ、新しいファームウェアなど。
設定フェーズの最後に、「アップグレード計画」が生成されます。 アップグレード計画は、現在のインストールと開梱された新しいバージョンの比較に基づきます。 次のフェーズで実行する必要があるアップグレード手順を決定します。 詳細は、「アップグレード計画ステータスおよび進捗のチェック」を参照してください。
この設定プロセス全体が、単一のコマンドでアプライアンス管理者によって起動されます。
注意:
最初に事前構成プロセスが完了していることを確認します。 「アップグレード環境を事前構成」を参照してください。
後でアップグレード計画を実行する際に不整合を回避するには、準備プロセス内のupgradePreConfig
(事前構成)およびpreUpgrade
(設定)の両方のコマンドを指定された順序でまとめて完了することが重要です。 preUpgrade
コマンドを再実行する必要がある場合は、先に前のコマンドを再実行する必要があります。
「サービスWeb UI」の使用
-
ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。
-
「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。
-
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。
「要求の作成」ウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。
-
適切なアップグレード・リクエスト・タイプを選択: preUpgrade.
-
アップグレード・リクエスト・タイプには、ISOと入力します。 必要なファイルは、解凍されたISOイメージから取得されます。
-
「要求の作成」をクリックします。
新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。 ジョブが正常に完了すると、Upgraderは最新の状態になり、新しいソフトウェア・バージョン・ソースを使用できます。
「サービスCLI」の使用
-
最新のUpgraderバージョンのインストールと、新しいアプライアンス・ソフトウェア・ソースの設定を開始します。
PCA-ADMIN> preUpgrade type=ISO Status: Running JobId: aa33246e-fd79-460f-a191-cc97f8be04be Data: in progress
次のコマンドで実行されるアップグラダ操作:
-
新しいUpgraderバージョンを管理ノードにインストールし、Upgrader systemdサービスを再起動して変更を有効にします。
-
「サービスCLI」および「サービスWeb UI」を更新して、最新のコマンドおよび関数を使用可能にします。
次のコマンドで実行される設定操作:
-
現在のソフトウェア・イメージをバックアップします。
-
ISOイメージを解凍し、新しいソフトウェアRPMおよびインストール・ファイル(イメージ、ファームウェア)を正しいディレクトリに保存します。
-
アプライアンスの内部共有ストレージから不要になったバックアップおよびイメージを削除します。
-
アップグレード計画を生成します。
-
-
次のコマンドを使用して、いつでもpreUpgradeプロセスのステータスを確認します:
PCA-ADMIN> getPreUpgradeStatus Data: status = IN-PROGRESS message = PREUPGRADE-c0f0b38d-64d2-42bb-8d96-de39d1218b24: A pre-upgrade task is running! PCA-ADMIN> getPreUpgradeStatus Data: status = SUCCESS message = The previous pre-upgrade task succeeded!
-
Upgraderの最新バージョンが正常にインストールされていることを確認します。
PCA-ADMIN> getUpgradeJobs Data: id Upgrade Request Id Command Name Result -- ------------------ ------------ ------ 1737484792498-setup-42073 PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8 setup Passed 1737483518274-prepare-28393 UWS-e37208d4-d433-4e16-8140-de38c0757c9d prepare Passed
preUpgradeプロセスが失敗した場合は、アップグレード・ジョブでトラブルシューティング情報を確認してください。
PCA-ADMIN> getUpgradeJob upgradeJobId=1737484792498-setup-42073 Data: Upgrade Request Id = PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8 Name = setup Pid = 25325 Host = pcamn02 Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_setup_upgrade_environment_2025_01_21-18.39.52.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":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":null,"request_id":"PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8","uln":null,"patch":null} Status = Failed Execution Time(sec) = 1069 Tasks 1 - Name = Validate Setup Image Location Tasks 2 - Name = Validate Upgrader Version Tasks 3 - Name = Validate Upgrade Order [...] Tasks 22 - Name = Delete Old backups Tasks 22 - Message = [Errno 2] No such file or directory: '/nfs/shared_storage/yum/pca_upgrader' Tasks 22 - Status = Failed
-
システムが準備完了状態であることを確認します。 次に、ラック・アップグレード・ワークフローに進みます。
-
アップグレード計画を表示して、アップグレードする必要があるコンポーネントを確認します。 ターゲットのビルド番号が、アップグレードを計画しているアプライアンス・ソフトウェアのバージョンと一致することを確認します。
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