Chapter 10. The Ceph iSCSI Gateway (Limited Availability)

Procedure

1. Retrieve the information of the iSCSI container on the host:

   Example

   [root@iscsigw ~]# podman ps

   Copy to Clipboard Toggle word wrap

2. Log into the Cephadm shell:

   Example

   [root@iscsigw ~]# cephadm shell

   Copy to Clipboard Toggle word wrap

3. Optional: On all Ceph iSCSI gateway hosts, install and configure the OpenSSL utility, if needed.

   1. Install the openssl package:

      Example

      [ceph: root@iscsigw /]# yum install openssl

      Copy to Clipboard Toggle word wrap

   2. On the primary iSCSI gateway node, create a directory to hold the SSL keys:

      Example

      [ceph: root@iscsigw /]# mkdir ~/ssl-keys
      [ceph: root@iscsigw /]# cd ~/ssl-keys

      Copy to Clipboard Toggle word wrap

   3. On the primary iSCSI gateway node, create the certificate and key files. Enter the environmental information when prompted.

      Example

      [ceph: root@iscsigw /]# openssl req -newkey rsa:2048 -nodes -keyout iscsi-gateway.key -x509 -days 365 -out iscsi-gateway.crt

      Copy to Clipboard Toggle word wrap

   4. On the primary iSCSI gateway node, create a PEM file:

      Example

      [ceph: root@iscsigw /]# cat iscsi-gateway.crt iscsi-gateway.key > iscsi-gateway.pem

      Copy to Clipboard Toggle word wrap

   5. On the primary iSCSI gateway node, create a public key:

      Example

      [ceph: root@iscsigw /]# openssl x509 -inform pem -in iscsi-gateway.pem -pubkey -noout > iscsi-gateway-pub.key

      Copy to Clipboard Toggle word wrap

   6. From the primary iSCSI gateway node, copy the iscsi-gateway.crt, iscsi-gateway.pem, iscsi-gateway-pub.key, and iscsi-gateway.key files to the /etc/ceph/ directory on the other iSCSI gateway hosts.

4. Create a pool using the following commands:

   Syntax

   ceph osd pool create POOL_NAME PG_NUM
   ceph osd pool application enable POOL_NAME rbd
   rbd pool init -p POOL_NAME

   Copy to Clipboard Toggle word wrap

   Example

   [ceph: root@iscsigw /]# ceph osd pool create pool1 100
   [ceph: root@iscsigw /]# ceph osd pool application enable pool1 rbd
   [ceph: root@iscsigw /]# rbd pool init -p pool1

   Copy to Clipboard Toggle word wrap

5. Create a configuration file on a Ceph iSCSI gateway node.

   1. Create a file named iscsi-gateway.yaml in the /etc/ceph/ directory:

      Example

      [ceph: root@iscsigw /]# touch /etc/ceph/iscsi-gateway.yaml

      Copy to Clipboard Toggle word wrap

   2. Edit the iscsi-gateway.yaml file and add the following lines:

      Syntax

      service_type: iscsi
      service_id: iscsi
      placement:
        hosts:
          - HOST_NAME
          - HOST_NAME
      spec:
        pool: POOL_NAME  # RADOS pool where ceph-iscsi config data is stored.
        trusted_ip_list: "IP_ADDRESS_1,IP_ADDRESS_2"

      Copy to Clipboard Toggle word wrap

      Example

      service_type: iscsi
      service_id: iscsi
      placement:
        hosts:
        - host01
        - host02
      spec:
        pool: iscsipool1
        trusted_ip_list: "10.80.100.100,10.8.100.113"

      Copy to Clipboard Toggle word wrap

6. Change the path to /etc/ceph/ and apply the specification with the following command:

   Example

   [ceph: root@iscsigw /]# ceph orch apply -i iscsi-gateway.yaml

   Copy to Clipboard Toggle word wrap

7. Next, configure targets, LUNs, and clients. See the Configuring the iSCSI target using the command-line interface section for details.

Procedure

1. Retrieve the information of the iSCSI container running on the host:

   Example

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

   Copy to Clipboard Toggle word wrap

2. Start the iSCSI gateway command-line interface:

   [root@iscsigw ~]# gwcli

   Copy to Clipboard Toggle word wrap

3. Navigate to the iscsi-targets directory:

   Example

   />cd /iscsi-targets

   Copy to Clipboard Toggle word wrap

4. Create the iSCSI gateways using either IPv4 or IPv6 addresses:

   Syntax

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

   Example

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

   Copy to Clipboard Toggle word wrap

5. Add a Ceph block device:

   Syntax

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

   Copy to Clipboard Toggle word wrap

   Example

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

   Copy to Clipboard Toggle word wrap

   Note

   Do not use any periods (.) in the pool or image name.

6. Create a client:

   Syntax

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

   Copy to Clipboard Toggle word wrap

   Example

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

   Copy to Clipboard Toggle word wrap

   Important

   Red Hat does not support mixing clients, some with Challenge Handshake Authentication Protocol (CHAP) enabled and some CHAP disabled. All clients must have either CHAP enabled or have CHAP disabled. The default behavior is to only authenticate an initiator by its initiator name.

   If initiators are failing to log into the target, the CHAP authentication might not be configured correctly for some initiators, for example:

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

   Copy to Clipboard Toggle word wrap

   Use the following command at the hosts level to reset all the CHAP authentication:

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

   Copy to Clipboard Toggle word wrap

7. Add disks to a client:

   Syntax

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

   Example

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

   Copy to Clipboard Toggle word wrap

8. Verify that the Ceph ISCSI gateways are working:

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

   Copy to Clipboard Toggle word wrap

   If the status is UNKNOWN, check for network issues and any misconfigurations. If using a firewall, verify that the appropriate TCP port is open. Verify that the iSCSI gateway is listed in the trusted_ip_list option. Verify that the rbd-target-api service is running on the iSCSI gateway node.

9. Optionally, reconfigure the max_data_area_mb option:

   Syntax

   />disks/ reconfigure POOL_NAME/IMAGE_NAME max_data_area_mb NEW_BUFFER_SIZE

   Copy to Clipboard Toggle word wrap

   Example

   />disks/ reconfigure rbd/disk_1 max_data_area_mb 64

   Copy to Clipboard Toggle word wrap

   Note

   The max_data_area_mb option controls the amount of memory in megabytes that each image can use to pass SCSI command data between the iSCSI target and the Ceph cluster. If this value is too small, it can result in excessive queue full retries which will affect performance. If the value is too large, it can result in one disk using too much of the system memory, which can cause allocation failures for other subsystems. The default value for the max_data_area_mb option is 8.

10. Configure an iSCSI initiator.

Procedure

1. Retrieve the information of the iSCSI container running on the host:

   Example

   [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

   Copy to Clipboard Toggle word wrap

2. Use the iSCSI container ID to enter into the container:

   Example

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

   Copy to Clipboard Toggle word wrap

3. Run the gwcli command:

   [ceph: root@iscsigw /]# gwcli

   Copy to Clipboard Toggle word wrap

4. Create a new host group:

   Syntax

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

   Copy to Clipboard Toggle word wrap

   Example

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

   Copy to Clipboard Toggle word wrap

5. Add a host to the host group:

   Important

   Ensure that you remove all the disks that are added to the host, before adding the host to the host group otheriwse, a host cannot be added to the hostgroup.

   Syntax

   cd GROUP_NAME
   host add client_iqn=CLIENT_IQN

   Copy to Clipboard Toggle word wrap

   Example

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

   Copy to Clipboard Toggle word wrap

   Repeat this step to add additional hosts to the group.

6. Add a disk to the host group:

   Syntax

   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

   Example

   > 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

   Copy to Clipboard Toggle word wrap

   Repeat this step to add additional disks to the group.

Procedure

1. Install the iSCSI initiator and multipath tools:

   [root@rhel ~]# yum install iscsi-initiator-utils
   [root@rhel ~]# yum install device-mapper-multipath

   Copy to Clipboard Toggle word wrap
2. Set the initiator name by editing the /etc/iscsi/initiatorname.iscsi file. Note that the initiator name must match the initiator name that was used during the initial setup using the gwcli command.

3. Configure multipath I/O.

   1. Create the default /etc/multipath.conf file and enable the multipathd service:

      [root@rhel ~]# mpathconf --enable --with_multipathd y

      Copy to Clipboard Toggle word wrap

   2. Update the /etc/multipath.conf file as follows:

      devices {
              device {
                      vendor                 "LIO-ORG"
                      product                "TCMU device"
                      hardware_handler       "1 alua"
                      path_grouping_policy   "failover"
                      path_selector          "queue-length 0"
                      failback               60
                      path_checker           tur
                      prio                   alua
                      prio_args              exclusive_pref_bit
                      fast_io_fail_tmo       25
                      no_path_retry          queue
              }
      }

      Copy to Clipboard Toggle word wrap

   3. Restart the multipathd service:

      [root@rhel ~]# systemctl reload multipathd

      Copy to Clipboard Toggle word wrap

4. Set up CHAP and iSCSI discovery and login.

   1. Provide a CHAP user name and password by updating the /etc/iscsi/iscsid.conf file accordingly, for example:

      node.session.auth.authmethod = CHAP
      node.session.auth.username = user
      node.session.auth.password = password

      Copy to Clipboard Toggle word wrap

   2. Discover the target portals:

      Syntax

      iscsiadm -m discovery -t st -p IP_ADDR

      Copy to Clipboard Toggle word wrap

   3. Log in to target:

      Syntax

      iscsiadm -m node -T TARGET -l

      Copy to Clipboard Toggle word wrap

5. View the multipath I/O configuration. The multipathd daemon sets up devices automatically based on the settings in the multipath.conf file.

   1. Use the multipath command to show devices setup in a failover configuration with a priority group for each path, for example:

      Example

      [root@rhel ~]# multipath -ll
      mpathbt (360014059ca317516a69465c883a29603) dm-1 LIO-ORG,TCMU device
      size=1.0G features='0' hwhandler='1 alua' wp=rw
      |-+- policy='queue-length 0' prio=50 status=active
      | `- 28:0:0:1 sde  8:64  active ready running
      `-+- policy='queue-length 0' prio=10 status=enabled
        `- 29:0:0:1 sdc  8:32  active ready running

      Copy to Clipboard Toggle word wrap

      The multipath -ll output prio value indicates the ALUA state, where prio=50 indicates it is the path to the owning iSCSI gateway in the ALUA Active-Optimized state and prio=10 indicates it is an Active-non-Optimized path. The status field indicates which path is being used, where active indicates the currently used path, and enabled indicates the failover path, if the active fails.

   2. To match the device name, for example, sde in the multipath -ll output, to the iSCSI gateway:

      Example

      [root@rhel ~]# iscsiadm -m session -P 3

      Copy to Clipboard Toggle word wrap

      The Persistent Portal value is the IP address assigned to the iSCSI gateway listed in the gwcli utility.

Procedure

1. Configure multipath I/O.

   1. Update the /etc/multipath/conf.d/DEVICE_NAME.conf file as follows:

      devices {
              device {
                      vendor                 "LIO-ORG"
                      product                "TCMU device"
                      hardware_handler       "1 alua"
                      path_grouping_policy   "failover"
                      path_selector          "queue-length 0"
                      failback               60
                      path_checker           tur
                      prio                   alua
                      prio_args              exclusive_pref_bit
                      fast_io_fail_tmo       25
                      no_path_retry          queue
              }
      }

      Copy to Clipboard Toggle word wrap

   2. Restart the multipathd service:

      [root@rhv ~]# systemctl reload multipathd

      Copy to Clipboard Toggle word wrap
2. Click the Storage resource tab to list the existing storage domains.
3. Click the New Domain button to open the New Domain window.
4. Enter the Name of the new storage domain.
5. Use the Data Center drop-down menu to select an data center.
6. Use the drop-down menus to select the Domain Function and the Storage Type. The storage domain types that are not compatible with the chosen domain function are not available.
7. Select an active host in the Use Host field. If this is not the first data domain in a data center, you must select the data center’s SPM host.

8. The New Domain window automatically displays known targets with unused LUNs when iSCSI is selected as the storage type. If the target that you are adding storage from is not listed then you can use target discovery to find it, otherwise proceed to the next step.

   1. Click Discover Targets to enable target discovery options. When targets have been discovered and logged in to, the New Domain window automatically displays targets with LUNs unused by the environment. Note that LUNs external to the environment are also displayed. You can use the Discover Targets options to add LUNs on many targets, or multiple paths to the same LUNs.
   2. Enter the fully qualified domain name or IP address of the iSCSI host in the Address field.
   3. Enter the port to connect to the host on when browsing for targets in the Port field. The default is 3260.
   4. If the Challenge Handshake Authentication Protocol (CHAP) is being used to secure the storage, select the User Authentication check box. Enter the CHAP user name and CHAP password.
   5. Click the Discover button.

   6. Select the target to use from the discovery results and click the Login button. Alternatively, click the Login All to log in to all of the discovered targets.

      Important

      If more than one path access is required, ensure to discover and log in to the target through all the required paths. Modifying a storage domain to add additional paths is currently not supported.

9. Click the + button next to the desired target. This will expand the entry and display all unused LUNs attached to the target.
10. Select the check box for each LUN that you are using to create the storage domain.

11. Optionally, you can configure the advanced parameters.

    1. Click Advanced Parameters.
    2. Enter a percentage value into the Warning Low Space Indicator field. If the free space available on the storage domain is below this percentage, warning messages are displayed to the user and logged.
    3. Enter a GB value into the Critical Space Action Blocker field. If the free space available on the storage domain is below this value, error messages are displayed to the user and logged, and any new action that consumes space, even temporarily, will be blocked.
    4. Select the Wipe After Delete check box to enable the wipe after delete option. You can edit this option after creating the domain, but doing so does not change the wipe after delete property of disks that already exist.
    5. Select the Discard After Delete check box to enable the discard after delete option. You can edit this option after creating the domain. This option is only available to block storage domains.
12. Click OK to create the storage domain and close the window.

Procedure

1. Install the iSCSI initiator and configure discovery and setup.

   1. Install the iSCSI initiator driver and MPIO tools.
   2. Launch the MPIO program, click the Discover Multi-Paths tab, check the Add support for iSCSI devices box, and click Add.
   3. Reboot the MPIO program.
   4. On the iSCSI Initiator Properties window, on the Discovery tab, add a target portal. Enter the IP address or DNS name and Port of the Ceph iSCSI gateway.
   5. On the Targets tab, select the target and click Connect.
   6. On the Connect To Target window, select the Enable multi-path option, and click the Advanced button.

   7. Under the Connect using section, select the Microsoft ISCSI Intiator as the Local adapter from the drop-down box. Select the Windows client IP address as the Initiator IP from the drop-down box. Select a Target portal IP address. Select Enable CHAP login on and enter the Name and Target secret values from the Ceph iSCSI client credentials section, and click OK.

      Important

      Windows Server 2016 does not accept a CHAP secret less than 12 bytes.

   8. Repeat the previous two steps for each target portal defined when setting up the iSCSI gateway before clicking on the Connecting tab.
   9. If the initiator name is different than the initiator name used during the initial setup, rename the initiator name. From iSCSI Initiator Properties window, on the Configuration tab, click the Change button to rename the initiator name.

2. Set up multipath I/O. In PowerShell, use the PDORemovePeriod command to set the MPIO load balancing policy and the mpclaim command to set the load balancing policy. The iSCSI Initiator Tool configures the remaining options.

   Note

   Red Hat recommends increasing the PDORemovePeriod option to 120 seconds from PowerShell. You might need to adjust this value based on the application. When all paths are down, and 120 seconds expires, the operating system starts failing I/O requests.

   Set-MPIOSetting -NewPDORemovePeriod 120

   Copy to Clipboard Toggle word wrap

   1. Set the failover policy

      mpclaim.exe -l -m 1

      Copy to Clipboard Toggle word wrap

   2. Verify the failover policy

      mpclaim -s -m
      MSDSM-wide Load Balance Policy: Fail Over Only

      Copy to Clipboard Toggle word wrap
   3. Using the iSCSI Initiator tool, from the Targets tab click on the Devices…​ button:
   4. From the Devices window, select a disk and click the MPIO…​ button:
   5. The Device Details window displays the paths to each target portal. The Load Balancing Policy Fail Over Only must be selected.

   6. View the multipath configuration from the PowerShell:

      mpclaim -s -d MPIO_DISK_ID

      Copy to Clipboard Toggle word wrap

      Replace MPIO_DISK_ID with the appropriate disk identifier.

      Note

      There is one Active/Optimized path which is the path to the iSCSI gateway node that owns the LUN, and there is an Active/Unoptimized path for each other iSCSI gateway node.

3. Optionally, tune the settings. Consider using the following registry settings:

   • Windows Disk Timeout

     Key

     HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Disk

     Copy to Clipboard Toggle word wrap

     Value

     TimeOutValue = 65

     Copy to Clipboard Toggle word wrap

   • Microsoft iSCSI Initiator Driver

     Key

     HKEY_LOCAL_MACHINE\\SYSTEM\CurrentControlSet\Control\Class\{4D36E97B-E325-11CE-BFC1-08002BE10318}\<Instance_Number>\Parameters

     Copy to Clipboard Toggle word wrap

     Values

     LinkDownTime = 25
     SRBTimeoutDelta = 15

     Copy to Clipboard Toggle word wrap

Procedure

1. Log into the VMware ESXi web interface.
2. Click on Actions highlight Services click Enable SSH.

3. Log into the VMware ESXi host console, and disable HardwareAcceleratedMove (XCOPY):

   > esxcli system settings advanced set --int-value 0 --option /DataMover/HardwareAcceleratedMove

   Copy to Clipboard Toggle word wrap
4. From the VMware ESXi web interface, on the Navigator pane, click Storage. Click on the Adapters tab. Highlight the adapter, and click on Configure iSCSI.
5. Verify the initiator name in the Name & alias field.

6. If the initiator name is different than the initiator name used when creating the client during the initial setup using the gwcli utility, then change the initiator name. From the VMware ESXi host console, do the following steps.

   1. Get the adapter name for the iSCSI software:

      > esxcli iscsi adapter list
      > Adapter  Driver     State   UID            Description
      > -------  ---------  ------  -------------  ----------------------
      > vmhba64  iscsi_vmk  online  iscsi.vmhba64  iSCSI Software Adapter

      Copy to Clipboard Toggle word wrap

   2. Set the initiator name:

      Syntax

      esxcli iscsi adapter set -A ADAPTOR_NAME -n INITIATOR_NAME

      Copy to Clipboard Toggle word wrap

      Example

      > esxcli iscsi adapter set -A vmhba64 -n iqn.1994-05.com.redhat:rh8-client

      Copy to Clipboard Toggle word wrap

   3. Verify the new initiator name from the VMware ESXi web interface. Click Storage in the Navigator pane. Click Software iSCSI. The new initiator name is in the Name & alias field, along with the Ceph Object Gateway node names.

7. Expand the CHAP authentication section. From the drop-down list, select Do not use CHAP unless required by target. Enter the CHAP Name and Secret credentials that were used in the initial setup. Verify the Mutual CHAP authentication section has Do not use CHAP selected.

   Important

   The usernames/passwords should not be the same for admin and mutual CHAP authentication.

   • The username/mutual_username is 8-64 characters long, containing any alphanumeric in the range of [0-9, a-z, A-Z] and ., :, @, _, -.
   • The password/mutual_password is 12-16 characters long, containing any alphanumeric in the range of [0-9, a-z, A-Z] and @, -, _, /.
   Warning

   Due to a bug in the VMware host client, the CHAP settings are not used initially. On the Ceph iSCSI gateway node, the kernel logs include the following errors as an indication of this bug:

   > kernel: CHAP user or password not set for Initiator ACL
   > kernel: Security negotiation failed.
   > kernel: iSCSI Login negotiation failed.

   Copy to Clipboard Toggle word wrap

   To work around this bug, configure the CHAP settings using the esxcli command. The authname argument is the Name in the CHAP authentication section:

   Syntax

   esxcli iscsi adapter auth chap set --direction=uni --authname=ISCSI_USER_NAME --secret=ISCSI_PASSWORD --level=discouraged -A ADAPTOR_NAME

   Copy to Clipboard Toggle word wrap

8. Expand Advanced settings section. Set the RecoveryTimeout value to 25.

9. In the Dynamic targets section, click on Add dynamic target. Under the Address field click to add an IP addresses for one of the Ceph iSCSI gateways. Only one IP address needs to be added. Finally, click the Save configuration button. Click on the Devices tab to see the RBD image.

   Note

   LUN is configured automatically, using the ALUA SATP and MRU PSP. Do not use other SATPs and PSPs. You can verify this by the esxcli command:

   Syntax

   esxcli storage nmp path list -d eui.DEVICE_ID

   Copy to Clipboard Toggle word wrap

   Replace DEVICE_ID with the appropriate device identifier.

10. From the VMware ESXi host console, verify that multipathing is set up correctly.

    1. List the devices:

       Example

       > esxcli storage nmp device list | grep iSCSI
          Device Display Name: LIO-ORG iSCSI Disk (naa.6001405f8d087846e7b4f0e9e3acd44b)
          Device Display Name: LIO-ORG iSCSI Disk (naa.6001405057360ba9b4c434daa3c6770c)

       Copy to Clipboard Toggle word wrap

    2. Get the multipath information for the Ceph iSCSI disk from the previous step:

       Example

       > esxcli storage nmp path list -d naa.6001405f8d087846e7b4f0e9e3acd44b
       
       iqn.2005-03.com.ceph:esx1-00023d000001,iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw,t,1-naa.6001405f8d087846e7b4f0e9e3acd44b
          Runtime Name: vmhba64:C0:T0:L0
          Device: naa.6001405f8d087846e7b4f0e9e3acd44b
          Device Display Name: LIO-ORG iSCSI Disk (naa.6001405f8d087846e7b4f0e9e3acd44b)
          Group State: active
          Array Priority: 0
          Storage Array Type Path Config: {TPG_id=1,TPG_state=AO,RTP_id=1,RTP_health=UP}
          Path Selection Policy Path Config: {current path; rank: 0}
       
       iqn.2005-03.com.ceph:esx1-00023d000002,iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw,t,2-naa.6001405f8d087846e7b4f0e9e3acd44b
          Runtime Name: vmhba64:C1:T0:L0
          Device: naa.6001405f8d087846e7b4f0e9e3acd44b
          Device Display Name: LIO-ORG iSCSI Disk (naa.6001405f8d087846e7b4f0e9e3acd44b)
          Group State: active unoptimized
          Array Priority: 0
          Storage Array Type Path Config: {TPG_id=2,TPG_state=ANO,RTP_id=2,RTP_health=UP}
          Path Selection Policy Path Config: {non-current path; rank: 0}

       Copy to Clipboard Toggle word wrap

       From the example output, each path has an iSCSI or SCSI name with the following parts:

       Initiator name = iqn.2005-03.com.ceph:esx1 ISID = 00023d000002 Target name = iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw Target port group = 2 Device id = naa.6001405f8d087846e7b4f0e9e3acd44b

       The Group State value of active indicates this is the Active-Optimized path to the iSCSI gateway. The gwcli command lists the active as the iSCSI gateway owner. The rest of the paths have the Group State value of unoptimized and are the failover path, if the active path goes into a dead state.

    3. To match all paths to their respective iSCSI gateways:

       Example

       > esxcli iscsi session connection list
       vmhba64,iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw,00023d000001,0
          Adapter: vmhba64
          Target: iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw
          ISID: 00023d000001
          CID: 0
          DataDigest: NONE
          HeaderDigest: NONE
          IFMarker: false
          IFMarkerInterval: 0
          MaxRecvDataSegmentLength: 131072
          MaxTransmitDataSegmentLength: 262144
          OFMarker: false
          OFMarkerInterval: 0
          ConnectionAddress: 10.172.19.21
          RemoteAddress: 10.172.19.21
          LocalAddress: 10.172.19.11
          SessionCreateTime: 08/16/18 04:20:06
          ConnectionCreateTime: 08/16/18 04:20:06
          ConnectionStartTime: 08/16/18 04:30:45
          State: logged_in
       
       vmhba64,iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw,00023d000002,0
          Adapter: vmhba64
          Target: iqn.2003-01.com.redhat.iscsi-gw:iscsi-igw
          ISID: 00023d000002
          CID: 0
          DataDigest: NONE
          HeaderDigest: NONE
          IFMarker: false
          IFMarkerInterval: 0
          MaxRecvDataSegmentLength: 131072
          MaxTransmitDataSegmentLength: 262144
          OFMarker: false
          OFMarkerInterval: 0
          ConnectionAddress: 10.172.19.22
          RemoteAddress: 10.172.19.22
          LocalAddress: 10.172.19.12
          SessionCreateTime: 08/16/18 04:20:06
          ConnectionCreateTime: 08/16/18 04:20:06
          ConnectionStartTime: 08/16/18 04:30:41
          State: logged_in

       Copy to Clipboard Toggle word wrap

       Match the path name with the ISID value, and the RemoteAddress value is the IP address of the owning iSCSI gateway.

11. From the VMware ESXi web interface, click on the Devices tab to see the iSCSI disk.

12. Click on New datastore to start the wizard.

    1. Provide a name for the new datastore, and click Next.
    2. Select Use full disk, and click Next.
    3. Click Finish. A warning message appears about erasing the disk. Click Yes to proceed, and create the new datastore.
    4. The new datastore will appear on the Datastores tab.

13. You can check disk usage by selecting the datastore name. You can also check disk usage from Ceph by running the following command:

    Syntax

    rbd du --pool POOL_NAME

    Copy to Clipboard Toggle word wrap

    Example

    [root@rbd-client ~]# rbd du --pool rbdpool

    Copy to Clipboard Toggle word wrap

Procedure

1. On the new iSCSI gateway hosts, enable the Red Hat Ceph Storage Tools repository:

   Example

   [root@iscsigw ~]# subscription-manager repos --enable=rhceph-5-tools-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

2. Install the ceph-iscsi, and tcmu-runner packages:

   Example

   [root@iscsigw ~]# dnf install ceph-iscsi tcmu-runner

   Copy to Clipboard Toggle word wrap

3. Create the specification file:

   Syntax

   cat iscsi-gateway.yaml
   
   service_type: iscsi
   service_id: SERVICE_ID
   service_name: SERVICE_NAME
   placement:
   hosts:
      - HOSTNAME_1
      - HOSTNAME_2
      - HOSTNAME_3
      - HOSTNAME_4
   spec:
    pool: POOL_NAME
    trusted_ip_list: IP_ADDRESS_1, IP_ADDRESS_2, IP_ADDRESS_3, IP_ADDRESS_4

   Copy to Clipboard Toggle word wrap

   Example

   [root@iscsigw ~]# cat iscsi-gateway.yaml
   
   service_type: iscsi
   service_id: iscsi
   service_name: iscsi.iscsi
   placement:
   hosts:
       - host01
       - host02
       - host03
       - host04
   spec:
    pool: rbd
    trusted_ip_list: 192.168.0.10,192.168.0.13,192.168.0.198,192.168.0.50,192.168.0.51

   Copy to Clipboard Toggle word wrap

4. Optional: Add proper rules in firewall for the newly added node/nodes:

   Example

   [root@host01 ~]# firewall-cmd --permanent --add-port=5000/tcp ; firewall-cmd --permanent --add-port=3260/tcp ; firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

   Note

   cephadm might open the ports on its own.

5. Mount the YAML file under a directory in the container:

   Example

   [root@host01 ~]# cephadm shell --mount iscsi-gateway.yaml:/var/lib/ceph/iscsi-gateway.yaml

   Copy to Clipboard Toggle word wrap

6. Navigate to the directory:

   Example

   [ceph: root@host01 /]# cd /var/lib/ceph

   Copy to Clipboard Toggle word wrap

7. Deploy the Ceph iSCSI service:

   Syntax

   ceph orch apply -i FILE_NAME.yaml

   Copy to Clipboard Toggle word wrap

   Example

   [ceph: root@host01 ceph]# ceph orch apply -i iscsi-gateway.yaml

   Copy to Clipboard Toggle word wrap

8. Optional: Deploy the Ceph iSCSI service using the placement specification:

   Syntax

   ceph orch apply iscsi POOL_NAME --placement="HOSTNAME_1,HOSTNAME_2,HOSTNAME_3,HOSTNAME_4" --trusted_ip_list="IP_ADDRESS_1,IP_ADDRESS_2,IP_ADDRESS_3,IP_ADDRESS_4" admin admin

   Copy to Clipboard Toggle word wrap

   Example

   [ceph: root@host01 ceph]# ceph orch apply iscsi iscsipool --placement="ceph-amk5-m0g9z7-node1-installer,ceph-amk5-m0g9z7-node4" --trusted_ip_list="10.0.210.209,10.0.210.153,192.168.0.50,192.168.0.51" admin admin

   Copy to Clipboard Toggle word wrap

9. Verify the installation:

   Example

   [ceph: root@host01 /]# ceph orch ls --service_type=iscsi
   
   NAME       PORTS   RUNNING  REFRESHED  AGE  PLACEMENT
   iscsi.foo  ?:5000      3/3  10m ago    75s  host01;host02;host03;host04

   Copy to Clipboard Toggle word wrap

10. From the ceph orch ps command, get the hostname on which iSCSI is installed:

    Example

    [ceph: root@host01 /]# ceph orch ps --daemon_type=iscsi
    
    NAME               HOST   PORTS   STATUS        REFRESHED  AGE  MEM USE  MEM LIM  VERSION  IMAGE ID      CONTAINER ID
    
    iscsi.foo.host02  host02  *:9095  running (2h)     8m ago   2h    85.3M        -  2.22.2   ac25aac5d567  ad8c7593d7c0

    Copy to Clipboard Toggle word wrap

11. Enter the container:

    Example

    [ceph: root@host01 /]#  cephadm enter --name iscsi.foo.host02.tetras

    Copy to Clipboard Toggle word wrap

12. Add the gateway using the gwcli from the iSCSI container:

    Example

    [root@host02 /]# gwcli
    /iscsi-target...get1/gateways> goto gateways
    /iscsi-target...get1/gateways> create host03 192.168.0.50
    Adding gateway, sync'ing 1 disk(s) and 1 client(s)
    ok
    /iscsi-target...get1/gateways> create host04 192.168.0.51
    Adding gateway, sync'ing 1 disk(s) and 1 client(s)
    ok
    /iscsi-target...get1/gateways> ls
    o- gateways .................................................................................................. [Up: 3/3, Portals: 3]
      o- host01 .................................................................................. [192.168.0.10 (UP)]
      o- host02.................................................................................. [192.168.0.13 (UP)]s
      o- host03.................................................................................... [192.168.0.50 (UP)]
      o- host04.................................................................................... [192.168.0.51 (UP)]
    /iscsi-target...get1/gateways>

    Copy to Clipboard Toggle word wrap