Welcome, Guest Login

ION KB-Support

Deploying ION – Setting Up an iSCSI Initiator Connection with CentOS 7.0

Last Updated: Mar 13, 2018 11:03AM PDT

In this lab we will focus on setting up an iSCSI Initiator Connection with CentOS 7.0.  The purpose behind this lab is to aid the support engineer with the proper configuration of an ION initiator, by working through the proper setup and configuration of a Linux cluster with ION.  The skills gained will aid in troubleshooting a customer’s Linux storage configuration with ION.

Information needed for this lab:
•    0000-ION-VLE-LAB-Diagram.pptx
•    Windows compatible remote desktop client (RDP)
•    Log in password:  Fusionio1
•    Windows jump server:  (Hostname: ION_LAB_MANAGEMENT, Username: administrator. IP address will be provided)
•    "Top" level VMware ESXi host:   (Username: root.  IP address will be provided.  Jump server can also log in to this host.)
•    CentOS 7.0 VM: (Username: root)
•    ION VM: (Username: admin)
•    Nested vCenter VMware ESXi VM:  (Username: root, password: vmware)


To get started, we will first check a few things within the lab environment to ensure the system is ready for configuration.

Step One:  Logging into the CentOS Desktop:

1.    Launch a remote desktop (RDP) client and login to the Windows jump server (IP address will be provided) that has access to the 10.0.0.x virtual lab network.

2.    Launch the vSphere Client on the jump-box, and login to the "top" ESXi server.
•    Power on the CentOS70VM1_ION virtual machine
•    Open the virtual machine console of your assigned CentOS70VM1_ION virtual machine.
•    Log in as root.

3.    From the desktop of the jump-box, launch the PuTTY Client and type in the IP address of the CentOS70VM1_ION Virtual Machine,  Log in as root.

4.    Power on the ION_2_4_0_HA1_ION and ION_2_4_0_HA2_ION VMs.  Verify your connection from the jump-box to the ION virtual machine by opening the PuTTY client, and SSH to an ION virtual machine at ION_2_4_0_HA1_ION.

5.    (Or) From the vSphere Client on the jump-box, login to the ESXi 5.1 server

•    Open the virtual machine console of your assigned ION_2_4_0_HA1_ION virtual machine.

6.    Enter admin as the username, and Fusionio1 as the password to login to the ION appliance.


Step One:  Create the ION Appliance Profile and Pool:

1.    Navigate to the ION Appliance console and enter profile:create maximum_performance

•    This will create the profile RAID0 as well as a pool

2.    Type raids –dt –-cluster at the command line, to verify RAID configuration.

3.    Type inigroup:create centos7 at the command line to create the initiator group.
4.    Create initiator number one by typing:
•     initiator:create -a centos7 rh1

5.    Create initiator number two:
•    initiator:create -a centos7 rh2

6.    Create initiator number three by typing:
•     initiator:create -a centos7 rh3

7.    Create initiator number four by typing:
•     initiator:create -a centos7 rh4

8.    Type initiators –dt –-cluster to verify the additions.

9.     Create the Pool and Volume by typing: volume:create vol1 100% raid0_pool

 10.     To create luns, type lun:create vol1 centos7 –a

11.    Now that the luns have been created, navigate to the console of the CentOS server (either launch the console from the vSphere Client, or SSH from the Windows jump-box).  Authenticate as username – root, password – Fusionio1

12.    At the server console, enter the following (and when prompted during install, select yes):

•     yum install device-mapper-multipath sg3_utils iscsi-initiator-utils lsscsi

13.    At the CentOS command line, enter: iscsiadm -m discovery -t st -p

14.    Next, enter: iscsiadm -m discovery -t st -p

15.    Next, enter: iscsiadm -m discovery -t st -p

16.    Next, enter: iscsiadm -m discovery -t st -p

17.    To view the configured target nodes, type  iscsiadm -m node -P1

18.    Type iscsiadm -m node -l  and view the output.  Running the command with the “–l” option is the command that logs into the target portal.

19.    Next, type  iscsiadm -m session
20.    Type multipath –ll
•    This output is showing that there is no /etc/multipath.conf file created or available.
•    In this instance, we will need to create this file.  The configuration is different for the following three cases:
•    Accessing ION HA
•    Accessing ION Standalone
•    Accessing multiple ION Standalone systems simultaneously in a host RAID configuration

*Note - The ION User Guide documents the multipath.conf file configurations
21.    Create the /etc/multipath.conf file using the sample from the ION Configuration Guide, "Installing Multipathing in HA Mode".

22.    To rescan for devices, type

23.    Type lsscsi -t
24.    To start the multipathd daemon, type service multipathd start

25.    Type chkconfig multipathd on, then type multipath –ll

•    This command ensures that multipathd is configured to start at boot
•    multipath –ll will show the available paths to the ION volume

26.    Type mkfs.ext4 /dev/mapper/mpatha

•    This command creates the file system on the ION volume, which can then be mounted or put into /etc/fstab for automatic mounting

27.    Type mount /dev/mapper/mpatha /mnt

28.    Enter df –h to review the summary of the drives and file system.

29.    Enter cd /var/lib/iscsi/ to change directories.

30.    Enter ls, then ls –R to view directory content.

Additional exercises:
•    Resize the ion volume and rescan on the Linux host to pick up the changes
•    Talk about the WWID for the ION volume.  See /etc/multipath/bindings.  Also, relationship to volumes -dt --display-flavor vmware
•    Create a user-defined name for the ION volume/LUN on the Linux initiator host
•    Look at generic SCSI devices created for all of the ION SCSI block devices.
•        lsscsi -t    
•        dmesg |grep sg
•    See Confluence:


Contact Us

  • Email Us
  • One Stop Systems

    Call Us @ 760-466-1677

    Support Resources

seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found