7.4.2. コマンドラインインターフェースを使用した iSCSI ターゲットの設定

Ceph iSCSI ゲートウェイは、iSCSI ターゲットノードおよび Ceph クライアントノードでもあります。Ceph iSCSI ゲートウェイをスタンドアロンのノードで設定するか、または Ceph Object Storage Device(OSD)ノードとコロケートします。

警告

本書で指定しない限り、gwcli reconfigure サブコマンドを使用して他のオプションを調整しないでください。

前提条件

  • Ceph iSCSI ゲートウェイソフトウェアのインストール。

Procedure

  1. iSCSI ゲートウェイコマンドラインインターフェースを起動します。

    [root@iscsigw ~]# gwcli
  2. IPv4 アドレスまたは IPv6 アドレスのいずれかを使用して、iSCSI ゲートウェイを作成します。

    構文

    >/iscsi-targets create iqn.2003-01.com.redhat.iscsi-gw:_target_name_
    > goto gateways
    > create ISCSI_GW_NAME IP_ADDR_OF_GW
    > create ISCSI_GW_NAME IP_ADDR_OF_GW

    >/iscsi-targets create iqn.2003-01.com.redhat.iscsi-gw:ceph-igw
    > goto gateways
    > create ceph-gw-1 10.172.19.21
    > create ceph-gw-2 10.172.19.22

    注記

    IPv4 アドレスと IPv6 アドレスの組み合わせを使用することはできません。

  3. Ceph ブロックデバイスを追加します。

    構文

    > cd /disks
    >/disks/ create POOL_NAME image=IMAGE_NAME size=IMAGE_SIZE_m|g|t

    > cd /disks
    >/disks/ create rbd image=disk_1 size=50g

    注記

    プールまたはイメージ名でピリオド(.)を使用しないでください。

  4. クライアントを作成します。

    構文

    > goto hosts
    > create iqn.1994-05.com.redhat:_client_name_
    > auth use username=USER_NAME password=PASSWORD

    > goto hosts
    > create iqn.1994-05.com.redhat:rh7-client
    > auth username=iscsiuser1 password=temp12345678

    重要

    Red Hat では、クライアントの混在をサポートしません。CHAP(チャレンジハンドシェイク認証プロトコル)が有効で、CHAP(CHAP)が無効なものもあります。すべてのクライアントで CHAP が有効になっているか、CHAP が無効になっている必要があります。デフォルトの動作では、イニシエーター名でのみイニシエーターを認証します。

    イニシエーターがターゲットにログインできない場合は、以下のようなイニシエーターで CHAP 認証が正しく設定されないことがあります。

    o- hosts ................................ [Hosts: 2: Auth: MISCONFIG]

    ホストレベルで次のコマンドを使用して、CHAP 認証をすべてリセットします。

    /> goto hosts
    /iscsi-target...csi-igw/hosts> auth nochap
    ok
    ok
    /iscsi-target...csi-igw/hosts> ls
    o- hosts ................................ [Hosts: 2: Auth: None]
      o- iqn.2005-03.com.ceph:esx ........... [Auth: None, Disks: 4(310G)]
      o- iqn.1994-05.com.redhat:rh7-client .. [Auth: None, Disks: 0(0.00Y)]
  5. クライアントにディスクを追加します。

    構文

    >/iscsi-target..eph-igw/hosts
    > cd iqn.1994-05.com.redhat:_CLIENT_NAME_
    > disk add POOL_NAME/IMAGE_NAME

    >/iscsi-target..eph-igw/hosts
    > cd iqn.1994-05.com.redhat:rh7-client
    > disk add rbd/disk_1

  6. API が SSL を正しく使用していることを確認するには、/var/log/rbd-target-api.log または /var/log/rbd-target/rbd-target-api.log (https など)にある rbd-target-api ログファイルを検索します。

    Aug 01 17:27:42 test-node.example.com python[1879]:  * Running on https://0.0.0.0:5000/
  7. Ceph ISCSI ゲートウェイが動作していることを確認します。

    /> goto gateways
    /iscsi-target...-igw/gateways> ls
    o- gateways ............................ [Up: 2/2, Portals: 2]
      o- ceph-gw-1  ........................ [ 10.172.19.21 (UP)]
      o- ceph-gw-2  ........................ [ 10.172.19.22 (UP)]

    ステータスがUNKNOWN の場合は、ネットワークの問題と設定ミスを確認します。ファイアウォールを使用している場合は、適切な TCP ポートが開いていることを確認します。iSCSI ゲートウェイが trusted_ip_list オプションに記載されていることを確認します。rbd-target-api サービスが iSCSI ゲートウェイノードで実行されていることを確認します。

  8. 必要に応じて、max_data_area_mb オプションを再設定します。

    構文

    >/disks/ reconfigure POOL_NAME/IMAGE_NAME max_data_area_mb NEW_BUFFER_SIZE

    >/disks/ reconfigure rbd/disk_1 max_data_area_mb 64

    注記

    max_data_area_mb オプションは、iSCSI ターゲットと Ceph クラスター間で SCSI コマンドデータを渡すために各イメージが使用できるメモリー量を制御します。この値を小さすぎると、キューが過剰に再試行し、パフォーマンスに影響を及ぼします。値が大きすぎると、1 つのディスクがシステムメモリーの多すぎるため、他のサブシステムで割り当てに失敗することがあります。max_data_area_mb オプションのデフォルト値は 8 です。

  9. iSCSI イニシエーターを設定します。

関連情報