このコンテンツを正しく表示するには、JavaScriptが有効になっている必要があります

第7章システムのアップグレード

この章では、管理者がOracle Private Cloud Applianceまたはそのコンポーネントの1つをアップグレードする方法について説明します。

「しない」:アプライアンス・コンポーネントに個々のパッケージをインストールまたはアップグレードします。この章で説明するアップグレードのみがサポートされています。セキュリティおよびその他の更新は、パッチを介して提供されます。パッチ適用はアップグレード機能とは別に、ULNミラーを使用して、サポートされているパッケージを管理ノードの共有ストレージにダウンロードします。

アップグレードおよびパッチ適用機能の実装の詳細および技術的なバックグラウンド情報は、「Oracle Private Cloud Appliance概要ガイド」にあります。「アプライアンス管理の概要」の章の「アップグレード」および「パッチ適用」の項を参照してください。

パッチ適用手順は、別のドキュメントに記載されています。「Oracle Private Cloud Applianceパッチ適用ガイド」を参照してください。

7.1 アップグレード要件

アップグレード手順を開始する前に、必要な権限があり、ISOイメージを適切なロケーションにダウンロードしたことを確認してください。

7.1.1 権限の確認

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

Service CLIにログインすると、すべてのカスタム・コマンドを表示して、アップグレード・コマンドが使用可能であることを確認できます。コマンドのリストは、アクセス・プロファイルに基づいてフィルタ処理されます。アップグレード・コマンドがリストされている場合は、実行する権限があることを意味します。

PCA-ADMIN> showallcustomcmds
    Operation Name: <Related Object(s)>
    -----------------------------------
    [...]
    getUpgradeJob:  UpgradeJob
    getUpgradeJobs:  UpgradeJobList
    getUpgradeRequests:  UpgradeRequest
    killUpgradeJob:  UpgradeJob
    [...]
    upgradeCN:  UpgradeRequest
    upgradeEtcd:  UpgradeRequest
    upgradeFullMN:  UpgradeRequest
    upgradeHost:  UpgradeRequest
    upgradeIlom:  UpgradeRequest
    upgradeKubernetes:  UpgradeRequest
    upgradeMySQL:  UpgradeRequest
    upgradePlatform:  UpgradeRequest
    upgradeSwitch:  UpgradeRequest
    upgradeVault:  UpgradeRequest
    upgradeZfssa:  UpgradeRequest

7.1.2 ISOイメージの準備

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

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

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

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

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

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

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

7.2 完全管理ノードのアップグレードの実行

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

ホスト・オペレーティング・システム
MySQLクラスタ・データベース
シークレット・サービス(EtcdとVaultを含む)
Kubernetesコンテナ・オーケストレーション・パッケージ
コンテナ化されたマイクロサービス

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

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

完全な管理ノードのアップグレードの場合は、アップグレードMNを選択します。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ISOチェックサム: ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: ISOイメージが保存されるロケーションへのパスを入力します。
Create Requestをクリックします。

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

サービスCLIの使用

コマンドを実行するために必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム

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

構文(1行に入力):

upgradeFullMN 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradeFullMN \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradeFullMN imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-24 06:56:31,871 UTC
Data:
  Service request has been submitted. Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64

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

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

PCA-ADMIN> getUpgradeJobs requestId=UWS-39329657-1051-4267-8c5a-9314f8e63a64
Command: getUpgradeJobs requestId=UWS-39329657-1051-4267-8c5a-9314f8e63a64
Status: Success
Time: 2021-09-24 17:32:31,595 UTC
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
Command: getUpgradeJob upgradeJobId=1634576652071-host-27088
Status: Success
Time: 2021-09-24 17:35:59,946 UTC
Data:
  Upgrade Request Id = UWS-39329657-1051-4267-8c5a-9314f8e63a64
  Composition Id = 1
  Name = host
  Start Time = 2021-09-24T07:04:12
  End Time = 2021-09-24T07:05:22
  Pid = 27088
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2021_09_24-07.04.12.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.35","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":"file:///nfs/shared_storage/pca-3.0.1-b544818.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":"1","request_id":"UWS-39329657-1051-4267-8c5a-9314f8e63a64","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 139
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-10-18T17:04:16
[...]

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

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

粒度の細かいアップグレード・メカニズムを使用すると、個々のハードウェアおよびソフトウェア・コンポーネントのアップグレード手順を実行できます。管理ノードのアップグレードに含まれるコンポーネントのほかに、さまざまな種類のファームウェア、およびコンピュート・ノード上のオペレーティング・システムやアプライアンス固有のソフトウェアをアップグレードすることもできます。

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

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

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: ホストをアップグレードします。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ホストIP: 内部管理ネットワークで管理ノードに割り当てられたIPアドレスを入力します。これは、内部の100.96.2.0/23範囲のIPアドレスです。
- ISOチェックサム: ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: ISOイメージが保存されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

コマンドを実行するために必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム
- ホスト・オペレーティング・システムをアップグレードする予定の管理ノードのIPアドレス

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

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

# 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を保持していることを示しています。

仮想IPを使用して管理ノードにログインし、サービスCLIを起動します。
```
# ssh pcamn02
# ssh admin@localhost -p 30006
PCA-ADMIN>
```

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

構文(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
Command: upgradeHost hostIp=100.96.2.35 imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
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

リクエスト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
Command: getUpgradeJob upgradeJobId=1632990827394-host-56156
Status: Success
Time: 2021-09-25 05:54:28,054 UTC
Data:
  Upgrade Request Id = UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755
  Composition Id = 1
  Name = host
  Start Time = 2021-09-25T05:47:02
  End Time = 2021-09-25T05:48:38
  Pid = 56156
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_2021_09_25-05.47.02.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.2.35","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":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":"1","request_id":"UWS-1a97a8d9-54ef-478d-a0c0-348a17ba6755","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 96
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-09-25T05:47:02
  Tasks 2 - Name = Validate Image Location
[...]

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

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

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を別の管理ノードに移動する場合は、数秒のみかかります。

仮想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
```
このアップグレードが正常に完了すると、すべての管理ノードのオペレーティング・システムが最新です。

7.3.2 MySQLクラスタ・データベースのアップグレード

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

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

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: MySQLをアップグレードします。
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム

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

構文(1行に入力):

upgradeMySQL 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradeMySQL \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradeMySQL imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-25 09:21:16,264 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632995409822-mysql-83013 Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1

共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力: upgradeMySQL。

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

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632995409822-mysql-83013        UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1   mysql         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=1632995409822-mysql-83013
Command: getUpgradeJob upgradeJobId=1632995409822-mysql-83013
Status: Success
Time: 2021-09-25 09:24:27,874 UTC
Data:
  Upgrade Request Id = UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1
  Name = mysql
  Start Time = 2021-09-25T09:21:16
  End Time = 2021-09-25T09:22:04
  Pid = 83013
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_mysql_cluster_2021_09_25-09.21.16.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"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":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-77bc0c30-7ff5-4c50-ad09-6f96907e22e1","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 48
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-09-25T09:21:16
[...]

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

シークレット・サービスには、個別にアップグレードする必要がある2つのコンポーネントが含まれています: EtcdとVault。それらをアップグレードする順序は関係ありません。

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

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: Etcdをアップグレードします。
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
Etcdのアップグレードが正常に完了したら、この手順を繰り返してボールトのアップグレード・リクエストを作成します。

サービスCLIの使用

管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム

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

構文(1行に入力):

upgradeEtcd 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

upgradeVault 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradeEtcd \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradeEtcd imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-25 10:24:52,177 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632826770954-etcd-26973 Upgrade Request Id = UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284

PCA-ADMIN> upgradeVault \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradeVault imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-25 10:38:25,417 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632850933353-vault-16966 Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906

共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータなしでコマンドを入力するだけです: upgradeEtcdおよびupgradeVault。

リクエスト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
  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=1632850933353-vault-16966
Command: getUpgradeJob upgradeJobId=1632850933353-vault-16966
Status: Success
Time: 2021-09-25 10:39:31,308 UTC
Data:
  Upgrade Request Id = UWS-352df3d1-c21f-441b-8f6e-9381ac075906
  Name = vault
  Start Time = 2021-09-25T10:38:25
  End Time = 2021-09-25T10:39:07
  Pid = 16966
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_vault_2021_09_25-10.38.25.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"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":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-352df3d1-c21f-441b-8f6e-9381ac075906","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 42
  Tasks 1 - Name = Check Vault Running Status
  Tasks 1 - Description = Check vault service running status is healthy
  Tasks 1 - Time = 2021-09-25T10:38:25
[...]

7.3.4 ファームウェアのアップグレード

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

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を実行します。

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: Ilomをアップグレードします。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ホストIP: ILOMネットワークにコンポーネントに割り当てられたIPアドレスを入力します。これは、内部の100.96.0.0/23範囲のIPアドレスです。
- イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ILOMファームウェアは、解凍されたISOイメージの/pca_firmware/<component>/サブディレクトリに*.pkgファイルとして格納されます。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

コマンドを実行するために必要な情報を収集します:
- ファームウェアをアップグレードするILOMのIPアドレス
- 展開されたISOイメージ内のファームウェア・パッケージ・ファイルへのパス

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

構文(1行に入力):

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

例:

PCA-ADMIN> upgradeIlom \
imageLocation="http://host.example.com/iso/pca_firmware/X9-2/.../ILOM-<version>-ORACLE_SERVER_X9-2-rom.pkg" \
hostIp=100.96.0.66
Command: upgradeIlom imageLocation="http://host.example.com/iso/pca_firmware/X9-2/.../ILOM-<version>-ORACLE_SERVER_X9-2-rom.pkg" hostIp=100.96.0.66
Status: Success
Time: 2021-09-24 11:18:31,044 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1620921089806-ilom-21480 Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010

リクエスト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
Command: getUpgradeJob 1620921089806-ilom-21480
Status: Success
Time: 2021-09-24 11:24:49,243 UTC
Data:
  Upgrade Request Id = UWS-732d6fce-9f06-4329-b972-d093bee40010
  Name = ilom
  Start Time = 2021-09-24 11:18:32
  End Time = 2021-09-24 11:21:18
  Pid = 21480
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_ilom_firmware_2021_09_24-11.18.31.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":"100.96.0.66","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":"file:///nfs/shared_storage/pca_firmware/X9-2/.../ILOM-5_0_2_21_r140740-ORACLE_SERVER_X9-2-rom.pkg","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-732d6fce-9f06-4329-b972-d093bee40010","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 166
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-09-24T11:18:32
[...]

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

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

アプライアンスZFS Storage Applianceのオペレーティング・ソフトウェアをアップグレードするには、アンパックされたISOイメージ内のファームウェア・パッケージへのパスを指定するだけで済みます。ストレージ・コントローラのIPアドレスがわかっているため、1つのアップグレード・コマンドによって両方のコントローラのローリング・アップグレードが開始されます。 2つのコントローラに新しいILOMファームウェア・バージョンが含まれている場合は、ストレージ・アプライアンスのアップグレード・プロセスの一部としてインストールされます。

注意

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: Zfssaをアップグレードします。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 ZFS Storage Applianceオペレーティング・ソフトウェアは、解凍されたISOイメージの/pca_firmware/zfs/サブディレクトリに*.pkgファイルとして格納されます。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

コマンドを実行するために必要な情報を収集: 開梱されたISOイメージ内のAK-NASファームウェア・パッケージへのパス。

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

構文:

upgradeZfssa imageLocation=<path-to-firmware>

例:

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

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

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632914107346-zfssa-83002        UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9   zfssa         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=1632914107346-zfssa-83002
Command: getUpgradeJob upgradeJobId=1632914107346-zfssa-83002
Status: Success
Time: 2021-09-27 11:42:10,729 UTC
Data:
  Upgrade Request Id = UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9
  Name = zfssa
  Start Time = 2021-09-29T11:15:07
  End Time = 2021-09-29T11:26:42
  Pid = 83002
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_zfssa_ak_2021_09_29-11.15.07.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"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":"file:///nfs/shared_storage/pca_firmware/zfs/ak-nas-2021.08.27-1.0x-nondebug.pkg","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 697
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-09-29T11:15:08
[...]

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

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

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

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: アップグレード・スイッチ。
アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- EPLD: このファームウェア・バージョンに必要な場合は、EPLDイメージ・ファイルが格納されているロケーションへのパスを入力します。 EPLDファイルが存在する場合、EPLDファイルは、解凍されたISOイメージの/pca_firmware/network/cisco/サブディレクトリにNX-OSオペレーティング・ソフトウェアとともに格納される*.imgファイルです。
- イメージのロケーション: ファームウェア・パッケージが格納されているロケーションへのパスを入力します。 Cisco NX-OSネットワーク・オペレーティング・ソフトウェアは、解凍されたISOイメージの/pca_firmware/network/cisco/サブディレクトリに*.binファイルとして格納されます。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- スイッチ・タイプ: アップグレードするスイッチ・タイプを選択します。優先されるアップグレード順序は次のとおりです: 最初にリーフ・スイッチ、次にスパイン・スイッチ、最後に管理スイッチ。
Create Requestをクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
アップグレードが正常に完了したが、システム内のほかのスイッチをアップグレードする必要がある場合は、アップグレードが必要なほかのタイプのスイッチに対してこの手順を繰り返します。

サービスCLIの使用

コマンドを実行するために必要な情報を収集します:
- アップグレードするウィッチのタイプ(スパイン、リーフ、管理)
- 開梱されたISOイメージ内のファームウェア・バイナリ・ファイルへのパス
- 新しいファームウェア・バージョンに存在する場合、解凍されたISOイメージ内のEPLDアップグレード・ファイルへのパス

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

構文(1行に入力):

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

例:

PCA-ADMIN> upgradeSwitch switchType=LEAF \
imageLocation="http://host.example.com/iso/pca_firmware/network/cisco/nxos.<version>.bin" \
epld="http://host.example.com/iso/pca_firmware/network/cisco/n9000-epld.<version>.img"
Command: 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
Time: 2021-09-24 14:16:54,704 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1630511206512-cisco-20299 Upgrade Request Id = UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3

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

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632914107346-zfssa-83002        UWS-881af57f-5dfb-4c75-8026-9f00cf3eb7c9   zfssa         Passed
  1630511206512-cisco-20299        UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3   cisco         Passed
  1620921089806-ilom-21480         UWS-732d6fce-9f06-4329-b972-d093bee40010   ilom          Passed

PCA-ADMIN> getupgradeJob upgradeJobId=1630511206512-cisco-20299
Command: getupgradeJob upgradeJobId=1630511206512-cisco-20299
Status: Success
Time: 2021-09-24 15:48:08,455 UTC
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
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"result_override":null,"log_level":null,"switch_type":"LEAF","precheck_status":false,"task_time":0,"fail_halt":false,"fail_upgrade":null,"component_names":null,"upgrade_to":null,"image_location":"file:///nfs/shared_storage/pca_firmware/network/cisco/nxos.9.3.2.bin","epld_image_location":null,"expected_iso_checksum":null,"checksum":null,"composition_id":null,"request_id":"UWS-44688fe5-b4f8-407f-a1b5-8cd1b685c2c3","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 777
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
  Tasks 1 - Time = 2021-09-24T14:46:47
[...]

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

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

依存関係の理由から、管理ノードのホスト・オペレーティング・システムの後にKubernetesをアップグレードする必要があります。そのため、共有ストレージでアップグレードISOイメージがすでに解凍されています。Kubernetesアップグレード・コマンドに必須パラメータはありません。

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: Kubernetesをアップグレードします。
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム

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

構文(1行に入力):

upgradeKubernetes 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradeKubernetes \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradeKubernetes imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-26 17:20:09,423 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632849609034-kubernetes-35545 Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf

共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力: upgradeKubernetes。

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

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed
  1632826770954-etcd-26973         UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284   etcd          Passed
  1632850933353-vault-16966        UWS-352df3d1-c21f-441b-8f6e-9381ac075906   vault         Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632849609034-kubernetes-35545
Command: getUpgradeJob upgradeJobId=1632849609034-kubernetes-35545
Status: Success
Time: 2021-09-26 17:43:38,443 UTC
Data:
  Upgrade Request Id = UWS-edfa3b32-c32a-4b67-8df5-2357096052bf
  Name = kubernetes
  Start Time = 2021-09-26T17:20:09
  End Time = 2021-09-26T17:21:52
  Pid = 35545
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_kubernetes_cluster_2021_09_26-17.20.09.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"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":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-edfa3b32-c32a-4b67-8df5-2357096052bf","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 249
  Tasks 1 - Name = Retrieving Cluster Status
  Tasks 1 - Description = Retrieving cluster status and upgrade data from the kubernetes nodes
  Tasks 1 - Time = 2021-09-26T17:20:10
[...]

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

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

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

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

サービスWeb UIの使用

ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: プラットフォームをアップグレードします。
必要に応じて、アップグレード・リクエスト・パラメータを入力します:
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
- ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
Create Requestをクリックします。

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

サービスCLIの使用

管理ノードのホスト・オペレーティング・システムをアップグレードしていない場合は、コマンドの実行に必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム

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

構文(1行に入力):

upgradePlatform 
imageLocation=<path-to-iso>
isoChecksum=<iso-file-checksum>

例:

PCA-ADMIN> upgradePlatform \
imageLocation="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Command: upgradePlatform imageLocation="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7
Status: Success
Time: 2021-09-26 20:48:41,452 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1632850650836-platform-68465 Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f

共有ストレージでアップグレードISOイメージがすでに展開されている場合は、パラメータを指定せずにコマンドを入力: upgradePlatform。

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

PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1632850650836-platform-68465     UWS-26dba234-9b52-426d-836c-ac11f37e717f   platform      Passed
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed
  1632826770954-etcd-26973         UWS-fec15d32-fc2b-48bd-9ae0-62f49587a284   etcd          Passed
  1632850933353-vault-16966        UWS-352df3d1-c21f-441b-8f6e-9381ac075906   vault         Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1632850650836-platform-68465
Command: getUpgradeJob 1632850650836-platform-68465
Status: Success
Time: 2021-09-26 21:03:16,264 UTC
Data:
  Upgrade Request Id = UWS-26dba234-9b52-426d-836c-ac11f37e717f
  Name = kubernetes
  Start Time = 2021-09-26T20:48:41
  End Time = 2021-09-26T20:59:34
  Pid = 68465
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_platform_services_2021_09_26-20.48.41.log
  Arguments = {"verify_only":false,"upgrade":false,"diagnostics":false,"host_ip":null,"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":"http://host.example.com/pca-3.0.1-b535176.iso","epld_image_location":null,"expected_iso_checksum":null,"checksum":"240420cfb9478f6fd026f0a5fa0e998e086275fc45e207fb5631e2e99732e192e8e9d1b4c7f29026f0a5f58dadc4d792d0cfb0279962838e95a0f0a5fa31dca7","composition_id":null,"request_id":"UWS-26dba234-9b52-426d-836c-ac11f37e717f","display_task_plan":false,"dry_run_tasks":false}
  Status = Passed
  Execution Time(sec) = 653
  Tasks 1 - Name = Check All Ingress Endpoints
  Tasks 1 - Description = Check whether all ingress endpoints are up and running
  Tasks 1 - Time = 2021-09-26T20:48:42
[...]

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

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

コンピュート・ノードのホストIPアドレスを取得するには、サービスCLIコマンドshow ComputeNode name=<node_name>を使用して、出力でIp Addressを探します。

サービスWeb UIの使用

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

詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
1. ナビゲーション・メニューで、Rack Unitsをクリックします。「ラック・ユニット」表で、アップグレードするコンピュート・ノードの名前をクリックして詳細ページを表示します。
2. コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、プロビジョニング・ロック・コマンドを選択します。
3. プロビジョニング・ロックが設定されたら、Controlsを再度クリックし、Maintenance Lockコマンドを選択します。
ナビゲーション・メニューで、アップグレード&パッチ適用をクリックします。
「アップグレード・ジョブ」ページの右上隅にあるアップグレードまたはパッチの作成をクリックします。

Create Requestウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: CNをアップグレード。
アップグレード・リクエスト・パラメータを入力します:
- ホストIP: 内部管理ネットワークでコンピュート・ノードに割り当てられたIPアドレスを入力します。これは、内部の100.96.2.0/23範囲のIPアドレスです。
- ISOチェックサム: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージがこのアップグレードに対して有効であることを確認できるチェックサムを入力します。チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。
- イメージのロケーション: このパラメータを指定して前のアップグレード・コマンドを実行していない場合は、ISOイメージが格納されるロケーションへのパスを入力します。
- ログ・レベル: オプションで、アップグレード・ログ・ファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを提供するJSON文字列を追加します。
Create Requestをクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
コンピュート・ノードが正常にアップグレードされたら、プロビジョニング・ロックおよびメンテナンス・ロックを解放します。

詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
1. コンピュート・ノードの詳細ページを開きます。
2. コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、Maintenance Unlockコマンドを選択します。
3. メンテナンス・ロックが解放されたら、制御を再度クリックし、プロビジョニング・ロック解除コマンドを選択します。

サービスCLIの使用

コマンドを実行するために必要な情報を収集します:
- アップグレード元のISOイメージのロケーション
- ISOイメージが有効であることを検証するために使用されるチェックサム
- アップグレードするコンピュート・ノードのIPアドレス

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

詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。

PCA-ADMIN> list ComputeNode
Data:
  id                                     name       provisioningState   provisioningType
  --                                     ----       -----------------   ----------------
  363a26f4-fa34-4e4c-8e17-a1671a0b77d1   pcacn001   Provisioned         KVM
  9e8745c7-52e3-4aae-984c-e198869ee2cc   pcacn002   Provisioned         KVM
  56a9ecda-2402-427f-92d1-7f9be57dba36   pcacn003   Provisioned         KVM

PCA-ADMIN> provisioningLock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1

PCA-ADMIN> maintenanceLock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1

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

構文(1行に入力):

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

例:

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

リクエスト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
Command: getupgradejob upgradeJobId=1630938939109-compute-7545
Status: Success
Time: 2021-09-26 08:15:03,208 UTC
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
[...]

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

詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。
```
PCA-ADMIN> maintenanceUnlock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1
PCA-ADMIN> provisioningUnlock id=363a26f4-fa34-4e4c-8e17-a1671a0b77d1
```
次のコンピュート・ノードに進み、この手順を繰り返します。

第7章 システムのアップグレード

7.1 アップグレード要件

7.1.1 権限の確認

7.1.2 ISOイメージの準備

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

7.2 完全管理ノードのアップグレードの実行

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

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

7.3.2 MySQLクラスタ・データベースのアップグレード

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

7.3.4 ファームウェアのアップグレード

ILOMのアップグレード

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

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

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

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

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

第7章システムのアップグレード