2.5. マルチパス設定

手順

1. オーバークラウドを設定します。

   注記

   詳細は、director のインストールと使用方法 の CLI ツールを使用した基本的なオーバークラウドの設定 を参照してください。

2. heat テンプレートを更新してマルチパスを有効にします。

   parameter_defaults:
     NovaLibvirtVolumeUseMultipath:  true
     NovaComputeOptVolumes:
       - /etc/multipath.conf:/etc/multipath.conf:ro
       - /etc/multipath/:/etc/multipath/:rw
     CinderVolumeOptVolumes:
       - /etc/multipath.conf:/etc/multipath.conf:ro
       - /etc/multipath/:/etc/multipath/:rw

   Copy to Clipboard Toggle word wrap

3. (オプション) Block Storage (cinder) を Image サービス (glance) のバックエンドとして使用する場合には、以下の手順も完了する必要があります。

   1. 次の GlanceApiOptVolumes 設定をヒートテンプレートに追加します。

      parameter_defaults:
        GlanceApiOptVolumes:
          - /etc/multipath.conf:/etc/multipath.conf:ro
          - /etc/multipath/:/etc/multipath/:rw

      Copy to Clipboard Toggle word wrap

   2. 次の方法で ControllerExtraConfig パラメーターを設定します。

      parameter_defaults:
        ControllerExtraConfig:
          glance::config::api_config:
            default_backend/cinder_use_multipath:
              value: true

      Copy to Clipboard Toggle word wrap

      注記

      default_backend と GlanceBackendID ヒートテンプレートのデフォルト値の両方が一致していることを確認してください。

4. 設定したすべてのバックエンドについて、use_multipath_for_image_xfer を true に設定します。

   parameter_defaults:
     ExtraConfig:
       cinder::config::cinder_config:
         <backend>/use_multipath_for_image_xfer:
           value: true

   Copy to Clipboard Toggle word wrap

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

   $ openstack overcloud deploy

   Copy to Clipboard Toggle word wrap
   注記

   オーバークラウドパラメーターを使用してオーバークラウドを作成する方法は、director のインストールと使用方法の CLI ツールを使用した基本的なオーバークラウドの設定 を参照してください。

6. コンテナーを実行する前に、すべてのコントローラーノードおよびコンピュートノードにマルチパスをインストールします。

   $ sudo dnf install -y device-mapper-multipath

   Copy to Clipboard Toggle word wrap
   注記

   director にはフックのセットが用意されており、初回のブートが完了してコア設定が開始する前に、特定ノードロールのカスタム設定を行うことができます。オーバークラウドのカスタム設定についての詳しい情報は、オーバークラウドの高度なカスタマイズの 事前設定: 特定のオーバークラウドロールのカスタマイズ を参照してください。

7. すべてのコントローラーノードおよびコンピュートノードでマルチパスデーモンを設定します。

   $ mpathconf --enable --with_multipathd y --user_friendly_names n --find_multipaths y

   Copy to Clipboard Toggle word wrap
   注記

   このコード例により、ほとんどの環境で機能する基本的なマルチパス設定が作成されます。ただし、一部のストレージベンダーはハードウェア固有の最適化した設定を使用しているので、ベンダーに推奨事項を問い合わせてください。マルチパスについての詳細は、Device Mapper Multipath の設定 を参照してください。

8. すべてのコントローラーノードおよびコンピュートノードで以下のコマンドを実行して、パーティションが作成されないようにします。

   $ sed -i "s/^defaults {/defaults {\n\tskip_kpartx yes\n\trecheck_wwid yes/" /etc/multipath.conf

   Copy to Clipboard Toggle word wrap
   注記

   skip_kpartx を yes に設定すると、コンピュートノード上の kpartx がデバイス上に自動的にパーティションを作成しなくなり、不要なデバイスマッパーエントリーを避けることができます。設定属性の詳細は、Device Mapper Multipath の設定の DM Multipath 設定ファイルの編集 を参照してください。

9. すべてのコントローラーノードおよびコンピュートノードでマルチパスデーモンを起動します。

   $ systemctl enable --now multipathd

   Copy to Clipboard Toggle word wrap

手順

1. すべてのコントローラーノードおよびコンピュートノードにマルチパスがインストールされていることを確認します。

   $ rpm -qa | grep device-mapper-multipath
   
   device-mapper-multipath-0.4.9-127.el8.x86_64
   device-mapper-multipath-libs-0.4.9-127.el8.x86_64

   Copy to Clipboard Toggle word wrap

   マルチパスがインストールされていない場合は、すべてのコントローラーノードおよびコンピュートノードにインストールします。

   $ sudo dnf install -y device-mapper-multipath

   Copy to Clipboard Toggle word wrap

2. すべてのコントローラーノードおよびコンピュートノードでマルチパスデーモンを設定します。

   $ mpathconf --enable --with_multipathd y --user_friendly_names n --find_multipaths y

   Copy to Clipboard Toggle word wrap
   注記

   このコード例により、ほとんどの環境で機能する基本的なマルチパス設定が作成されます。ただし、一部のストレージベンダーはハードウェア固有の最適化した設定を使用しているので、ベンダーに推奨事項を問い合わせてください。マルチパスについての詳細は、Device Mapper Multipath の設定 を参照してください。

3. すべてのコントローラーノードおよびコンピュートノードで以下のコマンドを実行して、パーティションが作成されないようにします。

   $ sed -i "s/^defaults {/defaults {\n\tskip_kpartx yes\n\trecheck_wwid yes/" /etc/multipath.conf

   Copy to Clipboard Toggle word wrap
   注記

   skip_kpartx を yes に設定すると、コンピュートノード上の kpartx がデバイス上に自動的にパーティションを作成しなくなり、不要なデバイスマッパーエントリーを避けることができます。設定属性の詳細は、Device Mapper Multipath の設定の DM Multipath 設定ファイルの編集 を参照してください。

4. すべてのコントローラーノードおよびコンピュートノードでマルチパスデーモンを起動します。

   $ systemctl enable --now multipathd

   Copy to Clipboard Toggle word wrap

5. heat テンプレートを更新してマルチパスを有効にします。

   parameter_defaults:
     NovaLibvirtVolumeUseMultipath:  true
     NovaComputeOptVolumes:
       - /etc/multipath.conf:/etc/multipath.conf:ro
       - /etc/multipath/:/etc/multipath/:rw
     CinderVolumeOptVolumes:
       - /etc/multipath.conf:/etc/multipath.conf:ro
       - /etc/multipath/:/etc/multipath/:rw

   Copy to Clipboard Toggle word wrap

6. (オプション) Block Storage (cinder) を Image サービス (glance) のバックエンドとして使用する場合には、以下の手順も完了する必要があります。

   1. 次の GlanceApiOptVolumes 設定をヒートテンプレートに追加します。

      parameter_defaults:
        GlanceApiOptVolumes:
          - /etc/multipath.conf:/etc/multipath.conf:ro
          - /etc/multipath/:/etc/multipath/:rw

      Copy to Clipboard Toggle word wrap

   2. 次の方法で ControllerExtraConfig パラメーターを設定します。

      parameter_defaults:
        ControllerExtraConfig:
          glance::config::api_config:
            default_backend/cinder_use_multipath:
              value: true

      Copy to Clipboard Toggle word wrap

      注記

      default_backend と GlanceBackendID ヒートテンプレートのデフォルト値の両方が一致していることを確認してください。

7. 設定したすべてのバックエンドについて、use_multipath_for_image_xfer を true に設定します。

   parameter_defaults:
     ExtraConfig:
       cinder::config::cinder_config:
         <backend>/use_multipath_for_image_xfer:
           value: true

   Copy to Clipboard Toggle word wrap

8. 以下のコマンドを実行してオーバークラウドを更新します。

   $ openstack overcloud deploy

   Copy to Clipboard Toggle word wrap
   注記

   openstack overcloud deploy コマンドを実行してマルチパスをインストールおよび設定する場合、--templates、--roles-file、-e (すべての環境ファイル用)、および --timeout など、オーバークラウドのデプロイに使用した以前のロールファイルおよび環境ファイルをすべて渡す必要があります。以前のロールファイルおよび環境ファイルをすべて渡さないと、オーバークラウドのデプロイメントで問題が発生する可能性があります。オーバークラウドパラメーターの使用についての詳細は、director のインストールと使用方法の CLI ツールを使用した基本的なオーバークラウドの設定 を参照してください。

手順

1. 仮想マシンを作成します。
2. 暗号化されていないボリュームを仮想マシンに割り当てます。

3. インスタンスが含まれるコンピュートノードの名前を取得します。

   $ nova show INSTANCE | grep OS-EXT-SRV-ATTR:host

   Copy to Clipboard Toggle word wrap

   INSTANCE をブートした仮想マシンの名前に置き換えます。

4. インスタンスの virsh 名を取得します。

   $ nova show INSTANCE | grep instance_name

   Copy to Clipboard Toggle word wrap

   INSTANCE をブートした仮想マシンの名前に置き換えます。

5. コンピュートノードの IP アドレスを取得します。

   $ . stackrc
   $ nova list | grep compute_name

   Copy to Clipboard Toggle word wrap

   compute_name を nova show INSTANCE コマンドの出力に表示される名前に置き換えます。

6. 仮想マシンを実行するコンピュートノードに SSH 接続します。

   $ ssh heat-admin@COMPUTE_NODE_IP

   Copy to Clipboard Toggle word wrap

   COMPUTE_NODE_IP をコンピュートノードの IP アドレスに置き換えます。

7. virsh を実行するコンテナーにログインします。

   $ podman exec -it nova_libvirt /bin/bash

   Copy to Clipboard Toggle word wrap

8. コンピュートノードインスタンスで以下のコマンドを入力し、cinder ボリュームホストの場所でマルチパスが使用されていることを確認します。

   virsh domblklist VIRSH_INSTANCE_NAME | grep /dev/dm

   Copy to Clipboard Toggle word wrap

   VIRSH_INSTANCE_NAME を nova show INSTANCE | grep instance_name コマンドの出力に置き換えます。

   インスタンスに /dev/dm- 以外の値が表示されている場合、接続は非マルチパスであるため、nova shelve および nova unshelve コマンドを使用して接続情報を更新する必要があります。

   $ nova shelve <instance>
   $ nova unshelve <instance>

   Copy to Clipboard Toggle word wrap
   注記

   複数の種別のバックエンドがある場合には、すべてのバックエンド上のインスタンスおよびボリュームを検証する必要があります。これは、各バックエンドが返す接続情報が異なる可能性があるためです。