第3章 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