ネットワークガイド

手順

1. アンダークラウドホストに stack ユーザーとしてログインし、source コマンドで stackrc ファイルを読み込みます。

   $ source stackrc

2. デプロイメントに適したカスタムロールファイルを選択します。そのままでご自分のニーズに適する場合には、直接デプロイコマンドで使用します。あるいは、他のカスタムロールファイルを組み合わせる独自のカスタムロールファイルを生成することもできます。

   デプロイメント	ロール	ロールファイル
   Networker ロール	Networker	Networker.yaml
   Networker ロールと SR-IOV の組み合わせ	NetworkerSriov	NetworkerSriov.yaml
   共存する control および networker と SR-IOV の組み合わせ	ControllerSriov	ControllerSriov.yaml

3. (オプション) 前述のカスタムロールファイルの 1 つを他のカスタムロールファイルと組み合わせた、新しいカスタムロールデータファイルを生成します。

   Director のインストールと使用 ガイドの roles_data ファイルの作成 の手順に従ってください。デプロイメントに応じて、適切なソースロールファイルを含めます。

4. (オプション) ロール用の特定のノードを特定するには、特定のハードウェアフレーバーを作成して特定のノードにフレーバーを割り当てることができます。次に、環境ファイルを使用してロールのフレーバーを定義し、ノード数を指定します。

   詳細については、Director のインストールと使用 ガイドの 新しいロールの作成 の例を参照してください。

5. デプロイメントに適した環境ファイルを作成します。

   デプロイメント	環境ファイルのサンプル
   Networker ロール	neutron-ovn-dvr-ha.yaml
   Networker ロールと SR-IOV の組み合わせ	ovn-sriov.yaml

6. デプロイメントに適するように、以下の設定を含めます。

   デプロイメント	設定
   Networker ロール	ControllerParameters: OVNCMSOptions: "" ControllerSriovParameters: OVNCMSOptions: "" NetworkerParameters: OVNCMSOptions: "enable-chassis-as-gw" NetworkerSriovParameters: OVNCMSOptions: ""
   Networker ロールと SR-IOV の組み合わせ	OS::TripleO::Services::NeutronDhcpAgent: OS::Heat::None ControllerParameters: OVNCMSOptions: "" ControllerSriovParameters: OVNCMSOptions: "" NetworkerParameters: OVNCMSOptions: "" NetworkerSriovParameters: OVNCMSOptions: "enable-chassis-as-gw"
   共存する control および networker と SR-IOV の組み合わせ	OS::TripleO::Services::NeutronDhcpAgent: OS::Heat::None ControllerParameters: OVNCMSOptions: "" ControllerSriovParameters: OVNCMSOptions: "enable-chassis-as-gw" NetworkerParameters: OVNCMSOptions: "" NetworkerSriovParameters: OVNCMSOptions: ""

7. デプロイコマンドを実行し、-r オプションを使用してデプロイコマンドにコア Heat テンプレート、その他の環境ファイル、およびカスタムロールデータファイルを含めます。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates <core_heat_templates> \
   -e <other_environment_files> \
   -e /home/stack/templates/my-neutron-environment.yaml
   -r mycustom_roles_file.yaml

検証手順

1. tripleo-admin ユーザーとして Controller ノードまたは Networker ノードにログインします。

   例

   ssh tripleo-admin@controller-0

2. ovn_metadata_agent が実行されていることを確認します。

   $ sudo podman ps | grep ovn_metadata

   出力例

   a65125d9588d  undercloud-0.ctlplane.localdomain:8787/rh-osbs ...
   openstack-neutron-metadata-agent-ovn ...
   kolla_start  23 hours ago  Up 21 hours ago  ovn_metadata_agent

3. OVN サービスが設定されたコントローラーノードまたは専用のネットワーカーノードが OVS のゲートウェイとして設定されていることを確認します。

   $ sudo ovs-vsctl get Open_Vswitch . external_ids:ovn-cms-options

   出力例

   enable-chassis-as-gw

SR-IOV デプロイメントの追加検証手順

1. tripleo-admin ユーザーとして Compute ノードにログインします。

   例

   ssh tripleo-admin@compute-0

2. neutron_sriov_agent が Compute ノード上で実行されていることを確認します。

   sudo podman ps | grep neutron_sriov_agent

   出力例

   f54cbbf4523a  undercloud-0.ctlplane.localdomain:8787 ...
   openstack-neutron-sriov-agent ...
   kolla_start  23 hours ago  Up 21 hours ago  neutron_sriov_agent

3. ネットワークに接続された SR-IOV NIC が正常に検出されていることを確認します。

   $ sudo podman exec -uroot galera-bundle-podman-0 mysql nova \
   -e 'select hypervisor_hostname,pci_stats from compute_nodes;'

   出力例

   computesriov-1.localdomain	{... {"dev_type": "type-PF", "physical_network"
   : "datacentre", "trusted": "true"}, "count": 1}, ... {"dev_type": "type-VF",
   "physical_network": "datacentre", "trusted": "true", "parent_ifname":
   "enp7s0f3"}, "count": 5}, ...}
   
   computesriov-0.localdomain	{... {"dev_type": "type-PF", "physical_network":
   "datacentre", "trusted": "true"}, "count": 1}, ... {"dev_type": "type-VF",
   "physical_network": "datacentre", "trusted": "true", "parent_ifname":
   "enp7s0f3"}, "count": 5}, ...}

1. Dashboard で プロジェクト > ネットワーク > ルーター を選択します。

2. ルーター リストで仮想ルーターの名前を選択し、+インターフェイスの追加 をクリックします。

   サブネットリストで、新規サブネットの名前を選択します。インターフェイスの IP アドレスを任意で指定することができます。

3. 送信 をクリックします。

   ネットワーク上のインスタンスが、サブネット外部のシステムと通信できるようになりました。

1. Dashboard で プロジェクト > ネットワーク > ネットワーク を選択します。

2. +ネットワークの作成 をクリックして、以下の値を指定します。

   フィールド	説明
   ネットワーク名	そのネットワークが果たすロールに基づいた説明的な名前。ネットワークを外部の VLAN と統合する場合には、名前に VLAN ID 番号を追記することを検討してください。たとえば、このサブネットで HTTP Web サーバーをホストし、VLAN タグが 122 の場合には webservers_122 とします。また、ネットワークトラフィックをプライベートにして、ネットワークを外部ネットワークと統合しない場合には、internal-only とします。
   管理状態有効	このオプションにより、ネットワークを即時に利用可能にするかどうかを制御することができます。ネットワークを Down の状態で作成するには、このフィールドを使用します。その場合、そのネットワークは論理的には存在しますが、アクティブではありません。このような設定は、そのネットワークを直ちに稼働させない場合に有用です。
   サブネットの作成	サブネットを作成するかどうかを決定します。たとえば、ネットワーク接続のないプレースホルダーとしてこのネットワークを維持する場合には、サブネットを作成しない方がよいでしょう。

3. 次へ ボタンをクリックして、サブネット タブで以下の値を指定します。

   フィールド	説明
   サブネット名	サブネットの説明的な名前を入力します。
   ネットワークアドレス	IP アドレス範囲とサブネットマスクが 1 つの値としてまとめられた CIDR 形式でアドレスを入力します。アドレスを判断するには、サブネットマスクでマスキングされたビット数を算出して、IP アドレス範囲の値に追記します。たとえば、サブネットマスク 255.255.255.0 でマスクされるビット数は 24 です。このマスクを IPv4 アドレス範囲 192.168.122.0 に使用するには、アドレスを 192.168.122.0/24 と指定します。
   IP バージョン	インターネットプロトコルバージョンを指定します (有効なタイプは IPv4 または IPv6)。ネットワークアドレス フィールドの IP アドレスの範囲は、選択したバージョンと一致する必要があります。
   ゲートウェイ IP	デフォルトゲートウェイに指定したルーターのインターフェイスの IP アドレス。このアドレスは、外部ロケーションを宛先とするトラフィックルーティングの次のホップとなり、ネットワークアドレス フィールドで指定した範囲内でなければなりません。たとえば、CIDR 形式のネットワークアドレスが 192.168.122.0/24 の場合には、通常デフォルトのゲートウェイは 192.168.122.1 となります。
   ゲートウェイなし	転送を無効にして、サブネットを分離します。

4. 次へ をクリックして DHCP オプションを指定します。

   • DHCP 有効: そのサブネットの DHCP サービスを有効にします。DHCP を使用して、インスタンスへの IP 設定の割り当てを自動化することができます。

   • IPv6 アドレス設定モード : IPv6 ネットワークを作成する際の設定モード。IPv6 ネットワークを作成する場合には、IPv6 アドレスと追加の情報をどのように割り当てるかを指定する必要があります。

     • オプション指定なし: IP アドレスを手動で設定する場合または OpenStack が対応していない方法を使用してアドレスを割り当てる場合には、このオプションを選択します。
     • SLAAC (Stateless Address Autoconfiguration): インスタンスは、ルーターから送信されるルーター広告 (RA) メッセージに基づいて IPv6 アドレスを生成します。OpenStack Networking ルーターオプションまたは外部ルーターオプションを選択します。ra_mode が slaac に、address_mode が slaac に設定された OpenStack Networking サブネットを作成するには、この設定を使用します。
     • DHCPv6 stateful: インスタンスは、OpenStack Networking DHCPv6 サービスから、IPv6 アドレスや追加のオプション (例: DNS) を受信します。ra_mode が dhcpv6-stateful に、address_mode が dhcpv6-stateful に設定されたサブネットを作成するには、この設定を使用します。
     • DHCPv6 stateless: インスタンスは、OpenStack Networking ルーターから送信されるルーター広告 (RA) メッセージに基づいて IPv6 アドレスを生成します。追加のオプション (例: DNS) は、OpenStack Networking DHCPv6 サービスから割り当てられます。ra_mode が dhcpv6-stateless に、address_mode が dhcpv6-stateless に設定されたサブネットを作成するには、この設定を使用します。
   • IP アドレス割り当てプール: DHCP によって割り当てられる IP アドレスの範囲。たとえば、192.168.22.100,192.168.22.150 という値を指定すると、その範囲内で使用可能なアドレスはすべて割り当ての対象として考慮されます。

   • DNS サーバー: ネットワーク上で利用可能な DNS サーバーの IP アドレス。DHCP はこれらの IP アドレスをインスタンスに割り当てて名前解決します。

     重要

     DNS 等の重要なサービスの場合、クラウド上ではホストしないことがベストプラクティスです。たとえば、クラウドで DNS をホストしている場合にクラウドが正常に動作しなくなると、DNS は利用できず、クラウドコンポーネントは互いに検索することができなくなります。

   • 追加のルート設定: 静的ホストルート。まず CIDR 形式で宛先のネットワークを指定し、その後にルーティングに使用する次のホップを指定します (例: 192.168.23.0/24, 10.1.31.1)。静的ルートをインスタンスに分散する必要がある場合には、この値を指定します。

5. Create をクリックします。

   作成が完了したネットワークは、ネットワーク タブに表示されます。必要に応じて、ネットワークの編集 をクリックしてオプションを変更することもできます。インスタンスの作成時には、そのサブネットを使用するように設定できるようになりました。指定した DHCP オプションがインスタンスに適用されます。

1. Dashboard で プロジェクト > ネットワーク > ネットワーク を選択して、ネットワーク ビューで対象のネットワークの名前をクリックします。

2. +サブネットの作成 をクリックして、以下の値を指定します。

   フィールド	説明
   サブネット名	サブネットの説明的な名前
   ネットワークアドレス	IP アドレス範囲とサブネットマスクが 1 つの値としてまとめられた CIDR 形式のアドレス。CIDR 形式のアドレスを決定するには、サブネットマスクでマスキングされたビット数を算出して、IP アドレス範囲の値に追記します。たとえば、サブネットマスク 255.255.255.0 でマスクされるビット数は 24 です。このマスクを IPv4 アドレス範囲 192.168.122.0 に使用するには、アドレスを 192.168.122.0/24 と指定します。
   IP バージョン	インターネットプロトコルバージョン (有効なタイプは IPv4 または IPv6)。ネットワークアドレス フィールドの IP アドレスの範囲は、選択したプロトコルバージョンと一致する必要があります。
   ゲートウェイ IP	デフォルトゲートウェイに指定したルーターのインターフェイスの IP アドレス。このアドレスは、外部ロケーションを宛先とするトラフィックルーティングの次のホップとなり、ネットワークアドレス フィールドで指定した範囲内でなければなりません。たとえば、CIDR 形式のネットワークアドレスが 192.168.122.0/24 の場合には、通常デフォルトのゲートウェイは 192.168.122.1 となります。
   ゲートウェイなし	転送を無効にして、サブネットを分離します。

3. 次へ をクリックして DHCP オプションを指定します。

   • DHCP 有効: そのサブネットの DHCP サービスを有効にします。DHCP を使用して、インスタンスへの IP 設定の割り当てを自動化することができます。

   • IPv6 アドレス設定モード : IPv6 ネットワークを作成する際の設定モード。IPv6 ネットワークを作成する場合には、IPv6 アドレスと追加の情報をどのように割り当てるかを指定する必要があります。

     • オプション指定なし: IP アドレスを手動で設定する場合または OpenStack が対応していない方法を使用してアドレスを割り当てる場合には、このオプションを選択します。
     • SLAAC (Stateless Address Autoconfiguration): インスタンスは、ルーターから送信されるルーター広告 (RA) メッセージに基づいて IPv6 アドレスを生成します。OpenStack Networking ルーターオプションまたは外部ルーターオプションを選択します。ra_mode が slaac に、address_mode が slaac に設定された OpenStack Networking サブネットを作成するには、この設定を使用します。
     • DHCPv6 stateful: インスタンスは、OpenStack Networking DHCPv6 サービスから、IPv6 アドレスや追加のオプション (例: DNS) を受信します。ra_mode が dhcpv6-stateful に、address_mode が dhcpv6-stateful に設定されたサブネットを作成するには、この設定を使用します。
     • DHCPv6 stateless: インスタンスは、OpenStack Networking ルーターから送信されるルーター広告 (RA) メッセージに基づいて IPv6 アドレスを生成します。追加のオプション (例: DNS) は、OpenStack Networking DHCPv6 サービスから割り当てられます。ra_mode が dhcpv6-stateless に、address_mode が dhcpv6-stateless に設定されたサブネットを作成するには、この設定を使用します。
   • IP アドレス割り当てプール: DHCP によって割り当てられる IP アドレスの範囲。たとえば、192.168.22.100,192.168.22.150 という値を指定すると、その範囲内で使用可能なアドレスはすべて割り当ての対象として考慮されます。
   • DNS サーバー: ネットワーク上で利用可能な DNS サーバーの IP アドレス。DHCP はこれらの IP アドレスをインスタンスに割り当てて名前解決します。
   • 追加のルート設定: 静的ホストルート。まず CIDR 形式で宛先のネットワークを指定し、その後にルーティングに使用する次のホップを指定します (例: 192.168.23.0/24, 10.1.31.1)。静的ルートをインスタンスに分散する必要がある場合には、この値を指定します。

4. Create をクリックします。

   サブネットは、サブネット のリストに表示されます。必要に応じて、ネットワークの編集 をクリックしてオプションを変更することもできます。インスタンスの作成時には、そのサブネットを使用するように設定できるようになりました。指定した DHCP オプションがインスタンスに適用されます。

1. Dashboard で プロジェクト > ネットワーク > ルーター を選択し、+ルーターの作成 をクリックします。
2. 新規ルーターの説明的な名前を入力し、ルーターの作成 をクリックします。
3. ルーター リストに新たに追加されたルーターのエントリーの横にある ゲートウェイの設定 をクリックします。
4. 外部ネットワーク のリストで、外部ロケーション宛のトラフィックを受信するネットワークを指定します。

5. Set Gateway をクリックします。

   ルーターを追加したら、作成済みのサブネットがこのルーターを使用してトラフィックを送信するように設定しなければなりません。そのためには、サブネットとルーター間のインターフェイスを作成します。

1. Dashboard で プロジェクト > ネットワーク > ルーター を選択し、削除するルーターの名前をクリックします。
2. 種別が 内部インタフェース のインターフェイスを選択し、インターフェイスの削除 をクリックします。
3. ルーターリストから対象のルーターを選択して ルーターの削除 をクリックします。

1. Dashboard で プロジェクト > ネットワーク > ネットワーク を選択します。
2. 対象のネットワークの名前をクリックします。
3. 対象のサブネットを選択して、サブネットの削除 をクリックします。

1. Dashboard で プロジェクト > ネットワーク > ネットワーク を選択します。

   対象のネットワークサブネットに関連付けられたルーターインターフェイスをすべて削除します。

   インターフェイスを削除するには、ネットワーク リストで対象のネットワークをクリックして ID フィールドを確認し、削除するネットワークの ID 番号を特定します。このネットワークに関連付けられたすべてのサブネットの ネットワーク ID フィールドには、この値が使用されます。

2. プロジェクト > ネットワーク > ルーター に移動し、ルーター リストで対象の仮想ルーターの名前をクリックし、削除するサブネットに接続されているインターフェイスを特定します。

   ゲートウェイ IP として機能していた IP アドレスで、削除するサブネットと他のサブネットを区別することができます。インターフェイスのネットワーク ID が以前のステップで書き留めた ID と一致しているかどうかを確認することで、さらに確実に識別することができます。

3. 削除するインターフェイスの インターフェイスの削除 ボタンをクリックします。
4. プロジェクト > ネットワーク > ネットワーク を選択して、対象のネットワークの名前をクリックします。

5. 削除するサブネットの サブネットの削除 ボタンをクリックします。

   注記

   この時点でサブネットをまだ削除できない場合には、インスタンスがすでにそのサブネットを使用していないかどうかを確認してください。

6. プロジェクト > ネットワーク > ネットワーク を選択し、削除するネットワークを選択します。
7. ネットワークの削除 をクリックします。

手順

1. アンダークラウドホストに stack ユーザーとしてログインして、カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-modules-environment.yaml

   ヒント

   Red Hat OpenStack Platform Orchestration サービス (heat) は、テンプレート と呼ばれるプランのセットを使用して環境をインストールおよび設定します。カスタム環境ファイル を使用して、オーバークラウドの要素をカスタマイズすることができます。このファイルは、orchestration テンプレートをカスタマイズするための特別な種別のテンプレートです。

2. YAML 環境ファイルの parameter_defaults セクションで、NeutronBridgeMappings を使用して外部ネットワークへのアクセスに使用する OVS ブリッジを指定します。

   例

   parameter_defaults:
     NeutronBridgeMappings: 'physnet1:br-net1,physnet2:br-net2'

3. Controller ノードおよび Compute ノードのカスタム NIC 設定テンプレートで、インターフェイスがアタッチされたブリッジを設定します。

   例

   ...
                 - type: ovs_bridge
                   name: br-net1
                   mtu: 1500
                   use_dhcp: false
                   members:
                   - type: interface
                     name: eth0
                     mtu: 1500
                     use_dhcp: false
                     primary: true
                 - type: ovs_bridge
                   name: br-net2
                   mtu: 1500
                   use_dhcp: false
                   members:
                   - type: interface
                     name: eth1
                     mtu: 1500
                     use_dhcp: false
                     primary: true
   ...

4. openstack overcloud deploy コマンドを実行し、変更したカスタム NIC テンプレートおよび新しい環境ファイルを含む、テンプレートおよび環境ファイルを追加します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-neutron-environment.yaml

検証

1. フラットネットワークとして外部ネットワーク (public1) を作成し、設定済みの物理ネットワーク (physnet1) に関連付けます。

   このネットワークを共有ネットワークとして設定し (--share を使用)、他のユーザーが外部ネットワークに直接接続された仮想マシンインスタンスを作成できるようにします。

   例

   # openstack network create --share --provider-network-type flat --provider-physical-network physnet1 --external public01

2. openstack subnet create コマンドを使用して、サブネット (public_subnet) を作成します。

   例

   # openstack subnet create --no-dhcp --allocation-pool start=192.168.100.20,end=192.168.100.100 --gateway 192.168.100.1 --network public01 public_subnet

3. 仮想マシンインスタンスを作成し、それを新たに作成した外部ネットワークに直接接続します。

   例

   $ openstack server create --image rhel --flavor my_flavor --network public01 my_instance

1. パケットはインスタンスの eth0 インターフェイスから送信され、linux ブリッジ qbr-xx に到達します。
2. ブリッジ qbr-xx は、veth ペア qvb-xx <-> qvo-xxx を使用して br-int に接続されます。これは、セキュリティーグループによって定義されている受信/送信のファイアウォールルールの適用にブリッジが使用されるためです。
3. インターフェイス qvb-xx は qbr-xx linux ブリッジに、qvo-xx は br-int Open vSwitch (OVS) ブリッジに接続されています。

1. 受信トラフィックは、物理ノードの eth1 に到達します。
2. パケットは br-ex ブリッジに移動します。
3. このパケットは、パッチピア phy-br-ex <--> int-br-ex を通じて br-int に移動します。

br-int のトラフィックフローの確認

1. パケットが int-br-ex に到達すると、br-int ブリッジ内の OVS フロールールにより、内部 VLAN タグ 5 を追加するようにパケットが変更されます。actions=mod_vlan_vid:5 のエントリーを参照してください。

    # ovs-ofctl dump-flows br-int
   NXST_FLOW reply (xid=0x4):
    cookie=0x0, duration=5351.536s, table=0, n_packets=12118, n_bytes=510456, idle_age=0, priority=1 actions=NORMAL
    cookie=0x0, duration=4537.553s, table=0, n_packets=3489, n_bytes=321696, idle_age=0, priority=3,in_port=15,vlan_tci=0x0000 actions=mod_vlan_vid:5,NORMAL
    cookie=0x0, duration=5350.365s, table=0, n_packets=628, n_bytes=57892, idle_age=4538, priority=2,in_port=15 actions=drop
    cookie=0x0, duration=5351.432s, table=23, n_packets=0, n_bytes=0, idle_age=5351, priority=0 actions=drop

2. 2 番目のルールは、VLAN タグのない (vlan_tci=0x0000) int-br-ex (in_port=15) に到達するパケットを管理します。このルールはパケットに VLAN タグ 5 を追加し (actions=mod_vlan_vid:5,NORMAL)、qvoxxx に転送します。
3. qvoxxx は、VLAN タグを削除した後に、パケットを受け入れて qvbxx に転送します。
4. 最終的にパケットはインスタンスに到達します。

手順

1. bridge_mappings を確認します。

   使用する物理ネットワーク名が bridge_mapping 設定の内容と一致していることを確認してください。

   例

   この例では、物理ネットワーク名は physnet1 です。

   $ openstack network show provider-flat

   出力例

   ...
   | provider:physical_network | physnet1
   ...

   例

   この例では、bridge_mapping 設定の内容も physnet1 です。

   $ grep bridge_mapping /etc/neutron/plugins/ml2/openvswitch_agent.ini

   出力例

   bridge_mappings = physnet1:br-ex

2. ネットワークの設定を確認します。

   ネットワークが external として作成され、flat の種別が使用されていることを確認します。

   例

   この例では、ネットワーク provider-flat に関する詳細が照会されます。

   $ openstack network show provider-flat

   出力例

   ...
   | provider:network_type     | flat                                 |
   | router:external           | True                                 |
   ...

3. パッチピアを確認します。

   パッチピア int-br-ex <--> phy-br-ex を使用して、br-int と br-ex が接続されていることを確認します。

   $ ovs-vsctl show

   出力例

     Bridge br-int
         fail_mode: secure
        Port int-br-ex
             Interface int-br-ex
                 type: patch
                 options: {peer=phy-br-ex}

   出力例

   br-ex でのパッチピアの設定:

       Bridge br-ex
           Port phy-br-ex
               Interface phy-br-ex
                   type: patch
                   options: {peer=int-br-ex}
           Port br-ex
               Interface br-ex
                   type: internal

   /etc/neutron/plugins/ml2/openvswitch_agent.ini の bridge_mapping が正しく設定されていれば、この接続は neutron-openvswitch-agent サービスを再起動する際に作成されます。

   サービスを再起動してもこの接続が作成されない場合には、bridge_mapping の設定を再確認してください。

4. ネットワークフローを確認します。

   ovs-ofctl dump-flows br-ex と ovs-ofctl dump-flows br-int を実行して、フローにより送信パケットの内部 VLAN ID が削除されたかどうかを確認します。まず、このフローは、特定の Compute ノード上のこのネットワークにインスタンスを作成すると追加されます。

   1. インスタンスの起動後にこのフローが作成されなかった場合には、ネットワークが flat として作成されていて、external であることと、physical_network の名前が正しいことを確認します。また、bridge_mapping の設定を確認してください。

   2. 最後に ifcfg-br-ex と ifcfg-ethx の設定を確認します。ethX が br-ex 内のポートとして追加されていること、および ip a の出力で ifcfg-br-ex および ifcfg-ethx に UP フラグが表示されることを確認します。

      出力例

      以下の出力では、eth1 が br-ex のポートであることが分かります。

          Bridge br-ex
              Port phy-br-ex
                  Interface phy-br-ex
                      type: patch
                      options: {peer=int-br-ex}
              Port "eth1"
                  Interface "eth1"

      例

      以下の例では eth1 は OVS ポートとして設定されていて、カーネルはこのインターフェイスからのパケットをすべて転送して OVS ブリッジ br-ex に送信することを認識していることが分かります。これは、master ovs-system のエントリーで確認することができます。

      $ ip a
      5: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq master ovs-system state UP qlen 1000

手順

1. アンダークラウドホストに stack ユーザーとしてログインして、カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-modules-environment.yaml

   ヒント

   Red Hat OpenStack Platform Orchestration サービス (heat) は、テンプレート と呼ばれるプランのセットを使用して環境をインストールおよび設定します。カスタム環境ファイル を使用して、オーバークラウドの要素をカスタマイズすることができます。このファイルは、orchestration テンプレートをカスタマイズするための特別な種別のテンプレートです。

2. YAML 環境ファイルの parameter_defaults セクションで、NeutronTypeDrivers を使用してネットワーク種別ドライバーを指定します。

   例

   parameter_defaults:
     NeutronTypeDrivers: vxlan,flat,vlan

3. NeutronNetworkVLANRanges の設定を行い、使用する物理ネットワークおよび VLAN 範囲を反映します。

   例

   parameter_defaults:
     NeutronTypeDrivers: 'vxlan,flat,vlan'
     NeutronNetworkVLANRanges: 'physnet1:171:172'

4. 外部ネットワークブリッジ (br-ex) を作成し、ポート (eth1) をそのブリッジに関連付けます。

   以下の例では、eth1 が br-ex を使用するように設定します。

   例

   parameter_defaults:
     NeutronTypeDrivers: 'vxlan,flat,vlan'
     NeutronNetworkVLANRanges: 'physnet1:171:172'
     NeutronBridgeMappings: 'datacentre:br-ex,tenant:br-int'

5. コアテンプレートおよびこの新しい環境ファイルを含む環境ファイルを指定して、openstack overcloud deploy コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-neutron-environment.yaml

検証

1. 外部ネットワークを種別 vlan として作成して、設定済みの physical_network に関連付けます。

   以下のサンプルコマンドを実行して、2 つのネットワーク (VLAN 171 用および VLAN 172 用) を作成します。

   例

   $ openstack network create \
   			--provider-network-type vlan \
   			--provider-physical-network physnet1 \
   			--provider-segment 171 \
   			provider-vlan171
   
   $ openstack network create \
   			--provider-network-type vlan \
   			--provider-physical-network physnet1 \
   			--provider-segment 172 \
   			provider-vlan172

2. 複数のサブネットを作成して、外部ネットワークを使用するように設定します。

   openstack subnet create または Dashboard のどちらかを使用して、これらのサブネットを作成することができます。ネットワーク管理者から取得した外部サブネットの詳細が、正しく各 VLAN に関連付けられるようにします。

   以下の例では、VLAN 171 はサブネット 10.65.217.0/24 を、VLAN 172 は 10.65.218.0/24 を、それぞれ使用しています。

   例

   $ openstack subnet create \
   			--network provider-171 \
   			--subnet-range 10.65.217.0/24 \
   			--dhcp \
   			--gateway 10.65.217.254 \
   			subnet-provider-171
   
   $ openstack subnet create \
   			--network provider-172 \
   			--subnet-range 10.65.218.0/24 \
   			--dhcp \
   			--gateway 10.65.218.254 \
   			subnet-provider-172

1. インスタンスの eth0 インターフェイスから送信されたパケットは、インスタンスに接続された linux ブリッジ qbr-xx に到達します。
2. qbr-xx は、veth ペア qvbxx <→ qvoxxx を使用して br-int に接続されます。
3. qvbxx は linux ブリッジ qbr-xx に、qvoxx は Open vSwitch ブリッジ br-int に接続されています。

手順

1. bridge_mapping 設定で使用される物理ネットワーク名が物理ネットワーク名と一致することを確認します。

   例

   $ openstack network show provider-vlan171

   出力例

   ...
   | provider:physical_network | physnet1
   ...

   例

   $ grep bridge_mapping /etc/neutron/plugins/ml2/openvswitch_agent.ini

   出力例

   この出力例では、物理ネットワーク名 physnet1 が bridge_mapping 設定で使用されている名前と一致しています。

   bridge_mappings = physnet1:br-ex

2. ネットワークが external として vlan の種別で作成され、正しい segmentation_id の値が使用されていることを確認します。

   例

   $ openstack network show provider-vlan171

   出力例

   ...
   | provider:network_type     | vlan                                 |
   | provider:physical_network | physnet1                             |
   | provider:segmentation_id  | 171                                  |
   ...

3. パッチピアを確認します。

   パッチピア int-br-ex <--> phy-br-ex を使用して、br-int と br-ex が接続されていることを確認します。

   $ ovs-vsctl show

   この接続は、/etc/neutron/plugins/ml2/openvswitch_agent.ini で bridge_mapping が正しく設定されていることを前提として、neutron-openvswitch-agent の再起動の後に作成されます。

   サービスを再起動してもこの接続が作成されない場合には bridge_mapping の設定を再確認してください。

4. ネットワークフローを確認します。

   1. 送信パケットのフローを確認するには、ovs-ofctl dump-flows br-ex および ovs-ofctl dump-flows br-int を実行して、このフローにより VLAN ID が外部 VLAN id (segmentation_id) にマッピングされていることを確認します。

   2. 受信パケットには、外部 VLAN ID が内部 VLAN ID にマッピングされます。

      このフローは、このネットワークに初めてインスタンスを作成した場合に neutron OVS エージェントにより追加されます。

   3. インスタンスの起動後にこのフローが作成されなかった場合には、ネットワークが vlan として作成されていて、external であることと、physical_network の名前が正しいことを確認します。また、bridge_mapping の設定を再確認してください。

   4. 最後に、ifcfg-br-ex と ifcfg-ethx の設定を再確認します。

      br-ex にポート ethX が含まれていること、および ip a コマンドの出力で ifcfg-br-ex と ifcfg- ethx の両方に UP フラグが表示されることを確認します。

      例

      $ ovs-vsctl show

      この出力例では、eth1 は br-ex のポートです。

          Bridge br-ex
              Port phy-br-ex
                  Interface phy-br-ex
                      type: patch
                      options: {peer=int-br-ex}
              Port "eth1"
                  Interface "eth1"

      例

      $ ip a

      出力例

      この出力例では、eth1 がポートとして追加されており、カーネルがすべてのパケットをインターフェイスから OVS ブリッジ br-ex に移動するように設定されています。これは、エントリー master ovs-system で確認できます。

      5: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq master ovs-system state UP qlen 1000

手順

1. アンダークラウドホストに stack ユーザーとしてログインして、カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-ovs-environment.yaml

   ヒント

   Orchestration サービス (heat) は、テンプレートと呼ばれるプランのセットを使用して環境をインストールおよび設定します。カスタム環境ファイルを使用して、オーバークラウドの要素をカスタマイズすることができます。このファイルは、heat テンプレートをカスタマイズするための特別な種別のテンプレートです。

2. YAML 環境ファイルの parameter_defaults セクションで、NeutronEnableIgmpSnooping を true に設定します。

   parameter_defaults:
       NeutronEnableIgmpSnooping: true
       ...

   重要

   コロン (:) と true の間に空白文字を追加するようにしてください。

3. コア heat テンプレート、環境ファイル、およびこの新しいカスタム環境ファイルを指定して、openstack overcloud deploy コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-ovs-environment.yaml

手順

1. セキュリティーを設定し、適切な仮想マシンインスタンスへのマルチキャストトラフィックを許可します。たとえば、セキュリティーグループルールのペアを作成し、IGMP クエリーアーからの IGMP トラフィックが仮想マシンインスタンスに到達/発進するのを許可し、3 番目のルールでマルチキャストトラフィックを許可します。

   例

   セキュリティーグループ mySG により、IGMP トラフィックが仮想マシンインスタンスに到達/発進するのを許可します。

    openstack security group rule create --protocol igmp --ingress mySG
   
    openstack security group rule create --protocol igmp --egress mySG

   別のルールにより、マルチキャストトラフィックが仮想マシンインスタンスに到達するのを許可します。

   openstack security group rule create  --protocol udp mySG

   セキュリティーグループルールを設定する代わりに、オペレーターはネットワーク上のポートセキュリティーを選択的に無効にすることもできます。ポートセキュリティーを無効にする場合は、関連するセキュリティーリスクについて検討し、対応を計画してください。

2. heat パラメーターを設定しますNeutronEnableIgmpSnoopingTrue。これは、アンダークラウドノードの環境ファイルで設定します。たとえば、以下の行を ovn-extras.yaml に追加します。

   例

   parameter_defaults:
           NeutronEnableIgmpSnooping: True

3. この環境ファイルをご自分の環境に該当するその他の環境ファイルと共に openstack overcloud deploy コマンドに追加して、オーバークラウドをデプロイします。

   $ openstack overcloud deploy \
   --templates \
   …
   -e <other_overcloud_environment_files> \
   
   -e ovn-extras.yaml \
   …

   <other_overcloud_environment_files> を既存のデプロイメントに含まれる環境ファイルのリストに置き換えます。

検証

1. マルチキャストスヌーピングが有効であることを確認します。ノースバウンドデータベースの Logical_Switch テーブルをリスト表示します。

   $ ovn-nbctl list Logical_Switch

   出力例

   _uuid         : d6a2fbcd-aaa4-4b9e-8274-184238d66a15
   other_config  : {mcast_flood_unregistered="false", mcast_snoop="true"}
   ...

   Networking サービス (neutron) の igmp_snooping_enable 設定は、OVN ノースバウンドデータベースの Logical_Switch テーブルの other_config 列で設定される mcast_snoop オプションに変換されます。mcast_flood_unregistered は常に false である点に注意してください。

2. IGMP グループを表示します。

   $ ovn-sbctl list IGMP_group

   出力例

   _uuid    : 2d6cae4c-bd82-4b31-9c63-2d17cbeadc4e
   address  : "225.0.0.120"
   chassis  : 34e25681-f73f-43ac-a3a4-7da2a710ecd3
   datapath : eaf0f5cc-a2c8-4c30-8def-2bc1ec9dcabc
   ports    : [5eaf9dd5-eae5-4749-ac60-4c1451901c56, 8a69efc5-38c5-48fb-bbab-30f2bf9b8d45]
   ...

手順

1. Dashboard で、管理 > ネットワーク > ネットワーク > +ネットワークの作成 > プロジェクト を選択します。
2. プロジェクト ドロップダウンリストを使用して、新規ネットワークをホストするプロジェクトを選択します。

3. プロバイダーネットワーク種別 でオプションを確認します。

   • ローカル: トラフィックはローカルの Compute ホストに残り、実質的には外部のネットワークから分離されます。
   • フラット: トラフィックは単一のネットワーク上に残り、ホストと共有することも可能となります。VLAN タグ付けやその他のネットワーク分離は行われません。
   • VLAN: 物理ネットワークに存在する VLAN に対応した VLAN ID を使用してネットワークを作成します。このオプションを選択すると、インスタンスは同じレイヤー 2 VLAN 上のシステムと通信することができます。
   • GRE: 複数のノードにまたがるネットワークオーバーレイを使用して、インスタンス間のプライベート通信を行います。オーバーレイの外部に送信されるトラフィックは、ルーティングする必要があります。
   • VXLAN: GRE と同様に、複数のノードにまたがるネットワークオーバーレイを使用して、インスタンス間のプライベート通信を行います。オーバーレイの外部に送信されるトラフィックは、ルーティングする必要があります。

4. Create Network をクリックします。

   プロジェクトのネットワークトポロジーをチェックして、ネットワークが適切に作成されたことを確認します。

手順

1. 以下のコマンドを入力して、プールから Floating IP アドレスを確保します。以下の例では、ネットワークは public という名前です。

   例

   $ openstack floating ip create public

   出力例

   以下の例では、新たに確保された Floating IP は 192.0.2.200 です。これをインスタンスに割り当てることができます。

   +---------------------+--------------------------------------------------+
   | Field               | Value                                            |
   +---------------------+--------------------------------------------------+
   | fixed_ip_address    | None                                             |
   | floating_ip_address | 192.0.2.200                                      |
   | floating_network_id | f0dcc603-f693-4258-a940-0a31fd4b80d9             |
   | id                  | 6352284c-c5df-4792-b168-e6f6348e2620             |
   | port_id             | None                                             |
   | router_id           | None                                             |
   | status              | ACTIVE                                           |
   +---------------------+--------------------------------------------------+

2. 以下のコマンドを入力して、インスタンスを探します。

   $ openstack server list

   出力例

   +-------------+-------------+--------+-------------+-------+-------------+
   | ID          | Name        | Status | Networks    | Image | Flavor      |
   +-------------+-------------+--------+-------------+-------+-------------+
   | aef3ca09-88 | prod-serv1  | ACTIVE | public=198. | rhel8 | review-     |
   | 7d-4d20-872 |             |        | 51.100.56   |       | ephemeral   |
   | d-1d1b49081 |             |        |             |       |             |
   | 958         |             |        |             |       |             |
   |             |             |        |             |       |             |
   +-------------+-------------+--------+-------------+-------+-------------+

3. インスタンス名または ID を Floating IP に関連付けます。

   例

   $ openstack server add floating ip prod-serv1 192.0.2.200

手順

1. テキストエディターで /etc/sysconfig/network-scripts/ifcfg-eth0 を開き、以下のパラメーターをご自分のサイトのネットワークに適した値で更新します。

   • IPADDR
   • NETMASK GATEWAY

   • DNS1 (ネームサーバー)

     以下に例を示します。

     # vi /etc/sysconfig/network-scripts/ifcfg-eth0
     DEVICE=eth0
     TYPE=OVSPort
     DEVICETYPE=ovs
     OVS_BRIDGE=br-ex
     ONBOOT=yes

2. テキストエディターで /etc/sysconfig/network-scripts/ifcfg-br-ex を開き、前のステップで eth0 に確保した IP アドレスの値で仮想ブリッジのパラメーターを更新します。

   # vi /etc/sysconfig/network-scripts/ifcfg-br-ex
   DEVICE=br-ex
   DEVICETYPE=ovs
   TYPE=OVSBridge
   BOOTPROTO=static
   IPADDR=192.168.120.10
   NETMASK=255.255.255.0
   GATEWAY=192.168.120.1
   DNS1=192.168.120.1
   ONBOOT=yes

   インスタンスに Floating IP アドレスを割り当てて、物理ネットワークが利用できるようにすることができます。

1. Dashboard で プロジェクト > ネットワーク > ネットワークトポロジー を選択します。
2. 管理するルーターを特定してその上にカーソルを移動し、+インターフェイスの追加 をクリックします。

3. ルーターに接続するサブネットを指定します。

   IP アドレスを指定することもできます。インターフェイスに対して ping を実行して成功した場合には、トラフィックのルーティングが想定通りに機能していることが確認できるので、このアドレスを指定しておくとテストやトラブルシューティングに役立ちます。

4. Add interface をクリックします。

   ネットワークトポロジー の図が自動的に更新され、ルーターとサブネットの間の新規インターフェイス接続が反映されます。

1. Dashboard で プロジェクト > ネットワーク > ルーター を選択します。
2. 削除するインターフェイスをホストしているルーターの名前をクリックします。
3. インターフェイス種別 (内部インタフェース) を選択し、インターフェイスの削除 をクリックします。

1. インターネット: 一般的な最初のステップは、www.example.com などのインターネットロケーションに ping テストを送信することです。

   • Success:このテストは、マシンとインターネットの間にあるさまざまなネットワークポイントすべてが正常に機能していることを示します。これには、仮想/物理インフラストラクチャーが含まれます。
   • Failure:遠隔にあるインターネットロケーションへの ping テストは、さまざまな部分で失敗する可能性があります。ネットワーク上の他のマシンがインターネットに正常に ping 送信できる場合には、インターネット接続は機能していることが分かり、問題は概ねローカルマシンの設定にあると考えられます。

2. 物理ルーター: これは、外部の送信先にトラフィックを転送するために、ネットワーク管理者が指定するルーターインターフェイスです。

   • Success:物理ルーターに ping テストを行って、ローカルネットワークと基盤のスイッチが機能しているかどうかを検証することができます。このパケットは、ルーターを通過しないため、デフォルトのゲートウェイにルーティングの問題があるかどうかは分かりません。
   • Failure:これは、VM1 とデフォルトゲートウェイの間で問題があることを示しています。ルーター/スイッチがダウンしているか、不正なデフォルトゲートウェイを使用している可能性があります。正常に機能していることを確認済みの別のサーバーと、設定内容を比較してください。また、ローカルネットワーク上の別のサーバーに ping 送信を試行してみてください。

3. Neutron ルーター: これは、Red Hat OpenStack Platform が仮想マシントラフィックの転送に使用する仮想 SDN (ソフトウェア定義ネットワーク) ルーターです。

   • Success:ファイアウォールが ICMP トラフィックを許可し、ネットワークノードがオンラインの状態です。
   • Failure:インスタンスのセキュリティーグループで、ICMP トラフィックが許可されているかどうかを確認してください。また、ネットワークノードがオンラインで、必要なサービスすべてが実行中であることをチェックし、L3 エージェントのログ (/var/log/neutron/l3-agent.log) を確認してください。

4. 物理スイッチ: 物理スイッチは、同じ物理ネットワーク上にあるノード間のトラフィックを管理します。

   • Success:仮想マシンが物理スイッチへ送信したトラフィックは、仮想ネットワークインフラストラクチャーを通過する必要があります。つまり、このセグメントが正常に機能していることが分かります。
   • Failure:必要な VLAN をトランク接続するように物理スイッチポートが設定されていることを確認してください。

5. VM2: 同じ Compute ノード上にある、同じサブネットの仮想マシンに ping 送信を試行します。

   • Success:VM1 上の NIC ドライバーと基本的な IP 設定が機能しています。
   • Failure:VM1 のネットワーク設定を確認します。問題がない場合には、VM2 のファイアウォールが単に ping トラフィックをブロックしている可能性があります。また、仮想スイッチの設定を検証し、Open vSwitch のログファイルを確認します。

手順

1. r1 という名前のルーターに接続されたすべてのポートを表示するには、以下のコマンドを実行します。

   #  openstack port list --router r1

   出力例

   +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------+
   | id                                   | name | mac_address       | fixed_ips                                                                            |
   +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------+
   | b58d26f0-cc03-43c1-ab23-ccdb1018252a |      | fa:16:3e:94:a7:df | {"subnet_id": "a592fdba-babd-48e0-96e8-2dd9117614d3", "ip_address": "192.168.200.1"} |
   | c45e998d-98a1-4b23-bb41-5d24797a12a4 |      | fa:16:3e:ee:6a:f7 | {"subnet_id": "43f8f625-c773-4f18-a691-fd4ebfb3be54", "ip_address": "172.24.4.225"}  |
   +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------+

2. 各ポートの詳細を表示するには、以下のコマンドを実行します。表示するポートのポート ID を指定します。コマンドの出力にはポートのステータスが含まれており、以下の例では状態が ACTIVE であることが分かります。

   # openstack port show b58d26f0-cc03-43c1-ab23-ccdb1018252a

   出力例

   +-----------------------+--------------------------------------------------------------------------------------+
   | Field                 | Value                                                                                |
   +-----------------------+--------------------------------------------------------------------------------------+
   | admin_state_up        | True                                                                                 |
   | allowed_address_pairs |                                                                                      |
   | binding:host_id       | node.example.com                                                      |
   | binding:profile       | {}                                                                                   |
   | binding:vif_details   | {"port_filter": true, "ovs_hybrid_plug": true}                                       |
   | binding:vif_type      | ovs                                                                                  |
   | binding:vnic_type     | normal                                                                               |
   | device_id             | 49c6ebdc-0e62-49ad-a9ca-58cea464472f                                                 |
   | device_owner          | network:router_interface                                                             |
   | extra_dhcp_opts       |                                                                                      |
   | fixed_ips             | {"subnet_id": "a592fdba-babd-48e0-96e8-2dd9117614d3", "ip_address": "192.168.200.1"} |
   | id                    | b58d26f0-cc03-43c1-ab23-ccdb1018252a                                                 |
   | mac_address           | fa:16:3e:94:a7:df                                                                    |
   | name                  |                                                                                      |
   | network_id            | 63c24160-47ac-4140-903d-8f9a670b0ca4                                                 |
   | security_groups       |                                                                                      |
   | status                | ACTIVE                                                                               |
   | tenant_id             | d588d1112e0f496fb6cac22f9be45d49                                                     |
   +-----------------------+--------------------------------------------------------------------------------------+

3. ポートごとにステップ 2 を実施して、ステータスを判断します。

手順

1. ping <gateway-IP-address> コマンドを使用して、ゲートウェイに ping 送信を行います。

   以下のコマンドで作成されたネットワークを例にして説明します。

   # openstack network create --provider-network-type vlan --provider-physical-network phy-eno1 --provider-segment 120 provider
   # openstack subnet create --no-dhcp --allocation-pool start=192.168.120.1,end=192.168.120.153 --gateway 192.168.120.254 --network  provider public_subnet

   上記の例では、ゲートウェイの IP アドレスは 192.168.120.254 です。

   $ ping 192.168.120.254

2. ping 送信に失敗する場合は、以下の項目を確認します。

   1. 関連付けられた VLAN へのネットワークフローがあることを確認する。

      VLAN ID が設定されていない可能性があります。上記の例では、OpenStack Networking は VLAN 120 をプロバイダーネットワークにトランク接続するように設定されています。(例のステップ 1 の --provider:segmentation_id=120 を参照してください。)

   2. コマンド ovs-ofctl dump-flows <bridge-name> を使用して、ブリッジインターフェイスの VLAN フローを確認する。

      以下の例では、ブリッジは br-ex という名前です。

      # ovs-ofctl dump-flows br-ex
      
       NXST_FLOW reply (xid=0x4):
        cookie=0x0, duration=987.521s, table=0, n_packets=67897, n_bytes=14065247, idle_age=0, priority=1 actions=NORMAL
        cookie=0x0, duration=986.979s, table=0, n_packets=8, n_bytes=648, idle_age=977, priority=2,in_port=12 actions=drop

手順

1. openstack network agent list コマンドを使用して、RHOSP Networking サービスのエージェントが稼働し、正しいホスト名前で登録されていることを確認します。

   (overcloud)[stack@undercloud~]$ openstack network agent list
   +--------------------------------------+--------------------+-----------------------+-------+----------------+
   | id                                   | agent_type         | host                  | alive | admin_state_up |
   +--------------------------------------+--------------------+-----------------------+-------+----------------+
   | a08397a8-6600-437d-9013-b2c5b3730c0c | Metadata agent     | rhelosp.example.com   | :-)   | True           |
   | a5153cd2-5881-4fc8-b0ad-be0c97734e6a | L3 agent           | rhelosp.example.com   | :-)   | True           |
   | b54f0be7-c555-43da-ad19-5593a075ddf0 | DHCP agent         | rhelosp.example.com   | :-)   | True           |
   | d2be3cb0-4010-4458-b459-c5eb0d4d354b | Open vSwitch agent | rhelosp.example.com   | :-)   | True           |
   +--------------------------------------+--------------------+-----------------------+-------+----------------+

2. /var/log/containers/neutron/openvswitch-agent.log を確認します。作成プロセスで ovs-ofctl コマンドを使用して VLAN のトランク接続が設定されたことを確認します。
3. /etc/neutron/l3_agent.ini ファイルで external_network_bridge を確認します。external_network_bridge パラメーターにハードコードされた値がある場合、L3 エージェントと共にプロバイダーネットワークを使用することができず、必要なフローを作成することはできません。external_network_bridge の値は、external_network_bridge = "" の形式でなければなりません。
4. /etc/neutron/plugin.ini ファイルで network_vlan_ranges の値を確認します。プロバイダーネットワークの場合には、数字の VLAN ID を指定しないでください。VLAN を分離したプロジェクトネットワークを使用している場合に限り、ID を指定します。
5. OVS エージェントの設定ファイルのブリッジマッピング を検証し、phy-eno1 にマッピングされているブリッジが存在することと、eno1 に適切に接続されていることを確認します。

手順

1. Red Hat OpenStack Platform の認証情報を使用してオーバークラウドにログインします。
2. openstack server list コマンドを実行して、仮想マシンインスタンスの名前を取得します。

3. openstack server show コマンドを実行して、インスタンスを実行している Compute ノードを確認します。

   例

   $ openstack server show my_instance -c OS-EXT-SRV-ATTR:host \
   -c addresses

   出力例

   +----------------------+-------------------------------------------------+
   | Field                | Value                                           |
   +----------------------+-------------------------------------------------+
   | OS-EXT-SRV-ATTR:host | compute0.overcloud.example.com                  |
   | addresses            | finance-network1=192.0.2.2; provider-           |
   |                      | storage=198.51.100.13                           |
   +----------------------+-------------------------------------------------+

4. Compute ノードホストにログインします。

   例

   $ ssh tripleo-admin@compute0.example.com

5. ip netns list コマンドを実行して、OVN メタデータ名前空間を表示します。

   出力例

   ovnmeta-07384836-6ab1-4539-b23a-c581cf072011 (id: 1)
   ovnmeta-df9c28ea-c93a-4a60-b913-1e611d6f15aa (id: 0)

6. メタデータ名前空間を使用して、ip netns exec コマンドを実行して、関連付けられたネットワークに ping を実行します。

   例

   $ sudo ip netns exec ovnmeta-df9c28ea-c93a-4a60-b913-1e611d6f15aa \
   ping 192.0.2.2

   出力例

   PING 192.0.2.2 (192.0.2.2) 56(84) bytes of data.
   64 bytes from 192.0.2.2: icmp_seq=1 ttl=64 time=0.470 ms
   64 bytes from 192.0.2.2: icmp_seq=2 ttl=64 time=0.483 ms
   64 bytes from 192.0.2.2: icmp_seq=3 ttl=64 time=0.183 ms
   64 bytes from 192.0.2.2: icmp_seq=4 ttl=64 time=0.296 ms
   64 bytes from 192.0.2.2: icmp_seq=5 ttl=64 time=0.307 ms
   ^C
   --- 192.0.2.2 ping statistics ---
   5 packets transmitted, 5 received, 0% packet loss, time 122ms
   rtt min/avg/max/mdev = 0.183/0.347/0.483/0.116 ms

手順

1. openstack network list コマンドを使用して、すべてのプロジェクトネットワークをリスト表示して、ネットワークがどのネットワーク名前空間に含まれているかを確認します。

   $ openstack network list

   この出力では、web-servers ネットワークの ID (9cb32fe0-d7fb-432c-b116-f483c6497b08) に注意してください。このコマンドは、ネットワーク ID をネットワーク名前空間に追加します。これにより、次のステップで名前空間を特定できます。

   出力例

   +--------------------------------------+-------------+-------------------------------------------------------+
   | id                                   | name        | subnets                                               |
   +--------------------------------------+-------------+-------------------------------------------------------+
   | 9cb32fe0-d7fb-432c-b116-f483c6497b08 | web-servers | 453d6769-fcde-4796-a205-66ee01680bba 192.168.212.0/24 |
   | a0cc8cdd-575f-4788-a3e3-5df8c6d0dd81 | private     | c1e58160-707f-44a7-bf94-8694f29e74d3 10.0.0.0/24      |
   | baadd774-87e9-4e97-a055-326bb422b29b | private     | 340c58e1-7fe7-4cf2-96a7-96a0a4ff3231 192.168.200.0/24 |
   | 24ba3a36-5645-4f46-be47-f6af2a7d8af2 | public      | 35f3d2cb-6e4b-4527-a932-952a395c4bb3 172.24.4.224/28  |
   +--------------------------------------+-------------+-------------------------------------------------------+

2. ip netns list コマンドを使用して、ネットワークの名前空間をすべてリスト表示します。

   # ip netns list

   出力に、web-servers のネットワーク ID と一致する名前空間が表示されます。

   以下の例では、名前空間は qdhcp-9cb32fe0-d7fb-432c-b116-f483c6497b08 です。

   出力例

   qdhcp-9cb32fe0-d7fb-432c-b116-f483c6497b08
   qrouter-31680a1c-9b3e-4906-bd69-cb39ed5faa01
   qrouter-62ed467e-abae-4ab4-87f4-13a9937fbd6b
   qdhcp-a0cc8cdd-575f-4788-a3e3-5df8c6d0dd81
   qrouter-e9281608-52a6-4576-86a6-92955df46f56

3. 名前空間内でトラブルシューティングのコマンド ip netns exec <namespace> を実行し、web-servers ネットワークの設定を検証します。

   以下の例では、route -n コマンドを使用しています。

   例

   # ip netns exec qrouter-62ed467e-abae-4ab4-87f4-13a9937fbd6b route -n

   出力例

   Kernel IP routing table
   Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
   0.0.0.0         172.24.4.225    0.0.0.0         UG    0      0        0 qg-8d128f89-87
   172.24.4.224    0.0.0.0         255.255.255.240 U     0      0        0 qg-8d128f89-87
   192.168.200.0   0.0.0.0         255.255.255.0   U     0      0        0 qr-8efd6357-96

手順

1. tcpdump コマンドを使用して、ICMP トラフィックを取得します。

   例

   # ip netns exec qrouter-62ed467e-abae-4ab4-87f4-13a9937fbd6b tcpdump -qnntpi any icmp

2. 別のコマンドラインウィンドウで、外部ネットワークへの ping テストを実行します。

   例

   # ip netns exec qrouter-62ed467e-abae-4ab4-87f4-13a9937fbd6b ping www.example.com

3. tcpdump セッションを実行中のターミナルで、ping テストの結果の詳細を確認します。

   出力例

   tcpdump: listening on any, link-type LINUX_SLL (Linux cooked), capture size 65535 bytes
   IP (tos 0xc0, ttl 64, id 55447, offset 0, flags [none], proto ICMP (1), length 88)
       172.24.4.228 > 172.24.4.228: ICMP host 192.168.200.20 unreachable, length 68
   	IP (tos 0x0, ttl 64, id 22976, offset 0, flags [DF], proto UDP (17), length 60)
       172.24.4.228.40278 > 192.168.200.21: [bad udp cksum 0xfa7b -> 0xe235!] UDP, length 32

手順

1. OVN コンテナーにアクセスするために必要な権限を持つユーザーとしてコントローラーホストにログインします。

   例

   $ ssh tripleo-admin@controller-0.ctlplane

2. 実行する ovn コマンドが含まれるシェルスクリプトファイルを作成します。

   例

   vi ~/bin/ovn-alias.sh

3. ovn コマンドを追加して、スクリプトファイルを保存します。

   例

   この例では、ovn-sbctl コマンド、ovn-nbctl コマンド、および ovn-trace コマンドがエイリアスファイルに追加されています。

   REMOTE_IP=$(sudo ovs-vsctl get open . external_ids:ovn-remote)
   NBDB=$(echo $REMOTE_IP | sed 's/6642/6641/g')
   SBDB=$REMOTE_IP
   alias ovn-sbctl="sudo podman exec ovn_controller ovn-sbctl --db=$SBDB"
   alias ovn-nbctl="sudo podman exec ovn_controller ovn-nbctl --db=$NBDB"
   alias ovn-trace="sudo podman exec ovn_controller ovn-trace --db=$SBDB"

4. Compute ホストで、この手順のステップを繰り返します。

検証

1. source コマンドでスクリプトファイルを読み込みます。

   例

   # source ovn-alias.sh

2. コマンドを実行して、スクリプトファイルが正しく動作することを確認します。

   例

   # ovn-nbctl show

   出力例

   switch 26ce22db-1795-41bd-b561-9827cbd81778 (neutron-f8e79863-6c58-43d0-8f7d-8ec4a423e13b) (aka internal_network)
   	port 1913c3ae-8475-4b60-a479-df7bcce8d9c8
       	addresses: ["fa:16:3e:33:c1:fc 192.168.254.76"]
   	port 1aabaee3-b944-4da2-bf0a-573215d3f3d9
       	addresses: ["fa:16:3e:16:cb:ce 192.168.254.74"]
   	port 7e000980-59f9-4a0f-b76a-4fdf4e86f27b
       	type: localport
       	addresses: ["fa:16:3e:c9:30:ed 192.168.254.2"]

手順

1. OVN コンテナーにアクセスするために必要な権限を持つユーザーとしてコントローラーホストにログインします。

   例

   $ ssh tripleo-admin@controller-0.ctlplane

2. OVN データベースコマンドのエイリアスファイルを入手します。

   詳細は、「OVN トラブルシューティングコマンドのエイリアスの作成」 を参照してください。

   例

   source ~/ovn-alias.sh

3. 論理フローを表示します。

   $ ovn-sbctl lflow-list

4. 出力を確認します。

   出力例

   Datapath: "sw0" (d7bf4a7b-e915-4502-8f9d-5995d33f5d10)  Pipeline: ingress
     table=0 (ls_in_port_sec_l2  ), priority=100  , match=(eth.src[40]), action=(drop;)
     table=0 (ls_in_port_sec_l2  ), priority=100  , match=(vlan.present), action=(drop;)
     table=0 (ls_in_port_sec_l2  ), priority=50   , match=(inport == "sw0-port1" && eth.src == {00:00:00:00:00:01}), action=(next;)
     table=0 (ls_in_port_sec_l2  ), priority=50   , match=(inport == "sw0-port2" && eth.src == {00:00:00:00:00:02}), action=(next;)
     table=1 (ls_in_port_sec_ip  ), priority=0    , match=(1), action=(next;)
     table=2 (ls_in_port_sec_nd  ), priority=90   , match=(inport == "sw0-port1" && eth.src == 00:00:00:00:00:01 && arp.sha == 00:00:00:00:00:01), action=(next;)
     table=2 (ls_in_port_sec_nd  ), priority=90   , match=(inport == "sw0-port1" && eth.src == 00:00:00:00:00:01 && ip6 && nd && ((nd.sll == 00:00:00:00:00:00 || nd.sll == 00:00:00:00:00:01) || ((nd.tll == 00:00:00:00:00:00 || nd.tll == 00:00:00:00:00:01)))), action=(next;)
     table=2 (ls_in_port_sec_nd  ), priority=90   , match=(inport == "sw0-port2" && eth.src == 00:00:00:00:00:02 && arp.sha == 00:00:00:00:00:02), action=(next;)
     table=2 (ls_in_port_sec_nd  ), priority=90   , match=(inport == "sw0-port2" && eth.src == 00:00:00:00:00:02 && ip6 && nd && ((nd.sll == 00:00:00:00:00:00 || nd.sll == 00:00:00:00:00:02) || ((nd.tll == 00:00:00:00:00:00 || nd.tll == 00:00:00:00:00:02)))), action=(next;)
     table=2 (ls_in_port_sec_nd  ), priority=80   , match=(inport == "sw0-port1" && (arp || nd)), action=(drop;)
     table=2 (ls_in_port_sec_nd  ), priority=80   , match=(inport == "sw0-port2" && (arp || nd)), action=(drop;)
     table=2 (ls_in_port_sec_nd  ), priority=0    , match=(1), action=(next;)
     table=3 (ls_in_pre_acl      ), priority=0, match=(1), action=(next;)
     table=4 (ls_in_pre_lb       ), priority=0    , match=(1), action=(next;)
     table=5 (ls_in_pre_stateful ), priority=100  , match=(reg0[0] == 1), action=(ct_next;)
     table=5 (ls_in_pre_stateful ), priority=0    , match=(1), action=(next;)
     table=6 (ls_in_acl          ), priority=0    , match=(1), action=(next;)
     table=7 (ls_in_qos_mark     ), priority=0    , match=(1), action=(next;)
     table=8 (ls_in_lb           ), priority=0    , match=(1), action=(next;)
     table=9 (ls_in_stateful     ), priority=100  , match=(reg0[1] == 1), action=(ct_commit(ct_label=0/1); next;)
     table=9 (ls_in_stateful     ), priority=100  , match=(reg0[2] == 1), action=(ct_lb;)
     table=9 (ls_in_stateful     ), priority=0    , match=(1), action=(next;)
     table=10(ls_in_arp_rsp      ), priority=0    , match=(1), action=(next;)
     table=11(ls_in_dhcp_options ), priority=0    , match=(1), action=(next;)
     table=12(ls_in_dhcp_response), priority=0    , match=(1), action=(next;)
     table=13(ls_in_l2_lkup      ), priority=100  , match=(eth.mcast), action=(outport = "_MC_flood"; output;)
     table=13(ls_in_l2_lkup      ), priority=50   , match=(eth.dst == 00:00:00:00:00:01), action=(outport = "sw0-port1"; output;)
     table=13(ls_in_l2_lkup      ), priority=50   , match=(eth.dst == 00:00:00:00:00:02), action=(outport = "sw0-port2"; output;)
   Datapath: "sw0" (d7bf4a7b-e915-4502-8f9d-5995d33f5d10)  Pipeline: egress
     table=0 (ls_out_pre_lb      ), priority=0    , match=(1), action=(next;)
     table=1 (ls_out_pre_acl     ), priority=0    , match=(1), action=(next;)
     table=2 (ls_out_pre_stateful), priority=100  , match=(reg0[0] == 1), action=(ct_next;)
     table=2 (ls_out_pre_stateful), priority=0    , match=(1), action=(next;)
     table=3 (ls_out_lb          ), priority=0    , match=(1), action=(next;)
     table=4 (ls_out_acl         ), priority=0    , match=(1), action=(next;)
     table=5 (ls_out_qos_mark    ), priority=0    , match=(1), action=(next;)
     table=6 (ls_out_stateful    ), priority=100  , match=(reg0[1] == 1), action=(ct_commit(ct_label=0/1); next;)
     table=6 (ls_out_stateful    ), priority=100  , match=(reg0[2] == 1), action=(ct_lb;)
     table=6 (ls_out_stateful    ), priority=0    , match=(1), action=(next;)
     table=7 (ls_out_port_sec_ip ), priority=0    , match=(1), action=(next;)
     table=8 (ls_out_port_sec_l2 ), priority=100  , match=(eth.mcast), action=(output;)
     table=8 (ls_out_port_sec_l2 ), priority=50   , match=(outport == "sw0-port1" && eth.dst == {00:00:00:00:00:01}), action=(output;)
     table=8 (ls_out_port_sec_l2 ), priority=50   , match=(outport == "sw0-port2" && eth.dst == {00:00:00:00:00:02}), action=(output;)

   OVN と OpenFlow には、主に以下のような相違点があります。

   • OVN ポートは、ネットワーク内にある論理エンティティーで、単一のスイッチ上にある物理ポートではありません。
   • OVN により、パイプライン内の各テーブルには番号に加えて名前が付けられます。名前は、パイプライン内のそのステージの目的を示します。
   • OVN の match 構文は、複雑なブール表現をサポートしています。
   • OVN の論理フローでは、OpenFlow よりも幅広いアクションをサポートしています。OVN の論理フローの構文で DHCP などの高度な機能を実装することができます。

5. OVN トレースを実行します。

   ovn-trace コマンドを使用して、パケットが OVN の論理フローをどのように通過するかシミュレーションしたり、パケットがドロップする原因を特定するのに役立てたりすることができます。ovn-trace コマンドには、以下のパラメーターを指定して実行してください。

   DATAPATH

   シミュレーションされるパケットの送信が開始される場所の論理スイッチまたは論理ルーター。

   MICROFLOW

   シミュレーションされるパケット。ovn-sb データベースで使用される構文で指定します。

   例

   この例では、シミュレーションされるパケットに --minimal の出力オプションが示されており、そのパケットが宛先に到達したことを表しています。

   $ ovn-trace --minimal sw0 'inport == "sw0-port1" && eth.src == 00:00:00:00:00:01 && eth.dst == 00:00:00:00:00:02'

   出力例

   #  reg14=0x1,vlan_tci=0x0000,dl_src=00:00:00:00:00:01,dl_dst=00:00:00:00:00:02,dl_type=0x0000
       output("sw0-port2");

   例

   さらに詳しい情報を表示するには、シミュレーションされる同じパケットの --summary 出力に完全な実行パイプラインが表示されます。

   $ ovn-trace --summary sw0 'inport == "sw0-port1" && eth.src == 00:00:00:00:00:01 && eth.dst == 00:00:00:00:00:02'

   出力例

   出力例は次のとおりです。

   • パケットは sw0-port1 ポートから sw0 ネットワークに入り、受信のパイプラインを通過します。
   • outport 変数が sw0-port2 に設定されているのは、このパケットの宛先が sw0-port2 に指定されていることを意味します。
   • パケットは受信のパイプラインから出力されます。このパイプラインは、outport 変数が sw0-port2 に設定された sw0 の送信パイプラインにパケットを送ります。

   • 出力のアクションは、送信のパイプラインで実行されます。このパイプラインでは、パケットが outport 変数の現在の値である sw0-port2 に出力されます。

     #  reg14=0x1,vlan_tci=0x0000,dl_src=00:00:00:00:00:01,dl_dst=00:00:00:00:00:02,dl_type=0x0000
     ingress(dp="sw0", inport="sw0-port1") {
         outport = "sw0-port2";
         output;
         egress(dp="sw0", inport="sw0-port1", outport="sw0-port2") {
             output;
             /* output to "sw0-port2", type "" */;
         };
     };

手順

1. OVN コンテナーにアクセスするために必要な権限を持つユーザーとしてコントローラーホストにログインします。

   例

   $ ssh tripleo-admin@controller-0.ctlplane

2. ovs-ofctl dump-flows コマンドを実行します。

   例

   $ sudo ovs-ofctl dump-flows br-int

3. 出力を確認します。以下の様な出力になるはずです。

   出力例

   $ ovs-ofctl dump-flows br-int
   NXST_FLOW reply (xid=0x4):
    cookie=0x0, duration=72.132s, table=0, n_packets=0, n_bytes=0, idle_age=72, priority=10,in_port=1,dl_src=00:00:00:00:00:01 actions=resubmit(,1)
    cookie=0x0, duration=60.565s, table=0, n_packets=0, n_bytes=0, idle_age=60, priority=10,in_port=2,dl_src=00:00:00:00:00:02 actions=resubmit(,1)
    cookie=0x0, duration=28.127s, table=0, n_packets=0, n_bytes=0, idle_age=28, priority=0 actions=drop
    cookie=0x0, duration=13.887s, table=1, n_packets=0, n_bytes=0, idle_age=13, priority=0,in_port=1 actions=output:2
    cookie=0x0, duration=4.023s, table=1, n_packets=0, n_bytes=0, idle_age=4, priority=0,in_port=2 actions=output:1

手順

1. テストネットワークおよびサブネットを作成します。

   NETWORK_ID=\
   $(openstack network create internal_network | awk '/\| id/ {print $4}')
   
   openstack subnet create internal_subnet \
   --network $NETWORK_ID \
   --dns-nameserver 8.8.8.8 \
   --subnet-range 192.168.254.0/24

   エラーが発生した場合は、以下の手順を実行します。

2. 関連するコンテナーがコントローラーホストで実行していることを確認します。

   1. OVN コンテナーにアクセスするために必要な権限を持つユーザーとしてコントローラーホストにログインします。

      例

      $ ssh tripleo-admin@controller-0.ctlplane

   2. 以下のコマンドを入力します。

      $ sudo podman ps -a --format="{{.Names}}"|grep ovn

      次のサンプルに示すように、出力には OVN コンテナーが一覧表示されます。

      出力例

      container-puppet-ovn_controller
      ovn_cluster_north_db_server
      ovn_cluster_south_db_server
      ovn_cluster_northd
      ovn_controller

3. 関連するコンテナーが Compute ホストで実行していることを確認します。

   1. OVN コンテナーにアクセスするために必要な権限を持つユーザーとして Compute ホストにログインします。

      例

      $ ssh tripleo-admin@compute-0.ctlplane

   2. 以下のコマンドを入力します。

      $ sudo podman ps -a --format="{{.Names}}"|grep ovn

      次のサンプルに示すように、出力には OVN コンテナーが一覧表示されます。

      出力例

      container-puppet-ovn_controller
      ovn_metadata_agent
      ovn_controller

4. ログファイルでエラーメッセージの有無を確認します。

   grep -r ERR /var/log/containers/openvswitch/ /var/log/containers/neutron/

5. エイリアスファイルを読み込んで、OVN データベースコマンドを実行します。

   詳細は、「OVN トラブルシューティングコマンドのエイリアスの作成」 を参照してください。

   例

   $ source ~/ovn-alias.sh

6. ノースバウンドデータベースおよびサウスバウンドデータベースをクエリーして応答するかどうかを確認します。

   # ovn-nbctl show
   # ovn-sbctl show

7. 同じレイヤー 2 ネットワーク上にある OVN メタデータインターフェイスからインスタンスに ping 送信を試みます。

   詳細は、「ML2/OVN 名前空間内での基本的な ICMP テストの実行」 を参照してください。

8. サポートのために Red Hat に問い合わせる必要がある場合は、Red Hat ソリューション How to collect all required logs for Red Hat Support to investigate an OpenStack issue に記載されている手順を実施します。

手順

1. ロギングモードを設定する Controller または Compute ノードに、OVN コンテナーにアクセスするために必要な権限を持つユーザーとしてログインします。

   例

   $ ssh tripleo-admin@controller-0.ctlplane

2. ML2/OVN ロギングモードを設定します。

   デバッグロギングモード

   $ sudo podman exec -it ovn_controller ovn-appctl -t ovn-controller vlog/set dbg

   情報ロギングモード

   $ sudo podman exec -it ovn_controller ovn-appctl -t ovn-controller vlog/set info

手順

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

2. source コマンドでアンダークラウドの認証情報ファイルを読み込みます。

   $ source ~/stackrc

3. qos サービスプラグインがまだロードされていないことを確認します。

   $ openstack network qos policy list

   qos サービスプラグインがロードされていない場合、ResourceNotFound エラーが発生します。エラーが発生しない場合は、プラグインがロードされており、このトピックの手順を実行する必要はありません。

4. YAML カスタム環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-neutron-environment.yaml

5. ご自分の環境ファイルには、parameter_defaults というキーワードを含める必要があります。parameter_defaults の下の新しい行で、NeutronServicePlugins パラメーターに qos を追加します。

   parameter_defaults:
      NeutronServicePlugins: "qos"

6. ML2/OVS および ML2/SR-IOV メカニズムドライバーを使用する場合は、それぞれ NeutronAgentExtensions または NeutronSriovAgentExtensions 変数を使用して、エージェントに qos 拡張機能もロードする必要があります。

   • ML2/OVS

     parameter_defaults:
       NeutronServicePlugins: "qos"
       NeutronAgentExtensions: "qos"

   • ML2/SR-IOV

     parameter_defaults:
       NeutronServicePlugins: "qos"
       NeutronSriovAgentExtensions: "qos"

7. 最小帯域幅 QoS ポリシーを使用して VM インスタンスをスケジュールする場合は、次のことも行う必要があります。

   1. プラグインのリストに placement を追加し、リストに qos も含まれていることを確認します。

      parameter_defaults:
         NeutronServicePlugins: "qos,placement"

   2. ハイパーバイザー名が Compute サービス (nova) で使用される標準的なハイパーバイザー名と一致する場合は、ステップ 7.iii に進みます。

      ハイパーバイザー名が Compute サービスで使用される標準的なハイパーバイザー名と一致しない場合は、resource_provider_default_hypervisor を使用して代替のハイパーバイザー名を指定します。

      • ML2/OVS

        parameter_defaults:
          NeutronServicePlugins: "qos,placement"
          ExtraConfig:
            Neutron::agents::ml2::ovs::resource_provider_default_hypervisor: %{hiera('fqdn_canonical')}

      • ML2/SR-IOV

        parameter_defaults:
          NeutronServicePlugins: "qos,placement"
          ExtraConfig:
            Neutron::agents::ml2::sriov::resource_provider_default_hypervisor: %{hiera('fqdn_canonical')}

        重要

        代替ハイパーバイザー名を設定する別の方法は、resource_provider_hypervisor を使用することです。

        • ML2/OVS

          parameter_defaults:
            ExtraConfig:
               Neutron::agents::ml2::ovs::resource_provider_hypervisors:"ens5:%{hiera('fqdn_canonical')},ens6:%{hiera('fqdn_canonical')}"

        • ML2/SR-IOV

          parameter_defaults:
            ExtraConfig:
               Neutron::agents::ml2::sriov::resource_provider_hypervisors:
               "ens5:%{hiera('fqdn_canonical')},ens6:%{hiera('fqdn_canonical')}"

   3. 最小帯域幅を提供する必要のある各 Compute ノードの該当するエージェントに対して、リソースプロバイダーの受信および送信帯域幅を設定します。

      次の形式を使用して、送信、受信、またはその両方を設定できます。

      • 送信帯域幅だけを設定する場合 (kbps 単位):

        NeutronOvsResourceProviderBandwidths: <bridge0>:<egress_kbps>:,<bridge1>:<egress_kbps>:,...,<bridgeN>:<egress_kbps>:

      • 受信帯域幅だけを設定する場合 (kbps 単位):

        NeutronOvsResourceProviderBandwidths: <bridge0>::<ingress_kbps>,<bridge1>::<ingress_kbps>,...,<bridgeN>::<ingress_kbps>

      • 送信および受信帯域幅の両方を設定する場合 (kbps 単位):

        NeutronOvsResourceProviderBandwidths: <bridge0>:<egress_kbps>:<ingress_kbps>,<bridge1>:<egress_kbps>:<ingress_kbps>,...,<bridgeN>:<egress_kbps>:<ingress_kbps>

        例 - OVS エージェント

        OVS エージェント用にリソースプロバイダーの受信および送信帯域幅を設定するには、ネットワーク環境ファイルに以下の設定を追加します。

        parameter_defaults:
          ...
          NeutronBridgeMappings: physnet0:br-physnet0
          NeutronOvsResourceProviderBandwidths: br-physnet0:10000000:10000000

        例 - SRIOV エージェント

        SRIOV エージェント用にリソースプロバイダーの受信および送信帯域幅を設定するには、ネットワーク環境ファイルに以下の設定を追加します。

        parameter_defaults:
          ...
          NeutronML2PhysicalNetworkMtus: physnet0:1500,physnet1:1500
          NeutronSriovResourceProviderBandwidths: ens5:40000000:40000000,ens6:40000000:40000000

   4. オプション: vnic_types をサポート対象外として識別するには (複数の ML2 メカニズムドライバーがデフォルトでサポートし、複数のエージェントが Placement サービスで追跡されている場合)、環境ファイルに以下の設定を追加します。

      例 - OVS エージェント

      parameter_defaults:
        ...
        NeutronOvsVnicTypeBlacklist: direct

      例 - SRIOV エージェント

      parameter_defaults:
        ...
        NeutronSriovVnicTypeBlacklist: direct

8. DSCP マーキングポリシーを作成し、トンネリングプロトコル (VXLAN または GRE) で ML2/OVS を使用する場合は、NeutronAgentExtensions の下に次の行を追加します。

   parameter_defaults:
     ...
     ControllerExtraConfig:
       neutron::config::server_config:
           agent/dscp_inherit:
               value: true

   dscp_inherit が true の場合、Networking サービスは内部ヘッダーの DSCP 値を外部ヘッダーにコピーします。

9. コア heat テンプレート、その他の環境ファイル、およびこの新しいカスタム環境ファイルを指定して、deployment コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e <other_environment_files> \
   -e /home/stack/templates/my-neutron-environment.yaml

手順

1. Source コマンドで認証情報ファイルを読み込みます。

   例

   $ source ~/overcloudrc

2. qos サービスプラグインが Networking サービスにロードされていることを確認します。

   $ openstack network qos policy list

   qos サービスプラグインがロードされていない場合は、ResourceNotFound エラーが発生します。続行するには qos サービスプラグインをロードする必要があります。詳細は、「QoS ポリシーの Networking サービスの設定」 を参照してください。

3. QoS ポリシーを作成するプロジェクトの ID を特定します。

   $ openstack project list

   出力例

   +----------------------------------+----------+
   | ID                               | Name     |
   +----------------------------------+----------+
   | 4b0b98f8c6c040f38ba4f7146e8680f5 | auditors |
   | 519e6344f82e4c079c8e2eabb690023b | services |
   | 80bf5732752a41128e612fe615c886c6 | demo     |
   | 98a2f53c20ce4d50a40dac4a38016c69 | admin    |
   +----------------------------------+----------+

4. 前の手順のプロジェクト ID を使用して、プロジェクトの QoS ポリシーを作成します。

   例

   この例では、admin プロジェクト用に bw-limiter という名前の QoS ポリシーが作成されます。

   $ openstack network qos policy create --share --project 98a2f53c20ce4d50a40dac4a38016c69 bw-limiter

5. ポリシーのルールを設定します。

   注記

   各ルールのタイプまたは方向が異なる限り、複数のルールをポリシーに追加できます。たとえば、1 つを送信方向、もう 1 つを受信方向に設定して 2 つの bandwidth-limit ルールを指定できます。

   例

   この例では、50000 kbps の帯域幅制限と 50000 kbps の最大バーストサイズで、bw-limiter という名前のポリシーに対して QoS Ingress ルールと egress ルールが作成されます。

   $ openstack network qos rule create --type bandwidth-limit \
       --max-kbps 50000 --max-burst-kbits 50000 --ingress bw-limiter
   
   $ openstack network qos rule create --type bandwidth-limit \
       --max-kbps 50000 --max-burst-kbits 50000 --egress bw-limiter

6. ポリシーがアタッチされたポートを作成するか、既存のポートにポリシーをアタッチできます。

   例 - ポリシーがアタッチされたポートの作成

   この例では、ポリシー bw-limiter がポート port2 に関連付けられています。

   $ openstack port create --qos-policy bw-limiter --network private port2

   出力例

   +-----------------------+--------------------------------------------------+
   | Field                 | Value                                            |
   +-----------------------+--------------------------------------------------+
   | admin_state_up        | UP                                               |
   | allowed_address_pairs |                                                  |
   | binding_host_id       |                                                  |
   | binding_profile       |                                                  |
   | binding_vif_details   |                                                  |
   | binding_vif_type      | unbound                                          |
   | binding_vnic_type     | normal                                           |
   | created_at            | 2022-07-04T19:20:24Z                             |
   | data_plane_status     | None                                             |
   | description           |                                                  |
   | device_id             |                                                  |
   | device_owner          |                                                  |
   | dns_assignment        | None                                             |
   | dns_name              | None                                             |
   | extra_dhcp_opts       |                                                  |
   | fixed_ips             | ip_address='192.0.2.210', subnet_id='292f8c-...' |
   | id                    | f51562ee-da8d-42de-9578-f6f5cb248226             |
   | ip_address            | None                                             |
   | mac_address           | fa:16:3e:d9:f2:ba                                |
   | name                  | port2                                            |
   | network_id            | 55dc2f70-0f92-4002-b343-ca34277b0234             |
   | option_name           | None                                             |
   | option_value          | None                                             |
   | port_security_enabled | False                                            |
   | project_id            | 98a2f53c20ce4d50a40dac4a38016c69                 |
   | qos_policy_id         | 8491547e-add1-4c6c-a50e-42121237256c             |
   | revision_number       | 6                                                |
   | security_group_ids    | 0531cc1a-19d1-4cc7-ada5-49f8b08245be             |
   | status                | DOWN                                             |
   | subnet_id             | None                                             |
   | tags                  | []                                               |
   | trunk_details         | None                                             |
   | updated_at            | 2022-07-04T19:23:00Z                             |
   +-----------------------+--------------------------------------------------+

   例 - ポリシーの既存のポートへのアタッチ

   この例では、ポリシー bw-limiter が port1 に関連付けられています。

   $ openstack port set --qos-policy bw-limiter port1

手順

1. Source コマンドで認証情報ファイルを読み込みます。

   例

   $ source ~/overcloudrc

2. qos サービスプラグインが Networking サービスにロードされていることを確認します。

   $ openstack network qos policy list

   qos サービスプラグインがロードされていない場合は、ResourceNotFound エラーが発生します。続行する前に Networking サービスを設定する必要があります。詳細は、「QoS ポリシーの Networking サービスの設定」 を参照してください。

3. QoS ポリシーを作成するプロジェクトの ID を特定します。

   $ openstack project list

   出力例

   +----------------------------------+----------+
   | ID                               | Name     |
   +----------------------------------+----------+
   | 4b0b98f8c6c040f38ba4f7146e8680f5 | auditors |
   | 519e6344f82e4c079c8e2eabb690023b | services |
   | 80bf5732752a41128e612fe615c886c6 | demo     |
   | 98a2f53c20ce4d50a40dac4a38016c69 | admin    |
   +----------------------------------+----------+

4. 前の手順のプロジェクト ID を使用して、プロジェクトの QoS ポリシーを作成します。

   例

   この例では、admin プロジェクトに qos-web-servers という名前の QoS ポリシーが作成されます。

   openstack network qos policy create --project 98a2f53c20ce4d50a40dac4a38016c69 qos-web-servers

5. DSCP ルールを作成し、それをポリシーに適用します。

   例

   この例では、DSCP ルールは DSCP マーク 18 を使用して作成され、qos-web-servers ポリシーに適用されます。

   openstack network qos rule create --type dscp-marking --dscp-mark 18 qos-web-servers

   出力例

   Created a new dscp_marking_rule:
   +-----------+--------------------------------------+
   | Field     | Value                                |
   +-----------+--------------------------------------+
   | dscp_mark | 18                                   |
   | id        | d7f976ec-7fab-4e60-af70-f59bf88198e6 |
   +-----------+--------------------------------------+

6. ルールに割り当てられている DSCP 値を変更できます。

   例

   この例では、qos-web-servers ポリシーのルール d7f976ec-7fab-4e60-af70-f59bf88198e6 の DSCP マーク値が 22 に変更されます。

   $ openstack network qos rule set --dscp-mark 22 qos-web-servers d7f976ec-7fab-4e60-af70-f59bf88198e6

7. DSCP ルールを削除できます。

   例

   この例では、qos-web-servers ポリシーの DSCP ルール d7f976ec-7fab-4e60-af70-f59bf88198e6 が削除されます。

   $ openstack network qos rule delete qos-web-servers d7f976ec-7fab-4e60-af70-f59bf88198e6

手順

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

2. source コマンドでアンダークラウドの認証情報ファイルを読み込みます。

   $ source ~/stackrc

3. カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my_bridge_mappings.yaml

4. ご自分の環境ファイルには、parameter_defaults というキーワードを含める必要があります。parameter_defaults キーワードの後に、サイトに適した値を持つ NeutronBridgeMappings heat パラメーターを追加します。

   例

   この例では、NeutronBridgeMappings パラメーターは、物理名 datacentre と tenant、ブリッジ br-ex と br- tenant をそれぞれ関連付けます。

   parameter_defaults:
     NeutronBridgeMappings: "datacentre:br-ex,tenant:br-tenant"

   注記

   NeutronBridgeMappings パラメーターを使用しないと、デフォルトではホストの外部ブリッジ (br-ex) を物理名 (datacentre) にマッピングします。

5. フラットネットワークを使用している場合は、NeutronFlatNetworks パラメーターを使用してその名前を追加します。

   例

   この例では、パラメーターは物理名 datacentre をブリッジ br-ex に関連付け、物理名 tenant をブリッジ br-tenant に関連付けます。

   parameter_defaults:
     NeutronBridgeMappings: "datacentre:br-ex,tenant:br-tenant"
     NeutronFlatNetworks: "my_flat_network"

   注記

   NeutronFlatNetworks パラメーターが使用されていない場合、デフォルトは datacentre です。

6. VLAN ネットワークを使用している場合は、NeutronNetworkVLANRanges パラメーターを使用して、アクセスする VLAN の範囲とともにネットワーク名を指定します。

   例

   この例では、NeutronNetworkVLANRanges パラメーターは、tenant ネットワークの VLAN 範囲を 1 - 1000 で指定します。

   parameter_defaults:
    NeutronBridgeMappings: "datacentre:br-ex,tenant:br-tenant"
    NeutronNetworkVLANRanges: "tenant:1:1000"

7. コア heat テンプレート、環境ファイル、およびこの新しいカスタム環境ファイルを指定して、deployment コマンドを実行します。

   $ openstack overcloud deploy --templates \
     -e <your_environment_files> \
     -e /home/stack/templates/my_bridge_mappings.yaml

8. 以下の手順を実行します。

   1. ネットワークの VLAN 範囲を使用して、対応する外部ネットワークを表すプロバイダーネットワークを作成します。(neutron プロバイダーネットワークまたは Floating IP ネットワークを作成する際には、物理名を使用します。)
   2. ルーターインターフェイスを使用して、外部ネットワークをプロジェクトネットワークに接続します。

手順

1. アンダークラウドノードの環境ファイルで、EnableVLANTransparency パラメーターを true に設定します。たとえば、次の行を ovn-extras.yaml に追加します。

   parameter_defaults:
       EnableVLANTransparency: true

2. この環境ファイルをご自分の環境に該当するその他の環境ファイルと共に openstack overcloud deploy コマンドに追加して、オーバークラウドをデプロイします。

   $ openstack overcloud deploy \
   --templates \
   …
   -e <other_overcloud_environment_files> \
   
   -e ovn-extras.yaml \
   …

   <other_overcloud_environment_files> を既存のデプロイメントに含まれる環境ファイルのリストに置き換えます。

3. --transparent-vlan 引数を使用してネットワークを作成します。

   例

   $ openstack network create network-name --transparent-vlan

4. 参加するそれぞれの仮想マシンに VLAN インターフェイスを設定します。

   VLAN の透過性に必要な追加のタグ付けに対応するために、インターフェイスの MTU を下層のネットワークの MTU より 4 バイト少ない値に設定します。たとえば、下層のネットワークの MTU が 1500 の場合は、インターフェイスの MTU を 1496 に設定します。

   次のコマンド例では、MTU が 1496 の VLAN インターフェイスを eth0 に追加します。VLAN は 50 で、インターフェイス名は vlan50 です。

   例

   $ ip link add link eth0 name vlan50 type vlan id 50 mtu 1496
   $ ip link set vlan50 up
   $ ip addr add 192.128.111.3/24 dev vlan50

5. 仮想マシンポートに --allowed-address を設定します。

   許可されたアドレスを、手順 4 で VM 内の VLAN インターフェイス上に作成した IP アドレスに設定します。オプションで、VLAN インターフェイスの MAC アドレスを設定することもできます。

   例

   次の例では、ポート fv82gwk3-qq2e-yu93-go31-56w7sf476mm0 で、IP アドレスを 192.128.111.3 に設定し、オプションの MAC アドレス 00:40:96:a8:45:c4 を 設定します。

   $ openstack port set --allowed-address ip-address=192.128.111.3,mac-address=00:40:96:a8:45:c4 fv82gwk3-qq2e-yu93-go31-56w7sf476mm0

検証

1. vlan50 の IP アドレスを使用して VLAN 上の 2 つの仮想マシン間で ping を送信します。
2. eth0 で tcpdump を使用して、VLAN タグが付いたままパケットが到達するかどうかを確認します。

1. トランキングされた VLAN へのアクセスを必要とするインスタンスが含まれるネットワークを特定します。以下の例では、このネットワークは public ネットワークです。

   openstack network list
   +--------------------------------------+---------+--------------------------------------+
   | ID                                   | Name    | Subnets                              |
   +--------------------------------------+---------+--------------------------------------+
   | 82845092-4701-4004-add7-838837837621 | private | 434c7982-cd96-4c41-a8c9-b93adbdcb197 |
   | 8d8bc6d6-5b28-4e00-b99e-157516ff0050 | public  | 3fd811b4-c104-44b5-8ff8-7a86af5e332c |
   +--------------------------------------+---------+--------------------------------------+

2. 親のトランクポートを作成して、インスタンスの接続先ネットワークにアタッチします。以下の例では、public ネットワーク上に parent-trunk-port という名前の neutron ポートを作成します。このトランクは、サブポート の作成に使用することができるので、親 ポートです。

   openstack port create --network public parent-trunk-port
   +-----------------------+-----------------------------------------------------------------------------+
   | Field                 | Value                                                                       |
   +-----------------------+-----------------------------------------------------------------------------+
   | admin_state_up        | UP                                                                          |
   | allowed_address_pairs |                                                                             |
   | binding_host_id       |                                                                             |
   | binding_profile       |                                                                             |
   | binding_vif_details   |                                                                             |
   | binding_vif_type      | unbound                                                                     |
   | binding_vnic_type     | normal                                                                      |
   | created_at            | 2016-10-20T02:02:33Z                                                        |
   | description           |                                                                             |
   | device_id             |                                                                             |
   | device_owner          |                                                                             |
   | extra_dhcp_opts       |                                                                             |
   | fixed_ips             | ip_address='172.24.4.230', subnet_id='dc608964-9af3-4fed-9f06-6d3844fb9b9b' |
   | headers               |                                                                             |
   | id                    | 20b6fdf8-0d43-475a-a0f1-ec8f757a4a39                                        |
   | mac_address           | fa:16:3e:33:c4:75                                                           |
   | name                  | parent-trunk-port                                                           |
   | network_id            | 871a6bd8-4193-45d7-a300-dcb2420e7cc3                                        |
   | project_id            | 745d33000ac74d30a77539f8920555e7                                            |
   | project_id            | 745d33000ac74d30a77539f8920555e7                                            |
   | revision_number       | 4                                                                           |
   | security_groups       | 59e2af18-93c6-4201-861b-19a8a8b79b23                                        |
   | status                | DOWN                                                                        |
   | updated_at            | 2016-10-20T02:02:33Z                                                        |
   +-----------------------+-----------------------------------------------------------------------------+

3. ステップ 2 で作成したポートを使用してトランクを作成します。以下の例では、トランクは parent-trunk という名前です。

   openstack network trunk create --parent-port parent-trunk-port parent-trunk
   +-----------------+--------------------------------------+
   | Field           | Value                                |
   +-----------------+--------------------------------------+
   | admin_state_up  | UP                                   |
   | created_at      | 2016-10-20T02:05:17Z                 |
   | description     |                                      |
   | id              | 0e4263e2-5761-4cf6-ab6d-b22884a0fa88 |
   | name            | parent-trunk                         |
   | port_id         | 20b6fdf8-0d43-475a-a0f1-ec8f757a4a39 |
   | revision_number | 1                                    |
   | status          | DOWN                                 |
   | sub_ports       |                                      |
   | tenant_id       | 745d33000ac74d30a77539f8920555e7     |
   | updated_at      | 2016-10-20T02:05:17Z                 |
   +-----------------+--------------------------------------+

4. トランクの接続を確認します。

   openstack network trunk list
   +--------------------------------------+--------------+--------------------------------------+-------------+
   | ID                                   | Name         | Parent Port                          | Description |
   +--------------------------------------+--------------+--------------------------------------+-------------+
   | 0e4263e2-5761-4cf6-ab6d-b22884a0fa88 | parent-trunk | 20b6fdf8-0d43-475a-a0f1-ec8f757a4a39 |             |
   +--------------------------------------+--------------+--------------------------------------+-------------+

5. トランク接続の詳細を表示します。

   openstack network trunk show parent-trunk
   +-----------------+--------------------------------------+
   | Field           | Value                                |
   +-----------------+--------------------------------------+
   | admin_state_up  | UP                                   |
   | created_at      | 2016-10-20T02:05:17Z                 |
   | description     |                                      |
   | id              | 0e4263e2-5761-4cf6-ab6d-b22884a0fa88 |
   | name            | parent-trunk                         |
   | port_id         | 20b6fdf8-0d43-475a-a0f1-ec8f757a4a39 |
   | revision_number | 1                                    |
   | status          | DOWN                                 |
   | sub_ports       |                                      |
   | tenant_id       | 745d33000ac74d30a77539f8920555e7     |
   | updated_at      | 2016-10-20T02:05:17Z                 |
   +-----------------+--------------------------------------+

1. neutron ポートを作成します。

   このポートは、トランクへのサブポート接続です。親ポートに割り当てた MAC アドレスも指定する必要があります。

   openstack port create --network private --mac-address fa:16:3e:33:c4:75 subport-trunk-port
   +-----------------------+--------------------------------------------------------------------------+
   | Field                 | Value                                                                    |
   +-----------------------+--------------------------------------------------------------------------+
   | admin_state_up        | UP                                                                       |
   | allowed_address_pairs |                                                                          |
   | binding_host_id       |                                                                          |
   | binding_profile       |                                                                          |
   | binding_vif_details   |                                                                          |
   | binding_vif_type      | unbound                                                                  |
   | binding_vnic_type     | normal                                                                   |
   | created_at            | 2016-10-20T02:08:14Z                                                     |
   | description           |                                                                          |
   | device_id             |                                                                          |
   | device_owner          |                                                                          |
   | extra_dhcp_opts       |                                                                          |
   | fixed_ips             | ip_address='10.0.0.11', subnet_id='1a299780-56df-4c0b-a4c0-c5a612cef2e8' |
   | headers               |                                                                          |
   | id                    | 479d742e-dd00-4c24-8dd6-b7297fab3ee9                                     |
   | mac_address           | fa:16:3e:33:c4:75                                                        |
   | name                  | subport-trunk-port                                                       |
   | network_id            | 3fe6b758-8613-4b17-901e-9ba30a7c4b51                                     |
   | project_id            | 745d33000ac74d30a77539f8920555e7                                         |
   | project_id            | 745d33000ac74d30a77539f8920555e7                                         |
   | revision_number       | 4                                                                        |
   | security_groups       | 59e2af18-93c6-4201-861b-19a8a8b79b23                                     |
   | status                | DOWN                                                                     |
   | updated_at            | 2016-10-20T02:08:15Z                                                     |
   +-----------------------+--------------------------------------------------------------------------+

   注記

   エラーが発生した場合 (HttpException:Conflict)、親のトランクポートのあるネットワークとは異なるネットワークで、サブポートを作成していることを確認してください。この例では、親トランクポートにパブリックネットワークを、サブポートにはプライベートネットワークを使用しています。

2. トランク (parent-trunk) とポートを関連付けて、VLAN ID (55) を指定します。

   openstack network trunk set --subport port=subport-trunk-port,segmentation-type=vlan,segmentation-id=55 parent-trunk

手順

1. network trunk コマンドを使用して、ネットワークトランクの設定を確認します。

   例

   $ openstack network trunk list

   出力例

   +---------------------+--------------+---------------------+-------------+
   | ID                  | Name         | Parent Port         | Description |
   +---------------------+--------------+---------------------+-------------+
   | 0e4263e2-5761-4cf6- | parent-trunk | 20b6fdf8-0d43-475a- |             |
   | ab6d-b22884a0fa88   |              | a0f1-ec8f757a4a39   |             |
   +---------------------+--------------+---------------------+-------------+

   例

   $ openstack network trunk show parent-trunk

   出力例

   +-----------------+------------------------------------------------------+
   | Field           | Value                                                |
   +-----------------+------------------------------------------------------+
   | admin_state_up  | UP                                                   |
   | created_at      | 2021-10-20T02:05:17Z                                 |
   | description     |                                                      |
   | id              | 0e4263e2-5761-4cf6-ab6d-b22884a0fa88                 |
   | name            | parent-trunk                                         |
   | port_id         | 20b6fdf8-0d43-475a-a0f1-ec8f757a4a39                 |
   | revision_number | 2                                                    |
   | status          | DOWN                                                 |
   | sub_ports       | port_id='479d742e-dd00-4c24-8dd6-b7297fab3ee9', segm |
   |                 | entation_id='55', segmentation_type='vlan'           |
   | tenant_id       | 745d33000ac74d30a77539f8920555e7                     |
   | updated_at      | 2021-08-20T02:10:06Z                                 |
   +-----------------+------------------------------------------------------+

2. 親 port-id を仮想 NIC として使用するインスタンスを作成します。

   例

   openstack server create --image cirros --flavor m1.tiny --security-group default --key-name sshaccess --nic port-id=20b6fdf8-0d43-475a-a0f1-ec8f757a4a39 testInstance

   出力例

   +--------------------------------------+---------------------------------+
   | Property                             | Value                           |
   +--------------------------------------+---------------------------------+
   | OS-DCF:diskConfig                    | MANUAL                          |
   | OS-EXT-AZ:availability_zone          |                                 |
   | OS-EXT-SRV-ATTR:host                 | -                               |
   | OS-EXT-SRV-ATTR:hostname             | testinstance                    |
   | OS-EXT-SRV-ATTR:hypervisor_hostname  | -                               |
   | OS-EXT-SRV-ATTR:instance_name        |                                 |
   | OS-EXT-SRV-ATTR:kernel_id            |                                 |
   | OS-EXT-SRV-ATTR:launch_index         | 0                               |
   | OS-EXT-SRV-ATTR:ramdisk_id           |                                 |
   | OS-EXT-SRV-ATTR:reservation_id       | r-juqco0el                      |
   | OS-EXT-SRV-ATTR:root_device_name     | -                               |
   | OS-EXT-SRV-ATTR:user_data            | -                               |
   | OS-EXT-STS:power_state               | 0                               |
   | OS-EXT-STS:task_state                | scheduling                      |
   | OS-EXT-STS:vm_state                  | building                        |
   | OS-SRV-USG:launched_at               | -                               |
   | OS-SRV-USG:terminated_at             | -                               |
   | accessIPv4                           |                                 |
   | accessIPv6                           |                                 |
   | adminPass                            | uMyL8PnZRBwQ                    |
   | config_drive                         |                                 |
   | created                              | 2021-08-20T03:02:51Z            |
   | description                          | -                               |
   | flavor                               | m1.tiny (1)                     |
   | hostId                               |                                 |
   | host_status                          |                                 |
   | id                                   | 88b7aede-1305-4d91-a180-67e7eac |
   |                                      | 8b70d                           |
   | image                                | cirros (568372f7-15df-4e61-a05f |
   |                                      | -10954f79a3c4)                  |
   | key_name                             | sshaccess                       |
   | locked                               | False                           |
   | metadata                             | {}                              |
   | name                                 | testInstance                    |
   | os-extended-volumes:volumes_attached | []                              |
   | progress                             | 0                               |
   | security_groups                      | default                         |
   | status                               | BUILD                           |
   | tags                                 | []                              |
   | tenant_id                            | 745d33000ac74d30a77539f8920555e |
   |                                      | 7                               |
   | updated                              | 2021-08-20T03:02:51Z            |
   | user_id                              | 8c4aea738d774967b4ef388eb41fef5 |
   |                                      | e                               |
   +--------------------------------------+---------------------------------+

手順

1. アンダークラウドホストに stack ユーザーとしてログインして、カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-modules-environment.yaml

   ヒント

   RHOSP Orchestration サービス (heat) は、テンプレートと呼ばれるプランのセットを使用して環境をインストールおよび設定します。カスタム環境ファイル を使用して、オーバークラウドの要素をカスタマイズすることができます。このファイルは、heat テンプレートをカスタマイズするための特別な種別のテンプレートです。

2. ExtraConfig 下の YAML 環境ファイルで、rpc_response_timeout に適切な値 (秒単位) を設定します。(デフォルト値は 60 秒です。)

   例

   parameter_defaults:
     ExtraConfig:
       neutron::rpc_response_timeout: 120

   注記

   RHOSP Orchestration サービス (heat) は、カスタムの環境ファイルで設定した値ですべての RHOSP ノードを更新しますが、この値は RHOSP Networking コンポーネントにのみ影響します。

3. コア heat テンプレート、環境ファイル、およびこの新しいカスタム環境ファイルを指定して、openstack overcloud deploy コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-modules-environment.yaml

1. 利用可能なネットワークのリストを表示します。

   # openstack network list
   +--------------------------------------+-------------+-------------------------------------------------------+
   | id                                   | name        | subnets                                               |
   +--------------------------------------+-------------+-------------------------------------------------------+
   | fa9bb72f-b81a-4572-9c7f-7237e5fcabd3 | web-servers | 20512ffe-ad56-4bb4-b064-2cb18fecc923 192.168.200.0/24 |
   | bcc16b34-e33e-445b-9fde-dd491817a48a | private     | 7fe4a05a-4b81-4a59-8c47-82c965b0e050 10.0.0.0/24      |
   | 9b2f4feb-fee8-43da-bb99-032e4aaf3f85 | public      | 2318dc3b-cff0-43fc-9489-7d4cf48aaab9 172.24.4.224/28  |
   +--------------------------------------+-------------+-------------------------------------------------------+

2. プロジェクトのリストを表示します。

   # openstack project list
   +----------------------------------+----------+
   | ID                               | Name     |
   +----------------------------------+----------+
   | 4b0b98f8c6c040f38ba4f7146e8680f5 | auditors |
   | 519e6344f82e4c079c8e2eabb690023b | services |
   | 80bf5732752a41128e612fe615c886c6 | demo     |
   | 98a2f53c20ce4d50a40dac4a38016c69 | admin    |
   +----------------------------------+----------+

3. web-servers ネットワークの RBAC エントリーを作成し、auditors プロジェクト (4b0b98f8c6c040f38ba4f7146e8680f5) にアクセスを許可します。

   # openstack network rbac create --type network --target-project 4b0b98f8c6c040f38ba4f7146e8680f5 --action access_as_shared web-servers
   Created a new rbac_policy:
   +----------------+--------------------------------------+
   | Field          | Value                                |
   +----------------+--------------------------------------+
   | action         | access_as_shared                     |
   | id             | 314004d0-2261-4d5e-bda7-0181fcf40709 |
   | object_id      | fa9bb72f-b81a-4572-9c7f-7237e5fcabd3 |
   | object_type    | network                              |
   | target_project | 4b0b98f8c6c040f38ba4f7146e8680f5     |
   | project_id     | 98a2f53c20ce4d50a40dac4a38016c69     |
   +----------------+--------------------------------------+

1. openstack network rbac list コマンドを実行して、既存のロールベースアクセス制御 (RBAC) ポリシーの ID を取得します。

   # openstack network rbac list
   +--------------------------------------+-------------+--------------------------------------+
   | id                                   | object_type | object_id                            |
   +--------------------------------------+-------------+--------------------------------------+
   | 314004d0-2261-4d5e-bda7-0181fcf40709 | network     | fa9bb72f-b81a-4572-9c7f-7237e5fcabd3 |
   | bbab1cf9-edc5-47f9-aee3-a413bd582c0a | network     | 9b2f4feb-fee8-43da-bb99-032e4aaf3f85 |
   +--------------------------------------+-------------+--------------------------------------+

2. openstack network rbac-show コマンドを実行して、特定の RBAC エントリーの詳細を表示します。

   # openstack network rbac show 314004d0-2261-4d5e-bda7-0181fcf40709
   +----------------+--------------------------------------+
   | Field          | Value                                |
   +----------------+--------------------------------------+
   | action         | access_as_shared                     |
   | id             | 314004d0-2261-4d5e-bda7-0181fcf40709 |
   | object_id      | fa9bb72f-b81a-4572-9c7f-7237e5fcabd3 |
   | object_type    | network                              |
   | target_project | 4b0b98f8c6c040f38ba4f7146e8680f5     |
   | project_id     | 98a2f53c20ce4d50a40dac4a38016c69     |
   +----------------+--------------------------------------+

1. openstack network rbac list コマンドを実行して、既存のロールベースアクセス制御 (RBAC) ポリシーの ID を取得します。

   # openstack network rbac list
   +--------------------------------------+-------------+--------------------------------------+
   | id                                   | object_type | object_id                            |
   +--------------------------------------+-------------+--------------------------------------+
   | 314004d0-2261-4d5e-bda7-0181fcf40709 | network     | fa9bb72f-b81a-4572-9c7f-7237e5fcabd3 |
   | bbab1cf9-edc5-47f9-aee3-a413bd582c0a | network     | 9b2f4feb-fee8-43da-bb99-032e4aaf3f85 |
   +--------------------------------------+-------------+--------------------------------------+

2. 削除する RBAC の ID を指定して openstack network rbac delete コマンドを実行し、RBAC を削除します。

   # openstack network rbac delete 314004d0-2261-4d5e-bda7-0181fcf40709
   Deleted rbac_policy: 314004d0-2261-4d5e-bda7-0181fcf40709

手順

1. デプロイメントをアップグレードして、正しく機能していることを確認します。
2. director のスタック更新を実行して DVR を設定します。
3. 既存のルーターでルーティングが正常に機能していることを確認します。
4. L3 HA ルーターを直接 分散型 に移行することはできません。代わりに、各ルーターで L3 HA オプションを無効にしてから、分散型のオプションを有効にします。

1. ルーターを無効にします。

   例

   $ openstack router set --disable router1

2. 高可用性の設定を無効にします。

   例

   $ openstack router set --no-ha router1

3. ルーターが DVR を使用するように設定します。

   例

   $ openstack router set --distributed router1

4. ルーターを有効にします。

   例

   $ openstack router set --enable router1

5. 分散ルーティングが正常に機能していることを確認します。

手順

1. カスタム環境ファイルを作成して、以下の設定を追加します。

   parameter_defaults:
     NeutronEnableDVR: false

2. この設定を適用するには、その他の環境ファイルと共にカスタム環境ファイルをスタックに追加して、オーバークラウドをデプロイします。以下に例を示します。

   (undercloud) $ openstack overcloud deploy --templates \
     -e [your environment files]
     -e /home/stack/templates/<custom-environment-file>.yaml

手順

1. IPv6 サブネットを作成するプロジェクトのプロジェクト ID を取得します。これらの値は OpenStack デプロイメント固有なので、実際の値はこの例の値とは異なります。

   # openstack project list
   +----------------------------------+----------+
   | ID                               | Name     |
   +----------------------------------+----------+
   | 25837c567ed5458fbb441d39862e1399 |    QA    |
   | f59f631a77264a8eb0defc898cb836af |  admin   |
   | 4e2e1951e70643b5af7ed52f3ff36539 |   demo   |
   | 8561dff8310e4cd8be4b6fd03dc8acf5 | services |
   +----------------------------------+----------+

2. OpenStack Networking (neutron) 内の全ネットワークのリストを取得し、IPv6 サブネットをホストするネットワークの名前を書き留めておきます。

   # openstack network list
   +--------------------------------------+------------------+-------------------------------------------------------------+
   | id                                   | name             | subnets                                                     |
   +--------------------------------------+------------------+-------------------------------------------------------------+
   | 8357062a-0dc2-4146-8a7f-d2575165e363 | private          | c17f74c4-db41-4538-af40-48670069af70 10.0.0.0/24            |
   | 31d61f7d-287e-4ada-ac29-ed7017a54542 | public           | 303ced03-6019-4e79-a21c-1942a460b920 172.24.4.224/28        |
   | 6aff6826-4278-4a35-b74d-b0ca0cbba340 | database-servers |                                                             |
   +--------------------------------------+------------------+-------------------------------------------------------------+

3. openstack subnet create コマンドで、プロジェクト ID、ネットワーク名、および ipv6 アドレスモードを指定します。

   # openstack subnet create --ip-version 6 --ipv6-address-mode dhcpv6-stateful --project 25837c567ed5458fbb441d39862e1399 --network database-servers --subnet-range fdf8:f53b:82e4::53/125 subnet_name
   
   Created a new subnet:
   +-------------------+--------------------------------------------------------------+
   | Field             | Value                                                        |
   +-------------------+--------------------------------------------------------------+
   | allocation_pools  | {"start": "fdf8:f53b:82e4::52", "end": "fdf8:f53b:82e4::56"} |
   | cidr              | fdf8:f53b:82e4::53/125                                       |
   | dns_nameservers   |                                                              |
   | enable_dhcp       | True                                                         |
   | gateway_ip        | fdf8:f53b:82e4::51                                           |
   | host_routes       |                                                              |
   | id                | cdfc3398-997b-46eb-9db1-ebbd88f7de05                         |
   | ip_version        | 6                                                            |
   | ipv6_address_mode | dhcpv6-stateful                                              |
   | ipv6_ra_mode      |                                                              |
   | name              |                                                              |
   | network_id        | 6aff6826-4278-4a35-b74d-b0ca0cbba340                         |
   | tenant_id         | 25837c567ed5458fbb441d39862e1399                             |
   +-------------------+--------------------------------------------------------------+

検証手順

1. ネットワークのリストを確認して、ここでの設定を検証します。database-servers のエントリーには新規作成された IPv6 サブネットが反映されている点に注意してください。

   # openstack network list
   +--------------------------------------+------------------+-------------------------------------------------------------+
   | id                                   | name             | subnets                                                     |
   +--------------------------------------+------------------+-------------------------------------------------------------+
   | 6aff6826-4278-4a35-b74d-b0ca0cbba340 | database-servers | cdfc3398-997b-46eb-9db1-ebbd88f7de05 fdf8:f53b:82e4::50/125 |
   | 8357062a-0dc2-4146-8a7f-d2575165e363 | private          | c17f74c4-db41-4538-af40-48670069af70 10.0.0.0/24            |
   | 31d61f7d-287e-4ada-ac29-ed7017a54542 | public           | 303ced03-6019-4e79-a21c-1942a460b920 172.24.4.224/28        |
   +--------------------------------------+------------------+-------------------------------------------------------------+

   結果

   この設定により、QA プロジェクトの作成するインスタンスが database-servers サブネットに追加されると、DHCP IPv6 アドレスを取得できるようになります。

   # openstack server list
   +--------------------------------------+------------+--------+------------+-------------+-------------------------------------+
   | ID                                   | Name       | Status | Task State | Power State | Networks                            |
   +--------------------------------------+------------+--------+------------+-------------+-------------------------------------+
   | fad04b7a-75b5-4f96-aed9-b40654b56e03 | corp-vm-01 | ACTIVE | -          | Running     | database-servers=fdf8:f53b:82e4::52 |
   +--------------------------------------+------------+--------+------------+-------------+-------------------------------------+

手順

1. ネットワーク内では、それぞれのセグメントに固有の物理ネットワーク名を使用します。これにより、サブネット間で同じセグメンテーション情報を再利用することができます。

   たとえば、特定のプロバイダーネットワークのすべてのセグメントで同じ VLAN ID を使用します。

2. セグメント間のルーティングを実装します。

   セグメント上の各サブネットには、その特定のサブネット上のルーターインターフェイスのゲートウェイアドレスが含まれている必要があります。

   表16.1 ルーティングのセグメント例

   セグメント	バージョン	アドレス	ゲートウェイ
   segment1	4	203.0.113.0/24	203.0.113.1
   segment1	6	fd00:203:0:113::/64	fd00:203:0:113::1
   segment2	4	198.51.100.0/24	198.51.100.1
   segment2	6	fd00:198:51:100::/64	fd00:198:51:100::1

3. セグメントをコンピュートノードにマッピングします。

   ルーティング対応プロバイダーネットワークでは、コンピュートノードが異なるセグメントに存在することになります。ルーティングされたプロバイダーネットワーク内のすべてのコンピューティングホストが、セグメントの 1 つに直接接続されていることを確認します。

   表16.2 セグメントとコンピュートノードのマッピング例

   ホスト	ラック	物理ネットワーク
   compute0001	rack 1	segment 1
   compute0002	rack 1	segment 1
   …	…	…
   compute0101	rack 2	segment 2
   compute0102	rack 2	segment 2
   compute0102	rack 2	segment 2
   …	…	…

4. Modular Layer 2 プラグインと Open vSwitch メカニズムドライバーの組み合わせ (ML2/OVS) を使用してデプロイする場合、セグメントごとに少なくとも 1 つの DHCP エージェントをデプロイする必要があります。

   従来のプロバイダーネットワークとは異なり、DHCP エージェントはネットワーク内で複数のセグメントをサポートすることができません。ノード数を減らすために、ネットワークノードにではなくセグメントが含まれる Compute ノードに DHCP エージェントをデプロイします。

   表16.3 セグメントごとの DHCP エージェントのマッピング例

   ホスト	ラック	物理ネットワーク
   network0001	rack 1	segment 1
   network0002	rack 1	segment 1
   …	…	…

   カスタムロールファイルを使用して、DHCP エージェントおよび RHOSP Networking サービス (neutron) のメタデータエージェントをコンピュートノードにデプロイします。

   以下に例を示します。

   ###############################################################################
   # Role: ComputeSriov                                                          #
   ###############################################################################
   - name: ComputeSriov
     description: |
       Compute SR-IOV Role
     CountDefault: 1
     networks:
       External:
         subnet: external_subnet
       InternalApi:
         subnet: internal_api_subnet
       Tenant:
         subnet: tenant_subnet
       Storage:
         subnet: storage_subnet
     RoleParametersDefault:
       TunedProfileName: "cpu-partitioning"
     update_serial: 25
     ServicesDefault:
       - OS::TripleO::Services::Aide
       - OS::TripleO::Services::AuditD
       - OS::TripleO::Services::BootParams
       - OS::TripleO::Services::CACerts
   ...
       - OS::TripleO::Services::NeutronDhcpAgent
       - OS::TripleO::Services::NeutronMetadataAgent
   ...

   カスタム環境ファイルに以下のキーと値のペアを追加します。

   parameter_defaults:
       ....
       NeutronEnableIsolatedMetadata: 'True'
       ....

手順

1. デフォルトのセグメントが含まれる VLAN プロバイダーネットワークを作成します。

   以下の例では、VLAN プロバイダーネットワークは multisegment1 という名前で、provider1 という名前の物理ネットワークおよび ID が 128 の VLAN を使用します。

   例

   $ openstack network create --share --provider-physical-network provider1 \
     --provider-network-type vlan --provider-segment 128 multisegment1

   出力例

   +---------------------------+--------------------------------------+
   | Field                     | Value                                |
   +---------------------------+--------------------------------------+
   | admin_state_up            | UP                                   |
   | id                        | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 |
   | ipv4_address_scope        | None                                 |
   | ipv6_address_scope        | None                                 |
   | l2_adjacency              | True                                 |
   | mtu                       | 1500                                 |
   | name                      | multisegment1                        |
   | port_security_enabled     | True                                 |
   | provider:network_type     | vlan                                 |
   | provider:physical_network | provider1                            |
   | provider:segmentation_id  | 128                                  |
   | revision_number           | 1                                    |
   | router:external           | Internal                             |
   | shared                    | True                                 |
   | status                    | ACTIVE                               |
   | subnets                   |                                      |
   | tags                      | []                                   |
   +---------------------------+--------------------------------------+

2. デフォルトのネットワークセグメントの名前を segment1 に変更します。

   1. セグメント ID を取得します。

      $ openstack network segment list --network multisegment1

      出力例

      +--------------------------------------+----------+--------------------------------------+--------------+---------+
      | ID                                   | Name     | Network                              | Network Type | Segment |
      +--------------------------------------+----------+--------------------------------------+--------------+---------+
      | 43e16869-ad31-48e4-87ce-acf756709e18 | None     | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 | vlan         | 128     |
      +--------------------------------------+----------+--------------------------------------+--------------+---------+

   2. セグメント ID を使用して、ネットワークセグメントの名前を segment1 に変更します。

      $ openstack network segment set --name segment1 43e16869-ad31-48e4-87ce-acf756709e18

3. プロバイダーネットワーク上に 2 番目のセグメントを作成します。

   以下の例では、ネットワークセグメントは provider2 という名前の物理ネットワークおよび ID が 129 の VLAN を使用します。

   例

   $ openstack network segment create --physical-network provider2 \
     --network-type vlan --segment 129 --network multisegment1 segment2

   出力例

   +------------------+--------------------------------------+
   | Field            | Value                                |
   +------------------+--------------------------------------+
   | description      | None                                 |
   | headers          |                                      |
   | id               | 053b7925-9a89-4489-9992-e164c8cc8763 |
   | name             | segment2                             |
   | network_id       | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 |
   | network_type     | vlan                                 |
   | physical_network | provider2                            |
   | revision_number  | 1                                    |
   | segmentation_id  | 129                                  |
   | tags             | []                                   |
   +------------------+--------------------------------------+

4. ネットワークに segment1 および segment2 のセグメントが含まれていることを確認します。

   $ openstack network segment list --network multisegment1

   出力例

   +--------------------------------------+----------+--------------------------------------+--------------+---------+
   | ID                                   | Name     | Network                              | Network Type | Segment |
   +--------------------------------------+----------+--------------------------------------+--------------+---------+
   | 053b7925-9a89-4489-9992-e164c8cc8763 | segment2 | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 | vlan         | 129     |
   | 43e16869-ad31-48e4-87ce-acf756709e18 | segment1 | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 | vlan         | 128     |
   +--------------------------------------+----------+--------------------------------------+--------------+---------+

5. segment1 セグメント上に、IPv4 サブネットおよび IPv6 サブネットをそれぞれ 1 つ作成します。

   以下の例では、IPv4 サブネットは 203.0.113.0/24 を使用します。

   例

   $ openstack subnet create \
     --network multisegment1 --network-segment segment1 \
     --ip-version 4 --subnet-range 203.0.113.0/24 \
     multisegment1-segment1-v4

   出力例

   +-------------------+--------------------------------------+
   | Field             | Value                                |
   +-------------------+--------------------------------------+
   | allocation_pools  | 203.0.113.2-203.0.113.254            |
   | cidr              | 203.0.113.0/24                       |
   | enable_dhcp       | True                                 |
   | gateway_ip        | 203.0.113.1                          |
   | id                | c428797a-6f8e-4cb1-b394-c404318a2762 |
   | ip_version        | 4                                    |
   | name              | multisegment1-segment1-v4            |
   | network_id        | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 |
   | revision_number   | 1                                    |
   | segment_id        | 43e16869-ad31-48e4-87ce-acf756709e18 |
   | tags              | []                                   |
   +-------------------+--------------------------------------+

   以下の例では、IPv6 サブネットは fd00:203:0:113::/64 を使用します。

   例

   $ openstack subnet create \
     --network multisegment1 --network-segment segment1 \
     --ip-version 6 --subnet-range fd00:203:0:113::/64 \
     --ipv6-address-mode slaac multisegment1-segment1-v6

   出力例

   +-------------------+------------------------------------------------------+
   | Field             | Value                                                |
   +-------------------+------------------------------------------------------+
   | allocation_pools  | fd00:203:0:113::2-fd00:203:0:113:ffff:ffff:ffff:ffff |
   | cidr              | fd00:203:0:113::/64                                  |
   | enable_dhcp       | True                                                 |
   | gateway_ip        | fd00:203:0:113::1                                    |
   | id                | e41cb069-9902-4c01-9e1c-268c8252256a                 |
   | ip_version        | 6                                                    |
   | ipv6_address_mode | slaac                                                |
   | ipv6_ra_mode      | None                                                 |
   | name              | multisegment1-segment1-v6                            |
   | network_id        | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9                 |
   | revision_number   | 1                                    |
   | segment_id        | 43e16869-ad31-48e4-87ce-acf756709e18                 |
   | tags              | []                                                   |
   +-------------------+------------------------------------------------------+

   注記

   デフォルトでは、プロバイダーネットワーク上の IPv6 サブネットは、ステートレスアドレス自動設定 (SLAAC) およびルーター広告の物理ネットワークインフラストラクチャーに基づきます。

6. segment2 セグメント上に、IPv4 サブネットおよび IPv6 サブネットをそれぞれ 1 つ作成します。

   以下の例では、IPv4 サブネットは 198.51.100.0/24 を使用します。

   例

   $ openstack subnet create \
     --network multisegment1 --network-segment segment2 \
     --ip-version 4 --subnet-range 198.51.100.0/24 \
     multisegment1-segment2-v4

   出力例

   +-------------------+--------------------------------------+
   | Field             | Value                                |
   +-------------------+--------------------------------------+
   | allocation_pools  | 198.51.100.2-198.51.100.254          |
   | cidr              | 198.51.100.0/24                      |
   | enable_dhcp       | True                                 |
   | gateway_ip        | 198.51.100.1                         |
   | id                | 242755c2-f5fd-4e7d-bd7a-342ca95e50b2 |
   | ip_version        | 4                                    |
   | name              | multisegment1-segment2-v4            |
   | network_id        | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 |
   | revision_number   | 1                                    |
   | segment_id        | 053b7925-9a89-4489-9992-e164c8cc8763 |
   | tags              | []                                   |
   +-------------------+--------------------------------------+

   以下の例では、IPv6 サブネットは fd00:198:51:100::/64 を使用します。

   例

   $ openstack subnet create \
     --network multisegment1 --network-segment segment2 \
     --ip-version 6 --subnet-range fd00:198:51:100::/64 \
     --ipv6-address-mode slaac multisegment1-segment2-v6

   出力例

   +-------------------+--------------------------------------------------------+
   | Field             | Value                                                  |
   +-------------------+--------------------------------------------------------+
   | allocation_pools  | fd00:198:51:100::2-fd00:198:51:100:ffff:ffff:ffff:ffff |
   | cidr              | fd00:198:51:100::/64                                   |
   | enable_dhcp       | True                                                   |
   | gateway_ip        | fd00:198:51:100::1                                     |
   | id                | b884c40e-9cfe-4d1b-a085-0a15488e9441                   |
   | ip_version        | 6                                                      |
   | ipv6_address_mode | slaac                                                  |
   | ipv6_ra_mode      | None                                                   |
   | name              | multisegment1-segment2-v6                              |
   | network_id        | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9                   |
   | revision_number   | 1                                                      |
   | segment_id        | 053b7925-9a89-4489-9992-e164c8cc8763                   |
   | tags              | []                                                     |
   +-------------------+--------------------------------------------------------+

検証

1. それぞれの IPv4 サブネットが少なくとも 1 つの DHCP エージェントと関連付けられていることを確認します。

   $ openstack network agent list --agent-type dhcp --network multisegment1

   出力例

   +--------------------------------------+------------+-------------+-------------------+-------+-------+--------------------+
   | ID                                   | Agent Type | Host        | Availability Zone | Alive | State | Binary             |
   +--------------------------------------+------------+-------------+-------------------+-------+-------+--------------------+
   | c904ed10-922c-4c1a-84fd-d928abaf8f55 | DHCP agent | compute0001 | nova              | :-)   | UP    | neutron-dhcp-agent |
   | e0b22cc0-d2a6-4f1c-b17c-27558e20b454 | DHCP agent | compute0101 | nova              | :-)   | UP    | neutron-dhcp-agent |
   +--------------------------------------+------------+-------------+-------------------+-------+-------+--------------------+

2. Compute サービスの配置 API の各セグメントの IPv4 サブネットにインベントリーが作成されたことを確認します。

   すべてのセグメント ID に対して、以下のコマンドを実行します。

   $ SEGMENT_ID=053b7925-9a89-4489-9992-e164c8cc8763
   $ openstack resource provider inventory list $SEGMENT_ID

   出力例

   この出力例では、セグメントのうち 1 つだけが表示されています。

   +----------------+------------------+----------+----------+-----------+----------+-------+
   | resource_class | allocation_ratio | max_unit | reserved | step_size | min_unit | total |
   +----------------+------------------+----------+----------+-----------+----------+-------+
   | IPV4_ADDRESS   |              1.0 |        1 |        2 |         1 |        1 |    30 |
   +----------------+------------------+----------+----------+-----------+----------+-------+

3. Compute サービスの各セグメントにホストアグリゲートが作成されたことを確認します。

   $ openstack aggregate list

   出力例

   以下の例では、1 つのセグメントだけが示されています。

   +----+---------------------------------------------------------+-------------------+
   | Id | Name                                                    | Availability Zone |
   +----+---------------------------------------------------------+-------------------+
   | 10 | Neutron segment id 053b7925-9a89-4489-9992-e164c8cc8763 | None              |
   +----+---------------------------------------------------------+-------------------+

4. 1 つまたは複数のインスタンスを起動します。それぞれのインスタンスは、特定のコンピュートノードで使用するセグメントに従って IP アドレスを取得します。

   注記

   ユーザーがポート作成要求で Fixed IP を指定すると、その特定の IP が直ちにポートに割り当てられます。ただし、ポートを作成してインスタンスに渡した際の動作は、従来のネットワークとは異なります。ポート作成要求で Fixed IP が指定されていない場合、特定のコンピュートノードが明確になるまで Networking サービスは IP アドレスをポートに割り当てません。たとえば、以下のコマンドを実行した場合:

   $ openstack port create --network multisegment1 port1

   出力例

   +-----------------------+--------------------------------------+
   | Field                 | Value                                |
   +-----------------------+--------------------------------------+
   | admin_state_up        | UP                                   |
   | binding_vnic_type     | normal                               |
   | id                    | 6181fb47-7a74-4add-9b6b-f9837c1c90c4 |
   | ip_allocation         | deferred                             |
   | mac_address           | fa:16:3e:34:de:9b                    |
   | name                  | port1                                |
   | network_id            | 6ab19caa-dda9-4b3d-abc4-5b8f435b98d9 |
   | port_security_enabled | True                                 |
   | revision_number       | 1                                    |
   | security_groups       | e4fcef0d-e2c5-40c3-a385-9c33ac9289c5 |
   | status                | DOWN                                 |
   | tags                  | []                                   |
   +-----------------------+--------------------------------------+

手順

1. 移行されるネットワークについて、現在のネットワークセグメントの ID を取得します。

   例

   $ openstack network segment list --network my_network

   出力例

   +--------------------------------------+------+--------------------------------------+--------------+---------+
   | ID                                   | Name | Network                              | Network Type | Segment |
   +--------------------------------------+------+--------------------------------------+--------------+---------+
   | 81e5453d-4c9f-43a5-8ddf-feaf3937e8c7 | None | 45e84575-2918-471c-95c0-018b961a2984 | flat         | None    |
   +--------------------------------------+------+--------------------------------------+--------------+---------+

2. 移行されるネットワークについて、現在のサブネットの ID を取得します。

   例

   $ openstack network segment list --network my_network

   出力例

   +--------------------------------------+-----------+--------------------------------------+---------------+
   | ID                                   | Name      | Network                              | Subnet        |
   +--------------------------------------+-----------+--------------------------------------+---------------+
   | 71d931d2-0328-46ae-93bc-126caf794307 | my_subnet | 45e84575-2918-471c-95c0-018b961a2984 | 172.24.4.0/24 |
   +--------------------------------------+-----------+--------------------------------------+---------------+

3. サブネットの現在の segment_id の値が None であることを確認します。

   例

   $ openstack subnet show my_subnet --c segment_id

   出力例

   +------------+-------+
   | Field      | Value |
   +------------+-------+
   | segment_id | None  |
   +------------+-------+

4. サブネットの segment_id の値をネットワークセグメント ID に変更します。

   以下に例を示します。

   $ openstack subnet set --network-segment 81e5453d-4c9f-43a5-8ddf-feaf3937e8c7 my_subnet

手順

1. アンダークラウドに stack ユーザーとしてログインし、source コマンドで stackrc ファイルを読み込み、director コマンドラインツールを有効にします。

   例

   $ source ~/stackrc

2. カスタム YAML 環境ファイルを作成します。

   例

   $ vi /home/stack/templates/my-neutron-environment.yaml

   ヒント

   Red Hat OpenStack Platform Orchestration サービス (heat) は、テンプレート と呼ばれるプランのセットを使用して環境をインストールおよび設定します。カスタム環境ファイル を使用して、オーバークラウドの要素をカスタマイズすることができます。このファイルは、heat テンプレートをカスタマイズするための特別な種別のテンプレートです。

3. YAML 環境ファイルで、実際のサイトに固有の値と共に ha_vrrp_advert_int 引数を使用して VRRP 広告の間隔を増やします。(デフォルトは 2 秒です)。

   Gratuitous ARP メッセージに値を設定することもできます。

   ha_vrrp_garp_master_repeat

   マスター状態への移行後に一度に送信する Gratuitous ARP メッセージの数。(デフォルトのメッセージ数は 5 です。)

   ha_vrrp_garp_master_delay

   優先順位の低い広告がマスター状態で受信された後、2 番目の Gratuitous ARP メッセージセットの遅延。(デフォルトは 5 秒です。)

   例

   parameter_defaults:
     ControllerExtraConfig:
       neutron::agents::l3::ha_vrrp_advert_int: 7
       neutron::config::l3_agent_config:
         DEFAULT/ha_vrrp_garp_master_repeat:
           value: 5
         DEFAULT/ha_vrrp_garp_master_delay:
           value: 5

4. コア heat テンプレート、環境ファイル、およびこの新しいカスタム環境ファイルを指定して、openstack overcloud deploy コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-neutron-environment.yaml

手順

1. アンダークラウドに stack ユーザーとしてログインし、source コマンドで stackrc ファイルを読み込み、director コマンドラインツールを有効にします。

   例

   $ source ~/stackrc

2. カスタム YAML 環境ファイル (my-neutron-environment.yaml) を作成します。

   注記

   丸かっこ内の値は、この手順のコマンド例で使用されるサンプルの値です。これらのサンプル値を、実際のサイトに適した値に置き換えてください。

   例

   $ vi /home/stack/templates/my-neutron-environment.yaml

   ヒント

   アンダークラウドには、オーバークラウドの作成プランを形作るさまざまな Orchestration サービスのテンプレートが含まれます。YAML フォーマットの環境ファイルを使用して、オーバークラウドの特性をカスタマイズすることができます。このファイルで、Orchestration サービスのコアテンプレートコレクションのパラメーターおよびリソースを上書きします。必要に応じていくつでも環境ファイルを追加することができます。

3. 環境ファイルに parameter_defaults セクションを追加します。このセクションで、ポートエクステンション用 dns_domain dns_domain_ports を追加します。

   例

   parameter_defaults:
     NeutronPluginExtensions: "qos,port_security,dns_domain_ports"

   注記

   dns_domain_ports を設定する場合は、デプロイメントで DNS Integration エクステンション dns_domain も使用しないようにしてください。これらのエクステンションは互換性がなく、両方のエクステンションを同時に定義することはできません。

4. また、parameter_defaults セクションで、NeutronDnsDomain パラメーターを使用してドメイン名 (example.com) を追加します。

   例

   parameter_defaults:
       NeutronPluginExtensions: "qos,port_security,dns_domain_ports"
       NeutronDnsDomain: "example.com"

5. コア Orchestration テンプレート、環境ファイル、およびこの新しい環境ファイルを指定して、openstack overcloud deploy コマンドを実行します。

   重要

   後で実行される環境ファイルで定義されているパラメーターとリソースが優先されることになるため、環境ファイルの順序は重要となります。

   例

   $ openstack overcloud deploy --templates \
   -e [your-environment-files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/services/my-neutron-environment.yaml

検証

1. オーバークラウドにログインし、ネットワーク (public) に新しいポート (new_port) を作成します。DNS 名 (my_port) をポートに割り当てます。

   例

   $ source ~/overcloudrc
   $ openstack port create --network public --dns-name my_port new_port

2. ポート (new_port) の詳細を表示します。

   例

   $ openstack port show -c dns_assignment -c dns_domain -c dns_name -c name new_port

   出力

   +-------------------------+----------------------------------------------+
   | Field                   | Value                                        |
   +-------------------------+----------------------------------------------+
   | dns_assignment          | fqdn='my_port.example.com',                  |
   |                         | hostname='my_port',                          |
   |                         | ip_address='10.65.176.113'                   |
   | dns_domain              | example.com                                  |
   | dns_name                | my_port                                      |
   | name                    | new_port                                     |
   +-------------------------+----------------------------------------------+

   dns_assignment セクションにおいて、ポートの完全修飾ドメイン名 (fqdn) 値には、DNS 名 (my_port) と、前のステップで NeutronDnsDomain で設定したドメイン名 (example.com) の連結が含まれています。

3. 作成したポート (new_port) を使用して、新しい仮想マシンインスタンス (my_vm) を作成します。

   例

   $ openstack server create --image rhel --flavor m1.small --port new_port my_vm

4. ポート (new_port) の詳細を表示します。

   例

   $ openstack port show -c dns_assignment -c dns_domain -c dns_name -c name new_port

   出力

   +-------------------------+----------------------------------------------+
   | Field                   | Value                                        |
   +-------------------------+----------------------------------------------+
   | dns_assignment          | fqdn='my_vm.example.com',                    |
   |                         | hostname='my_vm',                            |
   |                         | ip_address='10.65.176.113'                   |
   | dns_domain              | example.com                                  |
   | dns_name                | my_vm                                        |
   | name                    | new_port                                     |
   +-------------------------+----------------------------------------------+

   Compute サービスは、dns_name 属性を元の値 (my_port) からポートが関連付けられたインスタンスの名前 (my_vm) に変更します。