手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. RhsmVars パラメーターが含まれるオーバークラウドのサブスクリプション管理用環境ファイルを編集します。通常、このファイルのデフォルト名は rhsm.yml です。

4. サブスクリプション管理の設定で、rhsm_releaseパラメーターが含まれているかどうかを確認します。rhsm_release パラメーターが存在しない場合は、追加して 9.2 に設定します。

   parameter_defaults:
     RhsmVars:
       …​
       rhsm_username: "myusername"
       rhsm_password: "p@55w0rd!"
       rhsm_org_id: "1234567"
       rhsm_pool_ids: "1a85f9223e3d5e43013e3d6e8ff506fd"
       rhsm_method: "portal"
       rhsm_release: "9.2"

5. オーバークラウドのサブスクリプション管理用環境ファイルを保存します。

6. すべてのノードでオペレーティングシステムのバージョンを RHEL 9.2 にロックするタスクを含む Playbook を作成します。

   $ cat > ~/set_release.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: set release to 9.2
         command: subscription-manager release --set=9.2
         become: true
   EOF

7. set_release.yaml Playbook を実行します。

   $ ansible-playbook -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml -f 25 ~/set_release.yaml --limit <undercloud>, <Controller>, <Compute>

   • <stack> をスタックの名前に置き換えます。
   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> は、それらのノードを含む環境内の Ansible グループに置き換えます。これらのノードには別のサブスクリプションがある可能性があるため、Ceph Storage ノードに対してこの Playbook を実行しないでください。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. RhsmVars パラメーターが含まれるオーバークラウドのサブスクリプション管理用環境ファイルを編集します。通常、このファイルのデフォルト名は rhsm.yml です。

4. サブスクリプション管理の設定で rhsm_repos パラメーターを確認します。rhsm_repos パラメーターで RHOSP 17.1 リポジトリーを使用している場合は、リポジトリーを正しいバージョンに変更します。

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-9-for-x86_64-baseos-eus-rpms
         - rhel-9-for-x86_64-appstream-eus-rpms
         - rhel-9-for-x86_64-highavailability-eus-rpms
         - openstack-17.1-for-rhel-9-x86_64-rpms
         - fast-datapath-for-rhel-9-x86_64-rpms

5. オーバークラウドのサブスクリプション管理用環境ファイルを保存します。

6. すべてのノードで、リポジトリーを RHOSP 17.1 に設定するタスクを含む Playbook を作成します。

   $ cat > ~/update_rhosp_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change osp repos
         command: subscription-manager repos --enable=openstack-17.1-for-rhel-9-x86_64-rpms
         become: true
   EOF

7. update_rhosp_repos.yaml Playbook を実行します。

   $ ansible-playbook -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml -f 25 ~/update_rhosp_repos.yaml --limit <undercloud>,<Controller>,<Compute>

   • <stack> をスタックの名前に置き換えます。
   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> は、それらのノードを含む環境内の Ansible グループに置き換えます。通常、Ceph Storage ノードは異なるサブスクリプションを使用するため、この Playbook を Ceph Storage ノードに対して実行しないでください。

8. すべての Ceph Storage ノードで、リポジトリーを RHOSP 17.1 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/update_ceph_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change ceph repos
         command: subscription-manager repos --enable=openstack-17.1-deployment-tools-for-rhel-9-x86_64-rpms
         become: true
   EOF

9. update_ceph_repos.yaml Playbook を実行します。

   $ ansible-playbook -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml -f 25 ~/update_ceph_repos.yaml --limit CephStorage

   --limit オプションを使用して、コンテンツを Ceph Storage ノードに適用します。

手順

1. コンテナー準備ファイルを編集します。通常、このファイルのデフォルト名は containers-prepare-parameter.yaml です。

2. 各ルールセットの tag パラメーターが 17.1 に設定されていることを確認します。

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
         ...
         tag: '17.1'
       tag_from_label: '{version}-{release}'

   注記

   更新に特定のタグ (17.1 や 17.1.1 など) を使用しない場合は、tag キーと値のペアを削除し、tag_from_label のみを指定します。これにより、更新プロセスの一部として使用するタグの値を決定する際に、インストールされた Red Hat OpenStack Platform バージョンが使用されます。

3. このファイルを保存します。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. コントローラーノードにログインし、Pacemaker コマンドを実行してフェンシングを無効にします。

   $ ssh tripleo-admin@<controller_ip> "sudo pcs property set stonith-enabled=false"

   • <controller_ip> を、コントローラーノードの IP アドレスに置き換えます。コントローラーノードの IP アドレスは、metalsmith list コマンドで確認できます。
4. fencing.yaml 環境ファイルで、EnableFencing パラメーターを false に設定し、更新プロセス中にフェンシングが無効のままとなるようにします。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 検証用にパッケージをインストールします。

   $ sudo dnf -y update openstack-tripleo-validations python3-validations-libs validations-common

4. 検証を実行します。

   $ validation run -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml --group pre-update

   • <stack> をスタックの名前に置き換えます。

検証

1. 検証レポートの結果を表示するには、director を使用した Red Hat OpenStack Platform のインストールと管理 の 検証履歴の表示 を参照してください。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. dnfupdateコマンドを使用して director メインパッケージを更新します。

   $ sudo dnf update -y python3-tripleoclient ansible-*

4. アンダークラウド環境を更新します。

   $ openstack undercloud upgrade

5. アンダークラウドの更新プロセスが完了するまで待ちます。

6. アンダークラウドをリブートして、オペレーティングシステムのカーネルとその他のシステムパッケージを更新します。

   $ sudo reboot

7. ノードがブートするまで待ちます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. stack ユーザーのホーム下の images ディレクトリー (/home/stack/images) から既存のイメージを削除します。

   $ rm -rf ~/images/*

4. アーカイブをデプロイメントします。

   cd ~/images
   for i in /usr/share/rhosp-director-images/ironic-python-agent-latest-17.1.tar /usr/share/rhosp-director-images/overcloud-hardened-uefi-full-latest-17.1.tar; do tar -xvf $i; done
   cd ~

5. director に最新のイメージをインポートします。

   $ openstack overcloud image upload --update-existing --image-path /home/stack/images/

6. ノードが新しいイメージを使用するように設定します。

   $ openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)

7. 新規イメージが存在することを確認します。

   $ ls -l /var/lib/ironic/httpboot /var/lib/ironic/images

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新準備コマンドを実行します。

   $ openstack overcloud update prepare \
       --templates \
       --stack <stack_name> \
       -r <roles_data_file> \
       -n <network_data_file> \
       -e <environment_file> \
       -e <environment_file> \
       ...

   以下のオプションの中で、お使いの環境に適切なオプションを追加します。

   • オーバークラウドスタックの名前がデフォルトの名前 overcloud とは異なる場合は、更新の準備コマンドに --stack オプションを追加し、<stack_name> を実際のスタック名に置き換えます。
   • 独自のカスタムロールを使用する場合は、-r オプションを使用してカスタムロール (<roles_data_file>) ファイルを含めます。
   • カスタムネットワークを使用する場合は、-n オプションを使用して、設定可能なネットワークを (<network_data_file>) ファイルに含めます。
   • 高可用性クラスターをデプロイする場合は、更新の準備コマンドに --ntp-server オプションを追加するか、環境ファイルに NtpServer パラメーターおよび値を追加します。
   • -e オプションを使用して、カスタム設定環境ファイルを含めます。
4. 更新の準備プロセスが完了するまで待ちます。

手順

1. SSH キーのサイズを検証します。

   ssh-keygen -l -f ~/.ssh/id_rsa.pub

   出力例:

   1024 SHA256:Xqz0Xz0/aJua6B3qRD7VsLr6n/V3zhmnGSkcFR6FlJw stack@director.example.local (RSA)

2. SSH キーが 2048 ビット未満の場合は、続行する前に ssh_key_rotation.yaml Ansible Playbook を使用して SSH キーを置き換えます。

   ANSIBLE_SSH_COMMON_ARGS="-o RequiredRSASize=1024" ansible-playbook \
   -i ~/config-download/<stack>/tripleo-ansible-inventory.yaml \
   /usr/share/ansible/tripleo-playbooks/ssh_key_rotation.yaml \
   --extra-vars "keep_old_key_authorized_keys=<true|false> \ backup_folder_path=</path/to/backup_folder>"

   • <stack> をオーバークラウドスタックの名前に置き換えます。
   • バックアップのニーズに基づいて <true|false> を置き換えます。この変数を含めない場合、デフォルト値は true になります。
   • </path/to/backup_folder> をバックアップパスに置き換えます。この変数を含めない場合、デフォルト値は /home/{{ ansible_user_id }}/backup_keys/{{ ansible_date_time.epoch }} になります。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. container_image_prepare タグの付いたタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags container_image_prepare

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. ovn タグを持つタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags ovn

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. ovn-controller コンテナーの更新が完了するまで待ちます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. ha_image_update タグを指定して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags ha_image_update

   • アンダークラウドスタックの名前がデフォルトのスタック名 undercloud と異なる場合は、--stack オプションを使用してスタック名を設定し、<stack_name> をスタックの名前に置き換えます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit Controller

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. コントローラーノードの更新が完了するまで待ちます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit Compute

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. コンピュートノードの更新が完了するまで待ちます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit ComputeHCI

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. ノードの更新が完了するまで待ちます。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit DistributedComputeHCI

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. DistributedComputeHCI ノードの更新が完了するまで待ちます。
5. 同じプロセスを使用して、DistributedComputeHCIScaleOut ノードを更新します。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 更新コマンドを実行します。

   $ openstack overcloud update run --stack  <stack_name> --limit CephStorage

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. ノードの更新が完了するまで待ちます。

手順

1. コントローラーノードにログインします。

2. クラスターの正常性を確認します。

   $ sudo cephadm shell -- ceph health

   注記

   Ceph Storage クラスターが正常な場合、コマンドは HEALTH_OK の結果を返します。コマンドが別の結果を返す場合は、更新を続行する前にクラスターのステータスを確認し、Red Hat サポートに連絡してください。詳細は、Red Hat Ceph Storageアップグレードガイド の cephadm を使用した Red Hat Ceph Storage クラスターのアップグレード または Red Hat Ceph Storage 6 アップグレードガイド の cephadm を使用した Red Hat Ceph Storage クラスターのアップグレード を参照してください。

3. オプション: Ceph Storage クラスターの更新に含める必要があるイメージを確認します。

   $ openstack tripleo container image list -f value |  awk -F '//' '/ceph/ {print $2}'

4. クラスターを最新の Red Hat Ceph Storage バージョンに更新します。

   $ sudo cephadm shell -- ceph orch upgrade start --image <image_name>: <version>

   • <image_name> を Ceph Storage クラスターイメージの名前に置き換えます。
   • <version> を、Ceph Storage クラスターを更新するターゲットバージョンに置き換えます。

5. Ceph Storage コンテナーの更新が完了するまで待ちます。更新ステータスを監視するには、次のコマンドを実行します。

    sudo cephadm shell -- ceph orch upgrade status

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. online_upgrade のタグを使用するタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags online_upgrade

手順

1. リブートするノードにログインします。

2. オプション: ノードが Pacemaker リソースを使用している場合は、クラスターを停止します。

   [tripleo-admin@overcloud-controller-0 ~]$ sudo pcs cluster stop

3. ノードをリブートします。

   [tripleo-admin@overcloud-controller-0 ~]$ sudo reboot

4. ノードがブートするまで待ちます。

検証

1. サービスが有効になっていることを確認します。

   1. ノードが Pacemaker サービスを使用している場合は、ノードがクラスターに再度加わったか確認します。

      [tripleo-admin@overcloud-controller-0 ~]$ sudo pcs status

   2. ノードが Systemd サービスを使用している場合は、すべてのサービスが有効化されていることを確認します。

      [tripleo-admin@overcloud-controller-0 ~]$ sudo systemctl status

   3. ノードがコンテナー化されたサービスを使用している場合は、ノード上の全コンテナーがアクティブであることを確認します。

      [tripleo-admin@overcloud-controller-0 ~]$ sudo podman ps

手順

1. ceph-mon サービスを実行している Ceph Monitor または Controller ノードにログインし、Ceph Storage クラスターのリバランスを一時的に無効にします。

   $ sudo cephadm shell -- ceph osd set noout
   $ sudo cephadm shell -- ceph osd set norebalance

   注記

   マルチスタックまたは分散コンピュートノード (DCN) アーキテクチャーを使用している場合は、noout フラグと norebalance フラグの設定時に Ceph クラスター名を指定する必要があります。例: sudo cephadm shell -c /etc/ceph/<cluster>.conf -k /etc/ceph/<cluster>.client.keyring。

2. 再起動する最初の Ceph Storage ノードを選択し、そのノードにログインします。

3. ノードをリブートします。

   $ sudo reboot

4. ノードがブートするまで待ちます。

5. ノードにログインし、Ceph クラスターのステータスを確認します。

   $ sudo cephadm -- shell ceph status

   pgmap により、すべての pgs が正常な状態 (active+clean) として報告されることを確認します。

6. ノードからログアウトして、次のノードを再起動し、ステータスを確認します。全 Ceph Storage ノードが再起動されるまで、このプロセスを繰り返します。

7. 完了したら、ceph-mon サービスを実行している Ceph Monitor または Controller ノードにログインし、クラスターのリバランスを有効にします。

   $ sudo cephadm shell -- ceph osd unset noout
   $ sudo cephadm shell -- ceph osd unset norebalance

   注記

   マルチスタックまたは分散コンピュートノード (DCN) アーキテクチャーを使用している場合は、noout フラグと norebalance フラグの設定解除時に Ceph クラスター名を指定する必要があります。例: sudo cephadm shell -c /etc/ceph/<cluster>.conf -k /etc/ceph/<cluster>.client.keyring。

8. 最終のステータスチェックを実行して、クラスターが HEALTH_OK を報告していることを確認します。

   $ sudo cephadm shell ceph status

インスタンスの移行ワークフロー

1. コンピュートノードを再起動する前に、インスタンスを別のノードに移行するか決定します。
2. 再起動するコンピュートノードを選択して無効にし、新規インスタンスをプロビジョニングしないようにします。
3. インスタンスを別のコンピュートノードに移行します。
4. 空のコンピュートノードを再起動します。
5. 空のコンピュートノードを有効にします。

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. 全コンピュートノードとその UUID をリスト表示します。

   $ source ~/stackrc
   (undercloud) $ metalsmith list | grep compute

   リブートするコンピュートノードの UUID を特定します。

3. オーバークラウドからコンピュートノードを選択し、そのノードを無効にします。

   $ source ~/overcloudrc
   (overcloud)$ openstack compute service list
   (overcloud)$ openstack compute service set <hostname> nova-compute --disable

   • <hostname> は、コンピュートノードのホスト名に置き換えます。

4. コンピュートノード上の全インスタンスをリスト表示します。

   (overcloud)$ openstack server list --host <hostname> --all-projects

5. オプション: インスタンスを別のコンピュートノードに移行するには、次の手順を実行します。

   1. インスタンスを別のコンピュートノードに移行する場合は、以下のコマンドのいずれかを使用します。

      • インスタンスを別のホストに移行するには、次のコマンドを実行します。

        (overcloud) $ openstack server migrate <instance_id> --live <target_host> --wait

        • <instance_id> は、インスタンス ID に置き換えます。
        • <target_host> は、インスタンスの移行先のホストに置き換えます。

      • nova-scheduler がターゲットホストを自動的に選択できるようにします。

        (overcloud) $ nova live-migration <instance_id>

      • すべてのインスタンスを一度にライブマイグレーションします。

        $ nova host-evacuate-live <hostname>

        注記

        nova コマンドで非推奨の警告が表示される可能性がありますが、無視しても問題ありません。

   2. 移行が完了するまで待ちます。

   3. 移行が正常に完了したことを確認します。

      (overcloud) $ openstack server list --host <hostname> --all-projects

   4. コンピュートノードのインスタンスがなくなるまで、移行を続けます。

6. コンピュートノードにログインして、ノードをリブートします。

   [tripleo-admin@overcloud-compute-0 ~]$ sudo reboot

7. ノードがブートするまで待ちます。

8. コンピュートノードを再度有効にします。

   $ source ~/overcloudrc
   (overcloud) $ openstack compute service set <hostname>  nova-compute --enable

9. コンピュートノードが有効であることを確認します。

   (overcloud) $ openstack compute service list

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 検証を実行します。

   $ validation run -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml --group post-update

   • <stack> をスタックの名前に置き換えます。

検証

1. 検証レポートの結果を表示するには、director を使用した Red Hat OpenStack Platform のインストールと管理 の 検証履歴の表示 を参照してください。