アップグレード用の新規ソフトウェア・ソースの設定

Upgraderのコードは、他のシステム・サービスと同様に定期的に変更されます。 アップグレード準備の設定フェーズでは、すべてのアップグレード・コマンドが最新バージョンで実行されるように、最初にUpgraderが最新であることが保証されます。 Upgraderが使用可能な最新バージョンでないことがシステムで検出された場合、アップグレード操作は実行できません。

最新バージョンのUpgraderが稼働している場合、新しいアプライアンス・ソフトウェアのソースは、システム・アップグレード手順で使用するように設定されます。 現在のソフトウェア・イメージがバックアップされ、新しいソフトウェアISOが適切なディレクトリ構造の管理クラスタ共有ストレージに解凍されます: OSベース・イメージ、アプライアンス・ソフトウェアRPMパッケージ、新しいコンピュート・インスタンス・イメージ、新しいファームウェアなど。

設定フェーズの最後に、「アップグレード計画」が生成されます。 アップグレード計画は、現在のインストールと開梱された新しいバージョンの比較に基づきます。 次のフェーズで実行する必要があるアップグレード手順を決定します。 詳細は、「アップグレード計画ステータスおよび進捗のチェック」を参照してください。

この設定プロセス全体が、単一のコマンドでアプライアンス管理者によって起動されます。

注意:

最初に事前構成プロセスが完了していることを確認します。 「アップグレード環境を事前構成」を参照してください。

後でアップグレード計画を実行する際に不整合を回避するには、準備プロセス内のupgradePreConfig (事前構成)およびpreUpgrade (設定)の両方のコマンドを指定された順序でまとめて完了することが重要です。 preUpgradeコマンドを再実行する必要がある場合は、先に前のコマンドを再実行する必要があります。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。 ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。

  2. 「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。

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

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

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

  5. アップグレード・リクエスト・タイプには、ISOと入力します。 必要なファイルは、解凍されたISOイメージから取得されます。

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

    新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。 ジョブが正常に完了すると、Upgraderは最新の状態になり、新しいソフトウェア・バージョン・ソースを使用できます。

「サービスCLI」の使用

  1. 最新のUpgraderバージョンのインストールと、新しいアプライアンス・ソフトウェア・ソースの設定を開始します。

    PCA-ADMIN> preUpgrade type=ISO
    Status: Running
    JobId: aa33246e-fd79-460f-a191-cc97f8be04be
    Data: in progress

    次のコマンドで実行されるアップグラダ操作:

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

    2. 「サービスCLI」および「サービスWeb UI」を更新して、最新のコマンドおよび関数を使用可能にします。

    次のコマンドで実行される設定操作:

    1. 現在のソフトウェア・イメージをバックアップします。

    2. ISOイメージを解凍し、新しいソフトウェアRPMおよびインストール・ファイル(イメージ、ファームウェア)を正しいディレクトリに保存します。

    3. アプライアンスの内部共有ストレージから不要になったバックアップおよびイメージを削除します。

    4. アップグレード計画を生成します。

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

    PCA-ADMIN> getPreUpgradeStatus
    Data: 
      status = IN-PROGRESS
      message =  PREUPGRADE-c0f0b38d-64d2-42bb-8d96-de39d1218b24: A pre-upgrade task is running!
    
    PCA-ADMIN> getPreUpgradeStatus
    Data:
      status = SUCCESS
      message =  The previous pre-upgrade task succeeded!
  3. Upgraderの最新バージョンが正常にインストールされていることを確認します。

    PCA-ADMIN> getUpgradeJobs
    Data: 
      id                            Upgrade Request Id                                Command Name   Result   
      --                            ------------------                                ------------   ------   
      1737484792498-setup-42073     PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8   setup          Passed   
      1737483518274-prepare-28393   UWS-e37208d4-d433-4e16-8140-de38c0757c9d          prepare        Passed  

    preUpgradeプロセスが失敗した場合は、アップグレード・ジョブでトラブルシューティング情報を確認してください。

    PCA-ADMIN> getUpgradeJob upgradeJobId=1737484792498-setup-42073
    Data:
      Upgrade Request Id = PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8
      Name = setup
      Pid = 25325
      Host = pcamn02
      Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_setup_upgrade_environment_2025_01_21-18.39.52.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":null,"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":null,"composition_id":null,"request_id":"PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8","uln":null,"patch":null}
      Status = Failed
      Execution Time(sec) = 1069
      Tasks 1 - Name = Validate Setup Image Location
      Tasks 2 - Name = Validate Upgrader Version
      Tasks 3 - Name = Validate Upgrade Order
    [...]
      Tasks 22 - Name = Delete Old backups
      Tasks 22 - Message = [Errno 2] No such file or directory: '/nfs/shared_storage/yum/pca_upgrader'
      Tasks 22 - Status = Failed
  4. システムが準備完了状態であることを確認します。 次に、ラック・アップグレード・ワークフローに進みます。

  5. アップグレード計画を表示して、アップグレードする必要があるコンポーネントを確認します。 ターゲットのビルド番号が、アップグレードを計画しているアプライアンス・ソフトウェアのバージョンと一致することを確認します。

    PCA-ADMIN> getUpgradePlan
    Data: 
      id                          component    currentBuild     targetBuild      currentVersion                   targetVersion                              requireReboot   timeEstimation (min)   requireUpgrade   impactedInfra   
      --                          ---------    ------------     -----------      --------------                   -------------                              -------------   --------------------   --------------   -------------   
      generic                     zfssa        3.0.2-b1300385   3.0.2-b1300385   2013.06.05.8.73.1-2.73.5701.1    2013.06.05.8.73.1-2.73.5701.1              false           45                     false            host,compute    
      100.96.2.64                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.65                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.66                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.33                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      100.96.2.34                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      100.96.2.35                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      generic                     mysql        3.0.2-b1300385   3.0.2-b1300385   8.0.36-1.1                       8.0.36-1.1                                 false           15                     false            host            
      generic                     etcd         3.0.2-b1300385   3.0.2-b1300385   3.5.6                            3.5.6                                      false           5                      false            host            
      generic                     vault        3.0.2-b1300385   3.0.2-b1300385   v1.7.1-3.10.0.0.0.4.g5f2d5af     v1.7.1-3.10.0.0.0.4.g5f2d5af               false           5                      false            host            
      generic                     kubernetes   3.0.2-b1300385   3.0.2-b1300385   1.25.16-2                        1.25.16-2                                  false           60                     false            host,compute    
      generic                     platform     3.0.2-b1300130   3.0.2-b1300385   None                             None                                       false           40                     true             host,compute    
      Oracle-Linux-7.9            ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      Oracle-Linux8-OKE-1.28.8    ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Solaris-11           ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.08.26_0                               false           5                      true             host            
      Oracle-Linux8-OKE-1.27.12   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Linux8-OKE-1.26.15   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Linux-9              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      Oracle-Linux-8              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      100.96.0.33                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.34                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.35                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.64                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.65                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.66                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      leaf                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
      spine                       switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
      mgmt                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute