iSCSI Configuration Example Using Solaris

A P P E N D I X B

This appendix shows an example of iSCSI configuration on a Solaris data host in the following sections:

To Prepare for the iSCSI Configuration

To Configure iSCSI

To Prepare for the iSCSI Configuration

1. Log into the data host as super user.

2. Identify the minimum required OS, software packages, and patches by referring to the Sun StorageTek 2500 Series Array Release Notes, 6.1 or higher.

Download from http://docs.sun.com/app/docs/coll/st2500arrays

You can also apply the latest patches from: http://sunsolve.sun.com/show.do?target=patchpage

a. Verify that you are running the required Solaris OS:

# cat /etc/release

b. Verify that iSCSI software packages are installed

# pkginfo SUNWiscsiu SUNWiscsir

system SUNWiscsiu Sun iSCSI Device Driver (root)

system SUNWiscsir Sun iSCSI Management Utilities (usr)

c. Verify that you have the latest patches applied for the iSCSI packages. For example:

On a SPARC system:

# showrev -p | grep 119090

On an x86 system:

# showrev -p | grep 119091

3. Install the Common Array Manager software on the management host and register the target array.

Follow the instruction in the Sun StorageTek Common Array Manager Installation Guide.

To Configure iSCSI

1. In the Common Array Manager software, go to the Port Summary page and verify that the target ports (one for each controller) are in an up status and note there IP addresses and ports.

If you need to change the port IP addresses, use the Port Details page. You can enter a new IP address or set DHCP.

2. From the data host:

a. List and note the IQN of each initiator.

# iscsiadm list initiator-node
Initiator node name: iqn.1986-03.com.sun:01:0003babc0401.46f806dd
Initiator node alias: -
      ...

b. Enable the discovery method of the targets as static.

#iscsiadm modify discovery --static enable

c. Ping the target ports IP addresses to confirm they can be reached.

#ping  ip_address
#ping 192.168.1.1 
192.168.1.1 is alive

d. Discover the targets (one port for each controller) from the iSCSI initiator using the isciadm command and the IP addresses of the ports.

#iscsiadm add discovery-address 192.168.1.1:3260 
#iscsiadm add discovery-address 192.168.2.1:3260 
...

e. Verify that discovered targets are listed on the data host.

#iscsiadm list discovery-address 
Discovery Address: 192.168.1.1:3260 
...

f. List the IQNs of the targets using the iscsiadm command and the IP addresses you noted on the Port Summary page.

>iscsiadm list discovery-address -v 192.168.1.1
Discovery Address: 192.168.1.1:3260
Target name:
iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b
               Target address:     192.168.1.1:3260, 1
Target name: 
iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b
               Target address:     192.168.1.2:3260, 1
Target name: 
iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b
               Target address:     192.168.2.1:3260, 2
Target name: 
iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b
               Target address:     192.168.2.2:3260, 2

g. Add the IQNs of the targets discovered in the last steps to the discovery table.

#iscsiadm add static-config iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b,192.168.1.1

This adds a target to the list of statically configured targets. Repeat for each target port.

h. List the statically configured targets and verify that the new targets have been added.

# iscsiadm list static-config 
Static Configuration Target:
iqn.1986-03.com.sun:2510.600a0b80003487e400000000474c6e0b,192.168.1.1:3260
...

i. Note the number of disks (volumes) before you configure new volumes.

#format 
AVAILABLE DISK SELECTIONS: 
       0. c3t0d0 <SUN72G cyl 14087 alt 2 hd 24 sec 424> 
          /pci@8,600000/SUNW,qlc@4/fp@0,0/ssd@w500000e010483de1,0 
...

3. In the CAM software:

a. Create each initiator with its IQN from the data host noted in Step 2a.

Refer to Adding Initiator Information for details.

b. Follow CAM documentation to:

Create a volume

Map the volume to a host or host group linked to the initiator.

4. On the data host:

a. Create the iSCSI device link on the data host.

#devfsadm -i iscsi

b. Issue the format command and verify that more disk (volumes) were created than what you noted in Step 2i.

#format

The system is ready for you to use system administrator commands to create and mount a file system.