10.4. iSCSI ターゲットの設定

手順

1. ホストで実行している iSCSI コンテナーの情報を取得します。

   例

   Copy to Clipboard Toggle word wrap

   [root@iscsigw ~]# podman ps
   [root@iscsigw ~]# podman exec -it 4b5ffb814409 /bin/bash

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

   Copy to Clipboard Toggle word wrap

   [root@iscsigw ~]# gwcli

3. iscsi-targets ディレクトリーに移動します。

   例

   Copy to Clipboard Toggle word wrap

   />cd /iscsi-targets

4. IPv4 アドレスまたは IPv6 アドレスのいずれかを使用して iSCSI ゲートウェイを作成します。

   構文

   Copy to Clipboard Toggle word wrap

   />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

   例

   Copy to Clipboard Toggle word wrap

   />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

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

   構文

   Copy to Clipboard Toggle word wrap

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

   例

   Copy to Clipboard Toggle word wrap

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

   注記

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

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

   構文

   Copy to Clipboard Toggle word wrap

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

   例

   Copy to Clipboard Toggle word wrap

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

   重要

   Red Hat は、Challenge Handshake Authentication Protocol (CHAP) が一部で有効になっており、他で無効になっているなど、クライアントの混同はサポートしていません。すべてのクライアントの CHAP を有効にするか、無効にする必要があります。デフォルトの動作としては、イニシエーター名でイニシエーターを認証するだけです。

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   /> 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)]

7. ディスクをクライアントに追加します。

   構文

   Copy to Clipboard Toggle word wrap

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

   例

   Copy to Clipboard Toggle word wrap

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

8. Ceph ISCSI ゲートウェイが機能していることを確認します。

   Copy to Clipboard Toggle word wrap

   /> 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 ゲートウェイノードで実行されていることを確認します。

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

   構文

   Copy to Clipboard Toggle word wrap

   />disks/ reconfigure POOL_NAME/IMAGE_NAME max_data_area_mb NEW_BUFFER_SIZE

   例

   Copy to Clipboard Toggle word wrap

   />disks/ reconfigure rbd/disk_1 max_data_area_mb 64

   注記

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

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

手順

1. ホストで実行している iSCSI コンテナーの情報を取得します。

   例

   Copy to Clipboard Toggle word wrap

   [root@iscsigw ~] podman ps
   CONTAINER ID  IMAGE                                           COMMAND   CREATED    STATUS  PORTS  NAMES
   4b5ffb814409  registry.redhat.io/rhceph-alpha/rhceph-5-rhel8:latest    2 hours ago         Up 2 hours ago ceph-f838eb7a-597c-11eb-b0a9-525400e2439c-iscsi.iscsi.cephLab2-node-01.anaahg

2. iSCSI コンテナー ID を使用してコンテナーに移動します。

   例

   Copy to Clipboard Toggle word wrap

   [root@iscsigw ~]# podman exec -it 4b5ffb814409 /bin/bash

3. gwcli コマンドを実行します。

   Copy to Clipboard Toggle word wrap

   [ceph: root@iscsigw /]# gwcli

4. 新規ホストグループを作成します。

   構文

   Copy to Clipboard Toggle word wrap

   cd iscsi-targets/
   cd IQN/host-groups
   create group_name=GROUP_NAME

   例

   Copy to Clipboard Toggle word wrap

   /> cd iscsi-targets/
   /iscsi-targets> cd iqn.2003-01.com.redhat.iscsi-gw:ceph-igw/host-groups/
   /iscsi-target.../host-groups> create group_name=igw_grp01

5. ホストグループにホストを追加します。

   重要

   ホストを追加する前に、ホストに追加したすべてのディスクをホストグループから削除してください。そうでないと、ホストグループにホストを追加することはできません。

   構文

   Copy to Clipboard Toggle word wrap

   cd GROUP_NAME
   host add client_iqn=CLIENT_IQN

   例

   Copy to Clipboard Toggle word wrap

   > cd igw_grp01
   /iscsi-target.../host-groups/igw_grp01> host add client_iqn=iqn.1994-05.com.redhat:rh8-client

   この手順を繰り返して、追加のホストをグループに追加します。

6. ホストグループにディスクを追加します。

   構文

   Copy to Clipboard Toggle word wrap

   cd /disks/
   /disks> create pool=POOL image=IMAGE_NAME size=SIZE
   cd /IQN/host-groups/GROUP_NAME
   disk add POOL/IMAGE_NAME

   例

   Copy to Clipboard Toggle word wrap

   > cd /disks/
   /disks> create pool=rbd image=rbdimage size=1G
   /> cd iscsi-targets/iqn.2003-01.com.redhat.iscsi-gw:ceph-igw/host-groups/igw_grp01/
   /iscsi-target...s/igw_grp01> disk add rbd/rbdimage

   この手順を繰り返して、グループにディスクを追加します。