Chapter 7. Configuring an iSCSI initiator

Procedure

1. Install iscsi-initiator-utils on client machine:

   # dnf install iscsi-initiator-utils

   Copy to Clipboard Toggle word wrap

2. Start the iscsid service:

   # systemctl start iscsid

   Copy to Clipboard Toggle word wrap

3. Check the initiator name:

   # cat /etc/iscsi/initiatorname.iscsi
   
   InitiatorName=iqn.2006-04.com.example:888

   Copy to Clipboard Toggle word wrap

4. If the ACL was given a custom name in Creating an iSCI ACL, update the initiator name to match the ACL:

   1. Open the /etc/iscsi/initiatorname.iscsi file and modify the initiator name:

      # vi /etc/iscsi/initiatorname.iscsi
      
      InitiatorName=custom-name

      Copy to Clipboard Toggle word wrap

   2. Restart the iscsid service:

      # systemctl restart iscsid

      Copy to Clipboard Toggle word wrap

5. Discover the target and log in to the target with the displayed target IQN:

   # iscsiadm -m discovery -t st -p 10.64.24.179
       10.64.24.179:3260,1 iqn.2006-04.com.example:444
   
   # iscsiadm -m node -T iqn.2006-04.com.example:444 -l
       Logging in to [iface: default, target: iqn.2006-04.com.example:444, portal: 10.64.24.179,3260] (multiple)
       Login to [iface: default, target: iqn.2006-04.com.example:444, portal: 10.64.24.179,3260] successful.

   Copy to Clipboard Toggle word wrap

   Replace 10.64.24.179 with the target-ip-address.

   You can use this procedure for any number of initiators connected to the same target if their respective initiator names are added to the ACL as described in the Creating an iSCSI ACL.

6. Find the iSCSI disk name and create a file system on this iSCSI disk:

   # grep "Attached SCSI" /var/log/messages
   
   # mkfs.ext4 /dev/disk_name

   Copy to Clipboard Toggle word wrap

   Replace disk_name with the iSCSI disk name displayed in the /var/log/messages file.

7. Mount the file system:

   # mkdir /mount/point
   
   # mount /dev/disk_name /mount/point

   Copy to Clipboard Toggle word wrap

   Replace /mount/point with the mount point of the partition.

8. Edit the /etc/fstab file to mount the file system automatically when the system boots:

   # vi /etc/fstab
   
   /dev/disk_name /mount/point ext4 _netdev 0 0

   Copy to Clipboard Toggle word wrap

   Replace disk_name with the iSCSI disk name and /mount/point with the mount point of the partition.

Procedure

1. Enable CHAP authentication in the iscsid.conf file:

   # vi /etc/iscsi/iscsid.conf
   
   node.session.auth.authmethod = CHAP

   Copy to Clipboard Toggle word wrap

   By default, the node.session.auth.authmethod is set to None

2. Add target username and password in the iscsid.conf file:

   node.session.auth.username = redhat
   node.session.auth.password = redhat_passwd

   Copy to Clipboard Toggle word wrap

3. Restart the iscsid service:

   # systemctl restart iscsid

   Copy to Clipboard Toggle word wrap

Procedure

1. Install the iscsi-initiator-utils on client machine:

   # dnf install iscsi-initiator-utils

   Copy to Clipboard Toggle word wrap

2. Find information about the running sessions:

   # iscsiadm -m session -P 3

   Copy to Clipboard Toggle word wrap

   This command displays the session or device state, session ID (sid), some negotiated parameters, and the SCSI devices accessible through the session.

   • For shorter output, for example, to display only the sid-to-node mapping, run:

     # iscsiadm -m session -P 0
             or
     # iscsiadm -m session
     
     tcp [2] 10.15.84.19:3260,2 iqn.1992-08.com.netapp:sn.33615311
     tcp [3] 10.15.85.19:3260,3 iqn.1992-08.com.netapp:sn.33615311

     Copy to Clipboard Toggle word wrap

     These commands print the list of running sessions in the following format: driver [sid] target_ip:port,target_portal_group_tag proper_target_name.