1. 管理者ガイドforリリース3.0.2
  2. システムのアップグレード
機械翻訳について

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

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

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

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

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

システムのアップグレード後に、importPlatformImagesコマンドを実行して、新しく配信されたプラットフォーム・イメージをすべてのコンパートメントで使用できるようにします。 「プラットフォーム・イメージの提供」を参照してください。

アップグレード要件

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

権限の確認

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

「サービス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

アップグレード環境の準備

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

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

アップグレード操作を実行する前に、ISOファイルの内容を解凍して、3つの管理ノードすべてにマウントされた共有ストレージにソース・ディレクトリを移入します。 これにより、アップグレード・コマンドの実行時に新しいバージョンがインストールされます。

「サービスCLI」の使用

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

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

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

  2. upgrade pre-configurationコマンドを入力します。

    構文(1行に入力):

    upgradePreConfig 
option=ISO
location=<path-to-iso>
isoChecksum=<iso-file-checksum>

    例:

    PCA-ADMIN> upgradePreConfig  option=ISO \
location="http://host.example.com/pca-<version>-<build>.iso" \
isoChecksum=90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027
Command: upgradePreConfig  option=ISO location="http://host.example.com/pca-<version>-<build>.iso" isoChecksum=90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027
Status: Success
Time: 2022-11-06 06:35:38,884 UTC
Data:
  Service request has been submitted. Upgrade Job Id = 1668417666968-prepare-28142 Upgrade Request Id = UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186

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

    PCA-ADMIN> getUpgradeJobs
  id                               upgradeRequestId                           commandName   result
  --                               ----------------                           -----------   ------
  1630938939109-compute-7545       UWS-61736806-7e5a-4648-9259-07c54c39cacb   compute       Passed
  1632849609034-kubernetes-35545   UWS-edfa3b32-c32a-4b67-8df5-2357096052bf   kubernetes    Passed
  1668417666968-prepare-28142      UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186   prepare       Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1668417666968-prepare-28142
Command: getUpgradeJob upgradeJobId=1668417666968-prepare-28142
Status: Success
Time: 2022-11-06 07:24:00,793 UTC
Data:
  Upgrade Request Id = UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186
  Name = prepare
  Start Time = 2022-06-14T06:35:56
  End Time = 2022-11-06T06:35:58
  Pid = 28142
  Host = pcamn02
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2022_11_16-06.35.56.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":"http://host.example.com/pca-<version>-<build>.iso","online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":"90e4505b098031afb02068080db2603dc6f580cd7cf52aa51ecd0c3b81668027","composition_id":null,"request_id":"UWS-c94ba56a-1b91-49d8-8e51-afeae7f62186","uln":null,"patch":null}
  Status = Passed
  Execution Time(sec) = 616
  Tasks 1 - Name = Validate Image Location
  Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
[...]

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

アップグレード前のバックアップ

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

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

「サービスCLI」の使用

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

    PCA-ADMIN> backup target=vault
Command: backup target=vault
Status: Success
Time: 2022-11-06 09:56:18,786 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm
  Display Name = brs-job-1668419778-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.wrxfwtxwxw6ydp2mwnypcaaxxzmwpuhsc33gcm3dyte7kgr4etuhb29qbs8q
  Time Created = 2022-11-06T09:56:18Z
  Lifecycle State = CREATING
  Retention = 14

PCA-ADMIN> backup target=zfs
Command: backup target=zfs
Status: Success
Time: 2022-11-06 09:57:23,084 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc
  Display Name = brs-job-1668419842-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.p7w0tgbvhtjqsgc8rllca2cvotkpgrtf4huiph7466mjio0dgskij9f0bp06
  Time Created = 2022-11-06T09:57:22Z
  Lifecycle State = CREATING
  Retention = 14

PCA-ADMIN> backup target=mysql
Command: backup target=mysql
Status: Success
Time: 2022-11-06 09:57:30,229 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
  Display Name = brs-job-1668419850-backup
  Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.henfqzdbafs4z3mxeuslb1c6f4t049w0pxvwf1gi3eb8wm1y11v7m932tn4g
  Time Created = 2022-11-06T09:57:30Z
  Lifecycle State = CREATING
  Retention = 14

  2. バックアップ・ジョブIDを使用して、バックアップのステータスを確認します。

    PCA-ADMIN> getBackupJobs
Command: getBackupJobs
Status: Success
Time: 2022-11-06 10:03:18,986 UTC
Data:
  id                                                                                              displayName                 components
  --                                                                                              -----------                 ----------
  ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot   brs-job-1668419850-backup   mysql
  ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc   brs-job-1668419842-backup   zfs
  ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm   brs-job-1668419778-backup   vault

PCA-ADMIN> getBackupJob backupJobId=ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
Command: getBackupJob backupJobId=ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
Status: Success
Time: 2022-11-06 10:04:07,080 UTC
Data:
  Type = BackupJob
  Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
  Display Name = brs-job-1668419850-backup
  Time Created = 2022-11-06T09:57:30Z
  Status = success
  Components = mysql

  3. 3つのバックアップ操作がすべて正常に完了したことを確認します。 次に、次のアップグレード準備フェーズに進みます。

Upgraderのアップグレード

アップグレーダのコードは、ほかのシステム・サービスと同様に、定期的に変更されます。 アプライアンスで最新のアップグレード・プログラムが実行されていることを確認するには、コンポーネントのアップグレードを開始する前に最新であることを確認してください。

「サービスCLI」の使用

  1. 管理ノードに最新のupgraderバージョンをインストールするプロセスを開始します。

    PCA-ADMIN> preUpgrade action=start type=ISO
Command: preUpgrade action=start type=ISO
Status: Success
Time: 2022-11-06 10:34:46,333 UTC
Data: 
  Successfully triggered the pre-upgrade task.
   Pre upgrade status = success

    プロセスの一部として、次の操作が実行されます:

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

    2. 新しいアップグレーダ・ファイルのyumリポジトリを構成します。

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

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

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

    PCA-ADMIN> preUpgrade action=status
Command: preUpgrade action=status
Status: Success
Time: 2022-11-16 10:34:56,042 UTC
Data: 
  A pre-upgrade task is running!
  Pre upgrade status = IN-PROGRESS
 
PCA-ADMIN> preUpgrade action=status
Command: preUpgrade action=status
Status: Success
Time: 2022-11-16 10:45:19,435 UTC
Data: 
   The previous pre-upgrade task succeeded!
   Pre upgrade status = SUCCESS

  3. アップグレーダの最新バージョンが正常にインストールされていることを確認します。 システムが準備完了状態であることを確認します。 次に、コンポーネントのアップグレードに進みます。

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

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

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

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

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

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

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

「サービスWeb UI」の使用

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

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

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

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

    3. プロビジョニング・ロックが設定されたら、Controlsを再度クリックし、Maintenance Lockコマンドを選択します。

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

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

  6. Create Requestをクリックします。

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

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

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

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

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

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

「サービスCLI」の使用

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

    • アップグレードするコンピュート・ノードのIPアドレス

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

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

  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

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

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

    アップグレードISOイメージがすでに共有ストレージで解凍されている場合は、ISOイメージ・パラメータを指定せずにコマンドを入力: upgradeCN hostIp=<compute-node-ip>。

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

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

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

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

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

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

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

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

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

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

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

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

「サービスWeb UI」の使用

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

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

  5. Create Requestをクリックします。

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

    ノート:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 ただし、このステップはアップグレード・プロセスの一部であるため、管理者アクションは必要ありません。

「サービスCLI」の使用

  1. アップグレード環境を準備するステップをまだ実行していない場合は、コマンドの実行に必要な情報を収集します:

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

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

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

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

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

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

    ノート:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 ただし、このステップはアップグレード・プロセスの一部であるため、管理者アクションは必要ありません。

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

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

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

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

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

「サービスWeb UI」の使用

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

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

  5. Create Requestをクリックします。

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

    ノート:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 ただし、このステップはアップグレード・プロセスの一部であるため、管理者アクションは必要ありません。

「サービスCLI」の使用

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

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

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

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

  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
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

    アップグレードISOイメージがすでに共有ストレージで解凍されている場合は、ISOイメージ・パラメータを指定せずにコマンドを入力: upgradeHost hostIp=<management-node-ip>。

  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
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
[...]

  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

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

    ノート:

    アップグレード後、変更を有効にするには、管理ノードをすべてリブートする必要があります。 ただし、このステップはアップグレード・プロセスの一部であるため、管理者アクションは必要ありません。

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

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

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

「サービスWeb UI」の使用

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

  5. Create Requestをクリックします。

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

「サービスCLI」の使用

  1. アップグレード環境を準備するステップをまだ実行していない場合は、コマンドの実行に必要な情報を収集します:

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

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

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

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

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

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

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

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

「サービスWeb UI」の使用

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

  5. Create Requestをクリックします。

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

  6. Etcdのアップグレードが正常に完了したら、この手順を繰り返してボールトのアップグレード・リクエストを作成します。

「サービスCLI」の使用

  1. アップグレード環境を準備するステップをまだ実行していない場合は、コマンドの実行に必要な情報を収集します:

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

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

  2. 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。

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

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

ファームウェアは、すべてのコンポーネントILOMのISOイメージ、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」の使用

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

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

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

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

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

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

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

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

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

  5. Create Requestをクリックします。

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

「サービス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
Command: 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
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

  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
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アップグレードが成功した後は、管理ノードまたはコンピュート・ノードを手動で再起動する必要があります。

注意:

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

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

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

注意:

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

始める前に

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

「サービスWeb UI」の使用

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

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

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

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

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

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

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

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

  5. Create Requestをクリックします。

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

「サービス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"
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

  3. リクエスト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ファイルが含まれている場合は、「最初にNX-OSソフトウェアをアップグレードしてから、EPLDイメージを更新」。

「サービスWeb UI」の使用

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

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

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

  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. Create Requestをクリックします。

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

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

「サービス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"
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

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

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

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

依存関係上の理由から、管理ノードのホスト・オペレーティング・システムのあとでKubernetesをアップグレードする必要があります。 Kubernetes upgradeコマンドには必須パラメータがありません。

「サービスWeb UI」の使用

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

  5. Create Requestをクリックします。

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

「サービスCLI」の使用

  1. アップグレード環境を準備するステップをまだ実行していない場合は、コマンドの実行に必要な情報を収集します:

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

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

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

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

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

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

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

ノート:

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

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

「サービスWeb UI」の使用

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

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

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

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

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

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

    • イメージのロケーション: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージが格納されているロケーションへのパスを入力します。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

    • ISOチェックサム: upgrade pre-configurationコマンドをまだ実行していない場合は、ISOイメージがこのアップグレードに対して有効であることをシステムが検証できるようにするチェックサムを入力します。 チェックサムは、ISOイメージとともに提供されます。そのファイル名は.sha512sumが付加されたISOイメージ名です。 アップグレード環境を準備する手順に従った場合、このパラメータはオプションです。

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

  5. Create Requestをクリックします。

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

「サービスCLI」の使用

  1. アップグレード環境を準備するステップをまだ実行していない場合は、コマンドの実行に必要な情報を収集します:

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

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

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

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

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