手順

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

2. stackrc ファイルを取得します。

   $ source ~/stackrc

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

4. サブスクリプション管理の設定で rhsm_release パラメーターを確認します。このパラメーターが設定されていない場合は、このパラメーターを追加してパラメーターを 8.2 に設定します。

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

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

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべてのノードで、オペレーティングシステムのバージョンを Red Hat Enterprise Linux 8.2 にロックするタスクが含まれる Playbook を作成します。

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

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

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

   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

手順

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

2. stackrc ファイルを取得します。

   $ source ~/stackrc

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

4. サブスクリプション管理の設定で rhsm_repos パラメーターを確認します。このパラメーターに EUS リポジトリーが含まれていない場合は、該当するリポジトリーを EUS バージョンに変更します。

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-8-for-x86_64-baseos-eus-rpms
         - rhel-8-for-x86_64-appstream-eus-rpms
         - rhel-8-for-x86_64-highavailability-eus-rpms
         - ansible-2.9-for-rhel-8-x86_64-rpms
         - advanced-virt-for-rhel-8-x86_64-rpms
         - openstack-16.1-for-rhel-8-x86_64-rpms
         - rhceph-4-tools-for-rhel-8-x86_64-rpms
         - fast-datapath-for-rhel-8-x86_64-rpms

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

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべてのノードで、リポジトリーを Red Hat Enterprise Linux 8.2 EUS に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/change_eus.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change to eus repos
         command: subscription-manager repos --disable=rhel-8-for-x86_64-baseos-rpms --disable=rhel-8-for-x86_64-appstream-rpms --disable=rhel-8-for-x86_64-highavailability-rpms --enable=rhel-8-for-x86_64-baseos-eus-rpms --enable=rhel-8-for-x86_64-appstream-eus-rpms --enable=rhel-8-for-x86_64-highavailability-eus-rpms
         become: true
   EOF

8. change_eus.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/change_eus.yaml --limit <undercloud>,<Controller>,<Compute>

   • すべての Red Hat OpenStack Platform ノードにコンテンツを適用するには、--limit オプションを使用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

手順

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

2. stackrc ファイルを取得します。

   $ source ~/stackrc

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

4. サブスクリプション管理の設定で rhsm_repos パラメーターを確認します。rhsm_repos パラメーターで Red Hat OpenStack Platform 13 リポジトリーおよび Ansible 2.8 リポジトリーが使用されている場合は、リポジトリーを正しいバージョンに変更します。

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-8-for-x86_64-baseos-eus-rpms
         - rhel-8-for-x86_64-appstream-eus-rpms
         - rhel-8-for-x86_64-highavailability-eus-rpms
         - ansible-2.9-for-rhel-8-x86_64-rpms
         - advanced-virt-for-rhel-8-x86_64-rpms
         - openstack-16.1-for-rhel-8-x86_64-rpms
         - fast-datapath-for-rhel-8-x86_64-rpms

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

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべてのノードで、リポジトリーを Red Hat OpenStack Platform 16.1 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/update_rhosp_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change osp repos
         command: subscription-manager repos --disable=openstack-16-for-rhel-8-x86_64-rpms --enable=openstack-16.1-for-rhel-8-x86_64-rpms --disable=ansible-2.8-for-rhel-8-x86_64-rpms --enable=ansible-2.9-for-rhel-8-x86_64-rpms
         become: true
   EOF

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

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

   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

9. すべてのノードで、リポジトリーを Red Hat OpenStack Platform 16.1 に設定するタスクが含まれる Playbook を作成します。

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

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

    $ ansible-playbook -i ~/inventory.yaml -f 25 ~/update_ceph_repos.yaml --limit CephStorage

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

手順

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

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

4. すべてのノードで container-tools モジュールをバージョン 2.0 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/container-tools.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: disable default dnf module for container-tools
         command: dnf module reset -y container-tools
         become: true
       - name: set dnf module for container-tools:2.0
         command: dnf module enable -y container-tools:2.0
         become: true
   EOF

5. すべてのノードに対して container-tools.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/container-tools.yaml

手順

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

2. tag パラメーターを 16.1 に設定し、namespace パラメーターを registry.redhat.io/rhosp-rhel8 に更新します。

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
         namespace: registry.redhat.io/rhosp-rhel8
         …​
         tag: '16.1'
       tag_from_label: '{version}-{release}'

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

手順

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

2. source コマンドで stackrc ファイルを読み込みます。

   $ source ~/stackrc

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

   $ ssh heat-admin@CONTROLLER_IP "sudo pcs property set stonith-enabled=false"

4. fencing.yaml環境ファイルで、EnableFencingパラメーターをfalseに設定し、アップグレードプロセス中にフェンシングが無効のままとなるようにします。

手順

1. director に stack ユーザーとしてログインします。

2. dnf コマンドを実行して、director の主要なパッケージをアップグレードします。

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

3. director は openstack undercloud upgrade コマンドを使用して、アンダークラウドの環境を更新します。以下のコマンドを実行します。

   $ openstack undercloud upgrade

4. アンダークラウドのアップグレードプロセスが完了するまで待ちます。

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

   $ sudo reboot

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

手順

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

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --static-yaml-inventory ~/inventory.yaml

4. 既存のイメージを新しい名前にタグ付けするスクリプトを作成します。

   cat > pcmkr_common_tag.sh <<'EOF'
   #!/bin/sh
   # Due to a change in internal CI repo, we need to adjust
   # the HA relate containers before running the update.
   # See bz#1846042/PIDONE
   OLD_PREFIX=${1:-"openstack-"}
   NEW_PREFIX=${2:-"openstack-"}
   TRANSFORM=s%${OLD_PREFIX}%${NEW_PREFIX}%p
   
   # Get all images used by HA containers (disregards images with cluster common tag in their name)
   IMAGES=$(sudo podman images | awk '$1 !~ /cluster.common.tag/ && $2 ~ /pcmklatest/ {print $1}')
   
   if [ -n "$IMAGES" ]; then
       echo "Creating cluster common tags and linking them to current HA images"
   fi
   
   # i: 192.168.24.1:8787/rhosp15-rhel8/openstack-mariadb
   # image: openstack-mariadb
   # transformed: openstack-mariadb
   # full_i: 192.168.24.1:8787/rhosp15-rhel8/openstack-mariadb:pcmklatest
   # full_icommon: cluster.common.tag/openstack-mariadb:pcmklatest
   for i in $IMAGES; do
       image=$(echo "$i" | sed 's%.*/%%')
       transformed=$(echo $image | sed -n $TRANSFORM)
       full_i=$i:pcmklatest
       full_icommon=cluster.common.tag/${transformed}:pcmklatest
       # echo $i - $TRANSFORM "=>" $image - $transformed
   
       # original image points to a image hash, create a new tag
       # with cluster.common.tag and make it point to the same image hash
       echo $full_i "-->" $full_icommon
       sudo podman tag $full_i $full_icommon
   done
   EOF

5. スクリプトを実行して既存のイメージを新しい名前にタグ付けします。

   $ ansible -i inventory.yaml 'overcloud' -m script -a './pcmkr_common_tag.sh'

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

   $ 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> を実際のスタック名に置き換えます。
   • 専用のカスタムロールを使用する場合は、カスタムロール (<roles_data>) ファイル を追加します (-r)。
   • カスタムネットワークを使用する場合は、コンポーザブルネットワーク (_<network_data>) ファイル _ を追加します (-n)。
   • 高可用性クラスターをデプロイする場合は、更新の準備コマンドに --ntp-server オプションを追加するか、または環境ファイルに NtpServer パラメーターおよび値を追加します。
   • すべてのカスタム設定環境ファイル (-e)
3. 更新の準備が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

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

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

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

3. コントローラーノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

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

3. コンピュートノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

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

3. ノードの更新が完了するまで待ちます。

4. Ceph Storage の更新コマンドを実行します。以下に例を示します。

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

5. コンピュート HCI ノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. グループノードを更新します。

   グループ内のすべてのノードを更新するには、以下のコマンドを実行します。

   $ openstack overcloud update run --limit <GROUP_NAME>

   グループ内の単一ノードを更新するには、以下のコマンドを実行します。

   $ openstack overcloud update run --limit <GROUP_NAME> [NODE_INDEX]

   注記

   ノードを個別に更新する場合は、必ずすべてのノードを更新してください。

   グループ内の最初のノードのインデックスはゼロ (0) です。たとえば、CephStorage という名前のグループの最初のノードを更新するには、以下のコマンドを実行します。

   openstack overcloud update run --limit CephStorage[0]

3. ノードの更新が完了するまで待ちます。

4. Ceph Storage コンテナーの更新コマンドを実行します。

   $ openstack overcloud external-update run --tags ceph

5. Ceph Storage コンテナーの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

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

   $ openstack overcloud external-update run --tags online_upgrade

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. オーバークラウドでフェンシングを再度有効にするには、fencing.yaml 環境ファイルで、EnableFencing パラメーターを true に設定します。

3. 更新の最終処理のコマンドを実行します。

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

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

   • EnableFencing パラメーターが true に設定された fencing.yaml 環境ファイル。
   • オーバークラウドスタックの名前がデフォルトの名前 overcloud とは異なる場合は、更新の準備コマンドに --stack オプションを追加し、<stack_name> を実際のスタック名に置き換えます。
   • 専用のカスタムロールを使用する場合は、カスタムロール (<roles_data>) のファイルを追加します (-r)
   • カスタムネットワークを使用する場合は、コンポーザブルネットワーク (<network_data>) のファイルを追加します (-n)
   • すべてのカスタム設定環境ファイル (-e)
4. 更新の最終処理が完了するまで待ちます。

手順

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

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

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

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

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

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

5. サービスを確認します。以下に例を示します。

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

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

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

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

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

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

手順

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

   $ sudo podman exec -it ceph-mon-controller-0 ceph osd set noout
   $ sudo podman exec -it ceph-mon-controller-0 ceph osd set norebalance

   注記

   マルチスタックまたは分散計算ノード (DCN) アーキテクチャーを使用している場合は、 nooutフラグとnorebalanceフラグの設定時にクラスター名を指定する必要があります。例: sudo podman exec -it ceph-mon-controller-0 ceph osd set noout --cluster <cluster_name>

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

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

   $ sudo reboot

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

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

   $ sudo podman exec -it ceph-mon-controller-0 ceph status

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

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

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

   $ sudo podman exec -it ceph-mon-controller-0 ceph osd unset noout
   $ sudo podman exec -it ceph-mon-controller-0 ceph osd unset norebalance

   注記

   マルチスタックまたは分散計算ノード (DCN) アーキテクチャーを使用している場合は、 nooutフラグとnorebalanceフラグの設定解除時にクラスター名を指定する必要があります。例: sudo podman exec -it ceph-mon-controller-0 ceph osd set noout --cluster <cluster_name>

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

   $ sudo podman exec -it ceph-mon-controller-0 ceph status

手順

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

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

   $ source ~/stackrc
   (undercloud) $ openstack server list --name compute

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

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

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

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

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

5. インスタンスを移行しない場合は、このステップ に進みます。

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

   • インスタンスを別のホストに移行する。

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

   • nova-scheduler により対象のホストが自動的に選択されるようにする。

     (overcloud) $ nova live-migration <instance_id>

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

     $ nova host-evacuate-live <hostname>

     注記

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

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

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

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

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

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

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

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

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

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

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

    (overcloud) $ openstack compute service list