Configuring persistent storage

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. 次のコマンドを実行して、Block Storage クラスターのすべてのサービスが実行されているかどうかを確認します。

   $ cinder --os-volume-api-version 3.17 cluster-list --detailed

3. いずれかのサービスが実行されていない場合は、以下のコマンドを実行してそのサービスを特定します。

   $ cinder --os-volume-api-version 3.17 service-list

4. クラスターのメンテナンスをトリガーするには、次のコマンドを実行します。

   $ cinder --os-volume-api-version 3.24 work-cleanup --cluster <cluster_name>

   • <cluster_name> をクラスターの名前に置き換えます。たとえば、tripleo@tripleo_ceph などです。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. cinder-volume のホストを特定します。

   $ cinder service-list

   このコマンドは、各 Block Storage サービス (cinder-backup、cinder-scheduler、および cinder-volume) のホストが含まれるリストを返します。以下に例を示します。

   +------------------+---------------------------+------+---------
   |      Binary      |            Host           | Zone |  Status ...
   +------------------+---------------------------+------+---------
   |  cinder-backup   |   localhost.localdomain   | nova | enabled ...
   | cinder-scheduler |   localhost.localdomain   | nova | enabled ...
   |  cinder-volume   | *localhost.localdomain@lvm* | nova | enabled ...
   +------------------+---------------------------+------+---------

3. ドライバーの機能を表示して、Block Storage サービスでサポートされている追加スペックを特定します。

   $ cinder get-capabilities <volsvchost>

   • <volsvchost> は cinder-volume のホストに置き換えます。以下に例を示します。

     $ cinder get-capabilities localhost.localdomain@lvm
         +---------------------+-----------------------------------------+
         |     Volume stats    |                        Value            |
         +---------------------+-----------------------------------------+
         |     description     |                         None            |
         |     display_name    |                         None            |
         |    driver_version   |                        3.0.0            |
         |      namespace      | OS::Storage::Capabilities::localhost.loc...
         |      pool_name      |                         None            |
         |   storage_protocol  |                        iSCSI            |
         |     vendor_name     |                     Open Source         |
         |      visibility     |                         None            |
         | volume_backend_name |                         lvm             |
         +---------------------+-----------------------------------------+
         +--------------------+------------------------------------------+
         | Backend properties |                        Value             |
         +--------------------+------------------------------------------+
         |    compression     |      {u'type': u'boolean', u'description'...
         |        qos         |              {u'type': u'boolean', u'des ...
         |    replication     |      {u'type': u'boolean', u'description'...
         | thin_provisioning  | {u'type': u'boolean', u'description': u'S...
         +--------------------+------------------------------------------+

     Backend properties のコラムには設定可能な追加スペックキーのリストが、Value のコラムには、Backend properties に対する有効な値が表示されます。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. Create Volume Type をクリックします。
4. Name フィールドにボリューム種別の名前を入力します。
5. Create Volume Type をクリックします。Volume Types の表に新しい種別が表示されます。
6. ボリューム種別の View Extra Specs のアクションを選択します。
7. Create をクリックして Key と Value を指定します。キーと値のペアは有効である必要があります。有効でない場合には、ボリュームの作成時にそのボリューム種別を指定するとエラーが発生してしまいます。たとえば、このボリューム種別のバックエンドを指定するには、volume_backend_name Key を追加し、Value を必要なバックエンドの名前に設定します。
8. Create をクリックします。関連付けられた設定 (キー/値のペア) が Extra Specs の表に表示されます。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. ボリューム種別 の表で、ボリューム種別の 追加スペックの表示 のアクションを選択します。

4. このページの 追加スペック の表では、以下のような操作を行うことができます。

   • ボリューム種別への新規設定の追加。そのためには、作成 をクリックして、ボリューム種別に関連付ける新規設定のキー/値ペアを指定します。
   • ボリューム種別に関連付けられている既存の設定の編集。そのためには、設定の 編集 アクションを選択します。
   • ボリューム種別に関連付けられている既存の設定の削除。そのためには、追加スペックのチェックボックスを選択して、表示中のダイアログ画面と次の画面で 追加スペックの削除 をクリックします。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. 新しい cinder ボリュームタイプを作成し、is-public フラグを false に設定します。

   $ cinder type-create --is-public false <type_name>

   • <type_name> は、この新しいプライベートボリュームタイプに付ける名前に置き換えます。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. プロジェクトのデフォルトのボリュームタイプを定義、クリア、または一覧表示します。

   注記

   これらのコマンドの <project_id> を必要なプロジェクトの ID に置き換える必要があります。各テナントの ID と名前を見つけるには、openstack project list コマンドを実行します。

   • プロジェクトのデフォルトのボリュームタイプを定義するには:

     $ cinder --os-volume-api-version 3.62 default-type-set <volume_type> <project_id>

     • <volume_type> を、必要なボリュームタイプの名前または ID に置き換えます。cinder type-list コマンドを実行して、すべてのボリュームタイプの名前と ID を一覧表示できます。

   • プロジェクトのデフォルトのボリュームタイプをクリアするには:

     $ cinder --os-volume-api-version 3.62 default-type-unset <project_id>

   • プロジェクトのデフォルトのボリュームタイプを一覧表示するには:

     $ cinder --os-volume-api-version 3.62 default-type-list --project <project_id>

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. QoS Specs の表で Create QoS Spec をクリックします。
4. QoS Spec の名前を入力します。
5. Consumer フィールドで、この QoS 仕様のコンシューマーを選択します。詳細は、Consumers of QoS specifications を参照してください。
6. Create をクリックします。新しい QoS 仕様が QoS Specs テーブルに表示されます。
7. QoS Specs テーブルで、新しい QoS 仕様の Manage Specs アクションを選択して Specs ウィンドウを開き、QoS パフォーマンス制限を追加します。
8. Specs ウィンドウで Create をクリックして、Create Extra Specs ウィンドウを開きます。

9. Key フィールドに QoS パフォーマンス制限の QoS プロパティーキーを指定し、Value フィールドにパフォーマンス制限値を設定します。使用可能なプロパティーキーの詳細は、 Block Storage QoS プロパティーキー を参照してください。

   重要

   QoS プロパティーキーのスペルが正しいことを確認してください。スペルが間違っているプロパティーキーを含むボリュームのパフォーマンス制限は無視されます。

10. Create をクリックして、QoS 制限を QoS 仕様に追加します。
11. QoS 仕様に追加する QoS 制限ごとに手順 7 ~ 10 を繰り返します。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. QoS 仕様を作成します。

   $ openstack volume qos create [--consumer <qos_spec_consumer>] <qos_spec_name>

   • オプション: <qos_spec_consumer> を、この QoS 仕様の必要なコンシューマーに置き換えます。指定しない場合、コンシューマーはデフォルトで Both を使用します。詳細は、Consumers of QoS specifications を参照してください。
   • <qos_spec_name> を QoS 仕様の名前に置き換えます。

3. 追加する QoS 制限ごとに個別の --property <key=value> 引数を指定して、QoS 仕様にパフォーマンス制限を追加します。

   $ openstack volume qos set --property <key>=<value> <qos_spec_name>

   • <key> を必要なパフォーマンス制約の QoS プロパティーキーに置き換えます。詳細は、Block Storage QoS プロパティーキー を参照してください。

     重要

     QoS プロパティーキーのスペルが正しいことを確認してください。スペルが間違っているプロパティーキーを含むボリュームのパフォーマンス制限は無視されます。

   • <value> を QoS プロパティーキーで必要な測定単位での、このパフォーマンス制約に対するデプロイメント固有の制限に置き換えます。

   • <qos_spec_name> を QoS 仕様の名前または ID に置き換えます。

     以下に例を示します。

     $ openstack volume qos set \
      --property read_iops_sec=5000 \
      --property write_iops_sec=7000 \
      myqoslimits

4. QoS 仕様を確認してください。

   $ openstack volume qos list
   +--------------------------------------+---------+-----------+--------------+-----------------------------------------------------+
   | ID                                   | Name    | Consumer  | Associations | Properties                                          |
   +--------------------------------------+---------+-----------+--------------+-----------------------------------------------------+
   | 204c6ba2-c67c-4ac8-918a-03f101811235 | myqoslimits | front-end |              | read_iops_sec='5000', write_iops_sec='7000' |
   +--------------------------------------+---------+-----------+--------------+-----------------------------------------------------+

   このコマンドは、設定されているすべての QoS 仕様の設定詳細のテーブルを提供します。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. Volume Types テーブルで、必要なボリュームタイプの Manage QoS Spec Association アクションを選択します。
4. QoS Spec to be associated リストから必要な QoS 仕様を選択します。
5. Associate をクリックします。QoS 仕様が、編集したボリュームタイプの Associated QoS Spec 列に追加されます。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. 必要な QoS 仕様を必要なボリュームタイプに関連付けます。

   $ openstack volume qos associate <qos_spec_name> <volume_type>

   • <qos_spec_name> を QoS 仕様の名前または ID に置き換えます。openstack volume qos list コマンドを実行すると、すべての QoS 仕様の名前と ID をリスト表示できます。
   • <volume_type> をボリュームタイプの名前または ID に置き換えます。cinder type-list コマンドを実行して、すべてのボリュームタイプの名前と ID を一覧表示できます。

3. QoS 仕様が関連付けられていることを確認します。

   $ openstack volume qos list

   出力テーブルの Associations 列には、どのボリュームタイプがこの QoS 仕様に関連付けられているかが表示されます。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. Volume Types テーブルで、必要なボリュームタイプの Manage QoS Spec Association アクションを選択します。
4. QoS Spec to be associated リストから None を選択します。

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

   QoS 仕様は、編集されたボリュームタイプの Associated QoS Spec 列から削除する必要があります。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. QoS 仕様に関連付けられているボリュームタイプの関連付けを解除します。特定のボリュームタイプの関連付けを解除することも、複数のボリュームタイプが同じ QoS 仕様に関連付けられている場合はすべてのボリュームタイプの関連付けを解除することもできます。

   • QoS 仕様に関連付けられた特定のボリュームタイプの関連付けを解除するには、次の手順を実行します。

     $ openstack volume qos disassociate <qos_spec_name> --volume-type <volume_type>

     • <qos_spec_name> を QoS 仕様の名前または ID に置き換えます。openstack volume qos list コマンドを実行すると、すべての QoS 仕様の名前と ID をリスト表示できます。
     • <volume_type> を、この QoS 仕様に関連付けられたボリュームタイプの名前または ID に置き換えます。cinder type-list コマンドを実行して、すべてのボリュームタイプの名前と ID を一覧表示できます。

   • QoS 仕様に関連付けられているすべてのボリュームタイプの関連付けを解除するには、次の手順を実行します。

     $ openstack volume qos disassociate <qos_spec_name> --all

3. QoS 仕様の関連付けが解除されていることを確認します。

   $ openstack volume qos list

   この QoS 仕様の Associations 列は、ボリュームタイプを指定しないか、空にする必要があります。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Admin > Volumes > Volume Types を選択します。
3. 暗号化するボリューム種別の アクション コラムで 暗号化設定の作成 を選択して、ボリューム種別の暗号化設定の作成 ウィザードを開きます。

4. このウィザードで、ボリューム種別の暗号化の プロバイダー、制御場所、暗号、および キーサイズ を設定します。説明 のコラムで各設定について説明されています。

   重要

   プロバイダー、暗号、および キーサイズ のオプションとしてサポートされるは、以下に示す値だけです。

   1. プロバイダー に luks と入力します。
   2. 暗号 に aes-xts-plain64 と入力します。
   3. キーサイズ に 256 と入力します。
5. ボリューム種別の暗号化設定の作成 をクリックします。

1. ボリューム種別の アクション コラムから 暗号化設定の更新 を選択して、ボリューム種別の暗号化設定の更新 ウィザードを開きます。
2. ボリュームが暗号化されているかどうかを判断するには、プロジェクト > コンピュート > ボリューム にある ボリューム テーブルの 暗号化 コラムを確認します。
3. ボリュームが暗号化されている場合には、暗号化のコラムの はい をクリックすると暗号化設定が表示されます。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. ボリューム種別を作成します。

   $ cinder type-create myEncType

3. 暗号、キーサイズ、制御場所、およびプロバイダー設定を定義します。

   $ cinder encryption-type-create --cipher aes-xts-plain64 --key-size 256 --control-location front-end myEncType luks

4. 暗号化されたボリュームを作成します。

   $ cinder --debug create 1 --volume-type myEncType --name myEncVol

手順

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

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 環境ファイルを編集し、parameter_defaults セクションに新しいエントリーを追加します。これにより、openstack overcloud deploy コマンドを使用して環境が再デプロイされるたびに、エントリーがコンテナーで更新され保持されるようになります。

4. CinderApiPolicies を使用して環境ファイルに新規セクションを追加し、整合性グループの設定を定義します。JSON ファイルのデフォルト設定を持つ同等の parameter_defaults セクションは、次のように表示されます。

   parameter_defaults:
     CinderApiPolicies: { \
        cinder-consistencygroup_create: { key: 'consistencygroup:create', value: 'group:nobody' }, \
        cinder-consistencygroup_delete: { key: 'consistencygroup:delete', value: 'group:nobody' },  \
        cinder-consistencygroup_update: { key: 'consistencygroup:update', value: 'group:nobody' }, \
        cinder-consistencygroup_get: { key: 'consistencygroup:get', value: 'group:nobody' }, \
        cinder-consistencygroup_get_all: { key: 'consistencygroup:get_all', value: 'group:nobody' }, \
        cinder-consistencygroup_create_cgsnapshot: { key: 'consistencygroup:create_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_delete_cgsnapshot: { key: 'consistencygroup:delete_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_get_cgsnapshot: { key: 'consistencygroup:get_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_get_all_cgsnapshots: { key: 'consistencygroup:get_all_cgsnapshots', value: 'group:nobody' }, \
    }

5. 値 'group:nobody' は、この機能を使用できるグループがないことを決定するため、効果的に無効になります。これを有効にするには、グループを別の値に変更します。

6. セキュリティーを強化するためには、整合性グループの API とボリューム種別管理の API の両方に、同じアクセス権限を設定します。デフォルトでは、ボリューム種別管理の API は (同じ /etc/cinder/policy.json_ file) で "rule:admin_or_owner" に設定されています。

   "volume_extension:types_manage": "rule:admin_or_owner",

7. 整合性グループの機能をすべてのユーザーが利用できるようにするには、API ポリシーのエントリーを設定して、ユーザーが専用の整合性グループを作成、使用、および管理できるようにします。そのためには、rule:admin_or_owner を使用します。

   CinderApiPolicies: { \
        cinder-consistencygroup_create: { key: 'consistencygroup:create', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_delete: { key: 'consistencygroup:delete', value: 'rule:admin_or_owner' },  \
        cinder-consistencygroup_update: { key: 'consistencygroup:update', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get: { key: 'consistencygroup:get', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_all: { key: 'consistencygroup:get_all', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_create_cgsnapshot: { key: 'consistencygroup:create_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_delete_cgsnapshot: { key: 'consistencygroup:delete_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_cgsnapshot: { key: 'consistencygroup:get_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_all_cgsnapshots: { key: 'consistencygroup:get_all_cgsnapshots', value: 'rule:admin_or_owner’ }, \
    }

8. 更新を環境ファイルに保存します。
9. その他の環境ファイルと共に環境ファイルをスタックに追加して、オーバークラウドをデプロイします。

手順

1. 管理者ユーザーまたはボリューム所有者としてダッシュボードにログインします。
2. Project > Compute > Volumes > Volume Consistency Groups を選択します。
3. 整合性グループの作成 をクリックします。
4. ウィザードの 整合性グループの情報 タブで、整合性グループの名前と説明を入力します。次に アベイラビリティーゾーン を指定します。
5. 整合性グループにボリューム種別を追加することもできます。整合性グループにボリュームを作成する際には、Block Storage サービスにより、これらのボリューム種別から互換性のある設定が適用されます。ボリューム種別を追加するには、利用可能な全ボリューム種別 リストから追加するボリューム種別の + ボタンをクリックします。
6. 整合性グループの作成 をクリックします。次回、作成した整合性グループが ボリュームの整合性グループ テーブルに表示されます。

手順

1. 管理ユーザーとして Dashboard にログインします。
2. Project > Compute > Volumes > Volume Consistency Groups を選択します。
3. (オプション) アクション コラムから 整合性グループの編集 を選択して、整合性グループの名前または説明を変更することができます。

4. 整合性グループにボリュームを直接追加または削除するには、設定する整合性グループを見つけます。その整合性グループの アクション コラムで、ボリュームの管理 を選択します。これにより、整合性グループボリュームの追加/削除 ウィザードが起動します。

   1. 整合性グループにボリュームを追加するには、利用可能な全ボリューム リストから追加するボリュームの + ボタンをクリックします。
   2. 整合性グループからボリュームを削除するには、選択済みのボリューム リストから削除するボリュームの - ボタンをクリックします。
5. 整合性グループの編集 をクリックします。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. 利用可能な整合性グループおよびその ID をすべて表示します。

   $ cinder consisgroup-list

3. 整合性グループを使用してスナップショットを作成します。

   $ cinder cgsnapshot-create [--name <cgsnapname>] [--description "<description>"] <cgnameid>

   • <cgsnapname> は、スナップショットの名前に置き換えます。
   • <description> は、スナップショットの説明に置き換えます。
   • <CGNAMEID> は、整合性グループの名前または ID に置き換えます。

4. 利用可能な整合性グループのスナップショットの全リストを表示します。

   # cinder cgsnapshot-list

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. 既存の整合性グループのクローンを作成するには、以下のコマンドを実行します。

   $ cinder consisgroup-create-from-src --source-cg <cgnameid> [--name <cgname>] [--description "<description>"]

   • <cgnameid> は、複製する整合性グループの名前または ID に置き換えます。
   • <cgname> は、整合性グループの名前に置き換えます。
   • <description> は、整合性グループの説明に置き換えます。

3. 整合性グループのスナップショットから整合性グループを作成するには、以下のコマンドを実行します。

   $ cinder consisgroup-create-from-src --cgsnapshot <cgsnapname> [--name <cgname>] [--description "<description>"]

   • <cgsnapname> は、整合性グループの作成に使用するスナップショットの名前または ID に置き換えてください。

手順

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

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. 上書き環境ファイルを使用するか、multipath_overrides.yaml などの新しい環境ファイルを作成します。以下のパラメーターを追加して設定します。

   parameter_defaults:
     ExtraConfig:
       cinder::config::cinder_config:
         backend_defaults/use_multipath_for_image_xfer:
           value: true

   注記

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

4. オプション: オーバークラウドデプロイメント用のマルチパス設定ファイルがある場合、MultipathdCustomConfigFile パラメーターを使用してこのファイルの場所を指定できます。

   parameter_defaults:
     MultipathdCustomConfigFile: <config_file_directory>/<config_file_name>

   次の例では、/home/stack はマルチパス設定ファイルのディレクトリーで、multipath.conf はこのファイルの名前です。

   parameter_defaults:
     MultipathdCustomConfigFile: /home/stack/multipath.conf

   注記

   他の TripleO マルチパスパラメーターは、ローカルのカスタム設定ファイル内の対応する値を上書きします。たとえば、MultipathdEnableUserFriendlyNames が False の場合、ローカルのカスタムファイルで設定が有効になっている場合でも、オーバークラウドノードのファイルが一致するように更新されます。

   マルチパスパラメーターの詳細は、Multipath heat template parameters を参照してください。

5. 更新をオーバーライド環境ファイルに保存します。

6. オーバーライド環境ファイルを、次のような他の環境ファイルと共にスタックに追加します。

   ----
   /usr/share/openstack-tripleo-heat-templates/environments/multipathd.yaml
   ----

7. オーバークラウドをデプロイする。

手順

1. インスタンスを作成します。
2. 暗号化されていないボリュームをインスタンスにアタッチします。

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

   $ nova show <instance> | grep OS-EXT-SRV-ATTR:host

   <instance> は、作成したインスタンスの名前に置き換えます。

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

   $ nova show <instance> | grep instance_name

5. Compute ノードの IP アドレスを取得します。

   $ . stackrc
   $ metalsmith list | grep <compute_name>

   <compute_name> は、nova show <instance> コマンドの出力からの名前に置き換えて、6 列のテーブルから 2 行を表示します。

   <compute_name> が 4 列目にある行を見つけます。<compute_name> の IP アドレスは、この行の最後の列にあります。

   次の例では、compute-0 は 2 行目の 4 列目にあるため、compute-0 の IP アドレスは 192.02.24.15 です。

   $ . stackrc
   $ metalsmith list | grep compute-0
   | 3b1bf72e-c425-494c-9717-d0b89bb66580 | compute-0    | 95b21d3e-36be-470d-ba5c-70d5dcd6d0b3 | compute-1    | ACTIVE | ctlplane=192.02.24.49 |
   | 72a24883-25f9-435c-bf71-a20e66be172d | compute-1    | a59f79f7-006e-4f38-a9ad-8164da47d58e | compute-0    | ACTIVE | ctlplane=192.02.24.15 |

6. インスタンスを実行する Compute ノードに SSH 接続します。

   $ ssh tripleo-admin@<compute_node_ip>

   <compute_node_ip> は、Compute ノードの IP アドレスに置き換えます。

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

   $ podman exec -it nova_libvirt /bin/bash

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

   virsh domblklist <virsh_instance_name> | grep /dev/dm

   <virsh_instance_name> は、nova show <instance> | grep instance_name コマンドの出力に置き換えます。

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

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

   注記

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

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. マルチ接続ボリューム用の新しいボリューム種別を作成します。

   $ cinder type-create multiattach

3. このマルチ接続ボリューム種別の multiattach プロパティーを有効にします。

   $ cinder type-key multiattach set multiattach="<is> True"

4. バックエンドを指定するには、以下のコマンドを実行します。

   $ cinder type-key multiattach set volume_backend_name=<backend_name>

手順

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

2. 以下のコマンドを実行し、マルチ接続のボリュームを作成します。

   $ cinder create <volume_size> --name <volume_name> --volume-type multiattach

3. 以下のコマンドを実行して、ボリュームがマルチ接続に対応していることを確認します。ボリュームがマルチ接続に対応している場合、multiattach フィールドは True と表示されます。

   $ cinder show <vol_id> | grep multiattach
   
   | multiattach | True |

手順

1. 管理ユーザーまたはボリューム所有者として Dashboard にログインします。
2. Project > Compute > Volumes を選択します。
3. 移行するボリュームの アクション のコラムで、ボリューム種別の変更 を選択します。
4. ボリューム種別の変更 ダイアログで、対象のボリューム種別を選択し、種別 のリストから新しいバックエンドを定義します。
5. 別のバックエンドにボリュームを移行する場合は、移行ポリシー のリストから 要求時 を選択します。詳細は、バックエンド間でのボリュームの移動 を参照してください。
6. ボリューム種別の変更 をクリックして移行を開始します。

手順

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

2. 以下のコマンドを入力してボリューム種別を変更します。

   $ cinder retype <volume name or id> <new volume type name>

3. 種別変更の操作で、あるバックエンドから別のバックエンドにボリュームを移動する必要がある場合は、Block Storage サービスには特定のフラグが必要です。

   $ cinder retype --migration-policy on-demand <volume name or id> <new volume type name>

手順

1. コントローラーノードのいずれかにログインします。

2. 以下のコマンドを実行します。

   [tripleo-admin@overcloud-controller-2 ~]$ sudo podman exec -it -u swift swift_object_server /usr/bin/swift-recon -arqlT --md5
   
   ======================================================================--> Starting reconnaissance on 3 hosts (object)
   ======================================================================[2018-12-14 14:55:47] Checking async pendings
   [async_pending] - No hosts returned valid data.
   ======================================================================[2018-12-14 14:55:47] Checking on replication
   [replication_failure] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_success] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_time] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_attempted] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   Oldest completion was 2018-12-14 14:55:39 (7 seconds ago) by 198.51.100.186:6000.
   Most recent completion was 2018-12-14 14:55:42 (4 seconds ago) by 198.51.100.174:6000.
   ======================================================================[2018-12-14 14:55:47] Checking load averages
   [5m_load_avg] low: 1, high: 2, avg: 2.1, total: 6, Failed: 0.0%, no_result: 0, reported: 3
   [15m_load_avg] low: 2, high: 2, avg: 2.6, total: 7, Failed: 0.0%, no_result: 0, reported: 3
   [1m_load_avg] low: 0, high: 0, avg: 0.8, total: 2, Failed: 0.0%, no_result: 0, reported: 3
   ======================================================================[2018-12-14 14:55:47] Checking ring md5sums
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================[2018-12-14 14:55:47] Checking swift.conf md5sum
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================[2018-12-14 14:55:47] Checking quarantine
   [quarantined_objects] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [quarantined_accounts] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [quarantined_containers] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   ======================================================================[2018-12-14 14:55:47] Checking time-sync
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================

3. (オプション) --all オプションを使用して、追加の出力を返します。

   このコマンドは、リング上のすべてのサーバーに対して、以下のデータのクエリーを実行します。

   • Async pendings: クラスターの負荷が非常に高くプロセスがデータベースファイルを十分な速度で更新できない場合、一部の更新は非同期で行われます。これらの数は徐々に減少します。
   • Replication metrics: レプリケーションのタイムスタンプを確認します。完全なレプリケーションパスは頻繁に行われ、エラーはほとんど発生しません。古いエントリー (例: 6 カ月前のタイムスタンプを持つエントリー) ば、そのノードでのレプリケーションが過去 6 カ月間完了していないことを意味します。
   • Ring md5sums: これにより、すべてのノードですべてのリングファイルの一貫性が確保されます。
   • swift.conf md5sums: これにより、すべてのノードですべての設定ファイルの一貫性が確保されます。
   • Quarantined files: すべてのノードについて、隔離されたファイルがない (あるいは、ほとんどない) はずです。
   • Time-sync: すべてのノードが同期されている必要があります。

手順

1. swift_params.yaml を編集します。

   $ cat > swift_params.yaml << EOF
     parameter_defaults:
         ExtraConfig:
           swift::proxy::copy::object_post_as_copy: False
     EOF

2. オーバークラウドをデプロイまたは更新する際に、パラメーターファイルを指定します。

   $ openstack overcloud deploy [... previous args ...] \
     -e swift_params.yaml

手順

1. /usr/share/openstack-tripleo-heat-templates から roles_data.yaml をコピーします。
2. 新規ファイルを編集します。
3. 不要な Controller ロールを削除します (例: Aodh*、Ceilometer*、Ceph*、Cinder*、Glance*、Heat*、Ironic*、Manila*、Nova*、Octavia*、Swift*)。
4. roles_data.yaml 内で ObjectStorage を見つけます。
5. このロールを、同じファイル内の新しいロールにコピーして、ObjectProxy という名前を付けます。

6. このロールの SwiftStorage は SwiftProxy に置き換えます。

   以下の roles_data.yaml ファイルの例には、サンプルのロールを記載しています。

   - name: Controller
     description: |
   	Controller role that has all the controller services loaded and handles
   	Database, Messaging and Network functions.
     CountDefault: 1
     tags:
   	- primary
   	- controller
     networks:
   	- External
   	- InternalApi
   	- Storage
   	- StorageMgmt
   	- Tenant
     HostnameFormatDefault: '%stackname%-controller-%index%'
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Clustercheck
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::Ec2Api
   	- OS::TripleO::Services::Etcd
   	- OS::TripleO::Services::HAproxy
   	- OS::TripleO::Services::Keepalived
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::Keystone
   	- OS::TripleO::Services::Memcached
   	- OS::TripleO::Services::MySQL
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Pacemaker
   	- OS::TripleO::Services::RabbitMQ
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages
   	- OS::TripleO::Services::Vpp
   
   - name: ObjectStorage
     CountDefault: 1
     description: |
   	Swift Object Storage node role
     networks:
   	- InternalApi
   	- Storage
   	- StorageMgmt
     disable_upgrade_deployment: True
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Collectd
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::FluentdClient
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::SensuClient
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::SwiftRingBuilder
   	- OS::TripleO::Services::SwiftStorage
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages
   
   - name: ObjectProxy
     CountDefault: 1
     description: |
   	Swift Object proxy node role
     networks:
   	- InternalApi
   	- Storage
   	- StorageMgmt
     disable_upgrade_deployment: True
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Collectd
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::FluentdClient
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::SensuClient
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::SwiftRingBuilder
   	- OS::TripleO::Services::SwiftProxy
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages

7. 通常の openstack deploy コマンドで、新規ロールを指定して、オーバークラウドをデプロイします。

   $ openstack overcloud deploy --templates -r roles_data.yaml -e [...]

手順

1. 登録する新規ノードの詳細を記載した新しい JSON ファイル (newnodes.json) を作成します。

   {
     "nodes":[
       {
           "mac":[
               "dd:dd:dd:dd:dd:dd"
           ],
           "cpu":"4",
           "memory":"6144",
           "disk":"40",
           "arch":"x86_64",
           "pm_type":"ipmi",
           "pm_user":"admin",
           "pm_password":"p@55w0rd!",
           "pm_addr":"192.02.24.207"
       },
       {
           "mac":[
               "ee:ee:ee:ee:ee:ee"
           ],
           "cpu":"4",
           "memory":"6144",
           "disk":"40",
           "arch":"x86_64",
           "pm_type":"ipmi",
           "pm_user":"admin",
           "pm_password":"p@55w0rd!",
           "pm_addr":"192.02.24.208"
       }
     ]
   }

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

3. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

4. 新しいノードを登録します。

   $ openstack overcloud node import newnodes.json

5. 新しいノードごとにイントロスペクションプロセスを開始します。

   $ openstack overcloud node introspect \
    --provide <node_1> [<node_2>] [<node_n>]

   • --provide オプションを使用して、イントロスペクション後に指定されたすべてのノードを available 状態にリセットします。
   • <node_1>、<node_2>、および <node_n> までの全ノードを、イントロスペクトする各ノードの UUID に置き換えます。

6. 新しいノードごとにイメージのプロパティーを設定します。

   $ openstack overcloud node configure <node>

手順

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

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. ベアメタルノードのプロビジョニングに使用する overcloud-baremetal-deploy.yaml ノード定義ファイルを開きます。

4. スケールアップするロールの count パラメーターを増やします。たとえば、以下の設定では、Object Storage ノード数を 4 に増やします。

   - name: Controller
     count: 3
   - name: Compute
     count: 10
   - name: ObjectStorage
     count: 4

5. オプション: 新規ノードに予測可能なノード配置を設定します。たとえば、以下の設定を使用して、node03 に新しい Object Storage ノードをプロビジョニングします。

   - name: ObjectStorage
     count: 4
     instances:
     - hostname: overcloud-objectstorage-0
       name: node00
     - hostname: overcloud-objectstorage-1
       name: node01
     - hostname: overcloud-objectstorage-2
       name: node02
     - hostname: overcloud-objectstorage-3
       name: node03

6. オプション: 新しいノードに割り当てるその他の属性を定義します。ノード定義ファイルでノード属性を設定するために使用できるプロパティーの詳細は、ベアメタルノードのプロビジョニング属性 を参照してください。
7. Object Storage サービス (swift) とディスク全体のオーバークラウドイメージ overcloud-hardened-uefi-full を使用する場合に、ディスクのサイズと /var および /srv のストレージ要件に基づいて /srv パーティションのサイズを設定します。詳細は、Object Storage サービスのディスクパーティション全体の設定 を参照してください。

8. オーバークラウドノードをプロビジョニングします。

   $ openstack overcloud node provision \
     --stack <stack> \
     --network-config \
     --output <deployment_file> \
     /home/stack/templates/overcloud-baremetal-deploy.yaml

   • <stack> を、ベアメタルノードがプロビジョニングされるスタックの名前に置き換えます。指定しない場合、デフォルトは overcloud です。
   • --network-config 引数を含めて、cli-overcloud-node-network-config.yaml Ansible Playbook にネットワーク定義を提供します。

   • <deployment_file> は、デプロイメントコマンドに含めるために生成する heat 環境ファイルの名前に置き換えます (例 :/home/stack/templates/overcloud-baremetal-deployed.yaml)。

     注記

     Red Hat OpenStack Platform 16.2 から 17.1 にアップグレードした場合は、openstack overcloud node provision コマンドでアップグレードプロセス中に作成または更新した YAML ファイルを含める必要があります。たとえば、/home/stack/templates/overcloud-baremetal-deployed.yaml ファイルの代わりに、/home/stack/tripleo-[stack]-baremetal-deploy.yaml ファイルを使用します。詳細は、16.2 から 17.1 へのアップグレードフレームワーク での オーバークラウドの導入と準備の実行 を参照してください。

9. 別のターミナルでプロビジョニングの進捗をモニタリングします。プロビジョニングが成功すると、ノードの状態が available から active に変わります。

   $ watch openstack baremetal node list

10. 生成された overcloud-baremetal-deployed.yaml ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。

    $ openstack overcloud deploy --templates \
      -e [your environment files] \
      -e /home/stack/templates/overcloud-baremetal-deployed.yaml \
      --deployed-server \
      --disable-validations \
      ...

手順

1. stack ユーザーとしてアンダークラウドにログインし、一時ディレクトリーを作成します。

   $ mkdir temp && cd temp/

2. 既存のノードの 1 つ (この例ではコントローラー 0) から新しいディレクトリーにオーバークラウドのリングファイルをダウンロードします。

   $ ssh tripleo-admin@overcloud-controller-0.ctlplane 'sudo tar -czvf - \
     /var/lib/config-data/puppet-generated/swift_ringbuilder/etc/swift \
     /{*.builder,*.ring.gz,backups/*.builder}' > swift-rings.tar.gz

3. リングを抽出し、リングサブディレクトリーに変更します。

   $ tar xzvf swift-rings.tar.gz && cd \
   var/lib/config-data/puppet-generated/swift_ringbuilder/etc/swift/

4. デバイス情報にしたがって、以下の変数の値を収集します。

   • <device_name>:

     $ openstack baremetal introspection data save \
       <node_name> | jq ".inventory.disks"

   • <node_ip>:

     $ metalsmith <node_name> show

   • <port>: デフォルトポートは 600x です。デフォルトを変更している場合は、該当するポートを使用します。
   • <builder_file>: 手順 3 のビルダーファイル名。
   • <weight> および <zone> 変数はユーザーが定義します。

5. swift-ring-builder を使用して、新しいノードを既存のリングに追加して更新します。デバイス情報に応じて、変数を置き換えます。

   注記

   swift-ring-builder コマンドを使用するには、python3-swift RPM をインストールする必要があります。

   $ swift-ring-builder etc/swift/<builder_file> \
     add <zone>-<node_ip>:<port>/<device_name> <weight>

6. リングを再調整して、新しいデバイスが使用されるようにします。

   $ swift-ring-builder etc/swift/<builder_file> rebalance

7. 変更したリングファイルをコントローラーノードにアップロードし、これらのリングファイルが使用されていることを確認します。次の例のようなスクリプトを使用して、リングファイルを配布します。

   #!/bin/sh
   set -xe
   
   ALL="tripleo-admin@overcloud-controller-0.ctlplane \
   tripleo-admin@overcloud-controller-1.ctlplane \
   tripleo-admin@overcloud-controller-2.ctlplane"

   • リングをすべてのノードにアップロードし、Object Storage サービスを再起動します。

     for DST in ${ALL}; do
       cat swift-rings.tar.gz | ssh "${DST}" 'sudo tar -C / -xvzf -'
       ssh "${DST}" 'sudo podman restart swift_copy_rings'
       ssh "${DST}" 'sudo systemctl restart tripleo_swift*'
     done

手順

1. 次の例のようなスクリプトを使用して、リングファイルを既存のコントローラーノードからすべてのコントローラーノードに配布し、それらのノードで Object Storage サービスコンテナーを再起動します。

   #!/bin/sh
   set -xe
   
   SRC="tripleo-admin@overcloud-controller-0.ctlplane"
   ALL="tripleo-admin@overcloud-controller-0.ctlplane \
   tripleo-admin@overcloud-controller-1.ctlplane \
   tripleo-admin@overcloud-controller-2.ctlplane"

   • リングファイルの現在のセットを取得します。

     ssh "${SRC}" 'sudo tar -czvf - \
       /var/lib/config-data/puppet-generated/swift_ringbuilder/etc/swift \
       /{*.builder,*.ring.gz,backups/*.builder}' > swift-rings.tar.gz

   • リングをすべてのノードにアップロードし、Object Storage サービスを再起動します。

     for DST in ${ALL}; do
       cat swift-rings.tar.gz | ssh "${DST}" 'sudo tar -C / -xvzf -'
       ssh "${DST}" 'sudo podman restart swift_copy_rings'
       ssh "${DST}" 'sudo systemctl restart tripleo_swift*'
     done

2. データが新しいディスクに移動されていることを確認するには、新規ストレージノードで以下のコマンドを実行してください。

   $ sudo grep -i replication  /var/log/container/swift/swift.log

手順

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

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. スケールダウンするロールについて、overcloud-baremetal-deploy.yaml ファイルの count パラメーターの数を減らします。
4. スタックから削除する各ノードの hostname と name を定義します (ロールの instances 属性で定義されていない場合)。

5. 削除するノードに属性 provisioned: false を追加します。たとえば、スタックからノード overcloud-objectstorage-1 を削除するには、overcloud-baremetal-deploy.yaml ファイルに以下のスニペットを追加します。

   - name: ObjectStorage
     count: 3
     instances:
     - hostname: overcloud-objectstorage-0
       name: node00
     - hostname: overcloud-objectstorage-1
       name: node01
       # Removed from cluster due to disk failure
       provisioned: false
     - hostname: overcloud-objectstorage-2
       name: node02
     - hostname: overcloud-objectstorage-3
       name: node03

   オーバークラウドの再デプロイ後、provisioned: false 属性で定義したノードがスタックには存在しなくなります。ただし、これらのノードは provisioned の状態で稼働したままです。

   注記

   スタックから一時的にノードを削除するには、属性 provisioned: false でオーバークラウドをデプロイし、属性 provisioned: true でオーバークラウドを再デプロイして、ノードをスタックに戻します。

6. オーバークラウドからノードを削除します。

   $ openstack overcloud node delete \
     --stack <stack> \
     --baremetal-deployment \
      /home/stack/templates/overcloud-baremetal-deploy.yaml

   • <stack> を、ベアメタルノードがプロビジョニングされるスタックの名前に置き換えます。指定しない場合、デフォルトは overcloud です。

     注記

     スタックから削除するノードを、openstack overcloud node delete コマンドのコマンド引数に含めないでください。

7. ironic ノードを削除します。

   $ openstack baremetal node delete <IRONIC_NODE_UUID>

   IRONIC_NODE_UUID は、ノードの UUID に置き換えます。

8. オーバークラウドノードをプロビジョニングして、デプロイメントコマンドに含める heat 環境ファイルを更新して生成します。

   $ openstack overcloud node provision \
     --stack <stack> \
     --output <deployment_file> \
     /home/stack/templates/overcloud-baremetal-deploy.yaml

   • <deployment_file> は、デプロイメントコマンドに含めるために生成する heat 環境ファイルの名前に置き換えます (例 :/home/stack/templates/overcloud-baremetal-deployed.yaml)。

9. プロビジョニングコマンドによって生成された overcloud-baremetal-deployed.yaml ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。

   $ openstack overcloud deploy \
     ...
     -e /usr/share/openstack-tripleo-heat-templates/environments \
     -e /home/stack/templates/overcloud-baremetal-deployed.yaml \
     --deployed-server \
     --disable-validations \
     ...

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. コンテナーの作成 をクリックします。

3. コンテナー名 を指定して、コンテナーアクセス フィールドで以下のいずれかのオプションを選択します。

   タイプ	説明
   プライベート	アクセスを現在のプロジェクトのユーザーに制限します。
   パブリック	パブリックの URL を使用して API アクセスを全員に許可します。ただし、Dashboard では、プロジェクトユーザーには、他のプロジェクトのパブリックコンテナーおよびデータは表示されません。

4. コンテナーの作成 をクリックします。

5. (オプション) 新しいコンテナーはデフォルトのストレージポリシーを使用します。複数のストレージポリシーが定義されている場合には (たとえば、デフォルトポリシーと Erasure Coding を有効にする別のポリシーなど)、デフォルト以外のストレージポリシーを使用するようにコンテナーを設定することができます。

   $ swift post -H "X-Storage-Policy:<policy>" <container_name>

   • <policy> を、コンテナーで使用するポリシーの名前またはエイリアスに置き換えます。
   • <container_name> は、コンテナーの名前に置き換えます。

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. 擬似フォルダーを追加するコンテナーの名前をクリックします。
3. 疑似フォルダーの作成 をクリックします。
4. 疑似フォルダー名 フィールドに名前を指定し、作成 をクリックします。

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. コンテナー のセクションのリストを参照して全オブジェクトが削除されていることを確認します。詳しくは、Object Storage サービスからのオブジェクトの削除 を参照してください。
3. 対象のコンテナーの矢印メニューで コンテナーの削除 を選択します。
4. コンテナーの削除 をクリックして、コンテナーを削除する操作を確定します。

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. アップロードされたオブジェクトを配置するコンテナーの名前をクリックします。コンテナーに擬似フォルダーがすでに存在する場合は、その名前をクリックします。
3. ファイルをブラウズして オブジェクトのアップロード をクリックします。

4. オブジェクト名 フィールドに名前を指定します。

   • / の文字 (例: Images/myImage.jpg) を使用して、名前に擬似フォルダーを指定できます。指定したフォルダーがまだ存在していない場合には、オブジェクトのアップロード時に作成されます。
   • 名前がその場所で一意ではない場合 (オブジェクトがすでに存在している場合)、そのオブジェクトのコンテンツは上書きされます。
5. オブジェクトのアップロード をクリックします。

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. オブジェクトのコンテナーまたはフォルダーの名前をクリックします (オブジェクトを表示します)。
3. オブジェクトのアップロード をクリックします。
4. コピーするファイルを参照し、矢印メニューで コピー を選択します。

5. 以下の項目を設定します。

   フィールド	説明
   宛先コンテナー	新規プロジェクトの宛先コンテナー
   パス	宛先コンテナーの擬似フォルダー。フォルダーが存在しない場合は、作成されます。
   宛先オブジェクト名	新規オブジェクト名。その場所で一意ではない名前を使用した場合 (オブジェクトがすでに存在している場合)、そのオブジェクトの以前のコンテンツは上書きされます。

6. オブジェクトのコピー をクリックします。

手順

1. Dashboard で プロジェクト > オブジェクトストア > コンテナー を選択します。
2. リストを参照して対象のオブジェクトを特定し、矢印メニューで オブジェクトの削除 を選択します。
3. オブジェクトの削除 をクリックして、オブジェクトを削除する操作を確定します。

手順

1. ストレージカスタマイズ YAML ファイルを作成して、環境に適した値またはオーバーライドを提供します。

   $ vi /home/stack/templates/<multiple_backends>.yaml

   • <multiple_backends> をファイルの名前に置き換えます。

2. ストレージカスタマイズ YAML ファイルを設定して、オーバーライドを含め、複数のバックエンドを有効にします。

   parameter_defaults:
     ManilaEnabledShareProtocols:
       - NFS
     ManilaNetappLogin: '<login_name>'
     ManilaNetappPassword: '<password>'
     ManilaNetappServerHostname: '<netapp-hostname>'
     ManilaNetappVserver: ‘<netapp-vserver>’
     ManilaNetappDriverHandlesShareServers: 'false'

   • 山かっこ <> 内の値を、YAML ファイルに応じた正しい値に置き換えます。
3. アンダークラウドホストに stack ユーザーとしてログインします。

4. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

5. ストレージカスタマイズ YAML ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。この設定例では、NetApp バックエンドと CephFS-NFS バックエンドを使用して Shared File Systems サービスを有効にします。

   $ openstack overcloud deploy \
     --timeout 100 \
     --stack overcloud \
     --templates /usr/share/openstack-tripleo-heat-templates \
     -n /usr/share/openstack-tripleo-heat-templates/network_data_ganesha.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-mds.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml \
     -r /home/stack/templates/roles/roles_data.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/manila-cephfsganesha-config.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/manila-netapp-config.yaml \
     -e /home/stack/templates/storage_customizations.yaml \
     ...

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. Shared File Systems サービスのバックエンドのリストを確認します。

   $ manila service-list
   
   +----+--------+--------+------+---------+-------+----------------------------+
   | Id | Binary | Host | Zone | Status | State | Updated_at |
   +----+--------+--------+------+---------+-------+----------------------------+
   | 2 | manila-scheduler | hostgroup | nova | enabled | up | 2021-03-24T16:49:09.000000 |
   | 5 | manila-share | hostgroup@cephfs | nova | enabled | up | 2021-03-24T16:49:12.000000 |
   | 8 | manila-share | hostgroup@tripleo_netapp | nova | enabled | up | 2021-03-24T16:49:06.000000 |

   正常にデプロイされた各バックエンドのステータスは enabled と表示され、状態は up が表示されます。

手順

1. ストレージカスタマイズ YAML ファイルを作成して、環境に適した値またはオーバーライドを提供します。

   $ vi /home/stack/templates/<custom_backend_data>.yaml

   • <custom_backend_data> をファイルの名前に置き換えます。

2. Shared File Systems サービスに必要なコンテナーイメージを使用して、ストレージカスタマイズ YAML ファイルを設定します。

   parameter_defaults:
     ContainerManilaShareImage: <custom_container_image_url>

   • <custom_container_image_url> をカスタムコンテナーイメージの URL に置き換えます。

3. ControllerExtraConfig パラメーターを使用して、Shared File Systems サービスに必要なバックエンドを設定します。このパラメーターにより、設定がすべての Controller ノードに確実に適用されます。

   parameter_defaults:
     ...
     ControllerExtraConfig:
       manila::config::manila_config:
         <backend_name>/<parameter>:
           value: '<parameter_value>'

   • <backend_name> をカスタムバックエンドの名前に置き換えます。
   • <parameter> を、このバックエンドに設定するパラメーターの名前 (netapp_server_hostname や netapp_password など) に置き換えます。

   • <parameter_value> を、パラメーターに設定する値 (203.0.113.20 や admin_password など) に置き換えます。

     注記

     カスタムロールを使用する場合は、ControllerExtraConfig パラメーターの代わりに [role_name]ExtraConfig を使用します。[role_name] を、カスタムロールの名前に置き換えます。

手順

1. ストレージカスタマイズ YAML ファイルを作成して、環境に適した値またはオーバーライドを提供します。

   $ vi /home/stack/templates/<manila_enabled_share_backends>.yaml

   • <manila_enabled_share_backends> をファイルの名前に置き換えます。

2. ストレージカスタマイズ YAML ファイルを設定して、有効な共有バックエンドのリストにカスタムバックエンドを追加します。

   parameter_defaults:
     ControllerExtraConfig:
       manila_user_enabled_backends:
         - '<backend_name>'

   • <backend_name> を、カスタムバックエンドの名前に置き換えます。

3. ストレージカスタマイズ YAML ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。

   $ openstack overcloud deploy --templates \
   -e [your environment files] \
     -e /home/stack/templates/<manila_enabled_share_backends>.yaml

手順

1. 以下のパラメーターを Shared File Systems サービス環境ファイルに追加して、2 つの AZ を作成します。

   parameter_defaults:
    ManilaXXXAvailabilityZone: zone1
    ManilaYYYAvailabilityZone: zone2

   • 以下に示す例のように、XXX および YYY を、サポートされるバックエンドの値に置き換えます。

     ManilaCephFSAvailabilityZone
     ManilaNetAppAvailabilityZone

     2 つのバックエンドをデプロイする例を以下に示します。ここでは、CephFS がゾーン 1 で NetApp がゾーン 2 です。

     parameter_defaults:
      ManilaCephFSAvailabilityZone: zone1
      ManilaNetAppAvailabilityZone: zone2

     注記

     /usr/share/openstack-tripleo-heat-templates/deployment/manila/ ディレクトリーでバックエンドに関連付けられた heat テンプレートを探し、正しいバックエンドの値を確認してください。

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

3. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

4. 更新された Shared File Systems サービス環境ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。

   $ openstack overcloud deploy --templates \
     -e [your environment files] \
     -e /home/stack/templates/<updated_environment_file>.yaml

5. デプロイ後、availability_zones 共有タイプの追加仕様を使用して、共有タイプを 1 つ以上の AZ に制限します。クラウドユーザーは、共有タイプによって制限されない限り、AZ に共有を直接作成できます。

手順

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

   $ source ~/<credentials_file>

   • <credentials_file> を認証情報ファイルの名前 (overcloudrc など) に置き換えます。

2. ストレージカスタマイズ YAML ファイルを作成して、環境に適した値またはオーバーライドを提供します。

   $ vi /home/stack/templates/<share_protocols>.yaml

   • <share_protocols> をファイルの名前に置き換えます。

3. 有効にする NAS プロトコルを使用して ManilaEnabledShareProtocols パラメーターを設定します。

   parameter_defaults:
     ManilaEnabledShareProtocols:
       - NFS
       - CEPHFS

4. ストレージカスタマイズ YAML ファイルを他の環境ファイルと共にスタックに追加し、オーバークラウドをデプロイします。

   $ openstack overcloud deploy --templates \
   -e [your environment files] \
     -e /home/stack/templates/<share_protocols>.yaml

   注記

   デプロイメントは設定を検証しません。割り当てる NAS プロトコルは、Shared File Systems サービスのデプロイメントのバックエンドによりサポートされる必要があります。

手順

1. 以下のコマンドを使用してクォータを表示することができます。--user オプションを含めると、指定したプロジェクトの特定ユーザーのクォータを表示できます。--user オプションを指定しないと、指定したプロジェクトのすべてのユーザーに適用されるクォータを表示できます。

   同様に、オプションの --share-type を指定すると、プロジェクトに関連する特定の共有種別のクォータを表示することができます。--user オプションおよび --share-type オプションは相互排他的です。

   $ manila quota-show

   • プロジェクトの例:

     $ manila quota-show \
       --project af2838436f3f4cf6896399dd97c4c050
     +-----------------------+----------------------------------+
     | Property              | Value                            |
     +-----------------------+----------------------------------+
     | gigabytes             | 1000                             |
     | id                    | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes     | 1000                             |
     | share_group_snapshots | 50                               |
     | share_groups          | 49                               |
     | share_networks        | 10                               |
     | share_replicas        | 100                              |
     | shares                | 50                               |
     | snapshot_gigabytes    | 1000                             |
     | snapshots             | 50                               |
     +-----------------------+----------------------------------+

   • プロジェクトユーザーの例:

     $ manila quota-show \
       --project af2838436f3f4cf6896399dd97c4c050 \
       --user 81ebb491dd0e4c2aae0775dd564e76d1
     +-----------------------+----------------------------------+
     | Property              | Value                            |
     +-----------------------+----------------------------------+
     | gigabytes             | 500                              |
     | id                    | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes     | 1000                             |
     | share_group_snapshots | 50                               |
     | share_groups          | 49                               |
     | share_networks        | 10                               |
     | share_replicas        | 100                              |
     | shares                | 25                               |
     | snapshot_gigabytes    | 1000                             |
     | snapshots             | 50                               |
     +-----------------------+----------------------------------+

   • 特定の共有種別のプロジェクトの例:

     $ manila quota-show \
       --project af2838436f3f4cf6896399dd97c4c050 \
       --share-type dhss_false
     +---------------------+----------------------------------+
     | Property            | Value                            |
     +---------------------+----------------------------------+
     | gigabytes           | 1000                             |
     | id                  | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes   | 1000                             |
     | share_replicas      | 100                              |
     | shares              | 15                               |
     | snapshot_gigabytes  | 1000                             |
     | snapshots           | 50                               |
     +---------------------+----------------------------------+

2. manila quota-update コマンドを使用してクォータを更新します。すべてのプロジェクトユーザー、特定のプロジェクトユーザー、またはプロジェクトの共有種別のクォータを更新できます。

   • プロジェクトのすべてのユーザーについてクォータを更新します。

     $ manila quota-update <id> \
       [--shares <share_quota> \
       --gigabytes <share_gigabytes_quota> \
       …]

     <id> をプロジェクト ID に置き換えます。この値はプロジェクト名ではなく、プロジェクト ID である必要があります。

   • プロジェクト内の特定ユーザーのクォータを更新します。

     $ manila quota-update <id> \
       --user <user_id> \
       [--shares <new_share_quota> \
       --gigabytes <new_share_gigabytes_quota> \
       …]

     • <id> をプロジェクト ID に置き換えます。この値はプロジェクト名ではなく、プロジェクト ID である必要があります。
     • <user_id> をユーザー ID に置き換えます。値はユーザー名ではなく、ユーザー ID である必要があります。

   • 特定の共有種別を使用するすべてのユーザーについてクォータを更新します。

     $ manila quota-update <id> \
       --share-type <share_type> \
       [--shares <new_share_quota>30
       --gigabytes <new-share_gigabytes_quota> \
       …]

     • <id> をプロジェクト ID に置き換えます。この値はプロジェクト名ではなく、プロジェクト ID である必要があります。
     • <share_type> を、クォータを適用する共有種別の名前または ID に置き換えてください。

検証

1. quota-delete コマンドは出力を生成しません。quota-show コマンドを使用して、クォータが正常にリセットされたかどうかを確認します。

2. すべてのプロジェクトのデフォルトクォータをリスト表示します。デフォルトクォータは、オーバーライドのないプロジェクトに適用されます。

   $ manila quota-class-show default

手順

1. manila quota-class-update コマンドの使用状況のステートメントを表示します。

   $ manila help quota-class-update
   usage: manila quota-class-update [--shares <shares>] [--snapshots <snapshots>]
                                    [--gigabytes <gigabytes>]
                                    [--snapshot-gigabytes <snapshot_gigabytes>]
                                    [--share-networks <share_networks>]
                                    [--share-replicas <share_replicas>]
                                    [--replica-gigabytes <replica_gigabytes>]
                                    <class_name>

   注記

   パラメーター <class_name> は位置引数です。クォータが設定されるクォータクラスを特定します。このパラメーターの値を default に設定します。他のクォータクラスはサポートされません。

   以下のオプションパラメーターの値をすべて更新できます。

   • --shares <shares>: shares クォータの新しい値を追加します。
   • --snapshots <snapshots>: snapshots クォータの新しい値を追加します。
   • --gigabytes <gigabytes>: gigabytes クォータの新しい値を追加します。
   • --snapshot-gigabytes <snapshot_gigabytes> または --snapshot_gigabytes <snapshot_gigabytes>: snapshot_gigabytes クォータの新しい値を追加します。
   • --share-networks <share_networks> または --share_networks <share_networks>: share_networks クォータの新しい値を追加します。
   • --share-replicas <share_replicas>、--share_replicas <share_replicas>、または --replicas <share_replicas>: share_replicas クォータの新しい値を追加します。
   • --replica-gigabytes <replica_gigabytes> または --replica_gigabytes <replica_gigabytes>: replica_gigabytes クォータの新しい値を追加します。

2. 使用状況のステートメントからの情報を使用して、デフォルトのクォータを更新します。以下の例では、ファイル shares および gigabytes のデフォルトクォータを更新しています。

   $ manila quota-class-update default \
     --shares 30 \
     --gigabytes 512
   $ manila quota-class-show default
   +-----------------------+---------+
   | Property              | Value   |
   +-----------------------+---------+
   | gigabytes             | 512     |
   | id                    | default |
   | replica_gigabytes     | 1000    |
   | share_group_snapshots | 50      |
   | share_groups          | 50      |
   | share_networks        | 10      |
   | share_replicas        | 100     |
   | shares                | 30      |
   | snapshot_gigabytes    | 1000    |
   | snapshots             | 50      |
   +-----------------------+---------+

手順

1. 共有ネットワークを作成します。

   $ manila share-network-create --name <network-name> \
       --neutron-net-id <25d1e65c-d961-4f22-9476-1190f55f118f> \
       --neutron-subnet-id <8ba20dce-0ca5-4efd-bf1c-608d6bceffe1>

   • <network-name> を、NFS または CIFS 共有に使用する共有ネットワーク名に置き換えます。
   • neutron-net-id と neutron-subnet-id を共有ネットワークの正しい値に置き換えます。

2. Active Directory サーバーを表すセキュリティーサービスリソースを作成します。

   $ manila security-service-create <active_directory> \
             --dns-ip <192.02.12.10> \
             --domain <domain-name.com> \
             --user <Administrator> \
             --password <password> \
             --name <AD-service>

   • 山かっこ <> の値を、セキュリティーサービスリソースに応じた適切な詳細情報に置き換えます。

3. セキュリティーサービスリソースを共有ネットワークに関連付けます。

   $ manila share-network-security-service-add \
     <network-name> <AD-service>

4. NFS または CIFS 共有を作成します。

   • 10 GB NFS の例:

     $ manila create --name <nfs-share> --share-type <netapp> \
         --share-network <nfs-network> nfs 10

   • 20 GB CIFS の例:

     $ manila create --name <cifs-share> --share-type dhss_true \
         --share-network <cifs-network> cifs 20

     • 山かっこ <> の値を、NFS または CIFS 共有に応じた適切な詳細情報に置き換えます。

手順

1. 新規共有に必要なデータが含まれる共有スナップショットの ID を取得します。

   $ manila snapshot-list

2. スナップショットから作成されたファイル共有は、スナップショットよりも大きくなりますが、小さくすることはできません。スナップショットのサイズを取得します。

   $ manila snapshot-show <snapshot-id>

3. スナップショットからファイル共有を作成します。

   $ manila create <share_protocol> <size> \
      --snapshot-id <snapshot_id> \
      --name <name>

   • <share_protocol> を、NFS 等のプロトコルに置き換えます。
   • <size> を、作成するファイル共有のサイズ (GB 単位) に置き換えます。
   • <snapshot_id> を、スナップショット ID に置き換えます。
   • <name> を、新しいファイル共有の名前に置き換えます。

4. ファイル共有をリスト表示して、ファイル共有が正常に作成されたことを確認します。

   $ manila list

5. 新しいファイル共有のプロパティーを表示します。

   $ manila show <name>

手順

1. 削除するスナップショットを特定し、その ID を取得します。

   $ manila snapshot-list

2. スナップショットを削除します。

   $ manila snapshot-delete <snapshot>

   注記

   削除するそれぞれのスナップショットについて、この手順を繰り返します。

3. スナップショットを削除したら、以下のコマンドを実行してスナップショットが削除されたことを確認します。

   $ manila snapshot-list

手順

1. ユーザーにネイティブ CephFS 共有へのアクセスを許可します。

   $ manila access-allow <share> cephx <user>

   • <share> を共有名または共有 ID に置き換えます。
   • <user> を cephx ユーザーに置き換えます。

2. ユーザーのアクセスキーを収集します。

   $ manila access-list <share>

手順

1. インスタンスにログインします。

   $ openstack server ssh demo-instance0 --login user

2. NFS 共有をマウントします。サンプル構文については、次の例を参照してください。

   $ mount -t nfs \
     -v <198.51.100.13:/volumes/_nogroup/e840b4ae-6a04-49ee-9d6e-67d4999fbc01>  \
     /mnt

   • <198.51.100.13:/volumes/_nogroup/e840b4ae-6a04-49ee-9d6e-67d4999fbc01> を共有のエクスポート場所に置き換えます。
   • の説明に従って、エクスポート先を取得します。「共有エクスポート場所の一覧表示」 .

3. ネイティブ CephFS 共有をマウントします。サンプル構文については、次の例を参照してください。

   $  mount -t ceph \
     <192.0.2.125:6789,192.0.2.126:6789,192.0.2.127:6789:/volumes/_nogroup/4c55ad20-9c55-4a5e-9233-8ac64566b98c> \
     -o name=<user>,secret='<AQA8+ANW/<4ZWNRAAOtWJMFPEihBA1unFImJczA==>'

   • <192.0.2.125:6789,192.0.2.126:6789,192.0.2.127:6789:/volumes/_nogroup/4c55ad20-9c55-4a5e-9233-8ac64566b98c> を共有のエクスポート場所に置き換えます。
   • の説明に従って、エクスポート先を取得します。「共有エクスポート場所の一覧表示」 .
   • <user> を、共有にアクセスできる cephx ユーザーに置き換えます。
   • secret 値を、で収集したアクセスキーに置き換えます。「ネイティブ CephFS 共有へのアクセス権の付与」 .

4. CIFS 共有をマウントします。サンプル構文については、次の例を参照してください。

   $  mount -t cifs \
     -o user=<user>,pass=<password> \
     <\\192.0.2.128/share_11265e8a_200c_4e0a_a40f_b7a1117001ed>

   • <user> を、共有にアクセスできる Active Directory ユーザーに置き換えます。
   • <password> をユーザーの Active Directory パスワードに置き換えます。
   • <\\192.0.2.128/share_11265e8a_200c_4e0a_a40f_b7a1117001ed> を共有のエクスポート場所に置き換えます。
   • の説明に従って、エクスポート先を取得します。「共有エクスポート場所の一覧表示」 .

手順

1. ファイル共有を作成するには、ファイル共有に割り当てる機能を指定する共有種別を使用します。クラウド管理者は共有種別を作成することができます。利用可能な共有種別を表示します。

   clouduser1@client:~$ manila type-list
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | ID                                   | Name        | visibility | is_default | required_extra_specs                 | optional_extra_specs                       | Description |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 | dhss_false  | public     | YES        | driver_handles_share_servers : False | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   | 277c1089-127f-426e-9b12-711845991ea1 | dhss_true   | public     | -          | driver_handles_share_servers : True  | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+

   この例では、2 つの共有種別が使用可能です。

2. driver_handles_share_servers=true 機能を指定する共有種別を使用するには、ファイル共有をエクスポートするファイル共有ネットワークを作成する必要があります。プライベートプロジェクトネットワークから、ファイル共有ネットワークを作成します。

   clouduser1@client:~$ openstack subnet list
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   | ID                                   | Name                | Network                              | Subnet              |
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   | 78c6ac57-bba7-4922-ab81-16cde31c2d06 | private-subnet      | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 | 10.0.0.0/26         |
   | a344682c-718d-4825-a87a-3622b4d3a771 | ipv6-private-subnet | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 | fd36:18fc:a8e9::/64 |
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   
   clouduser1@client:~$ manila share-network-create \
     --name mynet \
     --neutron-net-id 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 \
     --neutron-subnet-id 78c6ac57-bba7-4922-ab81-16cde31c2d06
   +-------------------+--------------------------------------+
   | Property          | Value                                |
   +-------------------+--------------------------------------+
   | network_type      | None                                 |
   | name              | mynet                                |
   | segmentation_id   | None                                 |
   | created_at        | 2018-10-09T21:32:22.485399           |
   | neutron_subnet_id | 78c6ac57-bba7-4922-ab81-16cde31c2d06 |
   | updated_at        | None                                 |
   | mtu               | None                                 |
   | gateway           | None                                 |
   | neutron_net_id    | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 |
   | ip_version        | None                                 |
   | cidr              | None                                 |
   | project_id        | cadd7139bc3148b8973df097c0911016     |
   | id                | 0b0fc320-d4b5-44a1-a1ae-800c56de550c |
   | description       | None                                 |
   +-------------------+--------------------------------------+
   
   clouduser1@client:~$ manila share-network-list
   +--------------------------------------+-------+
   | id                                   | name  |
   +--------------------------------------+-------+
   | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 | mynet |
   +--------------------------------------+-------+

3. ファイル共有を作成します。

   clouduser1@client:~$ manila create nfs 1 \
     --name software_share \
     --share-network mynet \
     --share-type dhss_true
   +---------------------------------------+--------------------------------------+
   | Property                              | Value                                |
   +---------------------------------------+--------------------------------------+
   | status                                | creating                             |
   | share_type_name                       | dhss_true                            |
   | description                           | None                                 |
   | availability_zone                     | None                                 |
   | share_network_id                      | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 |
   | share_server_id                       | None                                 |
   | share_group_id                        | None                                 |
   | host                                  |                                      |
   | revert_to_snapshot_support            | False                                |
   | access_rules_status                   | active                               |
   | snapshot_id                           | None                                 |
   | create_share_from_snapshot_support    | False                                |
   | is_public                             | False                                |
   | task_state                            | None                                 |
   | snapshot_support                      | False                                |
   | id                                    | 243f3a51-0624-4bdd-950e-7ed190b53b67 |
   | size                                  | 1                                    |
   | source_share_group_snapshot_member_id | None                                 |
   | user_id                               | 61aef4895b0b41619e67ae83fba6defe     |
   | name                                  | software_share                       |
   | share_type                            | 277c1089-127f-426e-9b12-711845991ea1 |
   | has_replicas                          | False                                |
   | replication_type                      | None                                 |
   | created_at                            | 2018-10-09T21:12:21.000000           |
   | share_proto                           | NFS                                  |
   | mount_snapshot_support                | False                                |
   | project_id                            | cadd7139bc3148b8973df097c0911016     |
   | metadata                              | {}                                   |
   +---------------------------------------+--------------------------------------+

4. ファイル共有のステータスを表示します。

   clouduser1@client:~$ manila list
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | ID                                   | Name           | Size | Share Proto | Status | Is Public | Share Type Name | Host | Availability Zone |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error  | False     | dhss_true       |      | None              |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+

   この例では、ファイル共有の作成中にエラーが発生しています。

5. ユーザーサポートメッセージを表示するには、message-list コマンドを実行します。--resource-id を使用して、確認したい特定のファイル共有に絞り込みます。

   clouduser1@client:~$ manila message-list
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+

   User Message コラムに、機能の不一致により Shared File Systems サービスがファイル共有の作成に失敗したことが表示されています。

6. より多くのメッセージ情報を表示するには、message-show コマンドを実行してから、message-list コマンドからのメッセージの ID を実行します。

   clouduser1@client:~$ manila message-show 7d411c3c-46d9-433f-9e21-c04ca30b209c
   +---------------+----------------------------------------------------------------------------------------------------------+
   | Property      | Value                                                                                                    |
   +---------------+----------------------------------------------------------------------------------------------------------+
   | request_id    | req-0a875292-6c52-458b-87d4-1f945556feac                                                                 |
   | detail_id     | 008                                                                                                      |
   | expires_at    | 2018-11-08T21:12:21.000000                                                                               |
   | resource_id   | 243f3a51-0624-4bdd-950e-7ed190b53b67                                                                     |
   | user_message  | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. |
   | created_at    | 2018-10-09T21:12:21.000000                                                                               |
   | message_level | ERROR                                                                                                    |
   | id            | 7d411c3c-46d9-433f-9e21-c04ca30b209c                                                                     |
   | resource_type | SHARE                                                                                                    |
   | action_id     | 001                                                                                                      |
   +---------------+----------------------------------------------------------------------------------------------------------+

7. クラウドユーザーは共有種別により機能を確認することができるので、利用可能な共有種別を確認することができます。2 つの共有種別の違いは、driver_handles_share_servers の値です。

   clouduser1@client:~$ manila type-list
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | ID                                   | Name        | visibility | is_default | required_extra_specs                 | optional_extra_specs                       | Description |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 | dhss_false  | public     | YES        | driver_handles_share_servers : False | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   | 277c1089-127f-426e-9b12-711845991ea1 | dhss_true   | public     | -          | driver_handles_share_servers : True  | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+

8. 利用可能な他の共有種別でファイル共有を作成します。

   clouduser1@client:~$ manila create nfs 1 \
     --name software_share \
     --share-network mynet \
     --share-type dhss_false
   +---------------------------------------+--------------------------------------+
   | Property                              | Value                                |
   +---------------------------------------+--------------------------------------+
   | status                                | creating                             |
   | share_type_name                       | dhss_false                           |
   | description                           | None                                 |
   | availability_zone                     | None                                 |
   | share_network_id                      | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 |
   | share_group_id                        | None                                 |
   | revert_to_snapshot_support            | False                                |
   | access_rules_status                   | active                               |
   | snapshot_id                           | None                                 |
   | create_share_from_snapshot_support    | True                                 |
   | is_public                             | False                                |
   | task_state                            | None                                 |
   | snapshot_support                      | True                                 |
   | id                                    | 2d03d480-7cba-4122-ac9d-edc59c8df698 |
   | size                                  | 1                                    |
   | source_share_group_snapshot_member_id | None                                 |
   | user_id                               | 5c7bdb6eb0504d54a619acf8375c08ce     |
   | name                                  | software_share                       |
   | share_type                            | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 |
   | has_replicas                          | False                                |
   | replication_type                      | None                                 |
   | created_at                            | 2018-10-09T21:24:40.000000           |
   | share_proto                           | NFS                                  |
   | mount_snapshot_support                | False                                |
   | project_id                            | cadd7139bc3148b8973df097c0911016     |
   | metadata                              | {}                                   |
   +---------------------------------------+--------------------------------------+

   この例では、試みた 2 番目のファイル共有作成は失敗します。

9. ユーザーサポートメッセージを表示します。

   clouduser1@client:~$ manila list
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | ID                                   | Name           | Size | Share Proto | Status | Is Public | Share Type Name | Host | Availability Zone |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | 2d03d480-7cba-4122-ac9d-edc59c8df698 | software_share | 1    | NFS         | error  | False     | dhss_false      |      | nova              |
   | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error  | False     | dhss_true       |      | None              |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   
   clouduser1@client:~$ manila message-list
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 | SHARE         | 2d03d480-7cba-4122-ac9d-edc59c8df698 | 002       | create: Driver does not expect share-network to be provided with current configuration.                  | 003       | 2018-10-09T21:24:40.000000 |
   | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+

   サービスは、使用した共有種別のファイル共有ネットワークに対応していません。

10. 管理者に相談することなく、管理者が利用可能にしたストレージバックエンドではプライベート neutron ネットワークにファイル共有を直接エクスポートする操作がサポートされない、ということを明らかにすることができます。share-network パラメーターを指定せずに、ファイル共有を作成します。

    clouduser1@client:~$ manila create nfs 1 \
      --name software_share \
      --share-type dhss_false
    +---------------------------------------+--------------------------------------+
    | Property                              | Value                                |
    +---------------------------------------+--------------------------------------+
    | status                                | creating                             |
    | share_type_name                       | dhss_false                           |
    | description                           | None                                 |
    | availability_zone                     | None                                 |
    | share_network_id                      | None                                 |
    | share_group_id                        | None                                 |
    | revert_to_snapshot_support            | False                                |
    | access_rules_status                   | active                               |
    | snapshot_id                           | None                                 |
    | create_share_from_snapshot_support    | True                                 |
    | is_public                             | False                                |
    | task_state                            | None                                 |
    | snapshot_support                      | True                                 |
    | id                                    | 4d3d7fcf-5fb7-4209-90eb-9e064659f46d |
    | size                                  | 1                                    |
    | source_share_group_snapshot_member_id | None                                 |
    | user_id                               | 5c7bdb6eb0504d54a619acf8375c08ce     |
    | name                                  | software_share                       |
    | share_type                            | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 |
    | has_replicas                          | False                                |
    | replication_type                      | None                                 |
    | created_at                            | 2018-10-09T21:25:40.000000           |
    | share_proto                           | NFS                                  |
    | mount_snapshot_support                | False                                |
    | project_id                            | cadd7139bc3148b8973df097c0911016     |
    | metadata                              | {}                                   |
    +---------------------------------------+--------------------------------------+

11. ファイル共有が正常に作成されたことを確認します。

    clouduser1@client:~$ manila list
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+
    | ID                                   | Name           | Size | Share Proto | Status    | Is Public | Share Type Name | Host | Availability Zone |
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+
    | 4d3d7fcf-5fb7-4209-90eb-9e064659f46d | software_share | 1    | NFS         | available | False     | dhss_false      |      | nova              |
    | 2d03d480-7cba-4122-ac9d-edc59c8df698 | software_share | 1    | NFS         | error     | False     | dhss_false      |      | nova              |
    | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error     | False     | dhss_true       |      | None              |
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+

12. ファイル共有およびサポートメッセージを削除します。

    clouduser1@client:~$ manila message-list
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    | ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 | SHARE         | 2d03d480-7cba-4122-ac9d-edc59c8df698 | 002       | create: Driver does not expect share-network to be provided with current configuration.                  | 003       | 2018-10-09T21:24:40.000000 |
    | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    
    clouduser1@client:~$ manila delete 2d03d480-7cba-4122-ac9d-edc59c8df698 243f3a51-0624-4bdd-950e-7ed190b53b67
    clouduser1@client:~$ manila message-delete ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 7d411c3c-46d9-433f-9e21-c04ca30b209c
    
    clouduser1@client:~$ manila message-list
    +----+---------------+-------------+-----------+--------------+-----------+------------+
    | ID | Resource Type | Resource ID | Action ID | User Message | Detail ID | Created At |
    +----+---------------+-------------+-----------+--------------+-----------+------------+
    +----+---------------+-------------+-----------+--------------+-----------+------------+

手順

1. ファイル共有のアクセス制御リストを確認し、クライアントに対応するルールが正しく適用され、正常に適用されていることを確認します。

   $ manila access-list share-01

   成功したルールでは、state 属性は active に等しくなります。

2. 共有種別パラメーターが driver_handles_share_servers=false に設定されている場合には、エクスポート場所からホスト名または IP アドレスをコピーし、これに ping して NAS サーバーへの接続を確認します。

   $ ping -c 1 198.51.100.13
   PING 198.51.100.13 (198.51.100.13) 56(84) bytes of data.
   64 bytes from 198.51.100.13: icmp_seq=1 ttl=64 time=0.048 ms--- 198.51.100.13 ping statistics ---
   1 packets transmitted, 1 received, 0% packet loss, time 0ms
   rtt min/avg/max/mdev = 7.851/7.851/7.851/0.000 ms
   If using the NFS protocol, you may verify that the NFS server is ready to respond to NFS rpcs on the proper port:
   $ rpcinfo -T tcp -a 198.51.100.13.8.1 100003 4
   program 100003 version 4 ready and waiting

   注記

   IP アドレスは汎用アドレスフォーマット (uaddr) で書かれているので、NFS サービスのポート 2049 を表すのに 2 つのオクテット (8.1) が追加されています。