Introduction

• Infinidat recommends using Host PowerTools to connect hosts to InfiniBox. If it is not possible to use Host PowerTools, use the instructions in this document to connect your hosts to InfiniBox.
• This article discusses iSCSI software initiators only. 
• To connect hosts using an HBA, contact customer support.

iSCSI setup documentation

For InfiniBox best practices for setting up services, refer to the InfiniBox best practices page.

InfiniBox setup

1. Create an iSCSI Network Space. See Creating a network space.
2. Have the IP addresses ready for the procedure for the OS side.
3. Add a host to the InfiniBox and configure it. See Creating a host.

Windows

Preparing Windows

1. Ensure that the iSCSI service is running and is configured to auto start at boot.
   • 36274299 Windows iSCSI service should be running
   • 36274305 Windows iSCSI service should be configured to auto start
2. Ensure that your host applies the following configuration:
   https://support.infinidat.com/hc/en-us/articles/202319282

Connecting Windows

1. Open the iSCSI Initiator window. 
2. Open the Configuration tab. The host IQN is displayed in the Initiator Name field.
   
3. Open the Discovery tab, and click the Discover Portal button. 
   
4. The Discover Target Portal window opens. Insert any of the IP addresses of the iSCSI network space and click OK. The IP address is added to the Target Portals table.
5. Open the Targets tab, and click the Connect button. The Connect To Target window opens. Select Enable multi-path. 
    
6. Click the Advanced button. The Advanced Settings window opens. The InfiniBox Network Space IP addresses are listed on the Target Portal IP drop-down list.
7. For each IP address, complete the following fields:
   1. Local Adapter - Enter the Microsoft iSCSI Initiator.
   2. Initiator IP - Enter an IP address that does not require routing.
   3. Target Portal IP - Enter an iSCSI network space IP address.
   4. For CHAP security mode, select Enable CHAP log on, and enter the InfiniBox secret.
   5. For Mutual CHAP security mode, select Perform mutual authentication.
   6. Click OK.
      

Repeat steps 6 and 7 for each path.

1. When you are finished, all of the InfiniBox Network Space IP addresses are displayed.
   

Linux

Supported Distributions

For the list of supported Linux distributions, see Infinidat products compatibility with host operating systems.

Preparing Linux

1. Install the iSCSI initiator software.
   See Installing the iSCSI Initiator on Linux
2. Configure the iSCSI service to load at boot.
   See 213055229 Linux: The iSCSI service must be loaded at boot time
3. Make sure your host applies the following configuration:
   202319282 List of items being checked by Host PowerTools
4. On the InfiniBox, add a host. See Creating a host.
5. Connect the Linux host to iSCSI InfiniBox.
   See Connecting Linux host to iSCSI InfiniBox

CHAP attributes

Note: The security settings cannot be used during the discovery of the iSCSI target.

# *************
# CHAP Settings
# *************
# To enable CHAP authentication set node.session.auth.authmethod
# to CHAP. The default is None.
#node.session.auth.authmethod = CHAP
# To set a CHAP username and password for initiator
# authentication by the target(s), uncomment the following lines:
#node.session.auth.username = username
#node.session.auth.password = password
# To set a CHAP username and password for target(s)
# authentication by the initiator, uncomment the following lines:
#node.session.auth.username_in = username_in
#node.session.auth.password_in = password_in
# To enable CHAP authentication for a discovery session to the target
# set discovery.sendtargets.auth.authmethod to CHAP. The default is None.
#discovery.sendtargets.auth.authmethod = CHAP
# To set a discovery session CHAP username and password for the initiator
# authentication by the target(s), uncomment the following lines:
#discovery.sendtargets.auth.username = username
#discovery.sendtargets.auth.password = password
# To set a discovery session CHAP username and password for target(s)
# authentication by the initiator, uncomment the following lines:
#discovery.sendtargets.auth.username_in = username_in
#discovery.sendtargets.auth.password_in = password_in

Connecting Linux

In the following sample commands, 172.16.38.223 is an IP address from an InfiniBox iSCSI netspace.

1. Run:

   # iscsiadm --mode discovery --type sendtargets --portal 172.16.38.223
   
   172.16.38.228:3260,42 iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770
   
   172.16.38.227:3260,43 iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770
   
   172.16.38.226:3260,44 iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770
   
   172.16.38.224:3260,45 iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770
   
   172.16.38.223:3260,46 iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770

2. Using the IQN received in step 1, run:

   # iscsiadm --mode node --targetname iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770 -l
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.226,3260] (multiple)
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.223,3260] (multiple)
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.227,3260] (multiple)
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.225,3260] (multiple)
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.228,3260] (multiple)
   
   Logging in to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.224,3260] (multiple)
   
   Login to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.226,3260] successful.
   
   Login to [iface: default, target: iqn.2009-11.com.infinidat:storage:infinibox-sn-1106-7770, portal: 172.16.38.223,3260] successful.

VMware

Preparing VMware ESXi hosts

1. Make sure your host applies the following configuration:
   https://support.infinidat.com/hc/en-us/articles/202319282
2. Make sure SATP rules are applied to each of the ESX's connected to the InfiniBox.
   See 16744747 Host Readiness Check for ESX Hosts - SATP rules
3. Change the iSCSI recovery timeout to 30 or higher.
   See Change the VMware ESX iSCSI recovery timeout to 30 seconds

Connecting the VMware ESXi host

1. Rescan:
   1. Open the vSphere client and click the ESX server. 
   2. Open the Configuration tab, and click Storage Adapters.
   3. Click Properties and then open the Dynamic Discovery tab. 
   4. Click Add.... The Add Send Target Server window opens. Close the window. 
   5. The Rescan window opens. Click Yes.
2. Set the path selection to Round Robin.
   1. Right-click a device, and select Manage Paths....
      
   2.  In the Path Selection field, select Round Robin from the drop-down list.
   3. Click Close.

Solaris 

Discovery

1. Connect to an InfiniBox system by an IP address of its iSCSI network space.

   # iscsiadm add discovery-address <IP-address[:port-number] ...>

2. Enable iSCSI auto-discovery.

   # iscsiadm modify discovery --type enable

3. List the available iSCSI connections.

   # iscsiadm list target                                                                                                                                                                   
   Target: iqn.2009-11.com.infinidat:storage:infinibox-sn-30190-8398
           Alias: InfiniBox iSCSI
           TPGT: 1565
           ISID: 4000002a0000
           Connections: 1
   Target: iqn.2009-11.com.infinidat:storage:infinibox-sn-30190-8398
           Alias: InfiniBox iSCSI
           TPGT: 1564
           ISID: 4000002a0000
           Connections: 1

Setting the number of sessions

# iscsiadm modify target-param -c 4 iqn.2009-11.com.infinidat:storage:infinibox-sn-30190-8398

Getting the Solaris IQN

# iscsiadm list initiator-node | grep "node name" | cut -d" " -f4 
iqn.1986-03.com.sun:01:e00000000000.565b26b7

Adding a Solaris port to an InfiniBox host

1. Create a host.
2. Add a port (IQN) to this host. The Solaris port is visible in the window.

Provisioning

Follow the instructions on: Connecting hosts to InfiniBox volumes without Host PowerTools.