各サービスを個別に更新する方式による OpenStack のアップグレード

手順 2. コンピュートノードのアップグレード

1. nova-compute サービスを disabled に設定して、ノード上で Compute が新規インスタンスのスケジュールを行わないようにします。

   # nova service-disable --reason upgrade NODENAME nova-compute

   NODENAME はアップグレードするコンピュートホストの名前に置き換えます。NODENAME は、Compute が認識済みのホスト名にする必要があります。Compute が認識済みのコンピュートホスト名の一覧を確認するには、以下のコマンドを実行してください。

   # nova service-list --binary nova-compute

2. ノード上の nova-compute サービスを停止します。

   # openstack-service stop nova-compute

3. 全 nova パッケージを python-migrate とともにアップグレードします。

   # yum upgrade \*nova\* python-migrate

4. nova サービスを再起動します。

   # openstack-service restart nova

5. nova-compute サービスを再度有効にします。

   # nova service-enable NODENAME nova-compute

手順 3. neutron と nova の対話の設定

1. ポートのステータスがアクティブに切り替わった時に neutron が nova に通知するように設定します。

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT notify_nova_on_port_status_changes true

2. neutron が Compute API サービスの新規アドレスを使用するように設定します。

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT nova_url http://COMPUTEAPIADDRESS:8774/v2

3. neutron に必要な認証情報を提供します。

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT nova_admin_username NOVAADMIN

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT nova_admin_password NOVAPASSWD

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT nova_admin_tenant_id NOVATENANT

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT nova_admin_auth_url KEYSTONEENDPOINT

   • NOVAADMIN は、OpenStack 環境で管理者権限のあるユーザーに置き換えます。

     注意

     『OpenStack のデプロイ: 実習環境 (手動設定)』ガイドの例では、Compute Service 専用に admin ロールを持つ compute というユーザーと、services というテナントを作成します。このユーザーは、NOVAADMIN として適切です。
   • NOVAPASSWD は、NOVAADMIN に対応するパスワードに置き換えます。
   • NOVATENANT は、NOVAADMIN に関連付けられたプライマリテナントの UUID に置き換えます。
   • KEYSTONEENDPOINT は、keystone サービスの管理エンドポイントの URL に置き換えます。

手順 4. ML2 の初期設定

1. openstack-neutron-ml2 パッケージをインストールします。

   # yum install openstack-neutron-ml2

2. Networking を ML2 設定ファイル ml2_conf.ini にダイレクトするためのシンボリックリンクを作成します。

   # ln -s /etc/neutron/plugins/ml2/ml2_conf.ini /etc/neutron/plugin.ini

3. ml2_conf.ini ファイルの [ml2] セクションに必要なプラグインの設定を追加します。
   
   ⁠
   

   表 7.  ML2 に必要なプラグイン設定

   設定オプション	説明
   mechanism_drivers	neutron.ml2.type_drivers 名前空間から読み込むネットワークメカニズムドライバーのエントリポイントのコンマ区切りの順序付きリスト。サポートされている値は local、flat、vlan、gre、および vxlan です。
   tenant_network_types	テナントネットワークとして割り当てる network_types のコンマ区切りの順序付きリスト。サポートされている値は、openvswitch、linuxbridge、および l2population です。
   type_drivers	neutron.ml2.type_drivers 名前空間から読み込むネットワークタイプドライバーのエントリポイントのコンマ区切りリスト。サポートされている値は mechanism_drivers と同じです。

4. 選択したメカニズムドライバーの必須設定を追加します。ネットワークタイプドライバー (type_drivers) 別の必須設定は、以下の表を参照してください。
   
   ⁠
   

   表 8.  ドライバータイプ別の必須設定

   type_driver	セクション	設定オプション	説明
   flat	[ml2_type_flat]	flat_networks	フラットなネットワークを作成可能な physical_network 名のリスト。フラットなネットワークに、任意の physical_network 名を割り当てられるようにするには、<literal>*</literal> を使用します。
   gre	[ml2_type_gre]	tunnel_id_ranges	テナントネットワークの割り当てに使用できる GRE トンネリング ID の範囲を列挙した MIN:MAX トンネリングタプルのコンマ区切りリスト
   vlan	[ml2_type_vlan]	network_vlan_ranges	VLAN プロバイダーとテナントネットワークが使用可能な物理ネットワーク名の一覧。この一覧に記載する各名前には、テナントネットワークへの割り当てに使用可能な VLAN タグの範囲を含めることができます。各名前の構文は、physical_network:vlan_min:vlan_max または physical_network の形式にすることができます。
   vxlan (全 2 中の 1)	[ml2_type_vxlan]	vni_ranges	テナントネットワークの割り当てに使用できる VXLAN VNI ID の範囲を列挙した MIN:MAX タプルのコンマ区切りリスト
   vxlan (全 2 中の 2)	[ml2_type_vxlan]	vxlan_group	VXLAN のマルチキャストグループ。未設定の場合には、VXLAN マルチキャストモードが無効になります。

手順 5. ML2 への移行

1. neutron.db.migration.migrate_to_ml2 を使用してプラグインのデータベースを移行するには、以下のコマンドを実行します。

   # python -m neutron.db.migration.migrate_to_ml2 PLUGIN mysql://DBADMIN:DBPASS@DBHOST/DBNAME

   • PLUGIN は、使用していた元のプラグインに置き換えます。サポートされている値は linuxbridge および openvswitch です。
   • DBADMIN は、OpenStack Networking データベースの有効な管理ユーザー名 (例: neutron) に置き換えます。
   • DBPASS は DBADMIN に対応するパスワードに置き換えます。
   • DBHOST は、OpenStack Networking データベースホストの IP アドレスに置き換えます。
   • DBNAME は OpenStack Networking データベースの名前に置き換えます。デフォルトでは、Packstack により ovs_neutron または neutron_linux_bridge という名前が選択したプラグインに応じて割り当てられます。

   注意

   Networking Service が使用する DBADMIN、DBPASS、DBHOST、および DBNAME の実際の値は、/etc/neutron/neutron.conf の [database] セクションに設定されます。具体的には、これらの値は以下の構文で connection の設定値に設定されます。

   connection = mysql://DBADMIN:DBPASS@DBHOST/DBNAME

   オプションのパラメーターには以下が含まれます。
   • --tunnel-type TUNNEL: プラグインがトンネリングを使用するように設定した場合には、このパラメーターを使用してトンネリングデータの移行も行ってください。TUNNEL は設定したトンネリングのタイプに置き換えます。サポートされている値は GRE および VXLAN です。
   • --vxlan-udp-port VXLANPORT: VXLAN トンネリングデータを移行する場合には、このパラメーターを使用して VXLAN トンネルが使用すべき UDP ポートを指定します (それに応じて VXLANPORT を置き換えてください)。このパラメーターを --tunnel-type VXLAN とともに使用しなかった場合には、デフォルトでポート 4789 が使用されます。
2. プラグインデータベースの移行が完了したら、手動で ML2 プラグインを有効化します。そのためには、まず /etc/neutron/neutron.conf 設定ファイルを開いて、core_plugin パラメーターを ML2 プラグインに設定します。

   core_plugin = neutron.plugins.ml2.plugin.Ml2Plugin

3. 次に、L3 ルータープラグイン (neutron.services.l3_router.l3_router_plugin.L3RouterPlugin) を service_plugins パラメーターに追加します。

   service_plugins = neutron.services.firewall.fwaas_plugin.FirewallPlugin,neutron.services.l3_router.l3_router_plugin.L3RouterPlugin

   両パラメーターは /etc/neutron/neutron.conf の DEFAULT セクションにあります。設定ファイルを手動で設定する場合には、各行頭に空白文字が入らないようにしてください。空白文字が入ってしまうと解析エラーが生じて、サービスの正常な機能を妨げる可能性があります。

手順 6. アップグレードを完了するための OpenStack Networking Service の設定

1. 全 Networking Service エージェントでハートビートを長く設定します。以下のコマンドを実行すると、本リリースの推奨値が設定されます。
   Networking コントローラーノードで以下のコマンドを実行します。

   # openstack-config --set /etc/neutron/neutron.conf DEFAULT agent_down_time 75

   次に、Networking Service エージェントをホストしている各ノードで以下のコマンドを実行します。

   # openstack-config --set /etc/neutron/neutron.conf agent report_interval 30

   上記の設定により、Networking Service は 30 秒ごとにエージェントが停止しているかどうかを確認するようになります。エージェントは、75 秒間到達不可の場合にのみ down 状態と宣言されます。
2. dnsmasq プロセスを強制終了します (この操作は、DHCP エージェントが機能するために必要です)。

   # killall dnsmasq

3. OpenStack Networking Service を再起動して、全設定を適用します。そのためには、Networking Service をホストしている全ノードで以下のコマンドを実行してください。

   # openstack-service start neutron