機械翻訳について
  1. アップグレード・ガイド
  2. アップグレード要件
  3. アップグレード環境の準備

アップグレード環境の準備

Oracle Private Cloud Applianceのソフトウェアのバージョンおよびアップグレードは、My Oracle Supportからダウンロードできます。 ISOファイルには、アプライアンスのハードウェアおよびソフトウェア・コンポーネントを特定のリリースにアップグレードするために必要なすべてのファイルとパッケージが含まれています。 ISOファイル内のすべてのアイテムが相互に動作することをテストされ、ラック・システムへの取り付けが認定されています。

ISOファイルを使用してアプライアンスをアップグレードできるようにするには、webサーバーがPrivate Cloud Appliance管理ノードで使用できるようにするロケーションにファイルをダウンロードする必要があります。 アプライアンスの内部管理ネットワークに接続されたバスチョン・ホストを設定した場合は、そのマシンにISOファイルを格納し、webサーバーを実行して、ISOファイルをhttp経由でアクセス可能にすると便利です。

アップグレード操作を実行する前に、ISOファイルの内容を開梱して、3つの管理ノードすべてにマウントされた共有ストレージにソース・ディレクトリを移入します。 これにより、アップグレード・コマンドの実行時に新しいバージョンがインストールされます。

前提条件バージョン

最新の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-b799577 to proceed further upgrade\\n'",), {})
  Tasks 24 - Status = Failed

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

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。

  2. 「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

    Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。

  3. 適切なアップグレード・リクエスト・タイプを選択: PreConfigをアップグレードします。

  4. アップグレード・リクエスト・パラメータを入力します:

    • オプション: ISOと入力します。

    • ロケーション: ISOイメージが格納されているロケーションへのパスを入力します。

    • ISOチェックサム: ISOイメージの整合性を検証するために必要なチェックサムを入力します。 チェックサムは、<iso_image>.sha256sumという名前のファイルのISOイメージとともに提供されます。

    • ログ・レベル: オプションで、アップグレード・ログファイルの特定のログ・レベルを選択します。 デフォルトのログ・レベルは「情報」です。 詳細は、「デバッグ」を選択します。

    • 拡張オプションJSON: オプションで、追加のコマンド・パラメータを指定するJSON文字列を追加します。

    • 代替ULNチャネル: このパラメータはパッチ適用に適用され、無視できます。

  5. Create Requestをクリックします。

    新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。

    ISOイメージは管理ノード・クラスタの共有ストレージに展開され、そこからその内容を使用して必要なアップグレード操作を実行できます。

「サービスCLI」の使用

  1. コマンドを実行するために必要な情報を収集します:

    • アップグレード元のISOイメージのロケーション

      ISOイメージが格納される場所のパスを入力します。 その内容は、管理ノードからアクセス可能な共有ストレージに展開されます。

    • ISOイメージの検証に使用されるチェックサム

      チェックサムはISOイメージとともに提供されます。 そのファイル名は、.sha256sumが付加されたISOイメージ名です。 システムはチェックサムを使用して、ISOイメージ内のデータがそのままであり、このアップグレードに有効であることを確認します。

  2. upgrade pre-configurationコマンドを入力します。

    構文(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=90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027
Command: upgradePreConfig  option=ISO location="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027
Status: Success
Time: 2022-11-06 06:35:38,884 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1668417666968-prepare-28142 Upgrade Request Id = UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186

  3. リクエスト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
  1668417666968-prepare-28142      UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186   prepare       Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1668417666968-prepare-28142
Command: getUpgradeJob upgradeJobId=1668417666968-prepare-28142
Status: Success
Time: 2022-11-06 07:24:00,793 UTC
Data:
  Upgrade Request Id = UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186
  Name = prepare
  Start Time = 2022-06-14T06:35:56
  End Time = 2022-11-06T06:35:58
  Pid = 28142
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2022_11_16-06.35.56.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":"http://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":"90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027","composition_id":null,"request_id":"UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186","uln":null,"patch":null}
  Status = Passed
  Execution Time(sec) = 616
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
[...]

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

アップグレード前のバックアップ

システム・クリティカルなコンポーネントおよびサービスの場合、Oracle Private Cloud Applianceはスケジュールされたバックアップ・サービスを実行し、壊滅的な障害が発生した場合にアプライアンスを最新の正常なヘルスにリストアできるようにします。 「コンピュート・エンクレーブ」のユーザーのクラウド・リソースにもバックアップ計画を実装することをお薦めします。

Private Cloud Applianceのコンポーネントをアップグレードする前に、MySQLデータベースの最新状態、ZFS Storage Applianceおよびシークレット・サービス(Vault)のバックアップを作成する必要があります。 バックアップ・コマンドでは既存のバックアップ・サービスが利用されますが、アップグレード開始直前の最新の変更を含む追加のリストア・ポイントを作成します。

「サービスCLI」の使用

  1. 必要な3つのバックアップ・タスクを開始します。

    PCA-ADMIN> backup target=vault
Command: backup target=vault
Status: Success
Time: 2022-11-06 09:56:18,786 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm
  Display Name = brs-job-1668419778-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.wrxfwtxwxw6ydp2mwnypcaaxxzmwpuhsc33gcm3dyte7kgr4etuhb29qbs8q
  Time Created = 2022-11-06T09:56:18Z
  Lifecycle State = CREATING
  Retention = 14

PCA-ADMIN> backup target=zfs
Command: backup target=zfs
Status: Success
Time: 2022-11-06 09:57:23,084 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc
  Display Name = brs-job-1668419842-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.p7w0tgbvhtjqsgc8rllca2cvotkpgrtf4huiph7466mjio0dgskij9f0bp06
  Time Created = 2022-11-06T09:57:22Z
  Lifecycle State = CREATING
  Retention = 14

PCA-ADMIN> backup target=mysql
Command: backup target=mysql
Status: Success
Time: 2022-11-06 09:57:30,229 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
  Display Name = brs-job-1668419850-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.henfqzdbafs4z3mxeuslb1c6f4t049w0pxvwf1gi3eb8wm1y11v7m932tn4g
  Time Created = 2022-11-06T09:57:30Z
  Lifecycle State = CREATING
  Retention = 14

  2. バックアップ・ジョブIDを使用して、バックアップのステータスを確認します。

    PCA-ADMIN> getBackupJobs
Command: getBackupJobs
Status: Success
Time: 2022-11-06 10:03:18,986 UTC
Data:
  id                                                                                              displayName                 components
  --                                                                                              -----------                 ----------
  ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot   brs-job-1668419850-backup   mysql
  ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc   brs-job-1668419842-backup   zfs
  ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm   brs-job-1668419778-backup   vault

PCA-ADMIN> getBackupJob backupJobId=ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
Command: getBackupJob backupJobId=ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
Status: Success
Time: 2022-11-06 10:04:07,080 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
  Display Name = brs-job-1668419850-backup
  Time Created = 2022-11-06T09:57:30Z
  Status = success
  Components = mysql

  3. 3つのバックアップ操作がすべて正常に完了したことを確認します。 次に、次のアップグレード準備フェーズに進みます。

Upgraderのアップグレード

アップグレーダのコードは、ほかのシステム・サービスと同様に、定期的に変更されます。 すべてのアップグレード・コマンドが最新バージョンで実行されるように、upgraderが最初に最新であることを確認します。

Upgraderが使用可能な最新バージョンでないことがシステムで検出された場合、アップグレード操作は実行できません。

ソフトウェア・バージョン3.0.2-b892153以降では、Upgraderを最新バージョンにアップグレードすると、「アップグレード計画」も生成されます。 アップグレード計画は、現在のインストールとアップグレード環境の準備中にダウンロードされたパッケージの比較に基づいており、次のフェーズで実行する必要があるアップグレードを決定します。 詳細は、「アップグレード計画のステータスおよび進捗のチェック」を参照してください。

注意:

アップグレード事前構成タスクが最初に完了していることを確認してください。 「アップグレード環境の準備」を参照してください。

後でアップグレード計画を実行する際の不整合を回避するには、準備プロセスの両方の部分であるアップグレードPreConfigとpreUpgradeが、指定された順序で同時に完了することが重要です。 preUpgradeコマンドを再実行する必要がある場合は、先に前のコマンドを再実行する必要があります。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。

  2. 「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

    Create Requestウィンドウが表示されます。 リクエスト・タイプとして「アップグレード」を選択します。

  3. 適切なアップグレード・リクエスト・タイプを選択: preUpgrade.

  4. アップグレード・リクエスト・パラメータを入力します:

    • アクション: startと入力して、新しいバージョンのアップグレーダを取得します。 (前のpreUpgradeジョブのステータスを確認するには、かわりに「ステータス」を入力します。)

    • タイプ: ISOと入力します。 アップグレーダ・パッケージは、解凍されたISOイメージから選択されます。

  5. Create Requestをクリックします。

    新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。 ジョブが正常に完了すると、アップグレーダは最新になり、使用できるようになります。

「サービスCLI」の使用

  1. 管理ノードに最新のupgraderバージョンをインストールするプロセスを開始します。

    PCA-ADMIN> preUpgrade action=start type=ISO
Data: 
  Successfully triggered the pre-upgrade task.
   Pre upgrade status = success

    プロセスの一部として、次の操作が実行されます:

    1. 既存のyum構成を保存します。

    2. 新しいアップグレーダ・ファイルのyumリポジトリを構成します。

    3. 新しいupgraderバージョンを管理ノードにインストールしてから、upgrader systemdサービスを再起動して変更を有効にします。

    4. 最初のステップで保存された既存のyum構成をリストアします。

  2. 次のコマンドを使用して、アップグレード・プロセスのステータスをいつでも確認します:

    PCA-ADMIN> preUpgrade action=status
Data: 
  A pre-upgrade task is running!
  Pre upgrade status = IN-PROGRESS
 
PCA-ADMIN> preUpgrade action=status
Data: 
   The previous pre-upgrade task succeeded!
   Pre upgrade status = SUCCESS

  3. アップグレーダの最新バージョンが正常にインストールされていることを確認します。 システムが準備完了状態であることを確認します。 次に、コンポーネントのアップグレードに進みます。

  4. オプションで、アップグレード計画を表示して、アップグレードする必要があるコンポーネントを確認します。

    ノート:

    この機能は、アプライアンスでソフトウェア・バージョン3.0.2-b892153以降が実行されている場合に利用できます。

    PCA-ADMIN> getUpgradePlan
Data:
  id                         componentType   currentBuild     targetBuild      currentVersion                  targetVersion                   requireReboot   timeEstimation   requireUpgrade   impactedInfra 
  --                         -------------   ------------     -----------      --------------                  -------------                   -------------   --------------   --------------   ------------- 
  generic                    zfssa           3.0.2-b892153    3.0.2-b1052646   2013.06.05.8.57.1-2.57.5392.2   2013.06.05.8.57.1-2.57.5501.4   false           45               true             host,compute  
  100.96.2.64                compute         3.0.2-b892153    3.0.2-b1052646   3.0.2-640                       3.0.2-691                       true            20               true             compute       
  100.96.2.65                compute         3.0.2-b892153    3.0.2-b1052646   3.0.2-640                       3.0.2-691                       true            20               true             compute       
  100.96.2.66                compute         3.0.2-b892153    3.0.2-b1052646   3.0.2-640                       3.0.2-691                       true            20               true             compute       
  100.96.2.67                compute         3.0.2-b892153    3.0.2-b1052646   3.0.2-640                       3.0.2-691                       true            20               true             compute       
  100.96.2.68                compute         3.0.2-b892153    3.0.2-b1052646   3.0.2-640                       3.0.2-691                       true            20               true             compute       
  100.96.2.33                host            3.0.2-b892153    3.0.2-b1052646   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9   true            35               true             host          
  100.96.2.34                host            3.0.2-b892153    3.0.2-b1052646   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9   true            35               true             host          
  100.96.2.35                host            3.0.2-b892153    3.0.2-b1052646   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9   true            35               true             host          
  generic                    mysql           3.0.2-b892153    3.0.2-b1052646   8.0.28-1.1                      8.0.33-1.1                      false           15               true             host          
  generic                    etcd            3.0.2-b892153    3.0.2-b1052646   3.3.10                          3.3.10                          false           5                false            host          
  generic                    vault           3.0.2-b892153    3.0.2-b1052646   v1.7.1-3                        v1.7.1-3                        false           5                false            host          
  generic                    kubernetes      3.0.2-b892153    3.0.2-b1052646   1.20.6-1                        1.25.7-1                        false           350              true             host,compute  
  generic                    platform        3.0.2-b892153    3.0.2-b1052646   None                            None                            false           50               true             host,compute  
  Oracle-Linux-7.9           ociImages       3.0.2-b892153    3.0.2-b1052646   2022.08.29_0                    2023.09.26_0                    false           5                true             host          
  Oracle-Linux-8             ociImages       3.0.2-b892153    3.0.2-b1052646   2022.08.29_0                    2023.09.26_0                    false           5                true             host          
  Oracle-Linux-9             ociImages       3.0.2-b892153    3.0.2-b1052646   None                            2023.09.26_0                    false           5                true             host          
  Oracle-Linux8-OKE-1.26.6   ociImages       3.0.2-b892153    3.0.2-b1052646   None                            20240210                        false           5                true             host          
  Oracle-Linux8-OKE-1.27.7   ociImages       3.0.2-b892153    3.0.2-b1052646   None                            20240209                        false           5                true             host          
  Oracle-Linux8-OKE-1.28.3   ociImages       3.0.2-b892153    3.0.2-b1052646   None                            20240210                        false           5                true             host          
  Oracle-Solaris-11          ociImages       3.0.2-b892153    3.0.2-b1052646   2023.04.18_0                    2023.10.16_0                    false           5                true             host          
  100.96.0.33                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.1.21                        true            10               true             host,compute  
  100.96.0.34                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.1.21                        true            10               true             host,compute  
  100.96.0.35                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.1.21                        true            10               true             host,compute  
  100.96.0.64                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.2.20.a                      true            10               true             host,compute  
  100.96.0.65                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.1.21                        true            10               true             host,compute  
  100.96.0.66                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.2.21                        true            10               true             host,compute  
  100.96.0.67                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.2.20.a                      true            10               true             host,compute  
  100.96.0.68                ilom            3.0.2-b892153    3.0.2-b1052646   5.0.2.23                        5.1.2.21                        true            10               true             host,compute  
  leaf                       switch          3.0.2-b892153    3.0.2-b1052646   10.2.5                          10.3.4a                         false           60               true             host,compute  
  mgmt                       switch          3.0.2-b892153    3.0.2-b1052646   10.2.5                          10.3.4a                         false           60               true             host,compute  
  spine                      switch          3.0.2-b892153    3.0.2-b1052646   10.2.5                          10.3.4a                         false           60               true             host,compute