Fujitsu ETERNUS User manual

Server Connection Guide (iSCSI) for Oracle Solaris
3Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Preface
This document briefly explains the operations that need to be performed by the user in order to
connect an ETERNUS2000 model 100 or 200, ETERNUS4000 model 300, 400, 500, or 600, or
ETERNUS8000 model 700, 800, 900, 1100, 1200, 2100, or 2200 Disk storage system to a
server running Solaris OS via an iSCSI interface.
This document should be used in conjunction with any other applicable user manuals, such as
those for the ETERNUS2000 model 100 or 200, ETERNUS4000 model 300, 400, 500, or 600, or
ETERNUS8000 model 700, 800, 900, 1100, 1200, 2100, or 2200 Disk storage system, server,
OS used, LAN cards, drivers, etc.
Note that this manual refers the following documents:
•Server Support Matrix
•ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS Disk Storage
System Settings for ETERNUS2000
•ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS Disk Storage
System Settings for ETERNUS4000, ETERNUS8000
•ETERNUSmgr Install Guide
•ETERNUSmgr User Guide
Also, note that in this document the ETERNUS2000 models 100 and 200, ETERNUS4000 mod-
els 300, 400, 500, and 600, and ETERNUS8000 models 700, 800, 900, 1100, 1200, 2100, and
2200 Disk storage systems are collectively referred to as ETERNUS Disk storage systems.
Third Edition
December 2010
The Contents and Structure of this Manual
This document is composed of the following ten chapters.
•Chapter 1 Workflow
This describes how to connect the ETERNUS Disk storage system to a server.
•Chapter 2 Checking the Server Environment
This describes which servers can be connected to ETERNUS Disk storage systems.
•Chapter 3 Notes
This describes issues that should be noted when connecting the ETERNUS Disk storage
systems and server.

Preface
Server Connection Guide (iSCSI) for Oracle Solaris
4Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
•Chapter 4 Checking the Server Information
This describes how to check the server information registered in the ETERNUS Disk storage
system.
•Chapter 5 Installing and Setting Up ETERNUSmgr
This describes how to install ETERNUSmgr.
•Chapter 6 Setting Up the ETERNUS Disk Storage Systems
This describes how to use ETERNUSmgr to set up the ETERNUS Disk storage systems.
•Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
This describes how to install the iSCSI Software Initiator and set up the server.
•Chapter 8 Checking Connections
This describes how to check the connection status between server and ETERNUS Disk
storage systems.
•Chapter 9 Setting Up the Multipath Configuration
This describes what to be set in order to create multipath environment.
•Chapter 10 Creating a File System
This describes how to create a file system.
Safe Use of this Product
■Using this manual
This manual contains important information to ensure the safe use of this product. Be sure to
thoroughly read and understand its contents before using the product. After reading, store this
manual in a safe place for future reference.
FUJITSU has made every effort to ensure the safety of the users and other personnel, and to
prevent property damage. When using this product, carefully follow the instructions described in
this manual.
Acknowledgments
•Oracle and Java are registered trademarks of Oracle and/or its affiliates.
•All SPARC trademarks are used under license and are trademarks or registered trademarks
of SPARC International, Inc. in the United States and other countries.
•The company names, product names and service names mentioned in this document are
registered trademarks or trademarks of their respective companies.

Preface
Server Connection Guide (iSCSI) for Oracle Solaris
5Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Naming Conventions
■Product names
Oracle Solaris might be described as Solaris, Solaris Operating System, or Solaris OS.
■Other names
•"iSCSI port" or "Channel Adapter" (CA) refers to the iSCSI interface module used in the
ETERNUS Disk storage systems to connect to the server.
•"LAN card" refers to the iSCSI interface module normally used in the server. A "Network
Interface Card" (NIC), "LAN adapter", or "LAN board" may be used instead, depending on the
server.
Copyright 2010 FUJITSU LIMITED

Server Connection Guide (iSCSI) for Oracle Solaris
6Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Contents
Chapter 1 Workflow ...................................................................................7
Chapter 2 Checking the Server Environment..........................................9
2.1 Hardware ............................................................................................................ 9
2.2 Basic Software ................................................................................................... 9
2.3 Network Interface Card ...................................................................................... 9
2.4 Multipath Configuration ...................................................................................... 9
Chapter 3 Notes .......................................................................................10
3.1 LAN Environment Notes ................................................................................... 10
3.2 Server Startup and Power Supply Control Notes ............................................. 11
Chapter 4 Checking the Server Information..........................................12
Chapter 5 Installing and Setting Up ETERNUSmgr ..............................13
Chapter 6 Setting Up the ETERNUS Disk Storage Systems................14
Chapter 7 Installing the iSCSI Software Initiator
and Setting Up the Server .....................................................15
7.1 Installing the iSCSI Software Initiator ............................................................... 15
7.2 Setting Up the Server ....................................................................................... 15
7.2.1 Setting Up the Command Queue Depth .................................................................................... 16
7.2.2 iSCSI Basic Settings .................................................................................................................. 17
7.2.3 Server Settings when CHAP Authentication is Used ................................................................. 19
7.2.4 Server Settings when Bidirectional CHAP Authentication is Used ............................................ 21
Chapter 8 Checking Connections ..........................................................23
8.1 Turning on the Devices .................................................................................... 23
8.2 Logical Unit Recognition .................................................................................. 23
Chapter 9 Setting Up the Multipath Configuration ...............................24
9.1 Enabling MPxIO ............................................................................................... 24
9.2 Reconfiguring and Restarting the Server ......................................................... 24
Chapter 10 Creating a File System...........................................................26

Server Connection Guide (iSCSI) for Oracle Solaris
7Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 1 Workflow
Exactly which documents are required depends on the connection environment, see the "Work-
flow" section that follows for details.
Required Documents
•Server Support Matrix
•ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS Disk Storage
System Settings for ETERNUS2000
•ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS Disk Storage
System Settings for ETERNUS4000, ETERNUS8000
•ETERNUS Disk storage systems Server Connection Guide (iSCSI) for Oracle Solaris (this
manual)
•ETERNUSmgr Install Guide
•ETERNUSmgr User Guide
Workflow
Install ETERNUSmgr and Set Up the ETERNUS Disk Storage System
If ETERNUSmgr is to be used, install it and set up the ETERNUS Disk storage system.
Refer
-"Chapter 4 Checking the Server Information" (page 12)
-"Chapter 5 Installing and Setting Up ETERNUSmgr" (page 13)
-"Chapter 6 Setting Up the ETERNUS Disk Storage Systems" (page 14)
-Install ETERNUSmgr.
•"ETERNUSmgr Install Guide"
-Check the setup and maintenance operations.
•"ETERNUSmgr User Guide"
-Set up the ETERNUS Disk storage system.
•"ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS
Disk Storage System Settings for ETERNUS2000"
•"ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS
Disk Storage System Settings for ETERNUS4000, ETERNUS8000"

Chapter 1 Workflow
>
Server Connection Guide (iSCSI) for Oracle Solaris
8Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Install the iSCSI Software Initiator and Set Up the Server
Set up the OS to connect to the ETERNUS Disk storage system.
Refer
-"Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server" (page 15)
Set the Server to Recognize the Logical Units
Set up the server so that it can recognize the ETERNUS Disk storage system logical units
(LUN).
Refer
-"8.2 Logical Unit Recognition" (page 23)
Configure the System
Set up the server as required by the system configuration.
Refer
-Set the multipaths.
•"9.1 Enabling MPxIO" (page 24)
-Set a file system.
•"Chapter 10 Creating a File System" (page 26)

Server Connection Guide (iSCSI) for Oracle Solaris
9Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 2 Checking the Server Environment
Server environment details are provided in the "Server Support Matrix".
2.1 Hardware
Refer to the "Server Support Matrix" for details.
2.2 Basic Software
Refer to the "Server Support Matrix" for details.
2.3 Network Interface Card
Refer to the "Server Support Matrix" for details.
2.4 Multipath Configuration
Refer to the "Server Support Matrix" for details.

Server Connection Guide (iSCSI) for Oracle Solaris
10 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 3 Notes
3.1 LAN Environment Notes
•The ETERNUS Disk storage system can be connected to a server via an existing LAN.
However, a decrease in LAN performance may be observed by prior users of said LAN.
•For the iSCSI LAN (used to transfer data), do not set multipath configuration with IP Network
Multipathing (IPMP).
•As with an FC-SAN, because of the large data flows (traffic volumes) the iSCSI LAN is
assumed to be a dedicated LAN separate from the business and management LANs, and
constructed with its own LAN switch.
•For IP network security reasons too, it is useful to separate the iSCSI LAN (for data transfers)
and management LAN (for administration) to prevent cross-access between them (use of
VLAN to separate the LAN segments is recommended).
•A configuration where multiple LAN ports of a single server are connected to the same
network may be restricted depending on the OS and/or driver specifications. For a multipath
connection, connect each path using different LAN segments by separating the VLAN and so
on.

Chapter 3 Notes
> 3.2 Server Startup and Power Supply Control Notes
Server Connection Guide (iSCSI) for Oracle Solaris
11 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Example LAN switch connection configuration
*1: In this system configuration, multipaths provide redundant connections between the servers and
storage system. LAN switches #1 and #2 provide physical separation of the network paths.
*2: A separate LAN segment is provided in the LAN switch (using the switch VLAN function) for each
grouping of business servers and disk storage systems (equivalent to the FC zones).
3.2 Server Startup and Power Supply Control Notes
Before turning the server on, check that the ETERNUS Disk storage systems and LAN switches
are all "Ready". If the server is turned on and they are not "Ready", the server will not be able to
recognize the ETERNUS Disk storage systems.
Also, when the ETERNUS Disk storage system power supply is being controlled by a con-
nected server, make sure that the ETERNUS Disk storage system does not shut down before
the connected servers. Similarly, the LAN switches must also be turned off after the connected
servers have been shut down.
If turned off, data writes from the running server cannot be saved to the ETERNUS Disk storage
systems, and already saved data may also be affected.
Business server A
LAN
card
#2
LAN
card
#1
Business server B
LAN
card
#2
LAN
card
#1
Business server C
LAN
card
#2
LAN
card
#1
LAN
card
#3
LAN switch
[Business LAN]
LAN switch
[Management LAN]
ETERNUS Disk storage system
12
LAN switch #1
[iSCSI LAN]
123
10 11 12
LUN1 LUN2
10
2 3
11
LAN switch #2
[iSCSI LAN]
LAN
card
#3
LAN
card
#3
1
LUN3 Management
LAN port
LAN switches should not
be inter-connected (*1)
A separate LAN segment is used for each
Server/Storage grouping. (*2)
Here, LAN ports 1, 2 and 10 comprise VLAN1,
while LAN ports 3 and 11 comprise VLAN2.
The iSCSI LAN and management
LAN segments are kept separate
in the iSCSI LAN switches, helping
maintain the security of each.
Similarly to FC-SAN, a
dedicated LAN is used for
iSCSI, not the business LAN.
Business LAN
iSCSI LAN
Management LAN

Server Connection Guide (iSCSI) for Oracle Solaris
12 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 4 Checking the Server Information
The server information registered in the ETERNUS Disk storage system should be checked.
A variety of commands are used to check the following server information.
•iSCSI Software Initiator
Since iSCSI Software Initiator is provided with the OS, installation is not required.
Check the SUNWiscsiu and SUNWiscsir packages using the "pkginfo" command.
•iSCSI Initiator name
Execute the following command:
The iSCSI Initiator name is displayed in the "Initiator node name" column.
•Server-side LAN card IP address for connecting to the ETERNUS Disk storage system
Execute the following command:
Set this IP address if it is not already set.
•Initiator CHAP Name
The Initiator CHAP Name is the user name for unidirectional CHAP authentication, and is not
required if CHAP authentication is not used.
Execute the following command:
The Initiator CHAP Name is displayed in the "CHAP Name" column of the applicable target
information.
# iscsiadm list initiator-node
# ifconfig -a
# iscsiadm list initiator-node

Server Connection Guide (iSCSI) for Oracle Solaris
13 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 5 Installing and Setting Up ETERNUSmgr
If ETERNUSmgr is to be used, install it according to the directions given in the "ETERNUSmgr
Install Guide". After the installation, set up ETERNUSmgr following the instructions in the
"ETERNUSmgr User Guide".

Server Connection Guide (iSCSI) for Oracle Solaris
14 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 6 Setting Up the ETERNUS Disk Storage
Systems
Set up the ETERNUS Disk storage systems using ETERNUSmgr.
ETERNUS Disk storage systems' setup can be performed independently of server setup. For
details on how to perform these settings, refer to the "ETERNUS Disk storage systems Server
Connection Guide (iSCSI) ETERNUS Disk Storage System Settings for ETERNUS2000" or
"ETERNUS Disk storage systems Server Connection Guide (iSCSI) ETERNUS Disk Storage
System Settings for ETERNUS4000, ETERNUS8000", and "ETERNUSmgr User Guide".

Server Connection Guide (iSCSI) for Oracle Solaris
15 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Chapter 7 Installing the iSCSI Software Initiator
and Setting Up the Server
7.1 Installing the iSCSI Software Initiator
Since iSCSI Software Initiator is provided with the OS, installation is not required.
7.2 Setting Up the Server
iSCSI connection settings depend on the CHAP authentication method. Perform the settings to
match the CHAP authentication to be used.
CHAP authentication method Required settings
None "7.2.1 Setting Up the Command Queue Depth" (page 16)
"7.2.2 iSCSI Basic Settings" (page 17)
Unidirectional
CHAP authentication
"7.2.1 Setting Up the Command Queue Depth" (page 16)
"7.2.2 iSCSI Basic Settings" (page 17)
"7.2.3 Server Settings when CHAP Authentication is Used" (page 19)
Bidirectional
CHAP authentication
"7.2.1 Setting Up the Command Queue Depth" (page 16)
"7.2.2 iSCSI Basic Settings" (page 17)
"7.2.3 Server Settings when CHAP Authentication is Used" (page 19)
"7.2.4 Server Settings when Bidirectional CHAP Authentication is
Used" (page 21)

Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
> 7.2 Setting Up the Server
Server Connection Guide (iSCSI) for Oracle Solaris
16 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
7.2.1 Setting Up the Command Queue Depth
Set the number of commands allowed to be queued (command queue depth) on each LUN in the
ETERNUS Disk storage systems from the LAN card. This setting optimizes the connection
between the ETERNUS Disk storage systems and the server.
Procedure
1Edit the configuration file.
Edit the configuration file (/etc/system) and specify the command queue depth.
The appropriate "ssd_max_throttle" parameter value is determined by the ETERNUS Disk
storage system model, as follows:
The parameter to be specified is determined by the CPU which is installed in the server to
be connected.
•For SPARC
Specify the command queue depth for the "ssd_max_throttle" parameter.
Add this parameter if it does not exist.
•For x86
Specify the command queue depth for the "sd_max_throttle" parameter.
Add this parameter if it does not exist.
2After editing the configuration file, save it.
3After the setting is complete, check the configuration file for incorrect settings.
4Reboot the server.
End of procedure
ETERNUS Disk storage system Command queue depth settings
ETERNUS2000 8
ETERNUS4000 20
ETERNUS8000 20
set ssd:ssd_max_throttle = 20
set sd:sd_max_throttle = 20
# /usr/sbin/shutdown -y -g0 -i6

Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
> 7.2 Setting Up the Server
Server Connection Guide (iSCSI) for Oracle Solaris
17 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
7.2.2 iSCSI Basic Settings
The following operations are required for iSCSI connection.
•Checking the iSCSI Initiator
•Checking the iSCSI Initiator Node Name
•Setting the iSCSI Target IP addresses
•Enabling the iSCSI Target connection
•Creating an iSCSI device link
•Checking the ETERNUS Disk storage system
Procedure
1Check that the iSCSI Initiator service (iscsid) is enabled.
If the iSCSI Initiator service is "disabled" (the default setting), use the "svcadm" command
to change it to the "online" state.
2Check the iSCSI Initiator Node Name.
Use the "iscsiadm" command to check the iSCSI Initiator Node Name.
This name is used for the ETERNUS Disk storage system settings.
3Set the iSCSI Target IP address(es).
To connect the iSCSI Target, specify the IP address of each iSCSI CA port of the
ETERNUS Disk storage system that is to be an iSCSI Target, as a "discovery-address".
# svcs -a | grep iscsi
disabled 14:30:33 svc:/network/iscsi/initiator:default
# svcadm enable iscsi/initiator
# svcs -a | grep iscsi
disabled 14:30:33 svc:/system/iscsitgt:default
online 14:30:33 svc:/network/iscsi/initiator:default
# iscsiadm list initiator-node
Initiator node name: iqn.1986-03.com.sun:01:0003bace9997.48a386c4
Initiator node alias: -
Login Parameters (Default/Configured):
Header Digest: NONE/-
Data Digest: NONE/-
Authentication Type: NONE
RADIUS Server: NONE
Configured Sessions: 1
# iscsiadm add discovery-address IP_address

Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
> 7.2 Setting Up the Server
Server Connection Guide (iSCSI) for Oracle Solaris
18 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
Example:
CM0Port0: 192.1.1.120, CM1Port0: 192.1.1.121
4Enable the connection to the iSCSI Target.
Enable the connection to the ETERNUS Disk storage system that is to be the iSCSI Tar-
get.
5Create an iSCSI device link.
6Check the ETERNUS Disk storage system.
Check the state of the ETERNUS Disk storage system disks using the "format" command.
Example: ETERNUS2000
End of procedure
# iscsiadm add discovery-address 192.1.1.120
# iscsiadm add discovery-address 192.1.1.121
# iscsiadm modify discovery -t enable
# devfsadm -i iscsi
# format
Searching for disks...done
AVAILABLE DISK SELECTIONS:
1. c6t25d0 <FUJITSU-E2000-0000 cyl 510 alt 2 hd 64 sec 256>
/iscsi/[email protected]%3Astorage-system.e2000%3A00001001-cm00002,0
2. c6t26d0 <FUJITSU-E2000-0000 cyl 510 alt 2 hd 64 sec 256>
/iscsi/[email protected]%3Astorage-system.e2000%3A00001001-cm00002,1
3. c6t27d0 <FUJITSU-E2000-0000 cyl 510 alt 2 hd 64 sec 256>
/iscsi/[email protected]%3Astorage-system.e2000%3A00001001-cm10004,0
4. c6t28d0 <FUJITSU-E2000-0000 cyl 510 alt 2 hd 64 sec 256>
/iscsi/[email protected]%3Astorage-system.e2000%3A00001001-cm10004,1
Specify disk (enter its number): Specify disk (enter its number):

Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
> 7.2 Setting Up the Server
Server Connection Guide (iSCSI) for Oracle Solaris
19 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
7.2.3 Server Settings when CHAP Authentication is Used
The following operations are required for CHAP authentication.
•Setting the Initiator secret
(password setting to connect to the ETERNUS Disk storage system)
•Setting the Initiator CHAP Name
(CHAP name setting to connect to the ETERNUS Disk storage system)
•Enabling CHAP
Procedure
1Set the Initiator secret.
This is a password that must be set so that the Initiator can connect to the target
ETERNUS Disk storage system. The CHAP secret set here must match that set in Target
information.
Example:
To set the password "initiator000"
2Set the Initiator CHAP Name.
The Initiator Node Name is the default Initiator CHAP Name. Use the "iscsiadm" command
to set a new Initiator CHAP Name. The Initiator CHAP Name set here must match that set
in Target information.
Example:
To set "initiator" as the CHAP Name
Passwords are restricted to a maximum of 16 characters by the
Solaris operating system. For 17 or more characters, the following
message is output:
# iscsiadm modify initiator-node --CHAP-secret
Enter secret:initiator000
Re-enter secret:initiator000
Iscsiadm: secret too long, maximum length is 16
Iscsiadm: Unable to complete operation
# iscsiadm modify initiator-node --CHAP-name CHAP_Name
# iscsiadm modify initiator-node --CHAP-name initiator

Chapter 7 Installing the iSCSI Software Initiator and Setting Up the Server
> 7.2 Setting Up the Server
Server Connection Guide (iSCSI) for Oracle Solaris
20 Copyright 2010 FUJITSU LIMITED
P3AM-4182-03ENZ0
3Enable CHAP authentication.
Enable CHAP authentication on the Initiator.
4Check that CHAP is enabled on the Initiator.
Use the "initiator-node" option.
5Check that CHAP is enabled on the Target.
Use the "target-param" option.
If CHAP is disabled, use the "iscsiadm" command to enable it.
Example:
To set "iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm0" and "iqn.2000-
09.com.fujitsu:storage-system.e2000:00001001-cm1" as the target CHAP names
End of procedure
# iscsiadm modify initiator-node --authentication CHAP
# iscsiadm list initiator-node
Initiator node name: iqn.1986-03.com.sun:01:00144f565a49.47677520
Initiator node alias: -
Login Parameters (Default/Configured):
Header Digest: NONE/-
Data Digest: NONE/-
Authentication Type: CHAP
CHAP Name: initiator
RADIUS Server: NONE
RADIUS access: unknown
Configured Sessions: 1
# iscsiadm list target-param -v
Target: iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm1
Alias: dxlcm1port1
Bi-directional Authentication: disabled
Authentication Type: CHAP
CHAP Name: iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm1
:
:
Target: iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm0
Alias: dxlcm0port1
Bi-directional Authentication: disabled
Authentication Type: CHAP
CHAP Name: iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm0
# iscsiadm modify target-param -a CHAP Target_name
#iscsiadm modify target-param -a CHAP iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm0
#iscsiadm modify target-param -a CHAP iqn.2000-09.com.fujitsu:storage-system.e2000:00001001-cm1