コンピュート・ノードへのパッチ適用

注意:

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

アプライアンス・ソフトウェア・バージョン3.0.2-b1081557以降にパッチを適用する場合は、他のすべてのコンポーネントより前にZFS Storage Applianceファームウェアにパッチを適用する必要があります。詳細は、「アップグレード計画ステータスおよび進捗のチェック」を参照してください。

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

syncUpstreamUlnMirrorコマンドを発行して、コンピュート・ノードのパッチ適用の前に、共有ストレージ上のミラーの同期が完了していることを確認します。詳細は、「ULNミラーとの更新および同期」を参照してください。

ノート:

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

ノート:

ソフトウェア・バージョン3.0.2-b892153以降では、すべてのパッチ操作はアップグレード計画に基づいており、アップグレード前コマンドの実行時に生成されます。詳細は、「パッチ適用のための新しいソフトウェア・ソースの設定」を参照してください。コンポーネントがすでに必須バージョンである場合、パッチ操作はスキップされます。ただし、必要に応じて、「サービスWeb UI」または「サービスCLI」コマンド・オプション(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. 5分待って、ILOMパッチ・ジョブを完了させます。次に、ホストのパッチ適用に進みます。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「パッチ」を選択します。
適切なパッチ・リクエスト・タイプの選択: パッチCN。
必要に応じて、リクエスト・パラメータを入力します:
- ホストIP: 内部管理ネットワークでコンピュート・ノードに割り当てられたIPアドレスを入力します。これは、内部の100.96.2.0/23範囲のIPアドレスです。
- ログ・レベル: オプションで、アップグレード・ログファイルの特定のログ・レベルを選択します。デフォルトのログ・レベルは「情報」です。詳細は、「デバッグ」を選択します。
- 拡張オプションJSON: 利用できません。
- 代替ULNチャネル: このパラメータは、リクエストに非標準ULNチャネルを強制的に使用します。 Oracleが明示的に指示しないかぎり、このオプションを使用しないでください。
- 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。
- 強制: 操作を強制するには、このオプションを有効にします。 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にパッチを適用します。

ILOM patchコマンドを入力します。

構文(1行に入力):

patchIlom
hostIp=<ilom-ip>

例:

PCA-ADMIN> patchIlom 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

5分待って、ILOMパッチ・ジョブを完了させます。次に、ホストのパッチ適用に進みます。

コンピュート・ノードのパッチ・コマンドを入力します。

構文(1行に入力):
```
patchCN 
hostIp=<compute-node-ip>
[optional] uln=<http|https>://<hostname.domainname>/<sub-directories>
```
オプションとマークされたパラメータは、ソフトウェア・バージョン3.0.2-b892153以降では非推奨です。以前のバージョンでは、ULNミラーの完全修飾ドメイン名にコマンドを含めます。

例:
```
PCA-ADMIN> patchCN hostIp=100.96.2.64 ULN=http://host.example.com/yum
Status: Success
Data:
  Service request has been submitted.  Upgrade Job ID = 1685372050358-compute-50568 Upgrade Request ID = UWS-f226d7d2-549d-4902-8614-e1f40bdc9ff6
```

リクエストIDとジョブIDを使用して、パッチ適用プロセスのステータスを確認します。

PCA-ADMIN> getUpgradeJobs
Command: getUpgradeJobs
Status: Success
Time: 2023-01-01 21:09:34.745 UTC
Data:
  id                              upgradeRequestId                           commandName   result
  --                              ----------------                           -----------   ------
  1685372050358-compute-50568     UWS-f226d7d2-549d-4902-8614-e1f40bdc9ff6   compute       Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1685372050358-compute-50568
Command: getUpgradeJob upgradeJobId=1685372050358-compute-50568
Status: Success
Time: 2023-01-01 21:10:13,804 UTC
Data:
  Upgrade Request Id = UWS-f226d7d2-549d-4902-8614-e1f40bdc9ff6
  Name = compute
[...]

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

詳細は、「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