Fujitsu ETERNUS バックエンドガイド

本ガイドでは、OpenStack で Fujitsu ETERNUS ディスクストレージシステムを Block Storage サービスのバックエンドとして使用するための設定方法について説明します。具体的には、オーバークラウドのデプロイメント上の ETERNUS デバイスによって提供されるファイバーチャネルおよび iSCSI バックエンドを定義する方法を記載します。これには、Block Storage サービスの カスタムバックエンド として両バックエンドを定義する必要があります。

以下のセクションは、下記を前提としてます。

Fujitsu ETERNUS では、ファイバーチャネルまたは iSCSI インターフェースのいずれかを使用することができます。各インターフェースには、独自の設定とドライバーがあります。Red Hat は、OpenStack で両方のインターフェース (およびそれぞれのドライバー) の使用をサポートしています。

先に Fujitsu ETERNUS デバイス上のストレージプールとポートを設定をしてからでないと、Fujitsu ETERNUS デバイスをブロックデバイスとして定義できません。それぞれの手順に関する情報は、デバイスのドキュメントを参照してください。

Red Hat OpenStack Platform オーバークラウドのデプロイ時には、director を使用してサービス設定すべてを実行することを推奨します。director で設定すると、今後オーバークラウドの更新の際に設定の一貫性を保たれるようになります。

ETERNUS バックエンドでは、(Block Storage サービスがホストされる) コントローラーノードで以下が要件となっています。

いずれのタスクも heat テンプレート を使用して、director でオーケストレーションすることができます。director 用に使用する heat テンプレートの構文に関する情報は、「Heat テンプレートの理解」を参照してください。

以下のテンプレート (eternus-temp.yaml) には、heat テンプレートで必要な基本構文が含まれています。また、必須の pywbem パッケージのインストール方法も含まれています。

heat_template_version: 2014-10-16

description: >
    Installs the pywbem package on all Controller nodes

parameters:
  server:
    type: string

resources:
    EternusSetup: # 1
    type: OS::Heat::SoftwareConfig
    properties:
      group: script
      config: |  # 2
        #!/bin/bash
        sudo yum install pywbem -y
        # 3

    ExtraPreDeployment:
    type: OS::Heat::SoftwareDeployment
    properties:
      config: {get_resource: EternusSetup}
      server: {get_param: server}
      actions: [CREATE,UPDATE]

director ノードの /home/stack/templates/ にこのファイルを保存します。一般的な Red Hat OpenStack Platform director デプロイメントでは、カスタムの heat テンプレートはここに保存されます。

<?xml version='1.0' encoding='UTF-8'?>
<FUJITSU>
<EternusIP>0.0.0.0</EternusIP>
<EternusPort>5988</EternusPort>
<EternusUser>smisuser</EternusUser>
<EternusPassword>smispassword</EternusPassword>
<EternusPool>raid5_0001</EternusPool>
<EternusSnapPool>raid5_0001</EternusSnapPool>
</FUJITSU>

<?xml version='1.0' encoding='UTF-8'?>
<FUJITSU>
<EternusIP>0.0.0.0</EternusIP>
<EternusPort>5988</EternusPort>
<EternusUser>smisuser</EternusUser>
<EternusPassword>smispassword</EternusPassword>
<EternusPool>raid5_0001</EternusPool>
<EternusSnapPool>raid5_0001</EternusSnapPool>
<EternusISCSIIP>1.1.1.1</EternusISCSIIP>
<EternusISCSIIP>1.1.1.2</EternusISCSIIP>
<EternusISCSIIP>1.1.1.3</EternusISCSIIP>
<EternusISCSIIP>1.1.1.4</EternusISCSIIP>
</FUJITSU>

sudo cat > /etc/cinder/eternus-fc.xml <<EOF
<?xml version=1.0 encoding=UTF-8?>
<FUJITSU>
<EternusIP>0.0.0.0</EternusIP>
<EternusPort>5988</EternusPort>
<EternusUser>smisuser</EternusUser>
<EternusPassword>smispassword</EternusPassword>
<EternusPool>raid5_0001</EternusPool>
<EternusSnapPool>raid5_0001</EternusSnapPool>
</FUJITSU>
EOF

sudo cat > /etc/cinder/eternus-iscsi.xml <<EOF
<?xml version=1.0 encoding=UTF-8?>
<FUJITSU>
<EternusIP>0.0.0.0</EternusIP>
<EternusPort>5988</EternusPort>
<EternusUser>smisuser</EternusUser>
<EternusPassword>smispassword</EternusPassword>
<EternusPool>raid5_0001</EternusPool>
<EternusSnapPool>raid5_0001</EternusSnapPool>
<EternusISCSIIP>1.1.1.1</EternusISCSIIP>
<EternusISCSIIP>1.1.1.2</EternusISCSIIP>
<EternusISCSIIP>1.1.1.3</EternusISCSIIP>
<EternusISCSIIP>1.1.1.4</EternusISCSIIP>
</FUJITSU>
EOF

sudo chown cinder:cinder /etc/cinder/eternus-*.xml
sudo chmod 0600 /etc/cinder/eternus-*.xml

heat_template_version: 2014-10-16

description: >
    Installs the pywbem package on all Controller nodes

parameters:
  server:
    type: string

resources:
    EternusSetup:
    type: OS::Heat::SoftwareConfig
    properties:
      group: script
      config: |
        #!/bin/bash
        sudo yum install pywbem -y
        sudo cat > /etc/cinder/eternus-fc.xml <<EOF
        <?xml version=1.0 encoding=UTF-8?>
        <FUJITSU>
        <EternusIP>0.0.0.0</EternusIP>
        <EternusPort>5988</EternusPort>
        <EternusUser>smisuser</EternusUser>
        <EternusPassword>smispassword</EternusPassword>
        <EternusPool>raid5_0001</EternusPool>
        <EternusSnapPool>raid5_0001</EternusSnapPool>
        </FUJITSU>
        EOF
        sudo cat > /etc/cinder/eternus-iscsi.xml <<EOF
        <?xml version=1.0 encoding=UTF-8?>
        <FUJITSU>
        <EternusIP>0.0.0.0</EternusIP>
        <EternusPort>5988</EternusPort>
        <EternusUser>smisuser</EternusUser>
        <EternusPassword>smispassword</EternusPassword>
        <EternusPool>raid5_0001</EternusPool>
        <EternusSnapPool>raid5_0001</EternusSnapPool>
        <EternusISCSIIP>1.1.1.1</EternusISCSIIP>
        <EternusISCSIIP>1.1.1.2</EternusISCSIIP>
        <EternusISCSIIP>1.1.1.3</EternusISCSIIP>
        <EternusISCSIIP>1.1.1.4</EternusISCSIIP>
        </FUJITSU>
        EOF
        sudo chown cinder:cinder /etc/cinder/eternus-*.xml
        sudo chmod 0600 /etc/cinder/eternus-*.xml

    ExtraPreDeployment:
    type: OS::Heat::SoftwareDeployment
    properties:
      config: {get_resource: EternusSetup}
      server: {get_param: server}
      actions: [CREATE,UPDATE]

環境ファイルには、定義する各バックエンドの設定が記載されます。また、カスタムのバックエンドのデプロイメントに関連したその他の設定も含まれます。環境ファイルに関する詳しい情報は、『Advanced Overcloud Customization』の「Environment Files」のセクションを参照してください。　

さらに、環境ファイルは、以前に「Heat テンプレートの準備」で作成した heat テンプレートも登録します。これにより、テンプレートで定義したインストールコマンドおよび echo コマンドが適切なノードで実行されます。

以下の環境ファイルの例には、ETERNUS デバイスを Block Storage バックエンドとして定義するのに必要なセクションがすべて含まれています。「各バックエンドのドライバー定義の作成」および「完全な Heat テンプレート例」でオーケストレーションした、各 XML ファイルに対するバックエンドの定義も作成します。

parameters: # 1
  CinderEnableIscsiBackend: false
  CinderEnableRbdBackend: false
  CinderEnableNfsBackend: false
  NovaEnableRbdBackend: false
  GlanceBackend: file # 2

resource_registry:
  OS::TripleO::NodeExtraConfig: /home/stack/templates/eternus-temp.yaml  # 3

parameter_defaults:
  controllerExtraConfig: # 4
    cinder::config::cinder_config:
        FJFC/volume_driver: # 5
            value: cinder.volume.drivers.fujitsu.eternus_dx_fc.FJDXFCDriver
        FJFC/cinder_eternus_config_file: # 6
            value: /etc/cinder/eternus-fc.xml
        FJFC/volume_backend_name: # 7
            value: FJFC
        FJISCSI/volume_driver: # 8
            value: cinder.volume.drivers.fujitsu.eternus_dx_iscsi.FJDXISCSIDriver
        FJISCSI/cinder_eternus_config_file:
            value: /etc/cinder/eternus-iscsi.xml
        FJISCSI/volume_backend_name:
            value: FJISCSI
    cinder_user_enabled_backends: [FJFC,FJISCSI] # 9

環境ファイルの作成後には、設定をデプロイすることができます。この目的で、/home/stack/templates/eternusbackend-env.yaml の環境ファイルを使用する方法についての情報は、「設定したバックエンドのデプロイ」を参照してください。

/home/stack/templates/ に custom-env.yaml ファイルを作成したら、stack ユーザーとしてログインし、以下のコマンドを実行してバックエンド設定をデプロイします。

$ openstack overcloud deploy --templates -e /home/stack/templates/eternusbackend-env.yaml

director がオーケストレーションを完了したら、バックエンドをテストします。手順は、「設定のテスト」を参照してください。

Block Storage サービスが新しい ETERNUS バックエンドを使用するように設定した後には、それぞれの ボリューム種別 を宣言します。ボリューム種別の設定により、新規ボリュームの作成時に使用するバックエンドを指定することができます。以下のコマンドを実行すると、FJFC ファイバーチャネルバックエンド) と FJISCSI (iSCSI バックエンド) の 2 つのボリュームが作成されます。

# cinder type-create FJFC
# cinder type-create FJISCSI

次に、ボリューム種別をそれぞれのバックエンドにマッピングします (「環境ファイルの作成」の定義に従います)。

# cinder type-key FJFC set volume_backend_name=FJFC
# cinder type-key FJISCSI volume_backend_name=FJISCSI

test_iscsi という名前の 1 GB の iSCSI ボリュームを作成して、設定を検証します。

# cinder create --volume_type FJISCSI --display_name test_iscsi 1

ファイバーチャネルバックエンドをテストするには、以下のコマンドを実行します。

# cinder create --volume_type FJFC --display_name test_fc 1