アクティブ・バージョン3.0.1-b741265

Private Cloud Applianceでビルド番号3.0.1-b741265のソフトウェア・バージョンを実行している場合は、この項の手順に従って、アプライアンス・ソフトウェア・バージョン3.0.2-b799577にアップグレードします。

ISOイメージのダウンロードと開梱

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

ISOイメージの準備

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

アプライアンスで最初のアップグレード・コマンドを実行するときは、ISOファイルへのパスをパラメータとして指定します。 この時点で、ISOファイルは3つすべての管理ノードにマウントされた共有ストレージにコピーされ、明確に定義されたディレクトリ構造に展開されます。 これらのステップは、事前に手動で実行する必要はありません。

システムが準備完了状態であることの確認

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

すべてのアップグレード操作の前に、事前チェックのセットがあります。 アップグレードは、すべての事前チェックに合格した場合にのみ開始されます。 同時アップグレード操作はサポートされていません。 アップグレード・ジョブは、新しいジョブを開始する前に完了する必要があります。

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

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

ホスト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.1-615   false                 false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.1-615   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.1-615   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.1-615   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.1-615   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.1-615   false                 false

「サービスCLI」の使用

  1. コンピュート・ノード・アップグレード・コマンドを実行するために必要な情報を収集します:

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

    • ISOイメージが有効であることを検証するために使用されるチェックサム

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

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

    ノート:

    インスタンスの移行およびコンピュート・ノードのロックの詳細は、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」の章の「コンピュート・ノード操作の実行」に関する項を参照してください。

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

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

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

      ノート:

      物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。

      PCA-ADMIN> migrateVm id=cf488903-fef8-4a51-8a41-c6990e4755c5 force=true
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.1-615   true                  false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.1-615   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.1-615   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.1-615   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.1-615   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.1-615   false                 false

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

    構文(1行に入力):

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

    例:

    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

PCA-ADMIN> getupgradejob upgradeJobId=1630938939109-compute-7545
Data:
  Upgrade Request Id = UWS-61736806-7e5a-4648-9259-07c54c39cacb
  Name = compute
  Pid = 7545
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_compute_2021_09_26-06.35.39.log
[...]

  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-640   false                 false             
  42a7594d-1173-4dbd-4755-07810cc2d527   pcacn002   100.96.2.65   100.96.0.65       On      PCA Hypervisor:3.0.2-640   false                 false             
  bc0f37d5-ba77-423e-bc11-017704b47e59   pcacn003   100.96.2.66   100.96.0.66       On      PCA Hypervisor:3.0.2-640   false                 false             
  2e5ac527-01f5-4230-ae41-0522fcb57c9a   pcacn004   100.96.2.67   100.96.0.67       On      PCA Hypervisor:3.0.2-640   false                 false             
  5a6b61cf-7e99-4df2-87e4-b37c5fb0bfb8   pcacn005   100.96.2.68   100.96.0.68       On      PCA Hypervisor:3.0.1-615   false                 false             
  885f2aa4-f017-41e8-b2bc-e588cc0c6162   pcacn006   100.96.2.69   100.96.0.69       On      PCA Hypervisor:3.0.1-615   false                 false

「サービスWeb UI」の使用

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

    ノート:

    インスタンスの移行およびコンピュート・ノードのロックの詳細は、「Oracle Private Cloud Appliance管理者ガイド」の「ハードウェア管理」の章の「コンピュート・ノード操作の実行」に関する項を参照してください。

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

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

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

      ノート:

      物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。

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

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

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

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

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

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

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

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

    • ISOチェックサム: チェックサムを入力してISOイメージを確認します。 ISOファイルとともに保存されます。

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

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

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

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

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

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

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

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

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

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

注意:

すべてのコンピュート・ノードがアップグレードされていることを確認します。

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

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

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

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

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

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

「サービスCLI」の使用

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

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

    • ISOイメージが有効であることを検証するために使用されるチェックサム

  2. コマンドを入力して、管理ノードのクラスタ全体のアップグレードを開始します。

    構文(1行に入力):

    PCA-ADMIN> upgradeFullMN
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>
    PCA-ADMIN> upgradeFullMN
imageLocation=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
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
  --                               ----------------                           -----------   ------
  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コマンドの出力には、アップグレード・プロシージャ中に実行されるタスクに関する詳細情報が表示されます。 説明、タイムスタンプ、期間、成功または失敗が表示されます。 アップグレード操作が失敗するたびに、コマンド出力にはどのタスクが失敗したかが示されます。 詳細なトラブルシューティングでは、コマンド出力開始の近くにあるロケーションにログ・ファイルを検索できます。

    注意:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 これは、「サービスCLI」からは実行できません。

  4. Oracle LinuxコマンドラインまたはILOMを使用して、3つの管理ノードをすべてリブートします。

    1. クラスタ仮想IPを所有する管理ノードを確認します。 いずれかの管理ノードのコマンド行から次のコマンドを実行します: 

      # pcs status
[...]
 Resource Group: mgmt-rg
     vip-mgmt-int     (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-host    (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-ilom    (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-lb      (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-ext     (ocf::heartbeat:IPaddr2):      Started    pcamn02
[...]

    2. クラスタ内のほかの2つの管理ノードをリブートします。 (この例では: pcamn01およびpcamn03)

    3. リブートした管理ノードのいずれかに仮想IPを移動します。 (この例では: pcamn01.) 

      # pcs resource move mgmt-rg pcamn01
# pcs status
Cluster name: mncluster
Stack: corosync
[...]
 scsi_fencing   (stonith:fence_scsi):   Stopped (disabled)
 Resource Group: mgmt-rg
     vip-mgmt-int       (ocf::heartbeat:IPaddr2):       Started pcamn01
     vip-mgmt-host      (ocf::heartbeat:IPaddr2):       Started pcamn01
[...]

    4. アップグレードされた3つの管理ノードの最後をリブートします。 (この例では: pcamn02.)

「サービスWeb UI」の使用

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

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

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

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

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

  4. 必要に応じて、アップグレード・リクエスト・パラメータを入力します:

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

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

    • ISOチェックサム: ISOイメージがこのアップグレードに対して有効であることを確認するためのチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。

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

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

    注意:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 これは、「サービスWeb UI」からは実行できません。

  6. Oracle LinuxコマンドラインまたはILOMを使用して、3つの管理ノードをすべてリブートします。 「サービスCLI」を使用して、管理クラスタのアップグレード手順の最終ステップを参照してください。

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

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

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

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

管理ノードのOracle Linuxホスト・オペレーティング・システムは、一度に1つのノードにアップグレードする必要があります。すべての管理ノードのローリング・アップグレードはできません。 カーネル・パッケージおよびシステム・パッケージの更新を含むこのアップグレード・プロセスは、常にクラスタの仮想IPを保持する管理ノードから開始する必要があります。 したがって、3つの管理ノード・クラスタで2つの管理ノードをアップグレードした場合は、クラスタ仮想IPをアップグレードされた管理ノードの1つに再割り当てし、そのノードから最終アップグレード・コマンドを実行する必要があります。

管理ノードは、それぞれ1つの内部IPアドレスをコマンド・パラメータとして使用して、一度に1つずつアップグレードする必要があります。 ホストIPアドレスを取得するには、「サービスCLI」コマンドshow ManagementNode name=<node_name>を使用し、出力でIp Addressを探します。

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

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

    • ISOイメージが有効であることを検証するために使用されるチェックサム

    • ホスト・オペレーティング・システムをアップグレードする予定の管理ノードのIPアドレス

  2. 管理クラスタの仮想IPを保持する管理ノードから「サービスCLI」を実行します。

    1. 管理ノードのいずれかにログオンし、クラスタのステータスを確認します。

      # ssh root@pcamn01
# pcs status
Cluster name: mncluster
Stack: corosync
Current DC: pcamn02 (version 1.1.23-1.0.1.el7-9acf116022) - partition with quorum

Online: [ pcamn01 pcamn02 pcamn03 ]

Full list of resources:

 scsi_fencing         (stonith:fence_scsi):          Stopped (disabled)
 Resource Group: mgmt-rg
     vip-mgmt-int     (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-host    (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-ilom    (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-lb      (ocf::heartbeat:IPaddr2):      Started    pcamn02
     vip-mgmt-ext     (ocf::heartbeat:IPaddr2):      Started    pcamn02
     l1api            (systemd:l1api):               Started    pcamn02
     haproxy          (ocf::heartbeat:haproxy):      Started    pcamn02
     pca-node-state   (systemd:pca_node_state):      Started    pcamn02
     dhcp             (ocf::heartbeat:dhcpd):        Started    pcamn02
     hw-monitor       (systemd:hw_monitor):          Started    pcamn02

Daemon Status:
  corosync: active/enabled
  pacemaker: active/enabled
  pcsd: active/enabled

      この例では、コマンド出力は、ホスト名がpcamn02のノードが現在クラスタ仮想IPを保持していることを示しています。

    2. 仮想IPを使用して管理ノードにログインし、「サービスCLI」を起動します。 

      # ssh pcamn02
# ssh admin@localhost -p 30006
PCA-ADMIN>

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

    構文(1行に入力):

    upgradeHost 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>
hostIp=<management-node-ip>

    例:

    PCA-ADMIN> upgradeHost hostIp=100.96.2.35 \
imageLocation=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
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
Status: Success
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. 最初の管理ノードのホスト・オペレーティング・システムのアップグレードが正常に完了したら、次の管理ノードに対して同じコマンドを実行します。

    PCA-ADMIN> upgradeHost hostIp=100.96.2.33 \
imageLocation=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7

  6. 2番目の管理ノード・ホストのオペレーティング・システムのアップグレードが正常に完了したら、「サービスCLI」を終了し、アップグレードしたノードのいずれかにクラスタ仮想IPを移動します。 

    PCA-ADMIN> exit
Connection to localhost closed.
# pcs resource move mgmt-rg pcamn01
# pcs status
Cluster name: mncluster
Stack: corosync
[...]
 scsi_fencing   (stonith:fence_scsi):   Stopped (disabled)
 Resource Group: mgmt-rg
     vip-mgmt-int       (ocf::heartbeat:IPaddr2):       Started pcamn01
     vip-mgmt-host      (ocf::heartbeat:IPaddr2):       Started pcamn01
[...]

    クラスタ仮想IPを別の管理ノードに移動する場合は、数秒のみかかります。

  7. 仮想IPを使用して管理ノードにログインし、「サービスCLI」を起動して、最終管理ノードのホスト・オペレーティング・システムのアップグレードを実行します。 

    # ssh pcamn01
# ssh admin@localhost -p 30006
PCA-ADMIN> upgradeHost hostIp=100.96.2.34 \
imageLocation=http://host.example.com/pca-<version>-<build>.iso \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7

    このアップグレードが正常に完了すると、すべての管理ノードのオペレーティング・システムが最新です。

    注意:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 これは、「サービスCLI」からは実行できません。

  8. Oracle LinuxコマンドラインまたはILOMを使用して、3つの管理ノードをすべてリブートします。

    1. クラスタ仮想IPを所有する管理ノードを確認します。 いずれかの管理ノードのコマンド行から次のコマンドを実行します: 

      # pcs status
[...]
 Resource Group: mgmt-rg
     vip-mgmt-int     (ocf::heartbeat:IPaddr2):      Started    pcamn01
     vip-mgmt-host    (ocf::heartbeat:IPaddr2):      Started    pcamn01
     vip-mgmt-ilom    (ocf::heartbeat:IPaddr2):      Started    pcamn01
     vip-mgmt-lb      (ocf::heartbeat:IPaddr2):      Started    pcamn01
     vip-mgmt-ext     (ocf::heartbeat:IPaddr2):      Started    pcamn01
[...]

    2. クラスタ内のほかの2つの管理ノードをリブートします。 (この例では: pcamn02およびpcamn03)

    3. リブートした管理ノードのいずれかに仮想IPを移動します。 (この例では: pcamn02.) 

      # pcs resource move mgmt-rg pcamn02
# pcs status
Cluster name: mncluster
Stack: corosync
[...]
 scsi_fencing   (stonith:fence_scsi):   Stopped (disabled)
 Resource Group: mgmt-rg
     vip-mgmt-int       (ocf::heartbeat:IPaddr2):       Started pcamn02
     vip-mgmt-host      (ocf::heartbeat:IPaddr2):       Started pcamn02
[...]

    4. アップグレードされた3つの管理ノードの最後をリブートします。 (この例では: pcamn01.)

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

管理ノードのホスト・オペレーティング・システムのアップグレード後にデータベースのアップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで展開されているため、ISOパスとチェックサムは、データベース・アップグレード・コマンドの必須パラメータとは見なされません。

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

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

    PCA-ADMIN> upgradeMySQL
Status: Success
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
Status: Success
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
[...]

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

管理ノードのホスト・オペレーティング・システムのアップグレード後にシークレット・サービスのアップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで展開されているため、ISOパスとチェックサムは、データベース・アップグレード・コマンドの必須パラメータとは見なされません。

シークレット・サービスには、この特定の順序で個別にアップグレードする必要がある2つのコンポーネントが含まれています: まず、Etcd、次にVault。 EtcdとVaultのアップグレードは、ローリング・アップグレードです: 各アップグレードは、3つの管理ノードすべてで1つのコマンドで実行されます。

  1. 2つのアップグレード・コマンドを入力します。 1つのアップグレードが終了するまで待ってから、2番目のコマンドを入力します。 

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

PCA-ADMIN> upgradeVault
Status: Success
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
  --                               ----------------                           -----------   ------
  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
Status: Success
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コンテナ・オーケストレーション・パッケージが含まれていません。 このコンポーネントはスキップできます。

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

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

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

管理ノードのホスト・オペレーティング・システムのアップグレード後にマイクロサービス・アップグレードが実行されることを前提としています。 オペレーティング・システムのアップグレード中にISOイメージがすでに共有ストレージで解凍されているため、マイクロサービス・アップグレード・コマンドのISOパスおよびチェックサムは必須パラメータとはみなされません。

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

    PCA-ADMIN> upgradePlatform
Status: Success
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
Status: Success
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
[...]

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

注意:

すべてのコンピュート・ノードと管理ノード・クラスタがアップグレードされていることを確認します。

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

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

アプライアンスのZFS Storage Applianceのオペレーティング・ソフトウェアをアップグレードするには、開梱されたISOイメージ内のファームウェア・パッケージへのパスを指定する必要があります。 ストレージ・コントローラのIPアドレスがわかっているため、1つのアップグレード・コマンドによって両方のコントローラのローリング・アップグレードが開始されます。 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. コマンドを実行するために必要な情報を収集: 解凍されたISOイメージ内のAK-NASファームウェア・パッケージへのパス。

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

    構文:

    upgradeZfssa imageLocation=<path-to-firmware>

    例:

    PCA-ADMIN> upgradeZfssa imageLocation="file:///nfs/shared_storage/pca_firmware/zfs/ak-nas-<version>.pkg"
Status: Success
Data:
  Service request has been submitted. Upgrade Job Id = 1632914107346-zfssa-83002 Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9

  3. リクエスト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. 適切なアップグレード・リクエスト・タイプを選択: Zfssaをアップグレードします。

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

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

    • イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ZFS Storage Applianceオペレーティング・ソフトウェアは、解凍したISOイメージの/pca_firmware/zfs/サブディレクトリに*.pkgファイルとして格納されます。

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

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

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

ILOMのアップグレード

ILOM アップグレードは、管理ノードおよびコンピュート・ノードに適用できます。 ファームウェア・パッケージはコンポーネント・タイプごとに異なる可能性があるため、ファームウェア・ディレクトリから正しいものを選択してください。 各内部IPアドレスをコマンド・パラメータとして使用して、ILOMを一度に1つずつアップグレードする必要があります。

ILOM IPアドレスを取得するには、「サービスCLI」コマンドshow ComputeNode name=<node_name>またはshow ManagementNode name=<node_name>を使用し、出力でILOM Ip Addressを探します。

注意:

管理仮想IPアドレスを保持する管理ノードのILOM、つまりクラスタ内のプライマリ・ロールをアップグレードしないでください。 ILOMをアップグレードするには、まず、クラスタ内の別のノードがプライマリ・ロールを引き継ぐように、問題の管理ノードをリブートします。 ノードが完全にリブートされたら、ILOMアップグレードを続行できます。

クラスタ内のプライマリ・ロールを持つ管理ノードを確認するには、任意の管理ノードにログインし、コマンドpcs statusを実行します。

「サービスCLI」の使用

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

    • ファームウェアをアップグレードするILOMのIPアドレス

    • 展開されたISOイメージ内のファームウェア・パッケージ・ファイルへのパス

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

    構文(1行に入力):

    upgradeIlom
imageLocation=<path-to-firmware>
hostIp=<ilom-ip>

    例:

    PCA-ADMIN> upgradeIlom \
imageLocation="file:///nfs/shared_storage/pca_firmware/X9-2/.../ILOM-<version>-ORACLE_SERVER_X9-2-rom.pkg" \
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
  1632926926773-host-32993         UWS-fef3b663-45b7-4177-a041-26f73e68848d   host          Passed
  1632990827394-host-56156         UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755   host          Passed
  1632990493570-host-6646          UWS-4c78f3ef-ac42-4f32-9483-bb43a309faa3   host          Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1620921089806-ilom-21480
Status: Success
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. 適切なアップグレード・リクエスト・タイプを選択: ILOMをアップグレードします。

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

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

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

    • イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ILOM ファームウェアは、解凍したISOイメージの/pca_firmware/<component>/サブディレクトリに*.pkgファイルとして格納されます。

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

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

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

アップグレードの終了時に、ILOM自体が自動的にリブートされます。 ただし、すべての変更を有効にするには、サーバー・コンポーネントもリブートする必要があります。 ILOMアップグレードが成功した後は、管理ノードまたはコンピュート・ノードを手動でリブートする必要があります。

注意:

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

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

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

ファームウェアをアップグレードする場合は、各アップグレード・コマンドで同じバイナリ・ファイルを使用します。 スイッチのカテゴリごとに1つのコマンドだけが必要です。つまり、リーフ・スイッチとスパイン・スイッチはペアでアップグレードされます。

ネットワーク・オペレーティング・ソフトウェアの一部のバージョンは、2つのファイルで構成されています: バイナリ・ファイルおよび追加のEPLD (電子プログラム可能ロジック・デバイス)イメージ。 新しいファームウェアにEPLDファイルが含まれている場合は、「最初にNX-OSソフトウェアをアップグレードしてから、EPLDイメージを更新」。

「サービスCLI」の使用

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

    • アップグレードするスイッチのタイプ(スパイン、リーフ、管理)

    • 解凍されたISOイメージ内のファームウェア・バイナリ・ファイルへのパス

    • 新しいファームウェア・バージョンに存在する場合、解凍されたISOイメージ内のEPLDアップグレード・ファイルへのパス

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

    構文(1行に入力):

    upgradeSwitch 
switchType=[MGMT | SPINE | LEAF] 
imageLocation=<path-to-firmware>
(epld=<path-to-epld-file>)

    例:

    PCA-ADMIN> upgradeSwitch switchType=LEAF \
imageLocation="file:///nfs/shared_storage/pca_firmware/network/cisco/nxos.<version>.bin" \
epld="file:///nfs/shared_storage/pca_firmware/network/cisco/n9000-epld.<version>.img"
Status: Success
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
  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. アップグレード・リクエスト・パラメータを入力します:

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

    • EPLD: このファームウェア・バージョンで必要な場合は、EPLDイメージ・ファイルが格納されているロケーションへのパスを入力します。 EPLDファイルが存在する場合、EPLDファイルは、解凍されたISOイメージの/pca_firmware/network/cisco/サブディレクトリにNX-OSオペレーティング・ソフトウェアとともに格納される*.imgファイルです。

    • イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 Cisco NX-OSネットワーク・オペレーティング・ソフトウェアは、解凍されたISOイメージの/pca_firmware/network/cisco/サブディレクトリに*.binファイルとして格納されます。

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

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

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

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

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

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

注意:

すべてのシステム・コンポーネントがアップグレードされていることを確認します。

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

アップグレードにより、新しいOracle Cloud Infrastructureイメージが環境に追加されます。ただし、既存のイメージは削除されません。 イメージが不要になった場合は、削除するオプションがあります。

Oracle Cloud Infrastructureイメージのインポート

importPlatformImagesコマンドを実行して、管理ノードの/nfs/shared_storage/oci_compute_imagesにあるすべてのイメージを、すべてのテナンシのすべてのコンパートメントでも使用できるようにします。 

PCA-ADMIN> importPlatformImages
Status: Running
JobId: f21b9d86-ccf2-4bd3-bab9-04dc3adb2966

JobIdを使用して、ジョブの詳細情報を取得します。 次の例では、新しいイメージは配信されていません: 

PCA-ADMIN> show job id=f21b9d86-ccf2-4bd3-bab9-04dc3adb2966
Status: Success
Data: 
  Id = f21b9d86-ccf2-4bd3-bab9-04dc3adb2966
  Type = Job
  Done = true
  Name = OPERATION
  Progress Message = There are no new platform image files to import
  Run State = Succeeded

Oracle Cloud Infrastructureイメージのリスト

listplatformImagesコマンドを使用して、管理ノードの共有ストレージからインポートされたすべてのOracle Cloud Infrastructureイメージをリストします。 アップグレードを実行したが、まだimportPlatformImagesを実行していない場合、リストには共有ストレージ内のすべてのイメージが表示されないことがあります。 

PCA-ADMIN> listplatformImages
Status: Success
Data:
  id                            displayName                                lifecycleState
  --                            -----------                                --------------
  ocid1.image.unique_ID_1   uln-pca-Oracle-Linux-7.9-2022.08.29_0...   AVAILABLE
  ocid1.image.unique_ID_2   uln-pca-Oracle-Linux-8-2022.08.29_0.oci    AVAILABLE
  ocid1.image.unique_ID_3   uln-pca-Oracle-Solaris-11.4.35-2021.0...   AVAILABLE

「コンピュート・エンクレーブ」ユーザーには、listplatformImagesに表示されるものと同じlifecycleStateが表示されます。 importPlatformImagesの実行直後に、listplatformImagesと「コンピュート・エンクレーブ」の両方に、lifecycleState IMPORTINGの新しいイメージが表示されることがあります。 importPlatformImagesジョブが完了すると、listplatformImagesと「コンピュート・エンクレーブ」の両方にイメージがAVAILABLEとして表示されます。

Oracle Cloud Infrastructureイメージを削除すると、listplatformImagesと「コンピュート・エンクレーブ」の両方に、イメージがDELETINGまたはDELETEDとして表示されます。

Oracle Cloud Infrastructureイメージの削除

次のコマンドを使用して、指定したOracle Cloud Infrastructureイメージを削除します。 このイメージは、listplatformImages出力および「コンピュート・エンクレーブ」でDELETING、DELETEDとして表示され、最終的にはリストされません。 ただし、イメージ・ファイルは管理ノードから削除されず、importPlatformImagesコマンドを実行すると、イメージがすべてのコンパートメントで再度使用できるようにイメージが再インポートされます。 

PCA-ADMIN> deleteplatformImage imageId=ocid1.image.unique_ID_3
Status: Running
JobId: 401567c3-3662-46bb-89d2-b7ad1541fa2d

PCA-ADMIN> listplatformImages
Status: Success
Data:
  id                            displayName                                lifecycleState
  --                            -----------                                --------------
  ocid1.image.unique_ID_1   uln-pca-Oracle-Linux-7.9-2022.08.29_0...   AVAILABLE
  ocid1.image.unique_ID_2   uln-pca-Oracle-Linux-8-2022.08.29_0.oci    AVAILABLE
  ocid1.image.unique_ID_3   uln-pca-Oracle-Solaris-11.4.35-2021.0...   DELETED