アクティブなバージョン3.0.2-b892153から3.0.2-b1185392

Private Cloud Applianceでビルド番号3.0.2-b892153のソフトウェア・バージョンを3.0.2-b1185392 (両方とも含まれる)に実行している場合は、この項の手順に従ってアプライアンス・ソフトウェア・バージョン3.0.2-b1261765にアップグレードします。

アプライアンスのアップグレードの準備

注意:

Private Cloud Applianceをアップグレードまたはパッチ適用する場合は、他の「サービス・エンクレーブ」操作が進行中または起動されていないことを確認してください。 アップグレードまたはパッチ適用プロセスは、アプライアンス管理アクティビティによって悪影響を受ける可能性があります。これには、次のものが含まれますが、これらに限定されません: コンピュート・ノードの操作(プロビジョニングやリブートなど)、管理ノード・クラスタでの操作、ハードウェアまたはソフトウェア・コンポーネントでの構成の変更、ラック・ネットワーク接続の変更、パスワードの変更など。

アプライアンス管理者は、常にサポートされているインタフェースを使用する必要があります: 「サービスCLI」および「サービスWeb UI」。 Linuxコマンドラインまたは昇格されたアクセス権限(あるいはその両方)からAPIを介して提供されない操作の実行は、Oracleによって明示的な指示が提供されないかぎり、サポートされていません。

注意:

冗長性が組み込まれた詳細なアプライアンス・アーキテクチャにより、管理者はダウンタイムなしでコンポーネントをアップグレードまたはパッチ適用できます。 ただし、アップグレードまたはパッチ・ワークフローの進行中は、リソースの容量とパフォーマンスが低下する可能性があります。

アップグレードまたはパッチ適用を担当する管理者は、このような計画メンテナンス操作を事前にすべての「コンピュート・エンクレーブ」ユーザーに通知することをお薦めします。

これは、メンテナンス・ウィンドウ中に新しいクラスタ・デプロイメントが許可されず、一部のタイプのアプリケーション・クラスタでサービスの中断が発生する可能性があるため、「Oracle Private Cloud Appliance Kubernetesエンジン(OKE)」のユーザーに特に重要です。

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

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

アップグレード・ステップを開始する前に、次のステップを実行したことを確認してください:

  1. 新しいソフトウェアISOイメージを適切なロケーションにダウンロードします。

  2. アップグレードの実行に必要な権限があることを確認します。

  3. 現在のシステム構成をバックアップします。

  4. アップグレード環境を事前構成します。

  5. コンポーネント・アップグレード手順を実行するための新しいアプライアンス・ソフトウェア・ソースを設定します。

ノート:

ソフトウェア・バージョン3.0.2-b1185392では、アップグレードおよびパッチ適用ワークフローの準備フェーズが再設計され、最新リリースのUpgrader機能ができるだけ早くアプライアンスに取り込まれるようになりました。 そのため、一部の操作は、アップグレードまたはパッチ・プロセスの開始時にアプライアンスのアクティブなソフトウェア・バージョンによって異なります。 このガイドの指示は、これらの違いについて説明しています。

アップグレード前、アップグレード中、およびアップグレード後のアプライアンスのステータスを確認するためのツールが用意されています。 アップグレード・ワークフローはアップグレード計画に従います。アップグレード計画では、いつでも確認して進捗状況を追跡できます。

パーミッションの確認

アップグレードまたはパッチ・ワークフローを実行できるようにするには、「サービス・エンクレーブ」にログインするための管理者アカウントが必要です。 これらの認可グループのいずれかのメンバーである必要があります: SuperAdmin、AdminまたはDR Admin。 詳細は、「Oracle Private Cloud Appliance管理者ガイド」の章「管理者アカウント管理」を参照してください。

サービスCLIにログインすると、これらのオブジェクト・カテゴリにすべてのカスタム・コマンドまたはカスタム・コマンドを表示することで、アップグレードおよびパッチ・コマンドが使用可能であることを確認できます: UpgradeRequest, PatchRequest, UpgradeJob, UpgradeJobList。 コマンドのリストは、アクセス・プロファイルに基づいてフィルタ処理されます。 upgradeおよびpatchコマンドがリストされている場合は、それらを実行する権限があることを意味します。 

PCA-ADMIN> showallcustomcmds
    Operation Name: <Related Object(s)>
    -----------------------------------
    getUpgradeHistory:  UpgradeRequest
    getUpgradeHistoryDetails:  UpgradeRequest
    getUpgradeJob:  UpgradeJob
    getUpgradeJobs:  UpgradeJobList
    getUpgradePlan:  UpgradeRequest
    getUpgradeRequests:  UpgradeRequest
    getUpstreamUlnChannel:  PatchRequest
    getUpstreamUlnChannels:  PatchRequest
[...]

PCA-ADMIN> showcustomcmds PatchRequest
    patchCN
    patchIlom
    patchOCIImages
    patchSwitch
[...]
    setUpstreamUlnMirror
    syncUpstreamUlnMirror
    getUpstreamUlnChannels
    getUpstreamUlnChannel
    addUpstreamUlnChannel
    removeUpstreamUlnChannel

PCA-ADMIN> showcustomcmds UpgradeJob
    getUpgradeJob
    killUpgradeJob

PCA-ADMIN> showcustomcmds UpgradeJobList
    getUpgradeJobs

PCA-ADMIN> showcustomcmds UpgradeRequest
    getUpgradeRequests
    upgradeFullMN
    upgradeCN
    upgradeIlom
    upgradeSwitch
[...]

アプライアンス更新前のバックアップ

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

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

注意:

アプライアンス・ソフトウェア・バージョン3.0.2-b1081557以降では、Prometheusからのモニタリング・データは自動バックアップに含まれません。 Prometheusデータを保持するには、バックアップを作成して手動でリストアします。 詳細は、「ドキュメントID 3021643.1」のノートを参照してください。

「サービスCLI」の使用

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

    PCA-ADMIN> backup target=vault
Status: Success
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
Status: Success
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
Status: Success
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
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
Status: Success
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つのバックアップ操作がすべて正常に完了したことを確認します。 次に、次のアップグレード準備フェーズに進みます。

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

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

事前構成ワークフローは、アップグレード前のアクティブなアプライアンス・ソフトウェアのバージョンによって異なります。

  • 3.0.2-b1185392より古いバージョンを実行しているシステムでは、upgradePreConfigおよびpreUpgradeコマンドにより、システムおよびコンポーネントのアップグレードを実行するために、新しいソフトウェア・パッケージ、最新のアップグレード・コードおよびアップグレード計画が実施されます。

  • システムでバージョン3.0.2-b1185392が実行されている場合は、新しいスクリプトがワークフローに追加されます。 内部ストレージにダウンロードすると、新しいアプライアンス・ソフトウェアISOがマウントされるため、pca-prerequisiteスクリプトをインストールして実行できます。 すべてのスクリプト操作が完了すると、ISOは再度アンマウントされます。

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

    • 現在および新しいソフトウェア・バージョンの検証

    • 最新のpreUpgrade機能のインストール

    • 最新のUpgraderコードをアプライアンスにコピー

    • 次の準備フェーズで使用するyamlファイルへの環境パラメータの書き込み

    • 新しいアップグレード履歴ファイルの生成

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

注意:

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

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

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

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

「サービスCLI」の使用

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

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

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

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

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

  2. 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=90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027
Status: Success
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
  --                               ----------------                           -----------   ------
  1668417666968-prepare-28142      UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186   prepare       Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1668417666968-prepare-28142

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

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

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

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

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

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

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

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

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

  6. 「要求の作成」をクリックします。

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

アップグレード用の新規ソフトウェア・ソースの設定

アップグレード準備の設定フェーズでは、すべてのアップグレード・コマンドが最新バージョンで実行されるように、最初にUpgraderが最新であることが保証されます。 Upgraderが使用可能な最新バージョンでないことがシステムで検出された場合、アップグレード操作は実行できません。

ソフトウェア・ソースは、アップグレード前のアクティブなアプライアンス・ソフトウェアのバージョンに応じて異なる方法で処理されます。

  • バージョン3.0.2-b1185392を実行しているシステムでは、最新バージョンのUpgraderが最初にインストールされます。 次に、新しいアプライアンス・ソフトウェアのソースが、システム・アップグレード手順で使用できるように設定されます。 現在のソフトウェア・イメージがバックアップされ、新しいソフトウェアISOが適切なディレクトリ構造の管理クラスタ共有ストレージに開梱されます: アプライアンス・ソフトウェアのRPMパッケージ、新しいイメージ、新しいファームウェアなど。

  • 3.0.2-b1185392より前のバージョンを実行しているシステムでは、事前構成中に別のパッケージ設定がすでに完了していました。 このフェーズでは、最新のアップグレード・コードが確実に配置されます。

設定フェーズの最後に、「アップグレード計画」が生成されます。 アップグレード計画は、現在のインストールと開梱された新しいバージョンの比較に基づきます。 次のフェーズで実行する必要があるアップグレード手順を決定します。 詳細は、「アップグレード計画ステータスおよび進捗のチェック」を参照してください。

この設定プロセス全体が、単一のコマンドでアプライアンス管理者によって起動されます。

注意:

最初に事前構成プロセスが完了していることを確認します。

後でアップグレード計画を実行する際に不整合を回避するには、準備プロセス内のupgradePreConfig (事前構成)およびpreUpgrade (設定)の両方のコマンドを指定された順序でまとめて完了することが重要です。 preUpgradeコマンドを再実行する必要がある場合は、先に前のコマンドを再実行する必要があります。

「サービスCLI」の使用

  1. 最新のUpgraderバージョンのインストールと、新しいアプライアンス・ソフトウェア・ソースの設定を開始します。

    • 3.0.2-b1185392より古いアクティブなバージョン: 

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

    • アクティブ・バージョン3.0.2-b1185392以降: 

      PCA-ADMIN> preUpgrade type=ISO
Status: Running
JobId: 1714591883904-setup-25325
Data: in progress

    次のコマンドで実行されるアップグラダ操作:

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

    2. 新しいUpgraderファイルのyumリポジトリを構成します。

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

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

    次のコマンドで実行される設定操作:

    1. 現在のソフトウェア・イメージをバックアップします。

    2. ISOを開梱し、新しいソフトウェアRPMとインストール・ファイル(イメージ、ファームウェア)を正しいディレクトリに格納します。

    3. アプライアンスの内部共有ストレージから不要になったバックアップおよびイメージを削除します。

    4. アップグレード計画を生成します。

    ノート:

    アクティブなソフトウェア・バージョンが3.0.2-b1185392より古い場合、事前構成時に別のパッケージ設定がすでに完了しています。 アップグレード計画は、常にバージョン3.0.2-b892153以降で生成されます。

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

    • 3.0.2-b1185392より古いアクティブなバージョン: 

      PCA-ADMIN> preUpgrade action=status
Data: 
   The previous pre-upgrade task succeeded!
   Pre upgrade status = SUCCESS

    • アクティブ・バージョン3.0.2-b1185392以降: 

      PCA-ADMIN> getPreUpgradeStatus
Data:
  status = IN-PROGRESS
  message =  A pre-upgrade task is running!

PCA-ADMIN> getPreUpgradeStatus
Data:
  status = SUCCESS
  message =  The previous pre-upgrade task succeeded!

  3. Upgraderの最新バージョンが正常にインストールされていることを確認します。

    アクティブ・バージョン3.0.2-b1185392以降: preUpgradeプロセスが失敗した場合は、アップグレード・ジョブでトラブルシューティング情報を確認してください。 

    PCA-ADMIN> getUpgradeJob upgradeJobId=1714591883904-setup-25325
Data:
  Upgrade Request Id = PREUPGRADE-7b5d6235-fdfa-4830-8824-349a5e1b9d47
  Name = setup
  Pid = 25325
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_setup_upgrade_environment_2024_05_01-19.31.23.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-7b5d6235-fdfa-4830-8824-349a5e1b9d47","uln":null,"patch":null}
  Status = Failed
  Execution Time(sec) = 1069
  Tasks 1 - Name = Configure MN Yum Repo
  Tasks 2 - Name = Validate Image Location
  Tasks 3 - Name = Validate Upgrader Version
  Tasks 4 - 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
  Tasks 27 - Name = UpdateHistoryTask
  Tasks 27 - Message = Failed to update the history of upgrade
  Tasks 27 - Status = Failed

  4. システムが準備完了状態であることを確認します。 次に、コンポーネントのアップグレードに進みます。

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

    PCA-ADMIN> getUpgradePlan
Data:
  id                          componentType   currentBuild     targetBuild      currentVersion                  targetVersion                    requireReboot   timeEstimation   requireUpgrade   impactedInfra 
  --                          -------------   ------------     -----------      --------------                  -------------                    -------------   --------------   --------------   ------------- 
  generic                     zfssa           3.0.2-b892153    3.0.2-b1261765   2013.06.05.8.57.1-2.57.5392.2   2013.06.05.8.73.1-2.73.5701.1    false           45               true             host,compute  
  100.96.2.64                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.65                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.66                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.67                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.68                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.69                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.33                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  100.96.2.34                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  100.96.2.35                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  generic                     mysql           3.0.2-b892153    3.0.2-b1261765   8.0.28-1.1                      8.0.36-1.1                       false           15               true             host          
  generic                     etcd            3.0.2-b892153    3.0.2-b1261765   3.3.10                          3.5.6                            false           5                true             host          
  generic                     vault           3.0.2-b892153    3.0.2-b1261765   v1.7.1-3                        v1.7.1-3                         false           5                true             host          
  generic                     kubernetes      3.0.2-b892153    3.0.2-b1261765   1.20.6-1                        1.25.16-2                        false           350              true             host,compute  
  generic                     platform        3.0.2-b892153    3.0.2-b1261765   None                            None                             false           50               true             host,compute  
  Oracle-Linux-7.9            ociImages       3.0.2-b892153    3.0.2-b1261765   2022.08.29_0                    2024.07.31_0                     false           5                true             host          
  Oracle-Linux-8              ociImages       3.0.2-b892153    3.0.2-b1261765   2022.08.29_0                    2024.07.31_0                     false           5                true             host          
  Oracle-Linux-9              ociImages       3.0.2-b892153    3.0.2-b1261765   None                            2024.07.31_0                     false           5                true             host          
  Oracle-Linux8-OKE-1.26.15   ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Linux8-OKE-1.27.12   ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Linux8-OKE-1.28.8    ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Solaris-11           ociImages       3.0.2-b892153    3.0.2-b1261765   2023.04.18_0                    2024.08.26_0                     false           5                true             host          
  100.96.0.33                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.34                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.35                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.64                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.65                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.66                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.67                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  leaf                        switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute  
  mgmt                        switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute  
  spine                       switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

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

    • アクション: このパラメータは、バージョン3.0.2-b1185392以降で使用できなくなりました。 startと入力して、新しいバージョンのアップグレーダを取得します。 (前のpreUpgradeジョブのステータスを確認するには、かわりに「ステータス」を入力します。)

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

  6. 「要求の作成」をクリックします。

    新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。 ジョブが正常に完了すると、Upgraderは最新の状態になり、新しいソフトウェア・バージョン・ソースを使用できます。

アップグレードの準備状況とステータスの確認

最新の機能とセキュリティおよび安定性を利用するには、通常、システム上で最新バージョンのPrivate Cloud Applianceオペレーティング・ソフトウェアを実行することをお薦めします。 アップグレードまたはパッチ適用によって、アプライアンス・ソフトウェアを最新バージョンにするためのプロセスは、中断を最小限に抑えるように設計されています: システムでは、パフォーマンスまたは可用性が一時的に低下する可能性がありますが、ワークロードはダウンタイムなしで引き続き実行されます。

アプライアンス管理者がアップグレードまたはパッチ適用の準備をしたり、アプライアンスを現在のソフトウェア・バージョンから最新のものにするために必要な作業範囲を設定したり、進行中のアップグレードまたはパッチ・ワークフローの進捗状況を監視したりできるように、このセクションで説明する一連のコマンドおよびツールがシステムに用意されています。 遅延や中断のリスクを最小限に抑えながら、プロセスをできるだけ流暢にするには、まず検証専用モードでコマンドを実行することをお勧めします。 管理者の最も重要なツールは、アップグレード計画です。この計画では、必要なすべてのステップが正しい順序で表示され、開始から完了までの進捗情報が表示されます。

コンポーネントの現在のバージョンの確認

アップグレード要件とアップグレードの影響を評価するために、トップレベルのラック・コンポーネントの現在の状態を確認できます。 このガイドには、アップグレード手順が記載されているすべてのコンポーネントの最も重要なビルド番号とバージョン番号がリストされています。

コンポーネント・バージョン・リストは、次の2つの方法で表示できます:

  • 「サービスWeb UI」で、ナビゲーション・メニューの「メンテナンス」に移動し、「コンポーネント・バージョン」を選択します。

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

    PCA-ADMIN> getComponentVersions
Data:
  id                         component    iso              version
  --                         ---------    ---              -------
  100.96.2.64                compute      3.0.2-b1046481   3.0.2-687
  100.96.2.65                compute      3.0.2-b1046481   3.0.2-687
  100.96.2.66                compute      3.0.2-b1046481   3.0.2-687
  100.96.2.67                compute      3.0.2-b1046481   3.0.2-687
  100.96.2.68                compute      3.0.2-b1046481   3.0.2-687
  100.96.2.69                compute      3.0.2-b1046481   3.0.2-687
  generic                    etcd         3.0.2-b1049367   3.3.10
  100.96.2.33                host         3.0.2-b1049367   oraclelinux-release-7.9-1.0.9
  100.96.2.34                host         3.0.2-b1049367   oraclelinux-release-7.9-1.0.9
  100.96.2.35                host         3.0.2-b1049367   oraclelinux-release-7.9-1.0.9
  100.96.0.33                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.34                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.35                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.64                ilom         3.0.2-b1049367   5.1.2.20.a
  100.96.0.65                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.66                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.67                ilom         3.0.2-b1049367   5.1.2.20.a
  100.96.0.68                ilom         3.0.2-b1049367   5.1.1.21
  100.96.0.69                ilom         3.0.2-b1049367   5.1.1.21
  generic                    kubernetes   3.0.2-b1049367   1.25.15-1
  generic                    mysql        3.0.2-b1049367   8.0.33-1.1
  Oracle-Linux-7.9           ociImages    3.0.2-b1049367   2023.09.26_0
  Oracle-Linux-8             ociImages    3.0.2-b1049367   2023.09.26_0
  Oracle-Linux-9             ociImages    3.0.2-b1049367   2023.09.26_0
  Oracle-Linux8-OKE-1.26.6   ociImages    3.0.2-b1049367   20240210
  Oracle-Linux8-OKE-1.27.7   ociImages    3.0.2-b1049367   20240209
  Oracle-Linux8-OKE-1.28.3   ociImages    3.0.2-b1049367   20240210
  Oracle-Solaris-11          ociImages    3.0.2-b1049367   2023.10.16_0
  generic                    platform     3.0.2-b1046481   None
  leaf                       switch       3.0.2-b1049367   10.3.4a
  mgmt                       switch       3.0.2-b1049367   10.3.4a
  spine                      switch       3.0.2-b1049367   10.3.4a
  generic                    vault        3.0.2-b1049367   v1.7.1-3
  generic                    zfssa        3.0.2-b1046481   2013.06.05.8.57.1-2.57.5501.1

システム・アップグレード履歴の確認

ノート:

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

すべてのコンポーネント・アップグレードおよびパッチに関する情報は、アップグレード・ジョブに格納され、「サービスWeb UI」および「サービスCLI」で参照できます。 時間が経つにつれて、システムが複数のアップグレードを経るにつれ、多数のエントリによってリストの解釈が困難になることがあります。 アップグレード履歴は、アプライアンスのアップグレードおよびパッチ適用アクティビティの詳細にドリルダウンする明確な方法を提供します。

アップグレード履歴には、すべてのアップグレード・ジョブおよびパッチ・ジョブからの情報が分類された方法で表示されるため、実行されたバージョン・アップグレード、それらのアップグレードごとに実行されたジョブ、およびソース(ISOアップグレードまたはULNパッチ)を確認できます。 詳細には、ビルド・バージョン、前後のコンポーネント・バージョン、ジョブ完了、成功または失敗、タイムスタンプおよび期間が含まれます。

アプライアンス・ソフトウェア・ビルドは、ISOイメージからのアップグレードまたはULNからのパッチ適用によってアプライアンスにインストールされます。 次のコマンドを実行して、ビルド履歴を表示します。 

PCA-ADMIN> GetUpgradeHistory
Data:
  id                                   From Build       To Build          Type       Status         Start Time               End Time               Actual Upgrade Time(min)   Total Upgrade Time(min)  
  --                                   -----            -------           -----      --------       ----------               --------               --------------             ------------
  pca-upgrade-history-3.0.2-b951413    3.0.2-b868711    3.0.2-b951413     ISO        Incomplete     2023-06-14T10:32:14      2023-06-14T15:32:14    300                        600
  pca-upgrade-history-3.0.2-b868711    3.0.2-b854356    3.0.2-b868711     ULN        Completed      2023-01-01T15:10:07      2023-01-01T19:10:07    250                        500
  pca-upgrade-history-3.0.2-b854356    3.0.2-b790137    3.0.2-b854356     ISO        Completed      2022-12-14T06:01:00      2022-12-14T12:01:00    350                        700

必要に応じて、結果をタイプでフィルタできます。

PCA-ADMIN> GetUpgradeHistory type=uln
Data:
  id                                   From Build       To Build          Type       Status         Start Time               End Time               Actual Upgrade Time(min)   Total Upgrade Time(min)  
  --                                   -----            -------           -----      --------       ----------               --------               --------------             ------------
  pca-upgrade-history-3.0.2-b868711    3.0.2-b854356    3.0.2-b868711     ULN        Completed      2023-01-01T15:10:07      2023-01-01T19:10:07    250                        500

特定のビルドに関連するアップグレード・ジョブ・リストを表示するには、ビルドIDをコピーして次のコマンドを実行します:

PCA-ADMIN> GetUpgradeHistoryDetails id=pca-upgrade-history-3.0.2-b951413
Data:
  id           component  Timestamp             From Version                    To Version                      Status   Job ID                                Time Taken(min)
  --           ---------  ---------             ------------                    ----------                      -------  -------                              ----------
  spine        cisco      2023-06-14T10:32:14   9.3.2                           10.2.3                           Failed   1686766376945-cisco-1509              50
  mgmt         cisco      2023-06-14T10:22:14   9.3.2                           10.2.3                           Passed   1686762287214-cisco-31252             60
  leaf         cisco      2023-06-14T10:12:14   9.3.2                           10.2.3                           Passed   1686758831077-cisco-35671             45
  generic      zfssa      2023-06-14T09:52:14   2013.06.05.8.40.1-2.40.4958.31  2013.06.05.8.48.1-2.48.5222.1    Passed   1686768921264-zfssa-19292             30
  100.96.0.66  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19293              55
  100.96.0.65  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19292              50
  100.96.0.64  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19294              60
  100.96.0.35  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19295              35
  100.96.0.34  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19296              30
  100.96.0.33  ilom       2023-06-14T09:22:14   5.0.2.23                        5.1.1.21                         Passed   1686768921264-ilom-19297              65
  generic      platform   2023-06-14T09:12:14   None                            None                             Passed   1686552138506-platform-48794          100
  generic      kubernetes 2023-06-14T09:12:14   1.20.6-1                        1.25.7-1                         Passed   1685379294807-kubernetes-72808        40
  generic      vault      2023-06-14T09:12:14   v1.7.1-3                        v1.7.1-3                         Passed   1685614045193-vault-47652             63
  generic      etcd       2023-06-14T09:02:14   3.3.10                          3.3.10                           Passed   1685613743232-etcd-83924              50
  generic      mysql      2023-06-14T08:52:14   8.0.28-1.1                      8.0.30-1.1                       Passed   1685378389035-mysql-90009             45
  100.96.2.35  host       2023-06-14T08:42:14   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9    Passed   1686726229799-host-68919              20
  100.96.2.34  host       2023-06-14T08:32:14   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9    Passed   1686726229799-host-68919              30
  100.96.2.33  host       2023-06-14T08:22:14   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.9    Passed   1686726229799-host-68919              25
  100.96.2.66  compute    2023-06-14T07:52:14   3.0.2-502                       3.0.2-630                        Passed   1685607717395-compute-53331           50
  100.96.2.65  compute    2023-06-14T07:42:14   3.0.2-502                       3.0.2-630                        Passed   1685606912300-compute-91673           66
  100.96.2.64  compute    2023-06-14T07:32:14   3.0.2-502                       3.0.2-630                        Passed   1685372050358-compute-50568           30
  100.96.2.64  compute    2023-06-14T07:22:14   3.0.2-502                       3.0.2-630                        Failed   1685372050358-compute-50560           45
  generic      preupgrade 2023-06-14T06:32:14   3.0.2-b868711                   3.0.2-b951413                    N/A      N/A                                   N/A

ノート:

または、この情報を「サービスWeb UI」で表示できます。 ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード履歴」をクリックします。

システムの準備完了状態の確認

アップグレードは、システムへの影響を限定して実行できます。 ダウンタイムは不要で、基礎となるインフラストラクチャが段階的にアップグレードされている間、ユーザー・ワークロードは引き続き実行されます。 ただし、システムのバックアップおよび環境内のリソースを確実に作成することをお薦めします。

障害ログ

ノート:

「アップグレード・フォルト」カテゴリは、アプライアンスがソフトウェア・バージョン3.0.2-b1185392以降を実行している場合に使用できます。

アップグレードの準備をするときは、システム障害ログを確認します。 アップグレードおよびパッチ適用に対する潜在的な影響に関する問題は、「アップグレード・フォルト」としてフラグが付けられ、アップグレードまたはパッチ・コマンドの実行が妨げられます。 「サービスCLI」は、次の例に示すように、これらのフォルトのフィルタリング・オプションを提供します: 

PCA-ADMIN> list fault fields upgradeFault,Status,Severity
Data:
  id                                     Upgrade Fault   Status    Severity
  --                                     -------------   ------    --------
  37f6cefe-f7d5-49a8-adff-76c1a020bcc8   False           Cleared   Critical
  2be57600-4dbd-40f0-a0f8-e4ffbb2c8468   True            Active    Critical
  297c770e-16e1-11ef-9e78-a8698c107234   True            Cleared   Major
  d27e0895-eb87-4e66-bd4b-f6500153cf64   True            Cleared   Critical
  77752a35-4cf7-49ed-88df-06158d846358   True            Active    Critical
  9ff4fe22-8ed6-463f-95b5-458d6a76d185   False           Active    Critical
  0a09204c-953e-4df3-912b-a2a175ce8c1a   True            Cleared   Critical
[...]

PCA-ADMIN> list fault where upgradeFault EQ True
Data:
  id                                     Name                                        Status    Severity
  --                                     ----                                        ------    --------
  2be57600-4dbd-40f0-a0f8-e4ffbb2c8468   pcamn01--PCA-8000-44--asrclient             Active    Critical
  297c770e-16e1-11ef-9e78-a8698c107234   ilom-pcacn001--PCA-8000-EA--ilom-pcacn001   Cleared   Major
  0a09204c-953e-4df3-912b-a2a175ce8c1a   pcamn01--PCA-8000-AH--mysql_cluster         Cleared   Critical
  f7da7c82-03bc-4383-95cf-542cefbb5d39   pcamn01--PCA-8000-CD--mysql_cluster         Cleared   Critical
  74fd23ac-3006-4ab6-9c50-544869ba78f9   pcamn02--PCA-8000-6C--registry              Cleared   Critical
  dc77b088-939d-4725-b45f-1072024b02ba   pcamn02--PCA-8000-0E--etcd                  Cleared   Critical
  d27e0895-eb87-4e66-bd4b-f6500153cf64   pcamn01--PCA-8000-22--vault                 Cleared   Critical
  77752a35-4cf7-49ed-88df-06158d846358   pcamn01--PCA-8000-93--mysql_cluster         Active    Critical

事前チェック

すべてのアップグレード操作の前に、事前チェックのセットがあります。 これらはアップグレード・コードに組み込まれており、システムがアップグレードに必要な状態でない場合、エラーを報告します。 アップグレードは、すべての事前チェックに合格した場合にのみ開始されます。

事前チェックを使用して、アップグレードの成功を妨げるシステム・ヘルスの問題を事前にテストできます。 アップグレード環境を準備したら、「verify only」オプションを使用してアップグレード・コマンドのいずれかまたはすべてを実行します。

注意:

Oracleでは、管理ノード全体のアップグレード・コマンドを検証専用モードで実行して、Private Cloud Applianceをアップグレードする準備が整っていることをテストすることを強くお薦めします。 出力には、修正処理およびアップグレードの計画に使用できる準備状況レポートが表示されます。

この検証の完了には時間がかかる場合があります。 スケジュールされたウィンドウ内で実際のアップグレードを完了できるように、事前に十分に実行してください。

「サービスWeb UI」では、アップグレード・リクエストの作成時にチェック・ボックスを使用して検証専用オプションがアクティブ化されます。「サービスCLI」では、次の例に示すオプションのアップグレード・コマンド・パラメータを使用します: 

PCA-ADMIN> upgradeKubernetes verifyOnly=True
[...]

PCA-ADMIN> getUpgradeJobs
  id                                      upgradeRequestId                           commandName          result
  --                                      ----------------                           -----------          ------
  1632849609034-kubernetes_verify-35545   UWS-8995e5b7-a237-4717-bb5c-01f1cf85daf0   kubernetes_verify    Passed

障害ログまたは事前チェックから問題が検出された場合は、計画されたアップグレード・ウィンドウの前に問題を解決し、実際のシステム・アップグレードをできるだけ流暢かつ短く保つことができます。

同時アップグレード操作はサポートされていないことに注意してください。 アップグレード・ジョブは、新しいジョブを開始する前に完了する必要があります。

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

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

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

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

注意:

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

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

  1. アップグレード環境の準備(PreConfigをアップグレード)

  2. Upgraderのアップグレード(PreUpgrade)

  3. ZFS Storage Applianceファームウェア(バージョン3.0.2-b1081557以上)

  4. コンピュート・ノード

  5. 管理ノードのホスト・オペレーティング・システム

  6. MySQLクラスタ・データベース

  7. シークレット・サービス(EtcdおよびVaultを含む)

  8. Kubernetesコンテナ・オーケストレーション・パッケージ(プラットフォーム・レイヤー)

  9. コンテナ化されたマイクロサービス

  10. Oracle Cloud Infrastructureイメージ

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

アップグレード計画の進行状況は、いつでも確認できます。 これは、どのコンポーネントが最新で、どのコンポーネントをアップグレードする必要があるかを示します。

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

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

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

    PCA-ADMIN> getUpgradePlan
Data:
  id                          componentType   currentBuild     targetBuild      currentVersion                  targetVersion                    requireReboot   timeEstimation   requireUpgrade   impactedInfra 
  --                          -------------   ------------     -----------      --------------                  -------------                    -------------   --------------   --------------   ------------- 
  generic                     zfssa           3.0.2-b892153    3.0.2-b1261765   2013.06.05.8.57.1-2.57.5392.2   2013.06.05.8.73.1-2.73.5701.1    false           45               true             host,compute  
  100.96.2.64                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.65                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.66                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.67                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.68                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.69                 compute         3.0.2-b892153    3.0.2-b1261765   3.0.2-640                       3.0.2-859                        true            20               true             compute       
  100.96.2.33                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  100.96.2.34                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  100.96.2.35                 host            3.0.2-b892153    3.0.2-b1261765   oraclelinux-release-7.9-1.0.9   oraclelinux-release-7.9-1.0.13   true            35               true             host          
  generic                     mysql           3.0.2-b892153    3.0.2-b1261765   8.0.28-1.1                      8.0.36-1.1                       false           15               true             host          
  generic                     etcd            3.0.2-b892153    3.0.2-b1261765   3.3.10                          3.5.6                            false           5                true             host          
  generic                     vault           3.0.2-b892153    3.0.2-b1261765   v1.7.1-3                        v1.7.1-3                         false           5                true             host          
  generic                     kubernetes      3.0.2-b892153    3.0.2-b1261765   1.20.6-1                        1.25.16-2                        false           350              true             host,compute  
  generic                     platform        3.0.2-b892153    3.0.2-b1261765   None                            None                             false           50               true             host,compute  
  Oracle-Linux-7.9            ociImages       3.0.2-b892153    3.0.2-b1261765   2022.08.29_0                    2024.07.31_0                     false           5                true             host          
  Oracle-Linux-8              ociImages       3.0.2-b892153    3.0.2-b1261765   2022.08.29_0                    2024.07.31_0                     false           5                true             host          
  Oracle-Linux-9              ociImages       3.0.2-b892153    3.0.2-b1261765   None                            2024.07.31_0                     false           5                true             host          
  Oracle-Linux8-OKE-1.26.15   ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Linux8-OKE-1.27.12   ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Linux8-OKE-1.28.8    ociImages       3.0.2-b892153    3.0.2-b1261765   None                            20240908                         false           5                true             host          
  Oracle-Solaris-11           ociImages       3.0.2-b892153    3.0.2-b1261765   2023.04.18_0                    2024.08.26_0                     false           5                true             host          
  100.96.0.33                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.34                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.35                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.64                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.65                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.66                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.67                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153    3.0.2-b1261765   5.0.2.23                        5.1.4.25                         true            10               true             host,compute  
  leaf                        switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute  
  mgmt                        switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute  
  spine                       switch          3.0.2-b892153    3.0.2-b1261765   10.2.5                          10.3.4a                          false           60               true             host,compute

コンピュート・ノードのアップグレード

注意:

システム・アップグレードの準備ステップがすべて完了していることを確認します。

ZFS Storage Applianceファームウェアは、他のすべてのコンポーネントより前にアップグレードする必要があります。 詳細は、「アップグレード計画ステータスおよび進捗のチェック」を参照してください。

コンピュート・ノードのアップグレードにより、最新のOracle Linuxカーネルおよびユーザー領域パッケージ、およびアプライアンス固有の最適化を含むovm-agentパッケージがインストールされます。 コンピュート・ノードは一度に1つずつロックおよびアップグレードする必要があります。同時アップグレードはサポートされていません。 アップグレードが成功したら、コンピュート・ノードがリブートされたときに、管理者は手動でロックを削除して、ノードを通常の操作に戻すことができるようにする必要があります。

ノート:

ILOMもアップグレードする必要がある場合は、オプションのステップを実行して、このプロシージャに統合できます。 組み合せた手順により、同じノードを2回退避してリブートする必要がなくなります。

ノート:

ソフトウェア・バージョン3.0.2-b892153以降では、アップグレード前プロセス中に生成された「アップグレード計画」を使用して、アップグレードが必要な特定のコンポーネントおよび順序を決定します。 コンポーネントがすでに必要なバージョンにある場合、アップグレード・コマンドはアップグレード・ジョブを開始します。ただし、アップグレード計画では何も実行できないことが示されているため、ただちに完了します。

実際には、コンポーネントがすでに必要なバージョンである場合、アップグレード手順はスキップされます。 ただし、必要に応じて「サービスWeb UI」または「サービスCLI」コマンド・オプションを使用して、同じバージョンのアップグレードを強制できます。 次に例を示します: upgradeCN hostIp=100.96.2.64 force=True。

ホストIPアドレスの取得

「サービスCLI」から、各内部IPアドレスをコマンド・パラメータとして使用して、コンピュート・ノードが一度に1つずつアップグレードされます。 ただし、ロック・コマンドでは代わりにコンピュート・ノードIDが使用されます。 コンピュート・ノード・アップグレードのすべてのコマンドを実行するには、両方の識別子が必要です。

ホストのIPアドレスとID、およびアップグレード手順に関連するその他の情報を取得するには、次の例に示す「サービスCLI」コマンドを使用します。 コマンドは、すべてのコンピュート・ノードのアップグレードを進めるときに、必要に応じて頻繁に実行してステータスを確認および確認できます。 

PCA-ADMIN> list computeNode fields hostname,ipAddress,ilomIp,state,firmwareVersion,provisioningLocked,maintenanceLocked orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version           Provisioning Locked   Maintenance Locked
  --                                     --------   ----------    ---------------   -----   ----------------           -------------------   ------------------
  cf488903-fef8-4a51-8a41-c6990e4755c5   pcacn001   100.96.2.64   100.96.0.64       On      PCA Hypervisor:3.0.2-681   false                 false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.2-681   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.2-681   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.2-681   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.2-681   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.2-681   false                 false

置き換えられたインスタンスのモニタリング

コンピュート・ノードのアップグレードまたはパッチ適用中は、アクティブなコンピュート・インスタンスが存在できないため、ノードを退避してメンテナンスのためにロックする必要があります。 コンピュート・ノードを退避するために、Compute Serviceは、同じフォルト・ドメイン内の別のコンピュート・ノードにインスタンスをライブ移行します。 フォルト・ドメインに十分な容量がない場合、高可用性の構成設定によって、インスタンスが別のフォルト・ドメインにライブ移行され、必要な容量が再度使用可能になると、選択したフォルト・ドメインに戻されることがあります。

割り当てられたフォルト・ドメインから移行されたコンピュート・インスタンスは、「置き換えられたインスタンス」と呼ばれます。 移行によって、コンピュート・ノードのアップグレードやパッチ適用が妨げられる場合があります。 特定のコンピュート・ノード上のロックが解放されると、その置き換えられたインスタンスは元の移行を開始し、その間はメンテナンスのために次のコンピュート・ノードをロックできない可能性があります。

コンピュート・ノードをアップグレードまたはパッチ適用する前に、置き換えられたインスタンスのステータスを監視します。 リストが空になるまで次のコンピュート・ノードに進ま「ない」でください。

  • 「サービスCLI」で、コマンドgetDisplacedInstancesを使用します。 次の例では、2つのインスタンスがフォルト・ドメイン1から移行されています。 

    PCA-ADMIN> getDisplacedInstances
Data:
 id                        displayName  compartmentId                faultDomain     faultDomainSelected
 --                        -----------  -------------                -----------     -------------------
 ocid1.instance.unique_ID  inst-name    ocid1.compartment.unique_ID  FAULT-DOMAIN-3  FAULT-DOMAIN-1
 ocid1.instance.unique_ID  inst-name    ocid1.compartment.unique_ID  FAULT-DOMAIN-2  FAULT-DOMAIN-1

  • サービスWeb UIで、ナビゲーション・メニューをクリックし、「FDインスタンス」をクリックしてから「置き換えられたインスタンス」をクリックします。

詳細は、Oracle Private Cloud Appliance管理者ガイドのハードウェア管理の章にある次の項を参照してください:

「サービスCLI」の使用

  1. 前述のコンピュート・ノード・リスト・コマンドで取得した出力から、アップグレードするコンピュート・ノードのIDとIPアドレスを取得します。

  2. アップグレードしようとしているコンピュート・ノードのプロビジョニング・ロックとメンテナンス・ロックを設定します。

    注意:

    コンピュート・サービスの高可用性構成によっては、自動インスタンス移行によって、コンピュート・ノードを正常にロックできない場合があります。 詳細は、Oracle Private Cloud Appliance管理者ガイドのハードウェア管理の章にある次の項を参照してください:

    1. コンピュート・ノードのプロビジョニングを無効にします。

      PCA-ADMIN> provisioningLock id=cf488903-fef8-4a51-8a41-c6990e4755c5
Status: Success
JobId: 6ee78c8a-e227-4d31-a770-9b9c96085f3f

    2. コンピュート・ノードを退避します。 移行ジョブが終了するまで待ってから、次のステップに進みます。

      ノート:

      物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。 ただし、厳密なフォルト・ドメイン強制(「厳密なFD」)ファンクションは無効にする必要があります。 

      PCA-ADMIN> migrateVm id=cf488903-fef8-4a51-8a41-c6990e4755c5
Status: Running
JobId: 6f1e94bc-7d5b-4002-ada9-7d4b504a2599

PCA-ADMIN> show Job id=6f1e94bc-7d5b-4002-ada9-7d4b504a2599
  Run State = Succeeded

    3. メンテナンスのためにコンピュート・ノードをロックします。

      PCA-ADMIN> maintenanceLock id=cf488903-fef8-4a51-8a41-c6990e4755c5
Status: Success
JobId: e46f6603-2af2-4df4-a0db-b15156491f88

    4. オプションで、コンピュート・ノード・リスト・コマンドを再実行してロック・ステータスを確認します。 たとえば: 

      PCA-ADMIN> list computeNode fields hostname,ipAddress,ilomIp,state,firmwareVersion,provisioningLocked,maintenanceLocked orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version           Provisioning Locked   Maintenance Locked
  --                                     --------   ----------    ---------------   -----   ----------------           -------------------   ------------------
  cf488903-fef8-4a51-8a41-c6990e4755c5   pcacn001   100.96.2.64   100.96.0.64       On      PCA Hypervisor:3.0.2-681   true                  true              
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.2-681   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.2-681   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.2-681   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.2-681   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.2-681   false                 false

  3. オプションで、最初にサーバーILOMをアップグレードします。

    1. ILOMアップグレード・コマンドを入力します。

      構文(1行に入力):

      upgradeIlom
hostIp=<ilom-ip>

      例:

      PCA-ADMIN> upgradeIlom hostIp=100.96.0.64
Data:
  Service request has been submitted. Upgrade Job Id = 1620921089806-ilom-21480 Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010

PCA-ADMIN> getUpgradeJob upgradeJobId=1620921089806-ilom-21480

    2. ILOMアップグレード・ジョブが完了するまで5分待ちます。 次に、ホストのアップグレードに進みます。

  4. コンピュート・ノードのアップグレード・コマンドを入力します。

    構文(1行に入力):

    upgradeCN 
hostIp=<compute-node-ip>
[optional] imageLocation=<path-to-iso>
[optional] isoChecksum=<iso-file-checksum>

    オプションとマークされたパラメータは、ソフトウェア・バージョン3.0.2-b892153以降では非推奨です。 以前のバージョンの場合は、コマンドにISOイメージ・パラメータを含めます。

    例:

    PCA-ADMIN> upgradeCN hostIp=100.96.2.64 \
imageLocation=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Data:
  Service request has been submitted. Upgrade Job Id = 1630938939109-compute-7545 Upgrade Request Id = UWS-61736806-7e5a-4648-9259-07c54c39cacb

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1630938939109-compute-7545       UWS-61736806-7e5a-4648-9259-07c54c39cacb   compute       Passed
  1632850650836-platform-68465     UWS-26dba234-9b52-426d-836c-ac11f37e717f   platform      Passed
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed

PCA-ADMIN> getupgradejob upgradeJobId=1630938939109-compute-7545
Data:
  Upgrade Request Id = UWS-61736806-7e5a-4648-9259-07c54c39cacb
  Name = compute
  Start Time = 2021-09-26T06:35:39
  End Time = 2021-09-26T06:45:55
  Pid = 7545
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_compute_2021_09_26-06.35.39.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.64","result_override":null,"log_level":null,"switch_type":null,"precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":null,"epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-61736806-7e5a-4648-9259-07c54c39cacb","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 616
  Tasks 1 - Name = Copy Scripts
  Tasks 1 - Description = Copy scripts to shared storage
  Tasks 1 - Time = 2021-09-26T06:35:39
[...]

  6. コンピュート・ノードのアップグレードが正常に完了し、ノードがリブートしたら、ロックを解除します。

    詳細は、「コンピュート・ノード操作の実行」の項を参照してください。 これは、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」章にあります。

    1. メンテナンス・ロックを解除します。

      PCA-ADMIN> maintenanceUnlock id=cf488903-fef8-4a51-8a41-c6990e4755c5
Status: Success
JobId: 625af20e-4b49-4201-879f-41d4405314c7

    2. プロビジョニング・ロックを解除します。

      PCA-ADMIN> provisioningUnlock id=cf488903-fef8-4a51-8a41-c6990e4755c5
Status: Success
JobId: 523892e8-c2d4-403c-9620-2f3e94015b46

  7. 次のコンピュート・ノードに進み、この手順を繰り返します。

    コンピュート・ノード・リスト・コマンドからの出力は、現在のステータスを示します。 たとえば: 

    PCA-ADMIN> list computeNode fields hostname,ipAddress,ilomIp,state,firmwareVersion,provisioningLocked,maintenanceLocked orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version           Provisioning Locked   Maintenance Locked
  --                                     --------   ----------    ---------------   -----   ----------------           -------------------   ------------------
  cf488903-fef8-4a51-8a41-c6990e4755c5   pcacn001   100.96.2.64   100.96.0.64       On      PCA Hypervisor:3.0.2-696   false                 false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.2-696   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.2-696   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.2-696   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.2-681   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.2-681   false                 false

「サービスWeb UI」の使用

  1. アップグレードしようとしているコンピュート・ノードのプロビジョニング・ロックとメンテナンス・ロックを設定します。 ノードにアクティブなコンピュート・インスタンスが存在しないことを確認します。

    注意:

    コンピュート・サービスの高可用性構成によっては、自動インスタンス移行によって、コンピュート・ノードを正常にロックできない場合があります。 「置き換えられたインスタンスのモニタリング」を参照してください。

    1. ナビゲーション・メニューで、「ラック・ユニット」をクリックします。 「ラック・ユニット」表で、アップグレードするコンピュート・ノードの名前をクリックして詳細ページを表示します。

    2. コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、プロビジョニング・ロック・コマンドを選択します。

    3. プロビジョニング・ロックが設定されたら、「Controls」を再度クリックし、「Migrate All Vms」コマンドを選択します。 コンピュート・サービスによってコンピュート・ノードが退避されます。つまり、実行中のインスタンスが他のコンピュート・ノードに移行されます。

      ノート:

      物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。 ただし、厳密なフォルト・ドメイン強制(「厳密なFD」)ファンクションは無効にする必要があります。

    4. コンピュート・ノードの退避が完了したら、「Controls」を再度クリックし、「Maintenance Lock」コマンドを選択します。 インスタンスの移行が進行中の場合、このコマンドは失敗することがあります。 数分待ってから再試行してください。

  2. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  3. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

  4. オプションで、最初にサーバーILOMをアップグレードします。

    1. 「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。 「要求の作成」ウィンドウが表示されます。

    2. リクエスト・タイプとして「アップグレード」を選択します。 適切なアップグレード・リクエスト・タイプを選択: ILOMをアップグレードします。

      ILOMネットワークで、サーバーに割り当てられたIPアドレスを入力します。 これは、内部の100.96.0.0/23範囲のIPアドレスです。

    3. 「要求の作成」をクリックします。 新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。

    4. ILOMアップグレード・ジョブが完了するまで5分待ちます。 次に、ホストのアップグレードに進みます。

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

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

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

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

    • ホストIP: 内部管理ネットワークでコンピュート・ノードに割り当てられたIPアドレスを入力します。 これは、内部の100.96.2.0/23範囲のIPアドレスです。

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

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

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

    • 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。

    • 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。

  8. 「要求の作成」をクリックします。

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

  9. コンピュート・ノードが正常にアップグレードされたら、プロビジョニング・ロックおよびメンテナンス・ロックを解放します。

    詳細は、「コンピュート・ノード操作の実行」の項を参照してください。 これは、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」章にあります。

    1. コンピュート・ノードの詳細ページを開きます。

    2. コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、Maintenance Unlockコマンドを選択します。

    3. メンテナンス・ロックが解放されたら、制御を再度クリックし、プロビジョニング・ロック解除コマンドを選択します。

管理ノード・クラスタのアップグレード

注意:

システム・アップグレードの準備ステップがすべて完了していることを確認します。

ZFS Storage Applianceファームウェアおよびすべてのコンピュート・ノードがアップグレードされていることを確認します。

完全管理ノード・クラスタのアップグレードは、1つのコマンドだけで3つの管理ノードすべてで必要なコンポーネントをすべてアップグレードする便利な方法です。 このプロセスの一環として、次のコンポーネントがこの特定の順序でアップグレードされます:

  1. ホスト・オペレーティング・システム

  2. クラスタ化されたMySQLデータベース

  3. シークレット・サービス(EtcdおよびVaultを含む)

  4. Kubernetesコンテナ・オーケストレーション・パッケージ

  5. コンテナ化されたマイクロサービス

  6. Oracle Cloud Infrastructureイメージ

注意:

新しいイメージがインポートされると、バックグラウンド・ジョブが起動され、実行中のOKEクラスタが、新しいイメージとともに提供される最新のCVE修正を受信するようになります。 詳細は、「Oracle Cloud Infrastructureイメージのアップグレード」を参照してください。

ノート:

ソフトウェア・バージョン3.0.2-b892153以降では、アップグレード前プロセス中に生成された「アップグレード計画」を使用して、アップグレードが必要な特定のコンポーネントおよび順序を決定します。 コンポーネントがすでに必要なバージョンにある場合、アップグレード・コマンドはアップグレード・ジョブを開始します。ただし、アップグレード計画では何も実行できないことが示されているため、ただちに完了します。

実際には、コンポーネントがすでに必要なバージョンである場合、アップグレード手順はスキップされます。 ただし、必要に応じて「サービスWeb UI」または「サービスCLI」コマンド・オプションを使用して、同じバージョンのアップグレードを強制できます。 次に例を示します: upgradeKubernetes force=True。

「サービスCLI」の使用

  1. アップグレード・コマンドを検証専用モードで実行します。

    注意:

    Oracleでは、最初の実行でverify-onlyオプション(verifyOnly=True)を使用することを強くお薦めします。 これにより、各コンポーネントの検証ジョブが開始されます。 実際のアップグレードを開始する前に、すべての検証ジョブを完了する必要があります。これには合計で約45分かかる場合があります。

    1. アップグレード・リクエストを検証専用モードで起動します。

      PCA-ADMIN> upgradeFullMN verifyOnly=True
Data: Service request has been submitted. Upgrade Request Id = UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056

    2. 関連するアップグレード・ジョブを検索し、IDを確認します。

      PCA-ADMIN> getUpgradeJobs requestId=UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056
Data:
  id                                      upgradeRequestId                           commandName         result
  --                                      ----------------                           -----------         ------
  1698788901590-oci_verify-38799          UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   oci_verify          Passed
  1698788685720-platform_verify-34138     UWS-20f69d05-9c43-4617-80a4-8cf8db5b8446   platform_verify     Passed
  1698788568097-kubernetes_verify-32571   UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   kubernetes_verify   Passed
  1698788265717-vault_verify-27153        UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   vault_verify        Passed
  1698787959640-etcd_verify-26413         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   etcd_verify         Passed
  1698787657287-mysql_verify-19656        UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   mysql_verify        Passed
  1698787353293-host_verify-18867         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed
  1698787049308-host_verify-12573         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed
  1698786925154-host_verify-36612         UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056   host_verify         Passed

    3. アップグレード・ジョブ詳細のステータスを確認してください。

      PCA-ADMIN> getUpgradeJob upgradeJobId=1698787353293-host_verify-18867
Data:
  Upgrade Request Id = UWS-9776b0fe-7f5f-4e46-9e3f-ceb4b1702056
  Name = host_verify
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_pcamn03_verify_2023_06_16-13.07.11.log
  Status = Passed

  2. アップグレードの検証が正常に完了したら、実際の完全管理ノードのアップグレードを開始します。

    PCA-ADMIN> upgradeFullMN
Data:
  Service request has been submitted. Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64

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

    完全な管理ノード・アップグレードはマルチ・コンポーネント・アップグレード・プロセスであるため、アップグレード・リクエストに複数のアップグレード・ジョブが関連付けられています。 リクエストIDに基づいて、これらのジョブに対してフィルタできます。 ジョブIDを使用して、各アップグレード・ジョブの詳細にドリルダウンできます。 

    PCA-ADMIN> getUpgradeJobs requestId=UWS-39329657-1051-4267-8c5a-9314f8e63a64
Data:
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1634579161548-oci-47486          UWS-39329657-1051-4267-8c5a-9314f8e63a64   oci           Passed
  1634578760906-platform-66082     UWS-39329657-1051-4267-8c5a-9314f8e63a64   platform      Passed
  1634578263434-kubernetes-63574   UWS-39329657-1051-4267-8c5a-9314f8e63a64   kubernetes    Passed
  1634578012353-vault-51696        UWS-39329657-1051-4267-8c5a-9314f8e63a64   vault         Passed
  1634577380954-etcd-46337         UWS-39329657-1051-4267-8c5a-9314f8e63a64   etcd          Passed
  1634577341291-mysql-40127        UWS-39329657-1051-4267-8c5a-9314f8e63a64   mysql         Passed
  1634576985926-host-36556         UWS-39329657-1051-4267-8c5a-9314f8e63a64   host          Passed
  1634576652071-host-27088         UWS-39329657-1051-4267-8c5a-9314f8e63a64   host          Passed
  1634576191050-host-24909         UWS-39329657-1051-4267-8c5a-9314f8e63a64   host          Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1634576652071-host-27088
Data:
  Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64
  Composition Id = 1
  Name = host
  Pid = 27088
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2023_05_24-07.04.12.log
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
[...]

    getUpgradeJobコマンドの出力には、アップグレード・プロシージャ中に実行されるタスクに関する詳細情報が表示されます。 説明、タイムスタンプ、期間、成功または失敗が表示されます。 アップグレード操作が失敗するたびに、コマンド出力にはどのタスクが失敗したかが示されます。 詳細なトラブルシューティングでは、コマンド出力開始の近くにあるロケーションにログ・ファイルを検索できます。

    ノート:

    アップグレード後に、アップグレード計画で管理ノードをリブートして変更を有効にする必要があると指定した場合、リブートはアップグレード・プロセスの一部として実行されます。 管理者アクションは必要ありません。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

    完全な管理ノードのアップグレードの場合は、アップグレードMNを選択します。

    注意:

    Oracleでは、最初の実行でverify-onlyオプションを使用することを強くお薦めします。 これにより、各コンポーネントの検証ジョブが開始されます。 実際のアップグレードを開始する前に、すべての検証ジョブを完了する必要があります。これには合計で約45分かかる場合があります。

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

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

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

    • 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。

    • 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。

  6. 「要求の作成」をクリックします。

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

    ノート:

    アップグレード後に、アップグレード計画で管理ノードをリブートして変更を有効にする必要があると指定した場合、リブートはアップグレード・プロセスの一部として実行されます。 管理者アクションは必要ありません。

個々のコンポーネントのアップグレード

完全管理ノード・クラスタのアップグレードは、1つのコマンドだけで3つの管理ノードすべてで必要なコンポーネントをすべてアップグレードする便利な方法です。 ただし、プロセスが中断されたり、途中でエラーが発生したりすることがあります。 管理クラスタ全体のアップグレードを繰り返すのではなく、この状況で個々のコンポーネントのアップグレードを実行する方が効率的です。

アップグレード・コマンドの出力およびログで、警告またはエラー・メッセージがないか確認します。 管理ノード・クラスタのアップグレードがどの段階で失敗したかを判断し、障害の原因となったと思われる問題を解決します。 正常にアップグレードされなかったコンポーネントから始めて、個々のコンポーネントのアップグレードを続行します。 次の各項のアップグレード操作は、管理ノード・クラスタのアップグレード時に実行される操作とまったく同じ順序でリストされます。

ノート:

ソフトウェア・バージョン3.0.2-b892153以降では、アップグレード前プロセス中に生成された「アップグレード計画」を使用して、アップグレードが必要な特定のコンポーネントおよび順序を決定します。 コンポーネントがすでに必要なバージョンにある場合、アップグレード・コマンドはアップグレード・ジョブを開始します。ただし、アップグレード計画では何も実行できないことが示されているため、ただちに完了します。

実際には、コンポーネントがすでに必要なバージョンである場合、アップグレード手順はスキップされます。 ただし、必要に応じて「サービスWeb UI」または「サービスCLI」コマンド・オプションを使用して、同じバージョンのアップグレードを強制できます。 次に例を示します: upgradeKubernetes force=True。

管理ノードのオペレーティング・システムのアップグレード

管理ノードのOracle Linuxホスト・オペレーティング・システムは、一度に1つのノードにアップグレードする必要があります。すべての管理ノードのローリング・アップグレードはできません。 このアップグレード・プロセス(カーネルおよびシステム・パッケージの更新を含む)では、3つの管理ノード・クラスタ内のどのノードが仮想IPおよびプライマリ・ロールを所有するかを検出します。 現在のプライマリ・ノードがアップグレードされると、プライマリ・ロールはまずクラスタ内の別のノードに転送されます。 この構成の変更はバックグラウンドで行われ、管理者からの個別または追加の介入は必要ありません。

ノート:

ILOMもアップグレードする必要がある場合は、オプションのステップを実行して、このプロシージャに統合できます。 組み合せた手順により、同じノードを2回退避してリブートする必要がなくなります。

管理ノードは、それぞれ1つの内部IPアドレスをコマンド・パラメータとして使用して、一度に1つずつアップグレードする必要があります。 次の例では、管理ノードのIPアドレスおよびアップグレード手順に関連するその他の情報を取得する「サービスCLI」コマンドを使用します。 

PCA-ADMIN> list managementNode fields hostname,ipAddress,ilomIp,state,firmwareVersion orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version
  --                                     --------   ----------    ---------------   -----   ----------------
  22ae47d8-a57a-433c-988d-df62fd3548e1   pcamn01    100.96.2.33   100.96.0.33       On      5.0.2.23
  042693b6-3ddb-4fb0-914d-f3deea838c8f   pcamn02    100.96.2.34   100.96.0.34       On      5.0.2.23
  bd2563b8-e310-4fca-ba1b-0e19b8040fc6   pcamn03    100.96.2.35   100.96.0.35       On      5.0.2.23

  1. ホスト・オペレーティング・システムをアップグレードする管理ノードのIPアドレスを取得します。

  2. オプションで、最初にサーバーILOMをアップグレードします。

    1. ILOMアップグレード・コマンドを入力します。

      構文(1行に入力):

      upgradeIlom
hostIp=<ilom-ip>

      例:

      PCA-ADMIN> upgradeIlom hostIp=100.96.0.35
Data:
  Service request has been submitted. Upgrade Job Id = 1632990827394-ilom-23871 Upgrade Request Id = UWS-1a97a8d9-9f06-478d-a0c0-d093bee4672

PCA-ADMIN> getUpgradeJob upgradeJobId=1632990827394-ilom-23871

    2. ILOMアップグレード・ジョブが完了するまで5分待ちます。 次に、ホストのアップグレードに進みます。

  3. 管理ノードのホスト・アップグレード・コマンドを入力します。

    構文(1行に入力):

    upgradeHost 
hostIp=<management-node-ip>

    例:

    PCA-ADMIN> upgradeHost hostIp=100.96.2.35
Command: upgradeHost hostIp=100.96.2.35 
Status: Success
Time: 2021-09-25 05:47:02,735 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632990827394-host-56156 Upgrade Request Id = UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632990827394-host-56156         UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755   host          Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632990827394-host-56156
Data:
  Upgrade Request Id = UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755
  Composition Id = 1
  Name = host
  Pid = 56156
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2021_09_25-05.47.02.log
[...]

  5. 最初の管理ノード・ホスト・オペレーティング・システムのアップグレードが正常に完了したら、2番目の管理ノードに対して同じコマンドを実行します。 そのアップグレードが正常に完了したら、3番目の管理ノードに対して同じコマンドを実行します。 

    PCA-ADMIN> upgradeHost hostIp=100.96.2.33
PCA-ADMIN> upgradeHost hostIp=100.96.2.34

    3つのオペレーティング・システムのアップグレードがすべて正常に完了すると、管理ノード・クラスタは最新になります。

    ノート:

    アップグレード後に、アップグレード計画で管理ノードをリブートして変更を有効にする必要があると指定した場合、リブートはアップグレード・プロセスの一部として実行されます。 管理者アクションは必要ありません。

MySQL Clusterデータベースのアップグレード

MySQL Clusterデータベースは、管理ノードのホスト・オペレーティング・システムとは無関係にアップグレードされます。MySQLパッケージは意図的にOracle Linuxアップグレードとは別に保持されます。

MySQLクラスタ・データベースのアップグレードはローリング・アップグレードです: 1つのコマンドで、3つの管理ノードそれぞれでアップグレードが実行されます。

  1. アップグレード・コマンドを入力します。

    PCA-ADMIN> upgradeMySQL
Data:
  Service request has been submitted. Upgrade Job Id = 1632995409822-mysql-83013 Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632995409822-mysql-83013        UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1   mysql         Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632995409822-mysql-83013
Data:
  Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1
  Name = mysql
  Pid = 83013
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_mysql_cluster_2021_09_25-09.21.16.log
[...]

シークレット・サービスのアップグレード

シークレット・サービスには、この特定の順序で個別にアップグレードする必要がある2つのコンポーネントが含まれています: まず、Etcd、次にVault。

EtcdとVaultのアップグレードは、ローリング・アップグレードです: 各アップグレードは、3つの管理ノードすべてで1つのコマンドで実行されます。

  1. 2つのアップグレード・コマンドを入力します。 Vaultアップグレードを開始する前に、Etcdアップグレードが終了するまで待ちます。 

    PCA-ADMIN> upgradeEtcd
Data:
  Service request has been submitted. Upgrade Job Id = 1632826770954-etcd-26973 Upgrade Request Id = UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284

PCA-ADMIN> upgradeVault
Data:
  Service request has been submitted. Upgrade Job Id = 1632850933353-vault-16966 Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632995409822-mysql-83013        UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1   mysql         Passed
  1632850933353-vault-16966        UWS-352df3d1-c21f-441b-8f6e-9381ac075906   vault         Passed
  1632826770954-etcd-26973         UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284   etcd          Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632850933353-vault-16966
Data:
  Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906
  Name = vault
  Pid = 16966
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_vault_2021_09_25-10.38.25.log
[...]

Kubernetesクラスタのアップグレード

Kubernetesコンテナ・オーケストレーション環境のアップグレードも、オペレーティング・システムとは別に保持されます。 1つのコマンドを使用すると、すべてのKubernetesパッケージ(kubeadm、kubectl、kubeletなど)が3つの管理ノードおよびすべてのコンピュート・ノードでアップグレードされます。 このアップグレードには、Kubernetesクラスタ内で実行されているマイクロサービスは含まれません。

Kubernetesアップグレード・プロセスについて

サービスの互換性と継続性を確保するには、Kubernetesを一度に1つのバージョンにアップグレードする必要があります。 バージョンのスキップ - メジャーまたはマイナー - は、サポートされていません。 Private Cloud Appliance Upgraderは、Kubernetesクラスタのすべての部分を次の使用可能なバージョンにアップグレードまたはパッチ適用することでこのプロセスを管理し、環境全体でアプライアンス・ソフトウェア・リポジトリから入手可能な最新のKubernetesバージョンが実行されるまで、同じ一連の操作を繰り返します。

Kubernetesクラスタのアップグレードまたはパッチ適用は、Private Cloud Appliance管理ノードおよびコンピュート・ノードを含む時間のかかるプロセスです。 追加の各コンピュート・ノードは、Kubernetesの増分バージョンごとに10分ずつプロセスを拡張します。

アプライアンス・ソフトウェア・バージョン3.0.2-b925538以降では、コンテナ・オーケストレーション環境がKubernetesバージョン1.20.xからバージョン1.25.yにアップグレードまたはパッチ適用されます。つまり、プロセス全体が5回実行される必要があります。 実行が成功するたびに、リポジトリが同期され、次の必要なバージョンが取得されます。 ただし、このバージョンのアプライアンス・ソフトウェアでは、リポジトリは複数のバージョンのKubernetesパッケージを許可するように再構成されるため、再同期は不要になります。

個々のKubernetesノードのアップグレードには、約10分かかります。 テストでは、Private Cloud Appliance Kubernetesクラスタのバージョン1.20からバージョン1.25へのアップグレードまたはパッチ適用に、管理ノードが3つ、コンピュート・ノードが3つあるベース・ラック構成で約4-5時間かかることが示されています。 20個のコンピュート・ノードがあるフル・ラックでは、プロセス全体で少なくとも9時間必要であり、完了までに最大18時間かかる場合があります。 ラック固有の構成の推定時間は、アップグレード計画で報告されます。

アップグレードまたはパッチ適用の進行状況を監視するには、ジョブ・ステータスまたはログを定期的に確認します。

  • サービスCLIを使用してジョブ・ステータスを確認: getUpgradeJob upgradeJobId=<id>

  • 管理ノードのUpgraderログの表示: tail -f /nfs/shared_storage/pca_upgrader/log/pca-upgrader_kubernetes_cluster_<time_stamp>.log。

Kubernetesのアップグレードまたはパッチ適用中に、特定のサービスが一時的に使用できなくなる可能性があります。

  • 「コンピュートWeb UI」、「サービスWeb UI」、OCI CLIおよび「サービスCLI」はすべて一時的に使用できなくなる可能性があります。 ユーザーは、操作を再試行する前に数分待つ必要があります。 「サービス・エンクレーブ」 (UIまたはCLI)での管理操作は、アップグレードまたはパッチ適用中に回避する必要があります。

  • Kubernetesアップグレードが開始されると、「Kubernetesワークロード・モニタリング・オペレータ」 (Sauronサービス)が停止されます。 その結果、Grafana、Prometheusおよびその他のSauronイングレス・エンドポイントにアクセスできません。 これらは、Kubernetesクラスタとコンテナ化されたマイクロサービス(プラットフォーム・レイヤー)のアップグレード・プロセスまたはパッチ適用プロセスの両方が完了した後、再び使用可能になります。

  1. アップグレード・コマンドを入力します。

    PCA-ADMIN> upgradeKubernetes
Data:
  Service request has been submitted. Upgrade Job Id = 1632849609034-kubernetes-35545 Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632849609034-kubernetes-35545
Data:
  Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf
  Name = kubernetes
  Pid = 35545
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_kubernetes_cluster_2021_09_26-17.20.09.log
[...]

マイクロサービスのアップグレード

マイクロサービス・アップグレードは、プラットフォーム・レイヤーの内部サービス、およびインフラストラクチャ・サービス・レイヤーを通じて公開される管理レベルとユーザー・レベルのサービスの両方をカバーします。

ノート:

特定の状況では、オプションのJSON文字列をコマンドに追加することで、特定のプラットフォーム・サービスを個別にアップグレードできます。 このオプションは、Oracleで明示的な手順が提供されないかぎり使用しないでください。

コンテナ化されたマイクロサービスには、独自のアップグレード・メカニズムがあります。 ISOイメージで新しいHelmデプロイメント・チャートとコンテナ・イメージが見つかった場合、サービスはアップグレードされます。 アップグレード・プロセス中に新しいデプロイメント・チャートが検出されると、サービスを実行しているポッドが新しいコンテナ・イメージで再起動されます。

  1. アップグレード・コマンドを入力します。

    PCA-ADMIN> upgradePlatform
Data:
  Service request has been submitted. Upgrade Job Id = 1632850650836-platform-68465 Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632850650836-platform-68465     UWS-26dba234-9b52-426d-836c-ac11f37e717f   platform      Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632850650836-platform-68465
Data:
  Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f
  Name = kubernetes
  Pid = 68465
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_platform_services_2021_09_26-20.48.41.log
[...]

Oracle Cloud Infrastructureイメージのアップグレード

Oracle Private Cloud Applianceで新しいOracle Cloud Infrastructureイメージが使用可能になり、サポートされている場合は、単一のアップグレード・コマンドを使用して、既存のすべてのテナンシで使用できるようにすることができます。 イメージは、ZFS Storage Applianceの/nfs/shared_storage/oci_compute_imagesディレクトリに格納されます。

イメージのバージョンは、アップグレード計画を通じて追跡されます。 アップグレード計画を確認し、新しいイメージがターゲット・ソフトウェア・バージョンに含まれているかどうかを確認します。 アップグレードにより、新しいOracle Cloud Infrastructureイメージが環境に追加されます。ただし、既存のイメージは削除されません。 イメージが不要になった場合は、deletePlatformImageコマンドを使用してイメージを削除することもできます。

  1. アップグレード・コマンドを入力します。

    PCA-ADMIN> upgradeOCIImages
Data:
  Service request has been submitted. Upgrade Job Id = 1680260388058-oci-38288 Upgrade Request Id = UWS-e601b085-d59d-4ae4-82a3-a09b446686ff

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

    PCA-ADMIN> getUpgradeJobs
Data:
  id                              upgradeRequestId                           commandName   result
  --                              ----------------                           -----------   ------
  1680260388058-oci-38288         UWS-e601b085-d59d-4ae4-82a3-a09b446686ff   oci           Passed
  
PCA-ADMIN> getUpgradeJob upgradeJobId=1680260388058-oci-38288
Data:
  Upgrade Request Id = UWS-e601b085-d59d-4ae4-82a3-a09b446686ff
  Name = oci
[...]

コンポーネント・ファームウェアのアップグレード

注意:

システム・アップグレードの準備ステップがすべて完了していることを確認します。

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

ファームウェアは、すべてのコンポーネントILOMのISOイメージ、ZFS Storage ApplianceのISOイメージ、およびスイッチに含まれています。 アップグレードするコンポーネント・タイプについて、次の指示を選択します。

完全管理ノード・クラスタのアップグレード中に、アップグレード計画が生成されました。 これを使用して、アプライアンスのアップグレードの進行状況を確認し、実行する必要のあるファームウェアのアップグレードを決定できます。 

PCA-ADMIN> getUpgradePlan
Data:
  id                          componentType   currentBuild      targetBuild      currentVersion                   targetVersion                    requireReboot   timeEstimation   requireUpgrade   impactedInfra 
  --                          -------------   ------------      -----------      --------------                   -------------                    -------------   --------------   --------------   ------------- 
  generic                     zfssa           3.0.2-b1261765    3.0.2-b1261765   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-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.65                 compute         3.0.2-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.66                 compute         3.0.2-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.67                 compute         3.0.2-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.68                 compute         3.0.2-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.69                 compute         3.0.2-b1261765    3.0.2-b1261765   3.0.2-859                        3.0.2-859                        false           20               false            compute       
  100.96.2.33                 host            3.0.2-b1261765    3.0.2-b1261765   oraclelinux-release-7.9-1.0.13   oraclelinux-release-7.9-1.0.13   false           35               false            host          
  100.96.2.34                 host            3.0.2-b1261765    3.0.2-b1261765   oraclelinux-release-7.9-1.0.13   oraclelinux-release-7.9-1.0.13   false           35               false            host          
  100.96.2.35                 host            3.0.2-b1261765    3.0.2-b1261765   oraclelinux-release-7.9-1.0.13   oraclelinux-release-7.9-1.0.13   false           35               false            host          
  generic                     mysql           3.0.2-b1261765    3.0.2-b1261765   8.0.36-1.1                       8.0.36-1.1                       false           15               false            host          
  generic                     etcd            3.0.2-b1261765    3.0.2-b1261765   3.5.6                            3.5.6                            false           5                false            host          
  generic                     vault           3.0.2-b1261765    3.0.2-b1261765   v1.7.1-3                         v1.7.1-3                         false           5                false            host          
  generic                     kubernetes      3.0.2-b1261765    3.0.2-b1261765   1.25.16-2                        1.25.16-2                        false           350              false            host,compute  
  generic                     platform        3.0.2-b1261765    3.0.2-b1261765   None                             None                             false           50               false            host,compute  
  Oracle-Linux-7.9            ociImages       3.0.2-b1261765    3.0.2-b1261765   2024.07.31_0                     2024.07.31_0                     false           5                false            host          
  Oracle-Linux-8              ociImages       3.0.2-b1261765    3.0.2-b1261765   2024.07.31_0                     2024.07.31_0                     false           5                false            host          
  Oracle-Linux-9              ociImages       3.0.2-b1261765    3.0.2-b1261765   2024.07.31_0                     2024.07.31_0                     false           5                false            host          
  Oracle-Linux8-OKE-1.26.15   ociImages       3.0.2-b1261765    3.0.2-b1261765   20240908                         20240908                         false           5                false            host          
  Oracle-Linux8-OKE-1.27.12   ociImages       3.0.2-b1261765    3.0.2-b1261765   20240908                         20240908                         false           5                false            host          
  Oracle-Linux8-OKE-1.28.8    ociImages       3.0.2-b1261765    3.0.2-b1261765   20240908                         20240908                         false           5                false            host          
  Oracle-Solaris-11           ociImages       3.0.2-b1261765    3.0.2-b1261765   2024.08.26_0                     2024.08.26_0                     false           5                false            host          
  100.96.0.33                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.34                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.35                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.64                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.65                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.66                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.67                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  100.96.0.68                 ilom            3.0.2-b892153     3.0.2-b1261765   5.0.2.23                         5.1.4.25                         true            10               true             host,compute  
  leaf                        switch          3.0.2-b892153     3.0.2-b1261765   10.2.5                           10.3.4a                          false           60               true             host,compute  
  mgmt                        switch          3.0.2-b892153     3.0.2-b1261765   10.2.5                           10.3.4a                          false           60               true             host,compute  
  spine                       switch          3.0.2-b892153     3.0.2-b1261765   10.2.5                           10.3.4a                          false           60               true             host,compute

ILOM IPアドレスの取得

「サービスCLI」の使用

ノート:

アプライアンスがソフトウェア・バージョン3.0.2-b892153以前を実行している場合は、このリストの3番目のオプションを使用します。

  • すべての管理ノードまたはコンピュート・ノードのILOM IPアドレスをリストするには、次のコマンドを使用します: 

    PCA-ADMIN> getCNIloms
Data:
  status = success
  data 1 = 100.96.0.66
  data 2 = 100.96.0.64
  data 3 = 100.96.0.65

PCA-ADMIN> getMNIloms
Data:
  status = success
  data 1 = 100.96.0.33
  data 2 = 100.96.0.34
  data 3 = 100.96.0.35

  • 特定のノード・ホスト名に対応するILOM IPアドレスを取得するには、次のコマンドを使用します: 

    PCA-ADMIN> getServerILOMIP hostName=<node_name>

    たとえば:

    PCA-ADMIN> getServerILOMIP hostName=pcacn002
Data:
  status = success
  data = 100.96.0.65

PCA-ADMIN> getServerILOMIP hostName=pcamn03
Data:
  status = success
  data = 100.96.0.35

  • コンピュート・ノードまたは管理ノードに関するID、IPアドレス、およびその他の重要な情報を取得するには、次のコマンドを使用します:

    PCA-ADMIN> list managementNode fields hostname,ipAddress,ilomIp,state,firmwareVersion orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version
  --                                     --------   ----------    ---------------   -----   ----------------
  22ae47d8-a57a-433c-988d-df62fd3548e1   pcamn01    100.96.2.33   100.96.0.33       On      5.0.2.23
  042693b6-3ddb-4fb0-914d-f3deea838c8f   pcamn02    100.96.2.34   100.96.0.34       On      5.0.2.23
  bd2563b8-e310-4fca-ba1b-0e19b8040fc6   pcamn03    100.96.2.35   100.96.0.35       On      5.0.2.23

PCA-ADMIN> list computeNode fields hostname,ipAddress,ilomIp,state,firmwareVersion,provisioningLocked,maintenanceLocked orderby hostname ASCENDING
Data:
  id                                     Hostname   Ip Address    ILOM Ip Address   State   Firmware Version           Provisioning Locked   Maintenance Locked
  --                                     --------   ----------    ---------------   -----   ----------------           -------------------   ------------------
  cf488903-fef8-4a51-8a41-c6990e4755c5   pcacn001   100.96.2.64   100.96.0.64       On      PCA Hypervisor:3.0.2-681   false                 false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.2-681   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.2-681   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.2-681   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.2-681   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.2-681   false                 false

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「ラック・ユニット」をクリックします。

  2. パッチを適用するコンポーネントの名前をクリックします。

  3. 「ラック・ユニット情報」タブを選択します。

  4. ILOM IPの下にリストされたIPアドレスを記録します。

ZFS Storage Applianceオペレーティング・ソフトウェアのアップグレード

アプライアンスのZFS Storage Applianceのオペレーティング・ソフトウェアをアップグレードするには、追加のパラメータなしでアップグレード・コマンドを入力します。 ストレージ・コントローラのIPアドレスとファームウェア・パッケージのロケーションが認識され、単一のアップグレード・コマンドによって両方のコントローラのローリング・アップグレードが開始されます。 2つのコントローラに新しいILOMファームウェア・バージョンが含まれている場合は、ZFS Storage Applianceアップグレード・プロセスの一部としてインストールされます。

注意:

アップグレード・プロセス中に、ZFS Storage Applianceまたはストレージ・コントローラILOMにログインしているユーザーがいないことを確認します。

アップグレードの進行中にストレージ構成を変更しないでください。 コントローラでさまざまなソフトウェア・バージョンが実行されている場合、あるコントローラの構成を変更しても、そのピア・コントローラには伝播されません。

ファームウェアのアップグレード中に、ストレージ・コントローラはアクティブ/パッシブ・モードになります。 アップグレードが完了すると、自動的にアクティブ/アクティブに戻ります。

始める前に

ZFS Storage Applianceアップグレードを開始する前に、ノード状態サービスを無効にして、アップグレード後のノード状態のエラーを防止する必要があります。
  1. 管理ノードから、次のコマンドを発行してプロビジョニング・ロックを設定します: 
    pca-admin locks set system provisioning
  2. 次の「サービスWeb UI」または「サービスCLI」プロシージャを使用して、ZFS Storage Applianceアップグレードを実行します。
  3. プロビジョニング・ロックを解除します。
    pca-admin locks unset system provisioning
  4. ロック状態を確認します。
    pca-admin locks show system

「サービスCLI」の使用

  1. アップグレード・コマンドを入力します。

    PCA-ADMIN> upgradeZfssa
Data:
  Service request has been submitted. Upgrade Job Id = 1632914107346-zfssa-83002 Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632914107346-zfssa-83002        UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9   zfssa         Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632914107346-zfssa-83002
Data:
  Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9
  Name = zfssa
  Pid = 83002
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_zfssa_ak_2021_09_29-11.15.07.log
[...]

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

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

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

    • イメージのロケーション: このパラメータは非推奨です。

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

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

    • 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。

    • 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。

  6. 「要求の作成」をクリックします。

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

ILOMのアップグレード

ノート:

サーバー・ノードにホストとILOMの両方のアップグレードが必要な場合は、2つのアップグレードを組み合せることで、同じノードを2回リブートする必要がなくなります。 手順は次のセクションで提供されます:

ILOM アップグレードは、管理ノードおよびコンピュート・ノードに適用できます。ファームウェア・パッケージは、コンポーネント・タイプごとに異なる場合があります。 各内部IPアドレスをコマンド・パラメータとして使用して、ILOMを一度に1つずつアップグレードする必要があります。

注意:

管理仮想IPアドレスを保持する管理ノードのILOM、つまりクラスタ内のプライマリ・ロールをアップグレードしないでください。 クラスタ内のプライマリ・ロールを持つ管理ノードを特定し、別のノードをプライマリにするには、次の「サービスCLI」コマンドを使用します: 

PCA-ADMIN> getPrimaryMgmtNode
  status = success
  data = pcamn01

PCA-ADMIN> updatePrimaryNode node=pcamn02
Data:
  status = success
  message = Successfully issued update primary node command

PCA-ADMIN> getPrimaryMgmtNode
  status = success
  data = pcamn02

「サービスCLI」の使用

  1. ファームウェアをアップグレードするILOMのIPアドレスを取得します。

  2. アップグレード・コマンドを入力します。

    構文(1行に入力):

    upgradeIlom
hostIp=<ilom-ip>

    例:

    PCA-ADMIN> upgradeIlom hostIp=100.96.0.66
Status: Success
Data:
  Service request has been submitted. Upgrade Job Id = 1620921089806-ilom-21480 Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1620921089806-ilom-21480         UWS-732d6fce-9f06-4329-b972-d093bee40010   ilom          Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1620921089806-ilom-21480
Data:
  Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010
  Name = ilom
  Pid = 21480
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_ilom_firmware_2021_09_24-11.18.31.log
[...]

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

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

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

    • ホストIP: ILOMネットワークに、コンポーネントに割り当てられたIPアドレスを入力します。 これは、内部の100.96.0.0/23範囲のIPアドレスです。

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

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

    • 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。

    • 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。

  6. 「要求の作成」をクリックします。

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

アップグレードの終了時に、ILOM自体が自動的にリブートされます。 ただし、すべての変更を有効にするには、サーバー・コンポーネントもリブートする必要があります。 5分待ってから、ILOMワークフローが最初に完了します。

動作への影響を最小限に抑えるには、すべてのILOMにパッチが適用された後に、コンピュート・ノードおよび管理ノードのリブート操作をスケジュールします。 コンピュート・ノードをリブートするにはコンピュート・インスタンスの移行が必要であることを考慮してください。 詳細は、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」の章にある「コンピュート・ノード操作の実行」を参照してください。

注意:

管理ノードをリブートする前に、常にクラスタ状態を確認してください。 詳細は、「Oracle Private Cloud Applianceリリース・ノート」を参照してください: 既知の問題「クラスタ状態が異常なときに管理ノードをリブートすると、プラットフォームの整合性の問題が発生」を参照してください。

スイッチ・ソフトウェアのアップグレード

アプライアンス・ラックには、Cisco Nexusスイッチの3つのカテゴリが含まれています: 管理スイッチ、2つのリーフ・スイッチ、および2つのスパイン・スイッチ。 すべて同じCisco NX-OSネットワーク・オペレーティング・ソフトウェアを実行します。 この順序でアップグレードを実行する必要があります: 最初にリーフ・スイッチ、次にスパイン・スイッチ、最後に管理スイッチ。 スイッチのカテゴリごとに1つのコマンドだけが必要です。つまり、リーフ・スイッチとスパイン・スイッチはペアでアップグレードされます。

ネットワーク・オペレーティング・ソフトウェアの一部のバージョンは、2つのファイルで構成されています: バイナリ・ファイルおよび追加のEPLD (電子プログラム可能ロジック・デバイス)イメージ。 どちらも、アップグレード・プロセス中に指定されたロケーションから自動的に取得され、正しい順序で適用されます。

注意:

必要なすべてのスイッチ・ポートが動作していることを確認します。 ポートが停止している場合、スイッチのアップグレード/パッチ適用中に停止が発生します。 詳細は、「Oracle Private Cloud Applianceリリース・ノート」の既知の問題「ポートが停止しているときにアップグレードまたはパッチ手順を切り替えない」を参照してください。

「サービスCLI」の使用

  1. アップグレードするスイッチのタイプ(スパイン、リーフ、管理)を決定します。

  2. アップグレード・コマンドを入力します。

    構文(1行に入力):

    upgradeSwitch 
switchType=[MGMT | SPINE | LEAF]

    例:

    PCA-ADMIN> upgradeSwitch switchType=LEAF
Data:
  Service request has been submitted. Upgrade Job Id = 1630511206512-cisco-20299 Upgrade Request Id = UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1630511206512-cisco-20299        UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3   cisco         Passed

PCA-ADMIN> getupgradeJob upgradeJobId=1630511206512-cisco-20299
Data:
  Upgrade Request Id = UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3
  Name = cisco
  Start Time = 2021-09-24T14:46:46
  End Time = 2021-09-24T14:59:44
  Pid = 20299
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_cisco_firmware_2021_09_24-14.46.46.log
[...]

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

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

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

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

    • スイッチ・タイプ: アップグレードするスイッチ・タイプを選択します。 優先されるアップグレード順序は次のとおりです: 最初にリーフ・スイッチ、次にスパイン・スイッチ、最後に管理スイッチ。

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

    • 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。

    • 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。

  6. 「要求の作成」をクリックします。

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

  7. アップグレードが正常に完了したが、システム内のほかのスイッチをアップグレードする必要がある場合は、アップグレードが必要なほかのタイプのスイッチに対してこの手順を繰り返します。