手順

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

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

   [stack@director ~]$ source ~/stackrc

3. /home/stack/templates/nic-configs/controller.yaml ファイルを変更して、コントローラーノード eth1 のプロビジョニングネットワークインターフェイスを再利用し、ベアメタルネットワークのブリッジを作成します。

   network_config:
   - type: ovs_bridge
     name: br-baremetal
     use_dhcp: false
     members:
       - type: interface
         name: eth1
     addresses:
       - ip_netmask:
           list_join:
           - /
           - - get_param: ControlPlaneIp
             - get_param: ControlPlaneSubnetCidr

   注記

   プロビジョニングネットワークを再利用してベアメタルネットワークを作成するときに、VLAN タグを付けることはできません。

4. network-environment.yaml ファイルの NeutronBridgeMappings パラメーターに br-baremetal を追加します。

   parameter_defaults:
     NeutronBridgeMappings: datacentre:br-ex,baremetal:br-baremetal

5. network-environment.yaml ファイルの NeutronFlatNetworks パラメーターで指定されたネットワークのリストに baremetal を追加します。

   parameter_defaults:
     NeutronBridgeMappings: datacentre:br-ex,baremetal:br-baremetal
     NeutronFlatNetworks: datacentre,baremetal

手順

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

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

   [stack@director ~]$ source ~/stackrc

3. network_data.yaml ファイルを環境ファイルディレクトリーにコピーします。

   (undercloud) [stack@host01 ~]$ cp /usr/share/openstack-tripleo-heat-templates/network_data.yaml /home/stack/templates/network_data.yaml

4. オーバークラウドプロビジョニング用の新しいネットワークを network_data.yaml ファイルに追加します。

   # custom network for overcloud provisioning
   - name: OcProvisioning
     name_lower: oc_provisioning
     vip: true
     vlan: 205
     ip_subnet: '<ipv4_subnet_address>/<ipv4_mask>'
     allocation_pools: [{'start': '<ipv4_start_address>', 'end': '<ipv4_end_address>'}]

   • <ipv4_subnet_address> を IPv4 サブネットの IPv4 アドレスに置き換えます。
   • <ipv4_mask> を IPv4 サブネットの IPv4 ネットワークマスクに置き換えます。
   • <ipv4_start_address> と <ipv4_end_address> は、アドレス割り当てに使用する IPv4 範囲に置き換えます。

5. 新しい IPv4 プロビジョニングネットワークを使用するには、ServiceNetMap 設定で IronicApiNetwork と IronicNetwork を設定します。

   ServiceNetMap:
     IronicApiNetwork: oc_provisioning
     IronicNetwork: oc_provisioning

6. 新しいネットワークをインターフェイスとして、ローカルコントローラー NIC 設定ファイルに追加します。

   network_config:
   - type: vlan
     vlan_id:
       get_param: OcProvisioningNetworkVlanID
     addresses:
     - ip_netmask:
         get_param: OcProvisioningIpSubnet

7. roles_data.yaml ファイルを環境ファイルディレクトリーにコピーします。

   (undercloud) [stack@host01 ~]$ cp /usr/share/openstack-tripleo-heat-templates/roles_data.yaml /home/stack/templates/roles_data.yaml

8. コントローラーの新しいネットワークを roles_data.yaml ファイルに追加します。

   networks:
     ...
     OcProvisioning:
       subnet: oc_provisioning_subnet

9. IronicInspector サービスがまだ存在しない場合は、roles_data.yaml ファイル内の Ironic ロールに含めます。

   ServicesDefault:
     OS::TripleO::Services::IronicInspector

手順

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

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

   [stack@director ~]$ source ~/stackrc

3. network_data.yaml ファイルを環境ファイルディレクトリーにコピーします。

   (undercloud) [stack@host01 ~]$ cp /usr/share/openstack-tripleo-heat-templates/network_data.yaml /home/stack/templates/network_data.yaml

4. オーバークラウドプロビジョニング用の新しい IPv6 ネットワークを network_data.yaml ファイルに追加します。

   # custom network for IPv6 overcloud provisioning
   - name: OcProvisioningIPv6
     vip: true
     name_lower: oc_provisioning_ipv6
     vlan: 10
     ipv6: true
     ipv6_subnet: '<ipv6_subnet_address>/<ipv6_prefix>'
     ipv6_allocation_pools: [{'start': '<ipv6_start_address>', 'end': '<ipv6_end_address>'}]
     gateway_ipv6: '<ipv6_gw_address>'

   • <ipv6_subnet_address> は、IPv6 サブネットの IPv6 アドレスに置き換えます。
   • <ipv6_prefix> は、IPv6 サブネットの IPv6 ネットワーク接頭辞に置き換えます。
   • <ipv6_start_address> と <ipv6_end_address> は、アドレス割り当てに使用する IPv6 範囲に置き換えます。
   • <ipv6_gw_address> は、ゲートウェイの IPv6 アドレスに置き換えます。

5. 環境ファイルディレクトリーに新しいファイル network_environment_overrides.yaml を作成します。

   $ touch /home/stack/templates/network_environment_overrides.yaml

6. 新しい IPv6 プロビジョニングネットワークを使用するには、network_environment_overrides.yaml ファイルで IronicApiNetwork と IronicNetwork を設定します。

   ServiceNetMap:
     IronicApiNetwork: oc_provisioning_ipv6
     IronicNetwork: oc_provisioning_ipv6

7. IronicIpVersion パラメーターを 6 に設定します。

   parameter_defaults:
     IronicIpVersion: 6

8. RabbitIPv6、MysqlIPv6、および RedisIPv6 の各パラメーターを有効化します。

   parameter_defaults:
     RabbitIPv6: True
     MysqlIPv6: True
     RedisIPv6: True

9. 新しいネットワークをインターフェイスとして、ローカルコントローラー NIC 設定ファイルに追加します。

   network_config:
   - type: vlan
     vlan_id:
       get_param: OcProvisioningIPv6NetworkVlanID
     addresses:
     - ip_netmask:
         get_param: OcProvisioningIPv6IpSubnet

10. roles_data.yaml ファイルを環境ファイルディレクトリーにコピーします。

    (undercloud) [stack@host01 ~]$ cp /usr/share/openstack-tripleo-heat-templates/roles_data.yaml /home/stack/templates/roles_data.yaml

11. コントローラーロールの新しいネットワークを roles_data.yaml ファイルに追加します。

    networks:
      ...
      - OcProvisioningIPv6

12. IronicInspector サービスがまだ存在しない場合は、roles_data.yaml ファイル内の Ironic ロールに含めます。

    ServicesDefault:
      OS::TripleO::Services::IronicInspector

手順

1. デプロイメント用に Bare Metal Provisioning サービスを設定する環境ファイル (例: ironic-overrides.yaml) をローカルディレクトリーに作成します。

2. オプション: プロビジョニングの前およびプロビジョニングの間にベアメタルマシンで実行されるクリーニングのタイプを設定します。

   parameter_defaults:
     IronicCleaningDiskErase: <cleaning_type>

   <cleaning_type> を次のいずれかの値に置き換えます。

   • full: (デフォルト) フルクリーンアップを実行します。
   • metadata: パーティションテーブルのみをクリーンアップします。このタイプの洗浄は、クリーニングプロセスを大幅にスピードアップします。ただし、マルチテナント環境ではデプロイメントのセキュリティーレベルが低くなるため、信頼済みのテナント環境でのみこのオプションを使用します。

3. オプション: デフォルトのドライバーにドライバーを追加します。

   parameter_defaults:
     IronicEnabledHardwareTypes: ipmi,idrac,ilo,[additional_driver_1],...,[additional_driver_n]

   [additional_driver_1] およびオプションで [additional_driver_n] までのすべてのドライバーは、有効にする追加のドライバーに置き換えます。

4. ベアメタルイントロスペクションを有効にするには、次の設定をローカルの Bare Metal Provisioning サービス環境ファイル ironic-overrides.yaml に追加します。

   parameter_defaults:
     IronicInspectorSubnets:
       - ip_range: <ip_range>
     IPAImageURLs: '["http://<ip_address>:<port>/agent.kernel", "http://<ip_address>:<port>/agent.ramdisk"]'
     IronicInspectorInterface: '<baremetal_interface>'

   • <ip_range> を環境の IP 範囲に置き換えます (例: 192.168.0.100,192.168.0.120)。
   • <ip_address>:<port> は、IPA カーネルと RAM ディスクをホストする Web サーバーの IP アドレスとポートに置き換えます。アンダークラウドで使用するのと同じイメージを使用するには、IP アドレスをアンダークラウドの IP アドレスに設定し、ポートを 8088 に設定します。このパラメーターを省略する場合は、各コントローラーノードに代替のパラメーターを含める必要があります。
   • <baremetal_interface> をベアメタルネットワークインターフェイス (br-baremetal など) に置き換えます。

5. 新しいロールとカスタム環境ファイルを他の環境ファイルと一緒にスタックに追加し、オーバークラウドをデプロイします。

   (undercloud)$ openstack overcloud deploy --templates \
     -e [your environment files] \
     -e /home/stack/templates/node-info.yaml \
     -r /home/stack/templates/roles_data.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/network-environment.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/services/<default_ironic_template> \
     -e /usr/share/openstack-tripleo-heat-templates/environments/services/ironic-inspector.yaml \
     -e /home/stack/templates/network_environment_overrides.yaml \
     -n /home/stack/templates/network_data.yaml \
     -e /home/stack/templates/ironic-overrides.yaml

   • デプロイメントのネットワークサービスメカニズムドライバーに応じて、<default_ironic_template> を ironic.yaml または ironic-overcloud.yaml のいずれかに置き換えます。
   注記

   環境ファイルを openstack overcloud deploy コマンドに渡す順序は重要です。これは、後のファイルの設定が優先されるためです。したがって、オーバークラウドで Bare Metal Provisioning を有効にして設定する環境ファイルは、ネットワーク設定ファイルの後にコマンドに渡す必要があります。

   openstack overcloud deploy コマンドの使用の詳細については、Including environment files in an overcloud deployment を参照してください。

Bare Metal Provisioning サービスの追加検証方法:

1. Identity に管理ユーザーとしてアクセスするためのシェルを設定します。

   $ source ~/overcloudrc

2. nova-compute サービスがコントローラーノードで実行中であることを確認します。

   $ openstack compute service list -c Binary -c Host -c Status

3. デフォルトの ironic ドライバーを変更した場合には、必要なドライバーを必ず有効にしてください。

   $ openstack baremetal driver list

4. ironic のエンドポイントがリストされていることを確認します。

   $ openstack catalog list

手順

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

   $ source ~/overcloudrc

2. ベアメタルインスタンスのフレーバーを作成します。

   (overcloud)$ openstack flavor create --id auto \
    --ram <ram_size_mb> --disk <disk_size_gb> \
    --vcpus <no_vcpus> baremetal

   • <ram_size_mb> をベアメタルノードの RAM (MB 単位) に置き換えます。
   • <disk_size_gb> をベアメタルノード上のディスク容量 (GB 単位) に置き換えます。

   • <no_vcpus> をベアメタルノードの CPU 数に置き換えます。

     注記

     これらの属性は、インスタンスのスケジューリングには使用されません。ただし Compute スケジューラーは、ディスク容量を使用してルートパーティションのサイズを決定します。

3. ノードリストを取得して UUID を把握します。

   (overcloud)$ openstack baremetal node list

4. 各ベアメタルノードにカスタムベアメタルリソースクラスのタグを付けます。

   (overcloud)$ openstack baremetal node set \
    --resource-class baremetal.<CUSTOM> <node>

   • <CUSTOM> は、リソースクラスの目的を識別する文字列に置き換えます。たとえば、GPU に設定して、GPU ワークロード用に指定するベアメタルノードにタグを付けるために使用できるカスタム GPU リソースクラスを作成します。
   • <node> をベアメタルノードの ID に置き換えてください。

5. ベアメタルインスタンスのフレーバーをカスタムリソースクラスに関連付けます。

   (overcloud)$ openstack flavor set \
    --property resources:CUSTOM_BAREMETAL_<CUSTOM>=1 \
    baremetal

   ベアメタルノードのリソースクラスに対応するカスタムリソースクラスの名前を指定するには、リソースクラスを大文字に変換し、それぞれの句読点をアンダースコアに置き換え、CUSTOM_ の接頭辞を追加します。

   注記

   フレーバーが要求できるのは、ベアメタルリソースクラスの 1 つのインスタンスだけです。

6. 以下のフレーバー属性を設定して、Compute スケジューラーがインスタンスのスケジューリングにベアメタルフレーバー属性を使用するのを防ぎます。

   (overcloud)$ openstack flavor set \
    --property resources:VCPU=0 \
    --property resources:MEMORY_MB=0 \
    --property resources:DISK_GB=0 baremetal

7. 新規フレーバーの値が正しいことを確認します。

   (overcloud)$ openstack flavor list

1. Nova スケジューラーが Nova API からインスタンスのブート要求を受け取る。
2. Nova スケジューラーが該当するハイパーバイザーを識別し、ターゲットの物理ノードを識別する。
3. Nova Compute マネージャーが選択したハイパーバイザーのリソースを要求する。
4. Nova のブート要求が指定するネットワークインターフェイスに基づき、Nova Compute マネージャーがバインド前のテナント仮想インターフェイス (VIF) を Networking サービスに作成する。

5. Nova Compute が Nova Compute の仮想レイヤーから driver.spawn を呼び出し、必要なすべての情報が含まれる子タスクを作成する。子タスク作成プロセス中に、仮想ドライバーは以下の処理を完了します。

   1. デプロイイメージ、インスタンスの UUID、要求された機能、およびフレーバー属性に関する情報で、ターゲットの ironic ノードを更新する。
   2. ironic API をコールして、ターゲットノードの電源およびデプロイインターフェイスを検証する。
   3. VIF をノードに接続する。それぞれの neutron ポートは、任意の ironic ポートまたはグループにアタッチすることができます。ポートグループはポートに優先します。
   4. コンフィグドライブを生成する。
6. Nova ironic 仮想ドライバーが、Ironic API を使用してベアメタルノードに対応する Ironic Conductor にデプロイ要求を発行する。
7. 仮想インターフェイスが接続され、PXE/TFTP オプションを設定するために Neutron API が DHCP を更新する。
8. ironic ノードのブートインターフェイスが (i)PXE 設定を準備し、デプロイカーネルおよび ramdisk をキャッシュする。
9. ironic ノードの管理インターフェイスがコマンドを発行し、ノードのネットワークブートを有効にする。
10. 必要に応じて、ironic ノードのデプロイインターフェイスがインスタンスイメージ、カーネル、および ramdisk をキャッシュする。
11. ironic ノードの電源インターフェイスがノードに電源投入を指示する。
12. ノードがデプロイ ramdisk を起動する。
13. iSCSI デプロイメントの場合には、Conductor が iSCSI 経由でイメージを物理ノードにコピーする。直接デプロイメントの場合には、デプロイ ramdisk が一時 URL からイメージをダウンロードする。この URL は、Swift API と互換性のあるオブジェクトストアまたは HTTP の URL でなければなりません。
14. ノードのブートインターフェイスがインスタンスイメージを参照するように PXE 設定を切り替え、ramdisk エージェントにノードのソフトパワーオフを指示する。ソフトパワーオフに失敗した場合には、ベアメタルノードの電源は IPMI/BMC により切断されます。
15. デプロイインターフェイスがネットワークインターフェイスにすべてのプロビジョニングポートの削除を指示し、テナントポートをノードにバインドし、ノードの電源を投入する。

手順

1. ベアメタル用のフレーバーで baremetal プロパティーを true に設定します。

   $ openstack flavor set baremetal --property baremetal=true

2. 仮想インスタンスに使用するフレーバーで baremetal プロパティーを false に設定します。

   $ openstack flavor set FLAVOR_NAME --property baremetal=false

3. baremetal-hosts という名前のホストアグリゲートを作成します。

   $ openstack aggregate create --property baremetal=true baremetal-hosts

4. 各コントローラーノードを baremetal-hosts アグリゲートに追加します。

   $ openstack aggregate add host baremetal-hosts HOSTNAME

   注記

   NovaIronic サービスでコンポーザブルロールを作成していた場合には、このサービスがあるノードをすべて baremetal-hosts アグリゲートに追加します。デフォルトでは、NovaIronic サービスがあるのはコントローラーノードのみです。

5. virtual-hosts という名前のホストアグリゲートを作成します。

   $ openstack aggregate create --property baremetal=false virtual-hosts

6. 各コンピュートノードを virtual-hosts アグリゲートに追加します。

   $ openstack aggregate add host virtual-hosts HOSTNAME

7. オーバークラウドのデプロイ時に以下の Compute フィルタースケジューラーを追加していなかった場合には、この時点で _/etc/nova/nova.conf_ の scheduler_default_filters セクションの既存リストに追加します。

   AggregateInstanceExtraSpecsFilter

手順

1. 以下のコマンドを実行して、各ホストの IP アドレスを表示します。

   (undercloud) [stack@host01 ~]$ openstack stack output show overcloud HostsEntry --max-width 80
   
   +--------------+---------------------------------------------------------------+
   | Field        | Value                                                         |
   +--------------+---------------------------------------------------------------+
   | description  | The content that should be appended to your /etc/hosts if you |
   |              | want to get                                                   |
   |              | hostname-based access to the deployed nodes (useful for       |
   |              | testing without                                               |
   |              | setting up a DNS).                                            |
   |              |                                                               |
   | output_key   | HostsEntry                                                    |
   | output_value | 172.17.0.10 overcloud-controller-0.localdomain overcloud-     |
   |              | controller-0                                                  |
   |              | 10.8.145.18 overcloud-controller-0.external.localdomain       |
   |              | overcloud-controller-0.external                               |
   |              | 172.17.0.10 overcloud-controller-0.internalapi.localdomain    |
   |              | overcloud-controller-0.internalapi                            |
   |              | 172.18.0.15 overcloud-controller-0.storage.localdomain        |
   |              | overcloud-controller-0.storage                                |
   |              | 172.21.2.12 overcloud-controller-0.storagemgmt.localdomain    |
   |              | overcloud-controller-0.storagemgmt                            |
   |              | 172.16.0.15 overcloud-controller-0.tenant.localdomain         |
   |              | overcloud-controller-0.tenant                                 |
   |              | 10.8.146.13 overcloud-controller-0.management.localdomain     |
   |              | overcloud-controller-0.management                             |
   |              | 10.8.146.13 overcloud-controller-0.ctlplane.localdomain       |
   |              | overcloud-controller-0.ctlplane                               |
   |              |                                                               |
   |              | 172.17.0.21 overcloud-compute-0.localdomain overcloud-        |
   |              | compute-0                                                     |
   |              | 10.8.146.12 overcloud-compute-0.external.localdomain          |
   |              | overcloud-compute-0.external                                  |
   |              | 172.17.0.21 overcloud-compute-0.internalapi.localdomain       |
   |              | overcloud-compute-0.internalapi                               |
   |              | 172.18.0.20 overcloud-compute-0.storage.localdomain           |
   |              | overcloud-compute-0.storage                                   |
   |              | 10.8.146.12 overcloud-compute-0.storagemgmt.localdomain       |
   |              | overcloud-compute-0.storagemgmt                               |
   |              | 172.16.0.16 overcloud-compute-0.tenant.localdomain overcloud- |
   |              | compute-0.tenant                                              |
   |              | 10.8.146.12 overcloud-compute-0.management.localdomain        |
   |              | overcloud-compute-0.management                                |
   |              | 10.8.146.12 overcloud-compute-0.ctlplane.localdomain          |
   |              | overcloud-compute-0.ctlplane                                  |
   |              |                                                               |
   |              |                                                               |
   |              |                                                               |
   |              |                                                               |
   |              | 10.8.145.16  overcloud.localdomain                            |
   |              | 10.8.146.7  overcloud.ctlplane.localdomain                    |
   |              | 172.17.0.19  overcloud.internalapi.localdomain                |
   |              | 172.18.0.19  overcloud.storage.localdomain                    |
   |              | 172.21.2.16  overcloud.storagemgmt.localdomain                |
   +--------------+---------------------------------------------------------------+

2. 特定のホストに絞り込むには、以下のコマンドを実行します。

   (undercloud) [stack@host01 ~]$ openstack stack output show overcloud HostsEntry -c output_value -f value | grep overcloud-controller-0
   
   172.17.0.12 overcloud-controller-0.localdomain overcloud-controller-0
   10.8.145.18 overcloud-controller-0.external.localdomain overcloud-controller-0.external
   172.17.0.12 overcloud-controller-0.internalapi.localdomain overcloud-controller-0.internalapi
   172.18.0.12 overcloud-controller-0.storage.localdomain overcloud-controller-0.storage
   172.21.2.13 overcloud-controller-0.storagemgmt.localdomain overcloud-controller-0.storagemgmt
   172.16.0.19 overcloud-controller-0.tenant.localdomain overcloud-controller-0.tenant
   10.8.146.13 overcloud-controller-0.management.localdomain overcloud-controller-0.management
   10.8.146.13 overcloud-controller-0.ctlplane.localdomain overcloud-controller-0.ctlplane

3. ホストをベアメタルノードにマッピングするには、以下のコマンドを実行します。

   (undercloud) [stack@host01 ~]$ openstack baremetal node list --fields uuid name instance_info -f json
   [
     {
       "UUID": "c0d2568e-1825-4d34-96ec-f08bbf0ba7ae",
       "Instance Info": {
         "root_gb": "40",
         "display_name": "overcloud-compute-0",
         "image_source": "24a33990-e65a-4235-9620-9243bcff67a2",
         "capabilities": "{\"boot_option\": \"local\"}",
         "memory_mb": "4096",
         "vcpus": "1",
         "local_gb": "557",
         "configdrive": "******",
         "swap_mb": "0",
         "nova_host_id": "host01.lab.local"
       },
       "Name": "host2"
     },
     {
       "UUID": "8c3faec8-bc05-401c-8956-99c40cdea97d",
       "Instance Info": {
         "root_gb": "40",
         "display_name": "overcloud-controller-0",
         "image_source": "24a33990-e65a-4235-9620-9243bcff67a2",
         "capabilities": "{\"boot_option\": \"local\"}",
         "memory_mb": "4096",
         "vcpus": "1",
         "local_gb": "557",
         "configdrive": "******",
         "swap_mb": "0",
         "nova_host_id": "host01.lab.local"
       },
       "Name": "host3"
     }
   ]

手順

1. ベアメタルノードに現在接続されている VIF の ID をリスト表示します。

   $ openstack baremetal node vif list baremetal-0
   +--------------------------------------+
   | ID                                   |
   +--------------------------------------+
   | 4475bc5a-6f6e-466d-bcb6-6c2dce0fba16 |
   +--------------------------------------+

2. VIF がアタッチされた後に、Bare Metal Provisioning サービスは OpenStack Networking サービス内の仮想ポートを実際の物理ポートの MAC アドレスで更新します。このポートアドレスを確認します。

   $ openstack port show 4475bc5a-6f6e-466d-bcb6-6c2dce0fba16 -c mac_address -c fixed_ips
   +-------------+-----------------------------------------------------------------------------+
   | Field       | Value                                                                       |
   +-------------+-----------------------------------------------------------------------------+
   | fixed_ips   | ip_address='192.168.24.9', subnet_id='1d11c677-5946-4733-87c3-23a9e06077aa' |
   | mac_address | 00:2d:28:2f:8d:95                                                           |
   +-------------+-----------------------------------------------------------------------------+

3. baremetal-0 ノードを作成したネットワーク上に新規ポートを作成します。

   $ openstack port create --network baremetal --fixed-ip ip-address=192.168.24.24 baremetal-0-extra

4. インスタンスからポートを削除します。

   $ openstack server remove port overcloud-baremetal-0 4475bc5a-6f6e-466d-bcb6-6c2dce0fba16

5. その IP アドレスがリストには存在しなくなったことを確認します。

   $ openstack server list

6. そのノードに接続されている VIF があるかどうかを確認します。

   $ openstack baremetal node vif list baremetal-0
   $ openstack port list

7. 新規作成されたポートを追加します。

   $ openstack server add port overcloud-baremetal-0 baremetal-0-extra

8. 新しい IP アドレスに新しいポートが表示されることを確認します。

   $ openstack server list
   +--------------------------------------+-------------------------+--------+------------------------+----------------+---------+
   | ID                                   | Name                    | Status | Networks               | Image          | Flavor  |
   +--------------------------------------+-------------------------+--------+------------------------+----------------+---------+
   | 53095a64-1646-4dd1-bbf3-b51cbcc38789 | overcloud-controller-2  | ACTIVE | ctlplane=192.168.24.7  | overcloud-full | control |
   | 3a1bc89c-5d0d-44c7-a569-f2a3b4c73d65 | overcloud-controller-0  | ACTIVE | ctlplane=192.168.24.8  | overcloud-full | control |
   | 6b01531a-f55d-40e9-b3a2-6d02be0b915b | overcloud-controller-1  | ACTIVE | ctlplane=192.168.24.16 | overcloud-full | control |
   | c61cc52b-cc48-4903-a971-073c60f53091 | overcloud-novacompute-0overcloud-baremetal-0 | ACTIVE | ctlplane=192.168.24.24 | overcloud-full | compute |
   +--------------------------------------+-------------------------+--------+------------------------+----------------+---------+

9. VIF ID が新規ポートの UUID であるかどうかを確認します。

   $ openstack baremetal node vif list baremetal-0
   +--------------------------------------+
   | ID                                   |
   +--------------------------------------+
   | 6181c089-7e33-4f1c-b8fe-2523ff431ffc |
   +--------------------------------------+

10. OpenStack Networking ポートの MAC アドレスが更新され、Bare Metal Provisioning サービスポートの中の 1 つと一致しているかどうかを確認します。

    $ openstack port show 6181c089-7e33-4f1c-b8fe-2523ff431ffc -c mac_address -c fixed_ips
    +-------------+------------------------------------------------------------------------------+
    | Field       | Value                                                                        |
    +-------------+------------------------------------------------------------------------------+
    | fixed_ips   | ip_address='192.168.24.24', subnet_id='1d11c677-5946-4733-87c3-23a9e06077aa' |
    | mac_address | 00:2d:28:2f:8d:95                                                            |
    +-------------+------------------------------------------------------------------------------+

11. 新規 IP アドレスを認識するように、ベアメタルノードを再起動します。

    $ openstack server reboot overcloud-baremetal-0

    インターフェイスを接続または切断した後には、ベアメタルの OS は変更されたネットワークインターフェイスを削除/追加/変更します。ポートを置き換える場合、DHCP 要求が新規 IP アドレスを取得しますが、古い DHCP リースがまだ有効なので、多少時間がかかる場合があります。変更を即時に適用するには、ベアメタルホストをリブートします。

手順

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

2. overcloudrc 認証情報ファイルを入手します。

   $ source ~/overcloudrc

3. イントロスペクションコマンドを実行します。

   $ openstack baremetal introspection start [--wait] <NODENAME>

   <NODENAME> は、検査するノードの名前または UUID に置き換えます。

4. イントロスペクションのステータスを確認します。

   $ openstack baremetal introspection status <NODENAME>

   <NODENAME> は、ノードの名前または UUID に置き換えます。

手順

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

2. source コマンドでオーバークラウドの認証情報を読み込みます。

   $ source ~/overcloudrc

3. iscsi_boot 機能を true に、storage-interface を選択したノードの cinder に、それぞれ設定します。

   $ openstack baremetal node set --property capabilities=iscsi_boot:true --storage-interface cinder <NODEID>

   <NODEID> を選択したノードの ID に置き換えてください。

4. ノードの iSCSI コネクターを作成します。

   $ openstack baremetal volume connector create --node <NODEID> --type iqn --connector-id iqn.2010-10.org.openstack.node<NUM>

   各ノードのコネクター ID は一意でなければなりません。この例では、コネクターは iqn.2010-10.org.openstack.node<NUM> です。ここで、<NUM> は各ノードの通し番号です。

前提条件

1. Red Hat Enterprise Linux QCOW2 イメージをダウンロードして、アンダークラウドの /home/stack/ ディレクトリーにコピーします。以下のページから、QCOW2 形式で Red Hat Enterprise Linux KVM イメージをダウンロードすることができます。

   • Red Hat Enterprise Linux 7
   • Red Hat Enterprise Linux 8

手順

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

2. QCOW2 イメージをマウントし、root ユーザーとしてアクセスします。

   1. nbd カーネルモジュールを読み込みます。

      $ sudo modprobe nbd

   2. QCOW イメージを /dev/nbd0 として接続します。

      $ sudo qemu-nbd --connect=/dev/nbd0 <IMAGE>

   3. NBD 上のパーティションを確認します。

      $ sudo fdisk /dev/nbd0 -l

      新しい Red Hat Enterprise Linux QCOW2 イメージには、パーティションが 1 つだけ含まれます。通常、そのパーティションは NBD の /dev/nbd0p1 という名前です。

   4. イメージのマウントポイントを作成します。

      mkdir /tmp/mountpoint

   5. イメージをマウントします。

      sudo mount /dev/nbd0p1 /tmp/mountpoint/

   6. イメージがホストのデバイス情報にアクセスできるように、dev ディレクトリーをマウントします。

      sudo mount -o bind /dev /tmp/mountpoint/dev

   7. ルートディレクトリーをマウントポイントに変更します。

      sudo chroot /tmp/mountpoint /bin/bash

3. イメージ上で iSCSI を設定します。

   注記

   このステップの一部のコマンドにより、以下のエラーが返される場合があります。

   lscpu: cannot open /proc/cpuinfo: No such file or directory

   このエラーは重要ではないので、エラーを無視して構いません。

   1. resolv.conf ファイルを一時的な場所に移動します。

      # mv /etc/resolv.conf /etc/resolv.conf.bak

   2. Red Hat コンテンツ配信ネットワークの DNS 要求を解決するために、一時的な resolv.conf ファイルを作成します。以下の例では、ネームサーバーに 8.8.8.8 を使用しています。

      # echo "nameserver 8.8.8.8" > /etc/resolv.conf

   3. マウントしたイメージを Red Hat コンテンツ配信ネットワークに登録します。

      # subscription-manager register

      コマンドにより要求されたら、ユーザー名およびパスワードを入力します。

   4. Red Hat Enterprise Linux が含まれるサブスクリプションをアタッチします。

      # subscription-manager list --all --available
      # subscription-manager attach --pool <POOLID>

      <POOLID> をサブスクリプションのプール ID に置き換えます。

   5. デフォルトのリポジトリーを無効にします。

      # subscription-manager repos --disable "*"

   6. Red Hat Enterprise Linux リポジトリーを有効にします。

      • Red Hat Enterprise Linux 7:

        # subscription-manager repos --enable "rhel-7-server-rpms"

      • Red Hat Enterprise Linux 8:

        # subscription-manager repos --enable "rhel-8-for-x86_64-baseos-eus-rpms"

   7. iscsi-initiator-utils パッケージをインストールします。

      # yum install -y iscsi-initiator-utils

   8. マウントしたイメージの登録を解除します。

      # subscription-manager unregister

   9. 元の resolv.conf ファイルを復元します。

      # mv /etc/resolv.conf.bak /etc/resolv.conf

   10. マウントされたイメージのカーネルバージョンを確認します。

       # rpm -qa kernel

       たとえば、出力が kernel-3.10.0-1062.el7.x86_64 の場合、カーネルバージョンは 3.10.0-1062.el7.x86_64 になります。次のステップのために、このカーネルバージョンを書き留めておきます。

       注記

       新しい Red Hat Enterprise Linux QCOW2 イメージには、1 つのカーネルバージョンしかインストールされません。複数のカーネルバージョンがインストールされている場合は、最新のものを使用してください。

   11. initramfs イメージに network および iscsi dracut モジュールを追加します。

       # dracut --force --add "network iscsi" /boot/initramfs-<KERNELVERSION>.img <KERNELVERSION>

       <KERNELVERSION> を rpm -qa kernel から取得したバージョン番号に置き換えます。以下の例では、カーネルバージョンに 3.10.0-1062.el7.x86_64 を使用しています。

       # dracut --force --add "network iscsi" /boot/initramfs-3.10.0-1062.el7.x86_64.img 3.10.0-1062.el7.x86_64

   12. マウントされたイメージからホストオペレーティングシステムに戻ります。

       # exit

4. イメージをアンマウントします。

   1. 一時的なマウントポイントから dev ディレクトリーをアンマウントします。

      $ sudo umount /tmp/mountpoint/dev

   2. マウントポイントからイメージをアンマウントします。

      $ sudo umount /tmp/mountpoint

   3. QCOW2 イメージを /dev/nbd0/ から切断します。

      $ sudo qemu-nbd --disconnect /dev/nbd0

5. イメージ上で grub メニュー設定を再ビルドします。

   1. libguestfs-tools パッケージをインストールします。

      $ sudo yum -y install libguestfs-tools

      重要

      アンダークラウドに libguestfs-tools パッケージをインストールする場合は、アンダークラウドの tripleo_iscsid サービスとのポートの競合を避けるために iscsid.socket を無効にします。

      $ sudo systemctl disable --now iscsid.socket

   2. QEMU を直接使用するように libguestfs バックエンドを設定します。

      $ export LIBGUESTFS_BACKEND=direct

   3. イメージ上の grub 設定を更新します。

      $ guestfish -a /tmp/images/{{ dib_image }} -m /dev/sda3 sh "mount /dev/sda2 /boot/efi && rm /boot/grub2/grubenv && /sbin/grub2-mkconfig -o /boot/grub2/grub.cfg && cp /boot/grub2/grub.cfg /boot/efi/EFI/redhat/grub.cfg && grubby --update-kernel=ALL --args=\"rd.iscsi.firmware=1\" && cp /boot/grub2/grubenv /boot/efi/EFI/redhat/grubenv && echo Success"

手順

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

2. iSCSI 対応イメージを glance にアップロードします。

   $ openstack image create --disk-format qcow2 --container-format bare --file rhel-server-7.7-x86_64-kvm.qcow2 rhel-server-7.7-iscsi

3. イメージからボリュームを作成します。

   $ openstack volume create --size 10 --image rhel-server-7.7-iscsi --bootable rhel-test-volume

4. cinder のブートボリュームを使用するベアメタルインスタンスを作成します。

   $ openstack server create --flavor baremetal --volume rhel-test-volume --key default rhel-test

手順

1. /home/stack/templates/ml2-ansible-hosts.yaml を作成し、以下の初期コンテンツを追加します。

   parameter_defaults:
     ML2HostConfigs:

2. ML2HostConfigs パラメーターには、スイッチの詳細情報が含まれる dict 値が必要です。dict の各初期キーは、スイッチの名前です。この値によって、OpenStack Networking (neutron) ML2 設定に特定の ansible:[switchname] セクションが定義されます。各スイッチ名のキーには、実際のスイッチの詳細情報が含まれる個別の dict が必要です。たとえば、スイッチを 3 つ設定する場合、スイッチキーを 3 つ追加します。

   parameter_defaults:
     ML2HostConfigs:
       switch1:
         [SWITCH DETAILS]
       switch2:
         [SWITCH DETAILS]
       switch3:
         [SWITCH DETAILS]

3. 各スイッチには、dict 内に特定のキー値ペアが必要です。

   ansible_network_os

   (必須) スイッチのオペレーティングシステム。選択肢は、junos と eos です。

   重要

   Arista Extensible Operating System (eos) のサポートは、本リリースでは テクノロジープレビュー として提供しているため、Red Hat では全面的にはサポートしていません。これは、テスト用途にのみご利用いただく機能で、実稼働環境にデプロイすべきではありません。テクノロジープレビュー機能についての詳しい情報は、対象範囲の詳細 を参照してください。

   ansible_host

   (必須) スイッチの IP またはホスト名。

   ansible_user

   (必須) Ansible がスイッチにアクセスする際に使用するユーザー。

   ansible_ssh_pass

   (必須) Ansible がスイッチにアクセスするために使用する SSH パスワード。

   mac

   ネットワークデバイスのシャーシ MAC ID。これを使用して、Link Layer Discovery Protocol (LLDP) MAC アドレス値を、ML2HostConfigs 設定で定義されたスイッチ名にマッピングします。この値は、イントロスペクションを使用してポート自動設定を実行する際に必要です。

   manage_vlans

   OpenStack Networking (neutron) が物理デバイス上の VLAN の作成と削除を制御するかどうかを定義するブール型変数。この機能によって、スイッチは各 Neutron ネットワークに対応する ID を持つ VLAN を作成および削除します。スイッチにこれらの VLAN が事前定義されていて、Neutron でスイッチに VLAN を作成したり削除したりする必要がない場合は、このパラメーターを false に設定します。デフォルト値は true です。

4. 以下の例は、全 ML2HostConfigs パラメーターで、これらの値を対応するキーにマッピングする方法を示しています。

   parameter_defaults:
     ML2HostConfigs:
       switch1:
         ansible_network_os: juno
         ansible_host: 10.0.0.1
         ansible_user: ansible
         ansible_ssh_pass: "p@55w0rd!"
         mac: 01:23:45:67:89:AB
         manage_vlans: false

5. /home/stack/templates/ml2-ansible-hosts.yaml ファイルを保存します。

6. オーバークラウドのデプロイメントコマンドの実行時に、-e オプション指定して /usr/share/openstack-tripleo-heat-templates/environments/neutron-ml2-ansible.yaml と /home/stack/templates/ml2-ansible-hosts.yaml ファイルを追加します。以下の例で、これらのファイルの追加方法を説明します。

   $ openstack overcloud deploy --templates \
     ...
     -e /usr/share/openstack-tripleo-heat-templates/environments/neutron-ml2-ansible.yaml \
     -e /home/stack/templates/ml2-ansible-hosts.yaml \
     ...

手順

1. ベアメタルシステムを作成します。

   • アクセスポートを使用するベアメタルシステムを作成するには、以下のコマンドを実行します。

     openstack server create --flavor baremetal --image overcloud-full --key default --network tenant-net test1

   • トランクポートを使用するベアメタルシステムを作成するには、以下のコマンドを実行します。

     openstack server create --flavor baremetal --image overcloud-full --port {primary-port-uuid} --key default test1

1. ironic.conf ファイル内の値を更新します。
2. Bare Metal Provisioning サービスを再起動します。
3. ベアメタルインスタンスを再デプロイします。

デプロイメント時の heat を使用した KernelArgs の変更

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

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

   $ source stackrc

3. 環境ファイル overcloud-console.yaml を作成して、以下の内容を記載します。

   parameter_defaults:
     <role>Parameters:
       KernelArgs: "console=<console-name>"

   <role> を設定するオーバークラウドロールの名前に置き換え、<console-name> を使用するコンソールの ID に置き換えます。たとえば、デフォルトロールのすべてのオーバークラウドノードが tty0 を使用するように設定するには、以下のスニペットを使用します。

   parameter_defaults:
     ControllerParameters:
       KernelArgs: "console=tty0"
     ComputeParameters:
       KernelArgs: "console=tty0"
     BlockStorageParameters:
       KernelArgs: "console=tty0"
     ObjectStorageParameters:
       KernelArgs: "console=tty0"
     CephStorageParameters:
       KernelArgs: "console=tty0"

4. -e オプションを使用して、overcloud-console-tty0.yaml ファイルをデプロイメントコマンドに追加します。

overcloud-full.qcow2 イメージの変更

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

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

   $ source stackrc

3. overcloud-full.qcow2 イメージのカーネル引数を変更して、ハードウェアの正しいコンソールを設定します。たとえば、コンソールを tty0 に設定します。

   $ virt-customize --selinux-relabel -a overcloud-full.qcow2 --run-command 'grubby --update-kernel=ALL --args="console=tty0"'

4. イメージを director にインポートします。

   $ openstack overcloud image upload --image-path /home/stack/images/overcloud-full.qcow2

5. オーバークラウドをデプロイします。

検証

1. アンダークラウドからオーバークラウドノードにログインします。

   $ ssh heat-admin@<IP-address>

   <IP-address> をオーバークラウドノードの IP アドレスに置き換えます。

2. /proc/cmdline ファイルの内容を調べ、console= パラメーターが使用するコンソールの値に設定されていることを確認します。

   [heat-admin@controller-0 ~]$ cat /proc/cmdline
   BOOT_IMAGE=(hd0,msdos2)/boot/vmlinuz-4.18.0-193.29.1.el8_2.x86_64 root=UUID=0ec3dea5-f293-4729-b676-5d38a611ce81 ro console=tty0 console=ttyS0,115200n81 no_timer_check crashkernel=auto rhgb quiet

1. ironic.conf でセンサーメソッドを有効にします。

   $ openstack-config --set /etc/ironic/ironic.conf \
      irmc sensor_method METHOD

   METHOD は scci または ipmitool に置き換えます。

2. SCCI を有効にした場合は、python-scciclient パッケージをインストールします。

   # dnf install python-scciclient

3. Bare Metal Conductor サービスを再起動します。

   # systemctl restart openstack-ironic-conductor.service