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

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

注意:

システム・アップグレードの準備ステップがすべて完了していることを確認します。手順は、「アプライアンスのアップグレードの準備」を参照してください。

アプライアンス・ソフトウェア・バージョン3.0.2-b1081557以降にアップグレードする場合は、他のすべてのコンポーネントより前に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管理者ガイドのハードウェア管理の章にある次の項を参照してください:

インスタンスの移行およびコンピュート・ノードのロック: 「コンピュート・ノード操作の実行」を参照してください。
コンピュート・サービスのHA構成: 「高可用性のためのコンピュート・サービスの構成」を参照してください。

「サービスWeb UI」の使用

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

注意:

コンピュート・サービスの高可用性構成によっては、自動インスタンス移行によって、コンピュート・ノードを正常にロックできない場合があります。「置き換えられたインスタンスのモニタリング」を参照してください。
1. ナビゲーション・メニューで、「ラック・ユニット」をクリックします。「ラック・ユニット」表で、アップグレードするコンピュート・ノードの名前をクリックして詳細ページを表示します。
2. コンピュート・ノードの詳細ページの右上隅にあるControlsをクリックし、プロビジョニング・ロック・コマンドを選択します。
3. プロビジョニング・ロックが設定されたら、「Controls」を再度クリックし、「Migrate All Vms」コマンドを選択します。コンピュート・サービスによってコンピュート・ノードが退避されます。つまり、実行中のインスタンスが他のコンピュート・ノードに移行されます。
  
  ノート:
  
  物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。ただし、厳密なフォルト・ドメイン強制(「厳密なFD」)ファンクションは無効にする必要があります。
4. コンピュート・ノードの退避が完了したら、「Controls」を再度クリックし、「Maintenance Lock」コマンドを選択します。インスタンスの移行が進行中の場合、このコマンドは失敗することがあります。数分待ってから再試行してください。
ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。
「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。
オプションで、最初にサーバーILOMをアップグレードします。
1. 「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。「要求の作成」ウィンドウが表示されます。
2. リクエスト・タイプとして「アップグレード」を選択します。適切なアップグレード・リクエスト・タイプを選択: ILOMをアップグレードします。
  
  ILOMネットワークで、サーバーに割り当てられたIPアドレスを入力します。これは、内部の100.96.0.0/23範囲のIPアドレスです。
3. 「要求の作成」をクリックします。新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
4. ILOMアップグレード・ジョブが完了するまで5分待ちます。次に、ホストのアップグレードに進みます。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: CNをアップグレード。
アップグレード・リクエスト・パラメータを入力します:
- ホストIP: 内部管理ネットワークでコンピュート・ノードに割り当てられたIPアドレスを入力します。これは、内部の100.96.2.0/23範囲のIPアドレスです。
- ログ・レベル: オプションで、アップグレード・ログファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- 拡張オプションJSON: オプションで、追加のコマンド・パラメータを指定するJSON文字列を追加します。
- 代替ULNチャネル: このパラメータはパッチ適用に適用され、無視できます。
- 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。
- 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。
「要求の作成」をクリックします。

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

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

「サービスCLI」の使用

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

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

注意:

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

インスタンスの移行およびコンピュート・ノードのロック: 「コンピュート・ノード操作の実行」を参照してください。
コンピュート・サービスのHA構成: 「高可用性のためのコンピュート・サービスの構成」を参照してください。

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

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

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

ノート:

物理リソースが制限されている場合、コンピュート・インスタンスはコンピュート・ノードの退避中に他のフォルト・ドメインに移行されます。ただし、厳密なフォルト・ドメイン強制(「厳密な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
```

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

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

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

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

オプションで、最初にサーバー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分待ちます。次に、ホストのアップグレードに進みます。

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

構文(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

リクエスト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
[...]

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

詳細は、「コンピュート・ノード操作の実行」の項を参照してください。これは、「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
```

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

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

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