OpenStack のアップグレード

手順3.1 ホスト上の OpenStack コンポーネントのアップグレード

1. Red Hat Enterprise Linux OpenStack Platform 7 (Kilo) 用の yum リポジトリーをインストールします。
2. openstack-utils パッケージがインストールされていることを確認します。

   # yum install openstack-utils

   Copy to Clipboard Toggle word wrap
3. 全ノードで OpenStack サービスをすべて停止します。このステップは、サービスがどのようにノードに分散されているかによって異なります。
   • 非高可用性環境:
     1 つのノードで実行されている OpenStack サービスをすべて停止するには、そのノードにログインして以下のコマンドを実行します。

     # openstack-service stop

     Copy to Clipboard Toggle word wrap
   • 高可用性環境:
     1. 1 つのノードで実行されている OpenStack サービスをすべて停止するには、そのノードにログインして以下のコマンドを実行します。

        # openstack-service stop

        Copy to Clipboard Toggle word wrap
     2. クラスター上で stop-all-resources を設定して、Pacemaker で管理されているリソースをすべて無効にします。Pacemaker クラスターの 1 つのメンバーで以下のコマンドを実行します。

        # pcs property set stop-all-resources=true

        Copy to Clipboard Toggle word wrap
        pcs status の出力で、すべてのリソースが停止されたことが表示されるまで待機します。
4. 全パッケージの完全なアップグレードを実行してから、Identity Service 内の期限切れトークンをフラッシュします (データベースの同期の所要時間が短縮される可能性があります)。

   # yum upgrade

   Copy to Clipboard Toggle word wrap
5. 各サービスに対して必要とされる設定更新を実行します。
   1. Identity Service
      RHEL OpenStack Platform 7 (Kilo) リリースでは、token.persistence.backends の場所が変更されました。keystone.conf の [token] のセクションの driver オプションを更新する必要があります。これには、keystone.token.backends を keystone.token.persistence.backends に置き換える必要があります。

      # sed -i 's/keystone.token.backends/keystone.token.persistence.backends/g' \
      /etc/keystone/keystone.conf

      Copy to Clipboard Toggle word wrap
      パッケージの更新には、新しい systemd のユニットファイルが含まれている可能性があるため、更新されたファイルが systemd により認識されていることを確認します。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   2. OpenStack Networking Service
      OpenStack Networking Service のアップグレードが完了したら、rootwrap dhcp.filter の設定ファイルを編集する必要があります。
      これには、/usr/share/neutron/rootwrap/dhcp.filters ファイルで、以下のように dnsmasq の値を更新します。たとえば、次のように記載されているとします。

      dnsmasq: EnvFilter, env, root, CONFIG_FILE=, NETWORK_ID=, dnsmasq

      Copy to Clipboard Toggle word wrap
      以下のように置き換えます。

      dnsmasq: CommandFilter, dnsmasq, root

      Copy to Clipboard Toggle word wrap
6. データベースを使用する各サービスのデータベーススキーマをアップグレードします。この操作を行うには、サービスをホストしているノードにログインして以下のコマンドを実行します。

   # openstack-db --service SERVICENAME --update

   Copy to Clipboard Toggle word wrap
   SERVICENAME は、サービスのプロジェクト名に置き換えます。たとえば、Idenitity Service のデータベーススキーマをアップグレードするためのコマンドは以下のようになります。

   # openstack-db --service keystone --update

   Copy to Clipboard Toggle word wrap
   Expand

   表3.1 データベースを使用する各 OpenStack サービスのプロジェクト名

   サービス	プロジェクト名
   Identity	keystone
   Block Storage	cinder
   Image Service	glance
   Compute	nova
   Networking	neutron
   Orchestration	heat

   Show more
   openstack-db コマンドで対応されていないサービスについては、Juno から Kilo のアップグレードの一部として追加でデータベースのメンテナンスを行う必要がある場合もあります。
   1. Identity Service
      初期のバージョンのインストーラーでは、期限切れの keystone トークンが自動的に削除されるようにシステム設定されていない可能性があるため、トークンテーブルに期限切れのエントリーが多数含まれている可能性があります。このような場合には、データベーススキーマのアップグレードの所要時間が大幅に増大する可能性があります。
      Keystone データベースのアップグレードプロセスを開始する前に、以下のコマンドを実行してこの問題を軽減します。

      # keystone-manage token_flush

      Copy to Clipboard Toggle word wrap
      このコマンドにより、データベースから期限切れのトークンがフラッシュされます。cron を使用して、このコマンドが定期的に (例: 1 日 1 回など) 実行されるように設定する必要があります。
   2. Compute
      Kilo に完全に更新した後に (すべてのノードが Kilo を実行している場合)、フレーバー情報のバックグラウンド移行を開始する必要があります。Kilo のコンダクターノードは、必要な場合にこの操作を自動的に行いますが、それ以外のアイドルデータはバックグラウンドで移行する必要があります。以下のコマンドは、nova ユーザーとして実行してください。

      # runuser -u nova -- nova-manage db migrate_flavor_data

      Copy to Clipboard Toggle word wrap
7. 上記の操作によって生成された設定ファイルを確認します。アップグレードされたパッケージには、Red Hat Enterprise Linux OpenStack Platform 7 バージョンのサービスに適した .rpmnew ファイルがインストールされているはずです。
   新しいバージョンの OpenStack サービスでは、特定の設定オプションが非推奨になっている可能性があります。このような非推奨の設定オプションが原因で今後のアップグレードの際に問題が発生する可能性があるため、非推奨の警告については OpenStack のログも参照してください。各サービスで新規追加/更新された設定オプションや非推奨となった設定オプションについての詳しい説明は、Red Hat Enterprise Linux OpenStack Platform ドキュメントスイート で『Configuration Reference』を参照してください。
8. パッケージのアップグレードで再起動が必要な場合には (例: アップグレードの一環として新規カーネルがインストールされた場合など)、OpenStack サービスが無効な状態のうちに、影響を受けたホストを再起動してください。
   • 非高可用性環境:
     OpenStack サービスを再起動するには、各ノードで以下のコマンドを実行します。

     # openstack-service start

     Copy to Clipboard Toggle word wrap
   • 高可用性環境:
     1. stop-all-resources プロパティーを再設定して、Pacemaker がリソースを再起動できるようにします。Pacemaker クラスターの 1 つのメンバー上で、以下のコマンドを実行します。

        # pcs property set stop-all-resources=false

        Copy to Clipboard Toggle word wrap
        pcs status の出力で、すべてのリソースが停止されたことが表示されるまで待機します (数分かかる可能性があります)。
     2. コンピュートノードで OpenStack サービスを再起動します。各コンピュートノードで以下のコマンドを実行します。

        # openstack-service start

        Copy to Clipboard Toggle word wrap

1. アップグレード前のタスク:
   各ホストで以下の手順を実行してください。
   1. Red Hat Enterprise Linux OpenStack Platform 7 (Kilo) 用の yum リポジトリーをインストールします。
   2. 利用可能な場合は openstack-selinux パッケージをアップグレードします。

      # yum upgrade openstack-selinux

      Copy to Clipboard Toggle word wrap
      これは、アップグレードしたサービスが SELinux が有効なシステムで正しく実行されるようにするために必要です。
2. 各サービスのアップグレード:
   以下のステップには、各サービス固有のアップグレード手順と順序をまとめています。
   1. Identity (keystone)
      初期のバージョンのインストーラーでは、期限切れの keystone トークンが自動的に削除されるようにシステム設定されていない可能性があるため、トークンテーブルに期限切れのエントリーが多数含まれている可能性があります。このような場合には、データベーススキーマのアップグレードの所要時間が大幅に増大する可能性があります。
      Identity データベースのアップグレードを実行する前に keystone-manage コマンドを使用すると、データベースから期限切れのトークンをフラッシュして問題を軽減することができます。
      このコマンドにより、データベースから期限切れのトークンがフラッシュされます。cron を使用して、このコマンドが定期的に (例: 1 日 1 回など) 実行されるように設定してください。
      Identity ホストで以下のコマンドを実行します。

      # openstack-service stop keystone
      # yum -d1 -y upgrade \*keystone\*
      # keystone-manage token_flush
      # openstack-db --service keystone --update
      # openstack-service start keystone

      Copy to Clipboard Toggle word wrap
   2. Object Storage (swift)
      Object Storage ホストで以下のコマンドを実行します。

      # openstack-service stop swift
      # yum -d1 -y upgrade \*swift\*
      # openstack-service start swift

      Copy to Clipboard Toggle word wrap
   3. Image Service (glance)
      Image Service ホストで以下のコマンドを実行します。

      # openstack-service stop glance
      # yum -d1 -y upgrade \*glance\*
      # openstack-db --service glance --update
      # openstack-service start glance

      Copy to Clipboard Toggle word wrap
   4. Block Storage (cinder)
      Block Storage ホストで以下のコマンドを実行します。

      # openstack-service stop cinder
      # yum -d1 -y upgrade \*cinder\*
      # openstack-db --service cinder --update
      # openstack-service start cinder

      Copy to Clipboard Toggle word wrap
   5. Orchestration (heat)
      Orchestration ホストで以下のコマンドを実行します。

      # openstack-service stop heat
      # yum -d1 -y upgrade \*heat\*
      # openstack-db --service heat --update
      # openstack-service start heat

      Copy to Clipboard Toggle word wrap
   6. Telemetry (ceilometer)
      1. Telemetry コンポーネントサービスをホストする全ノードで以下のコマンドを実行します。

         # openstack-service stop ceilometer
         # yum -d1 -y upgrade \*ceilometer\*

         Copy to Clipboard Toggle word wrap
      2. Image Service ホストで以下のコマンドを実行します。

         # ceilometer-dbsync

         Copy to Clipboard Toggle word wrap
         このコマンドにより、MySQL は Telemetry Service のバックエンドとして設定することができます。
         Telemetry のコンポーネントサービスの一覧については、 「TELEMETRY の API およびエージェントの起動」 を参照してください。
      3. パッケージのアップグレードが完了した後には、Telemetry コンポーネントサービスをホストする全ノードで以下のコマンドを実行して Telemetry Service を再起動します。

         # openstack-service start ceilometer

         Copy to Clipboard Toggle word wrap
   7. Compute (nova)
      1. コンピュートホストのローリングアップグレードを行うには、明示的に API のバージョンの制限を設定して、Juno および kilo 環境間の互換性を確保する必要があります。
         Kilo コントローラーまたはコンピュートサービスを開始する前に、nova.conf の [upgrade_levels] セクションの compute オプションを juno に設定する必要があります。

         # crudini --set /etc/nova/nova.conf upgrade_levels compute juno

         Copy to Clipboard Toggle word wrap
         コントローラーホストおよびコンピュートホストで、上記の変更を加える必要があります。
         全コンピュートホストを OpenStack Kilo にアップグレードした後で、この変更を元に戻す必要があります。
      2. コンピュートホストで以下のコマンドを実行します。

         # openstack-service stop nova
         # yum -d1 -y upgrade \*nova\*
         # openstack-db --service nova --update

         Copy to Clipboard Toggle word wrap
      3. Kilo に完全に更新した後に (すべてのノードが Kilo を実行している場合)、フレーバー情報のバックグラウンド移行を開始する必要があります。Kilo のコンダクターノードは、必要な場合にこの操作を自動的に行いますが、それ以外のアイドルデータはバックグラウンドで移行する必要があります。以下のコマンドは、nova ユーザーとして実行してください。

         # runuser -u nova -- nova-manage db migrate_flavor_data

         Copy to Clipboard Toggle word wrap
      4. 全ホストを Kilo にアップグレードした後には、以前のステップで設定した API の制限を削除します。全ホスト上で以下のコマンドを実行します。

         # crudini --del /etc/nova/nova.conf upgrade_levels compute

         Copy to Clipboard Toggle word wrap
      5. コンピュートホストおよびコントローラーすべてで Compute Service を再起動します。

         # openstack-service start nova

         Copy to Clipboard Toggle word wrap
   8. OpenStack Networking (neutron)
      1. OpenStack Networking ホストで以下のコマンドを実行します。

         # openstack-service stop neutron
         # yum -d1 -y upgrade \*neutron\*
         # openstack-db --service neutron --update

         Copy to Clipboard Toggle word wrap
      2. OpenStack Networking Service のアップグレードが完了したら、rootwrap dhcp.filter の設定ファイルを編集する必要があります。
         これには、/usr/share/neutron/rootwrap/dhcp.filters ファイルで、以下のように dnsmasq の値を更新します。たとえば、この値は

         dnsmasq: EnvFilter, env, root, CONFIG_FILE=, NETWORK_ID=, dnsmasq

         Copy to Clipboard Toggle word wrap
         以下のように置き換えます。

         dnsmasq: CommandFilter, dnsmasq, root

         Copy to Clipboard Toggle word wrap
      3. OpenStack Networking Service を再起動します。

         # openstack-service start neutron

         Copy to Clipboard Toggle word wrap
   9. Dashboard (horizon)
      Dashboard ホストで以下のコマンドを実行します。

      # yum -y upgrade \*horizon\* \*openstack-dashboard\*
      # yum -d1 -y upgrade \*horizon\* \*python-django\*
      # systemctl restart httpd

      Copy to Clipboard Toggle word wrap
3. アップグレード後のタスク:
   1. 個別サービスのアップグレードをすべて完了した後には、全システムで完全なパッケージアップグレードを行う必要があります。

      # yum upgrade

      Copy to Clipboard Toggle word wrap
      このコマンドで、すべてのパッケージが最新の状態にします。実行中のプロセスにおいて、更新後の基盤バイナリーバージョンが使用されるように、OpenStack ホストの再起動を後日にスケジューリングしてください。
   2. 上記の操作によって生成された設定ファイルを確認します。アップグレードされたパッケージには、Red Hat Enterprise Linux OpenStack Platform 7 バージョンのサービスに適した .rpmnew ファイルがインストールされているはずです。
      新しいバージョンの OpenStack サービスでは、特定の設定オプションが非推奨になっている可能性があります。このような非推奨の設定オプションが原因で今後のアップグレードの際に問題が発生する可能性があるため、非推奨の警告については OpenStack のログも参照してください。各サービスで新規追加/更新された設定オプションや非推奨となった設定オプションについての詳しい説明は、Red Hat Enterprise Linux OpenStack Platform ドキュメントスイート で『Configuration Reference』を参照してください。

1. アップグレード前のタスク:
   各ホストで以下の手順を実行してください。
   1. Staypuft で設定された Puppet を実行している場合には、Puppet を無効にする必要があります。

      # systemctl stop puppet
      # systemctl disable puppet

      Copy to Clipboard Toggle word wrap
      このコマンドでは、アップグレードプロセスの一部として加えられた変更を、Staypuft で設定された puppet により取り消されないようにします。
   2. Red Hat Enterprise Linux OpenStack Platform 7 (Kilo) 用の yum リポジトリーをインストールします。
   3. python パッケージすべてを手動でアップグレードします。

      # yum upgrade python*

      Copy to Clipboard Toggle word wrap
   4. 利用可能な場合は openstack-selinux パッケージをアップグレードします。

      # yum upgrade openstack-selinux

      Copy to Clipboard Toggle word wrap
      これは、アップグレードしたサービスが SELinux が有効なシステムで正しく実行されるようにするために必要です。
2. サービスのアップグレード:
   各サービスをアップグレードします。コントローラーで実行するアップグレードの適切な手順を以下に示します。
   MariaDB のアップグレード:
   MariaDB を実行する各ホストで、以下の手順を実行します。1 つのホストでの手順がすべて完了してから、次のホストでこのプロセスを開始してください。
   1. ローカルノードで実行されないようにサービスを停止します。

      # pcs resource ban galera-master $(crm_node -n)

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、ローカルノードで実行中のサービスがなくなるまで待機します。これは、数分かかる可能性があります。ローカルノードは、まず slaves モードに変更されます。

      Master/Slave Set: galera-master [galera]
      Masters: [ pcmk-mac525400aeb753 pcmk-mac525400bab8ae ]
      Slaves: [ pcmk-mac5254004bd62f ]

      Copy to Clipboard Toggle word wrap
      最終的に stopped のモードに変わります。

      Master/Slave Set: galera-master [galera]
      Masters: [ pcmk-mac525400aeb753 pcmk-mac525400bab8ae ]
      Stopped: [ pcmk-mac5254004bd62f ]

      Copy to Clipboard Toggle word wrap
   3. 適切なパッケージをアップグレードします。

      # yum upgrade '*mariadb*' '*galera*'

      Copy to Clipboard Toggle word wrap
   4. Pacemaker がローカルノードで galera リソースのスケジューリングができるようにします。

      # pcs resource clear galera-master

      Copy to Clipboard Toggle word wrap
   5. pcs status の出力で、gelara リソースがローカルノードでマスターとして実行されるまで待機します。pcs status からの出力は以下のようになります。

      Master/Slave Set: galera-master [galera]
      Masters: [ pcmk-mac5254004bd62f pcmk-mac525400aeb753
      pcmk-mac525400bab8ae ]

      Copy to Clipboard Toggle word wrap
   MongoDB のアップグレード:
   1. Pacemaker のコントロールから mongod リソースを削除します。

      # pcs resource unmanage mongod-clone

      Copy to Clipboard Toggle word wrap
   2. 全コントローラー上のサービスを停止します。各コントローラーで、以下を実行します。

      # systemctl stop mongod

      Copy to Clipboard Toggle word wrap
   3. 適切なパッケージをアップグレードします。

      #  yum upgrade 'mongodb*' 'python-pymongo*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. 各コントローラーで以下のコマンドを実行して、mongod サービスを再起動します。

      # systemctl start mongod

      Copy to Clipboard Toggle word wrap
   6. Pacemaker コントロールへのリソースをクリーンアップします。

      # pcs resource cleanup mongod-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker コントロールにリソースを戻します。

      # pcs resource manage mongod-clone

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Identity Service (keystone) のアップグレード:
   1. Pacemaker のコントロールから Identity Service を削除します。

      # pcs resource unmanage keystone-clone

      Copy to Clipboard Toggle word wrap
   2. 各コントローラーで以下のコマンドを実行して Identity Serice を停止します。

      # systemctl stop openstack-keystone

      Copy to Clipboard Toggle word wrap
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-keystone*' 'python-keystone*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. RHEL OpenStack Platform 7 (Kilo) リリースでは、token.persistence.backends の場所が変更されました。keystone.conf の [token] のセクションの driver オプションを更新する必要があります。これには、keystone.token.backends を keystone.token.persistence.backends に置き換える必要があります。

      # sed -i 's/keystone.token.backends/keystone.token.persistence.backends/g' \
      /etc/keystone/keystone.conf

      Copy to Clipboard Toggle word wrap
      パッケージの更新には、新しい systemd のユニットファイルが含まれている可能性があるため、更新されたファイルを systemd に認識させます。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   6. 初期のバージョンのインストーラーでは、期限切れの keystone トークンが自動的に削除されるようにシステム設定されていない可能性があるため、トークンテーブルに期限切れのエントリーが多数含まれている可能性があります。このような場合には、データベーススキーマのアップグレードの所要時間が大幅に増大する可能性があります。
      Identity データベースのアップグレードを実行する前に keystone-manage コマンドを使用すると、データベースから期限切れのトークンをフラッシュして問題を軽減することができます。
      このコマンドにより、データベースから期限切れのトークンがフラッシュされます。cron を使用して、このコマンドが定期的に (例: 1 日 1 回など) 実行されるように設定してください。

      # keystone-manage token_flush

      Copy to Clipboard Toggle word wrap
   7. Identity Service のデータベーススキーマを更新します。

      # openstack-db --service keystone --update

      Copy to Clipboard Toggle word wrap
   8. 各コントローラーで以下のコマンドを実行してサービスを再起動します。

      # systemctl start openstack-keystone

      Copy to Clipboard Toggle word wrap
   9. Pacemaker を使用して Identity Service をクリーンアップします。

      # pcs resource cleanup keystone-clone

      Copy to Clipboard Toggle word wrap
   10. Pacemaker コントロールにリソースを戻します。

       # pcs resource manage keystone-clone

       Copy to Clipboard Toggle word wrap
   11. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Image service (glance) のアップグレード:
   1. Pacemaker で Image Service のリソースを停止します。

      # pcs resource disable glance-registry-clone
      # pcs resource disable glance-api-clone

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、両サービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-glance*' 'python-glance*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Image Service のデータベーススキーマを更新します。

      # openstack-db --service glance --update

      Copy to Clipboard Toggle word wrap
   6. Pacemaker を使用して Image Service をクリーンアップします。

      # pcs resource cleanup glance-api-clone
      # pcs resource cleanup glance-registry-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Image Service のリソースを再起動します。

      # pcs resource enable glance-api-clone
      # pcs resource enable glance-registry-clone

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Block Storage Service (cinder) のアップグレード:
   1. Pacemaker で Block Storage Service のリソースを停止します。

      # pcs resource disable cinder-api-clone
      # pcs resource disable cinder-scheduler-clone
      # pcs resource disable cinder-volume

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、上記のサービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-cinder*' 'python-cinder*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Block Storage Service のデータベーススキーマを更新します。

      # openstack-db --service cinder --update

      Copy to Clipboard Toggle word wrap
   6. Pacemaker を使用して Block Storage Service をクリーンアップします。

      # pcs resource cleanup cinder-volume
      # pcs resource cleanup cinder-scheduler-clone
      # pcs resource cleanup cinder-api-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Block Storage Service のリソースを再起動します。

      # pcs resource enable cinder-volume
      # pcs resource enable cinder-scheduler-clone
      # pcs resource enable cinder-api-clone

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Orchestration (heat) のアップグレード:
   1. Pacemaker で Orchestration リソースを停止します。

      # pcs resource disable heat-api-clone
      # pcs resource disable heat-api-cfn-clone
      # pcs resource disable heat-api-cloudwatch-clone
      # pcs resource disable heat

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、上記のサービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-heat*' 'python-heat*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Orchestration のデータベーススキーマを更新します。

      # openstack-db --service heat --update

      Copy to Clipboard Toggle word wrap
   6. Pacemaker を使用して Orchestration Service をクリーンアップします。

      # pcs resource cleanup heat
      # pcs resource cleanup heat-api-cloudwatch-clone
      # pcs resource cleanup heat-api-cfn-clone
      # pcs resource cleanup heat-api-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Orchestration リソースを再起動します。

      # pcs resource enable heat
      # pcs resource enable heat-api-cloudwatch-clone
      # pcs resource enable heat-api-cfn-clone
      # pcs resource enable heat-api-clone

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Telemetry (ceilometer) のアップグレード:
   1. Pacemaker で Telemetry リソースをすべて停止します。

      # pcs resource disable openstack-ceilometer-central
      # pcs resource disable openstack-ceilometer-api-clone
      # pcs resource disable openstack-ceilometer-alarm-evaluator-clone
      # pcs resource disable openstack-ceilometer-collector-clone
      # pcs resource disable openstack-ceilometer-notification-clone
      # pcs resource disable openstack-ceilometer-alarm-notifier-clone
      # pcs resource disable ceilometer-delay-clone

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、上記のサービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-ceilometer*' 'python-ceilometer*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Telemetry に MySQL のバックエンドを使用している場合には、Telemetry データベーススキーマを更新します。

      # openstack-db --service ceilometer --update

      Copy to Clipboard Toggle word wrap

      注記

      MongoDB バックエンドを使用している場合には、この手順は必要ありません。
   6. Pacemaker を使用して Telemetry Service をクリーンアップします。

      # pcs resource cleanup ceilometer-delay-clone
      # pcs resource cleanup openstack-ceilometer-alarm-notifier-clone
      # pcs resource cleanup openstack-ceilometer-notification-clone
      # pcs resource cleanup openstack-ceilometer-collector-clone
      # pcs resource cleanup openstack-ceilometer-alarm-evaluator-clone
      # pcs resource cleanup openstack-ceilometer-api-clone
      # pcs resource cleanup openstack-ceilometer-central

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Telemetry リソースをすべて再起動します。

      # pcs resource enable ceilometer-delay-clone
      # pcs resource enable openstack-ceilometer-alarm-notifier-clone
      # pcs resource enable openstack-ceilometer-notification-clone
      # pcs resource enable openstack-ceilometer-collector-clone
      # pcs resource enable openstack-ceilometer-alarm-evaluator-clone
      # pcs resource enable openstack-ceilometer-api-clone
      # pcs resource enable openstack-ceilometer-central

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Compute (nova) のアップグレード:
   1. Pacemaker で Compute リソースをすべて停止します。

      # pcs resource disable openstack-nova-novncproxy-clone
      # pcs resource disable openstack-nova-consoleauth-clone
      # pcs resource disable openstack-nova-conductor-clone
      # pcs resource disable openstack-nova-api-clone
      # pcs resource disable openstack-nova-scheduler-clone

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、上記のサービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-nova*' 'python-nova*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Compute のデータベーススキーマを更新します。

      # openstack-db --service nova --update

      Copy to Clipboard Toggle word wrap
      Kilo に完全に更新した後に (すべてのノードが Kilo を実行している場合)、フレーバー情報のバックグラウンド移行を開始する必要があります。Kilo のコンダクターノードは、必要な場合にこの操作を自動的に行いますが、それ以外のアイドルデータはバックグラウンドで移行する必要があります。以下のコマンドは、nova ユーザーとして実行してください。

      # runuser -u nova -- nova-manage db migrate_flavor_data

      Copy to Clipboard Toggle word wrap
   6. コンピュートホストのローリングアップグレードを行うには、明示的に API のバージョンの制限を設定して、Juno および kilo 環境間の互換性を確保する必要があります。
      Kilo コントローラーまたはコンピュートサービスを開始する前に、nova.conf の [upgrade_levels] セクションの compute オプションを juno に設定する必要があります。

      # crudini --set /etc/nova/nova.conf upgrade_levels compute juno

      Copy to Clipboard Toggle word wrap
      まず、コントローラーの 1 つで pcs resource unmanage を実行することで Compute リソースの管理を解除する必要があります。

      # pcs resource unmanage openstack-nova-novncproxy-clone
      # pcs resource unmanage openstack-nova-consoleauth-clone
      # pcs resource unmanage openstack-nova-conductor-clone
      # pcs resource unmanage openstack-nova-api-clone
      # pcs resource unmanage openstack-nova-scheduler-clone

      Copy to Clipboard Toggle word wrap
      コントローラーすべてで全サービスを再起動します。

      # openstack-service restart nova

      Copy to Clipboard Toggle word wrap
      コンピュートホストをすべて OpenStack Kilo にアップグレードした後で、Pacemaker がコントロールできるように戻す必要があります。

      # pcs resource manage openstack-nova-scheduler-clone
      # pcs resource manage openstack-nova-api-clone
      # pcs resource manage openstack-nova-conductor-clone
      # pcs resource manage openstack-nova-consoleauth-clone
      # pcs resource manage openstack-nova-novncproxy-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Compute リソースをすべてクリーンアップします。

      # pcs resource cleanup openstack-nova-scheduler-clone
      # pcs resource cleanup openstack-nova-api-clone
      # pcs resource cleanup openstack-nova-conductor-clone
      # pcs resource cleanup openstack-nova-consoleauth-clone
      # pcs resource cleanup openstack-nova-novncproxy-clone

      Copy to Clipboard Toggle word wrap
   8. Pacemaker で Compute リソースをすべて再起動します。

      # pcs resource enable openstack-nova-scheduler-clone
      # pcs resource enable openstack-nova-api-clone
      # pcs resource enable openstack-nova-conductor-clone
      # pcs resource enable openstack-nova-consoleauth-clone
      # pcs resource enable openstack-nova-novncproxy-clone

      Copy to Clipboard Toggle word wrap
   9. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   OpenStack Networking (neutron) のアップグレード:
   1. Pacemaker による OpenStack Networking クリーンアップスクリプトがトリガーされないようにします。

      # pcs resource unmanage neutron-ovs-cleanup-clone
      # pcs resource unmanage neutron-netns-cleanup-clone

      Copy to Clipboard Toggle word wrap
   2. Pacemaker で OpenStack Networking のリソースを停止します。

      # pcs resource disable neutron-server-clone
      # pcs resource disable neutron-openvswitch-agent-clone
      # pcs resource disable neutron-dhcp-agent-clone
      # pcs resource disable neutron-l3-agent-clone
      # pcs resource disable neutron-metadata-agent-clone

      Copy to Clipboard Toggle word wrap
   3. 適切なパッケージをアップグレードします。

      # yum upgrade 'openstack-neutron*' 'python-neutron*'

      Copy to Clipboard Toggle word wrap
   4. openstack-neutron-vpnaas、openstack-neutron-fwaas、openstack-neutron-lbaas など neutron.conf ファイルで有効化された高度な OpenStack Networking Service のパッケージをインストールします。

      # yum install openstack-neutron-vpnaas
      # yum install openstack-neutron-fwaas
      # yum install openstack-neutron-lbaas

      Copy to Clipboard Toggle word wrap
      これらのパッケージをインストールすると、対応する設定ファイルが作成されます。
   5. neutron.conf ファイルの VPNaaS および LBaaS サービスのエントリーの場合は、service_provider エントリーを /etc/neutron 配下の対応する neutron-*aas.conf ファイルにコピーし、neutron.conf ファイルのこれらのエントリーをコメント化します。
      FWaaS サービスエントリーの場合は、service_provider パラメーターを neutron.conf ファイルに 残す必要があります。
   6. LBaaS エージェントを実行する全ノードで、openstack-neutron-lbaas パッケージをインストールします。

      # yum install openstack-neutron-lbaas

      Copy to Clipboard Toggle word wrap
   7. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   8. OpenStack Networking のデータベーススキーマを更新します。

      # openstack-db --service neutron --update

      Copy to Clipboard Toggle word wrap
   9. OpenStack Networking Service のアップグレードが完了したら、rootwrap dhcp.filter の設定ファイルを編集する必要があります。
      これには、/usr/share/neutron/rootwrap/dhcp.filters ファイルで、以下のように dnsmasq の値を更新します。たとえば、この値は

      dnsmasq: EnvFilter, env, root, CONFIG_FILE=, NETWORK_ID=, dnsmasq

      Copy to Clipboard Toggle word wrap
      以下のように置き換えます。

      dnsmasq: CommandFilter, dnsmasq, root

      Copy to Clipboard Toggle word wrap
   10. Pacemaker で OpenStack Networking のリソースをクリーンアップします。

       # pcs resource cleanup neutron-metadata-agent-clone
       # pcs resource cleanup neutron-l3-agent-clone
       # pcs resource cleanup neutron-dhcp-agent-clone
       # pcs resource cleanup neutron-openvswitch-agent-clone
       # pcs resource cleanup neutron-server-clone

       Copy to Clipboard Toggle word wrap
   11. Pacemaker で OpenStack Networking のリソースを再起動します。

       # pcs resource enable neutron-metadata-agent-clone
       # pcs resource enable neutron-l3-agent-clone
       # pcs resource enable neutron-dhcp-agent-clone
       # pcs resource enable neutron-openvswitch-agent-clone
       # pcs resource enable neutron-server-clone

       Copy to Clipboard Toggle word wrap
   12. Pacemaker コントロールにクリーンアップエージェントを戻します。

       # pcs resource manage neutron-ovs-cleanup-clone
       # pcs resource manage neutron-netns-cleanup-clone

       Copy to Clipboard Toggle word wrap
   13. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Dashboard (horizon) のアップグレード:
   1. Pacemaker で Dashboard リソースを停止します。

      # pcs resource disable horizon-clone

      Copy to Clipboard Toggle word wrap
   2. pcs status の出力で、このサービスが停止されるまで待機します。
   3. 適切なパッケージをアップグレードします。

      # yum upgrade httpd 'openstack-dashboard*' 'python-django*'

      Copy to Clipboard Toggle word wrap
   4. 更新したユニットファイルを有効にするために systemd を再読み込みします。

      # systemctl daemon-reload

      Copy to Clipboard Toggle word wrap
   5. Dashboard の設定を修正します。
      Apache 設定の修正:
      openstack-dashboard パッケージにより、/etc/httpd/conf.d/openstack-dashboard.conf ファイルがインストールされますが、Staypuft インストーラーはこのファイルを /etc/httpd/conf.d/15-horizon_vhost.conf ファイルに置き換えます。Horizon をアップグレードした後には、以下の設定ファイルが存在します。
      • 15-horizon_vhost.conf
      • openstack-dashboard.conf
      • openstack-dashboard.conf.rpmnew
      以下の変更を加えます。
      • openstack-dashboard.conf.rpmnew ファイルを削除します。

        # rm openstack-dashboard.conf.rpmnew

        Copy to Clipboard Toggle word wrap
      • 以下を置き換えて 15-horizon_vhost.conf ファイルを変更します。

        Alias /static "/usr/share/openstack-dashboard/static"

        Copy to Clipboard Toggle word wrap
        以下のように置き換えます。

        Alias /dashboard/static "/usr/share/openstack-dashboard/static"

        Copy to Clipboard Toggle word wrap
      Dashboard 設定の修正:
      openstack-dashboard パッケージにより、/etc/openstack-dashboard/local_settings ファイルがインストールされます。アップグレード後には、以下の設定ファイルが設定されています。
      • /etc/openstack-dashboard/local_settings
      • /etc/openstack-dashboard/local_settings.rpmnew
      以下の変更を加えます。
      • 既存の local_settings ファイルをバックアップします。

        # cp local_settings local_settings.old

        Copy to Clipboard Toggle word wrap
      • local_settings.rpmnew ファイルの名前を local_settings ファイルに変更します。

        # mv local_settings.rpmnew local_settings

        Copy to Clipboard Toggle word wrap
      • 以下の設定オプションを local_settings.old ファイルからの適切な値に置き換えます。
        • ALLOWED_HOSTS
        • SECRET_KEY
        • CACHES
        • OPENSTACK_KEYSTONE_URL
      • 全コントローラーで Web サーバーを再起動してすべての変更を適用します。

        # service httpd restart

        Copy to Clipboard Toggle word wrap
   6. Pacemaker で Dashboard リソースをクリーンアップします。

      #  pcs resource cleanup horizon-clone

      Copy to Clipboard Toggle word wrap
   7. Pacemaker で Dashboard リソースを再起動します。

      #  pcs resource enable horizon-clone

      Copy to Clipboard Toggle word wrap
   8. pcs status の出力で、上記のリソースが実行中と表示されるまで待機します。
   Compute (nova) ホストのアップグレード:
   各コンピュートホストで以下を実行します。
   1. ホスト上の OpenStack サービスをすべて停止します。

      # openstack-service stop

      Copy to Clipboard Toggle word wrap
   2. すべてのパッケージをアップグレードします。

      # yum upgrade

      Copy to Clipboard Toggle word wrap
   3. コンピュートホストのローリングアップグレードを行うには、明示的に API のバージョンの制限を設定して、Juno および kilo 環境間の互換性を確保する必要があります。
      Kilo コントローラーまたはコンピュートサービスを開始する前に、nova.conf の [upgrade_levels] セクションの compute オプションを juno に設定する必要があります。

      # crudini --set /etc/nova/nova.conf upgrade_levels compute juno

      Copy to Clipboard Toggle word wrap
      コントローラーホストおよびコンピュートホストで、上記の変更を加える必要があります。
   4. ホスト上の OpenStack サービスをすべて起動します。

      # openstack-service start

      Copy to Clipboard Toggle word wrap
   5. 全ホストを Kilo にアップグレードした後には、以前のステップで設定した API の制限を削除します。全ホスト上で以下のコマンドを実行します。

      # crudini --del /etc/nova/nova.conf upgrade_levels compute

      Copy to Clipboard Toggle word wrap
   アップグレード後のタスク:
   1. 個別サービスのアップグレードをすべて完了した後には、全システムで完全なパッケージアップグレードを行う必要があります。

      # yum upgrade

      Copy to Clipboard Toggle word wrap
      このコマンドで、すべてのパッケージが最新の状態にします。実行中のプロセスにおいて、更新後の基盤バイナリーバージョンが使用されるように、OpenStack ホストの再起動を後日にスケジューリングしてください。
   2. 上記の操作によって生成された設定ファイルを確認します。アップグレードされたパッケージには、Red Hat Enterprise Linux OpenStack Platform 7 バージョンのサービスに適した .rpmnew ファイルがインストールされているはずです。
      新しいバージョンの OpenStack サービスでは、特定の設定オプションが非推奨になっている可能性があります。このような非推奨の設定オプションが原因で今後のアップグレードの際に問題が発生する可能性があるため、非推奨の警告については OpenStack のログも参照してください。各サービスで新規追加/更新された設定オプションや非推奨となった設定オプションについての詳しい説明は、Red Hat Enterprise Linux OpenStack Platform ドキュメントスイート で『Configuration Reference』を参照してください。