Technical Report This document has been archived and will no longer be maintained or updated. For more information go to the Storage Solutions Technical Documents page on Dell TechCenter or contact support. Deploying SUSE Linux Enterprise Server with Dell EqualLogic PS Series Storage Arrays Abstract This technical report documents the procedure for configuring the SUSE® Linux Enterprise Server operating system to operate with Dell™ EqualLogic™ PS Series storage arrays. TR1071 V1.
Copyright © 2011 Dell Inc. All Rights Reserved. Dell EqualLogic is a trademark of Dell Inc. All trademarks and registered trademarks mentioned herein are the property of their respective owners. Possession, use, or copying of the documentation or the software described in this publication is authorized only under the license agreement specified herein. Dell, Inc. will not be held liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change.
Current Customers Please Note: You may not be running the latest versions of the tools and software listed below. If you are under valid warranty or support agreements for your PS Series array, you are entitled to obtain the latest updates and new releases as they become available. To learn more about any of these products, contact your local sales representative or visit the Dell EqualLogic site at http://www.equallogic.com.
Preface Thank you for your interest in Dell™ EqualLogic™ PS Series storage products. We hope you will find them intuitive and simple to configure and manage. PS Series arrays optimize resources by automating volume and network load balancing. Additionally, PS Series arrays offer all-inclusive array management software, host software, and firmware updates. The features and products described next are available as part of the all-inclusive software package and are at no additional cost.
Host Software for VMware – Host Integration Tools for VMware® - Auto-Snapshot Manager/VMware Edition (ASM/VE): Integrates with VMware Virtual Center and PS Series snapshots to allow administrators to enable Smart Copy protection of Virtual Center folders, datastores, and virtual machines. - EqualLogic Datastore Manager: Allows administrators to create and manage datastore on EqualLogic PS Series arrays from within vCenter.
Table of Contents Revision information ............................................................................................................................ iii Introduction ................................................................................................................................................1 Terminology ...............................................................................................................................................1 Deployment scenarios .......
Revision information The following table describes the release history of this Technical Report. Report Date Document Revision 1.0 August 2011 Initial Release The following table shows the software and firmware used for the preparation of this Technical Report. Vendor Model Software Revision Novell SUSE ® Linux Enterprise Server Version 11 SP1 Dell Dell™ EqualLogic™ PS Series SAN 5.0.2 The following table lists the documents referred to in this Technical Report.
Introduction This technical report documents the configuration procedures for a server running SUSE Linux Enterprise Server (SLES 11 SP1) with a Dell™ EqualLogic™ PS Series storage array. The report begins by introducing relevant terminology and detailing the hardware, software and network configuration used in the development of this report. Then, two deployment scenarios are discussed: single-path I/O and multi-path I/O.
iscsiadm: Open-iSCSI administration utility, included in the SLES software distribution. Command line tool which allows: discovery of iSCSI targets; login/logout of iSCSI targets; and management of the iSCSI records database. iscsid: Open-iSCSI daemon. Runs on the SLES server and provides block level access to the PS Series storage array. Managed by the iSCSI service.
SUSE Linux Enterprise Server 11 SP1, also known as SLES 11 SP1 PS Series firmware version 5.0.2 Deployment scenarios PS Series arrays connect to servers through physical Ethernet connections, either 1GbE or 10GbE. If the server has multiple NIC’s, then one can be used for data traffic and one (or more) can be used for iSCSI storage traffic.
high availability and performance load balancing across multiple network ports, allowing the iSCSI Initiator software on the server to utilize multiple network interfaces with a single iSCSI target. Refer to Figure 2 for a visual. The multiple paths can be utilized in one of two ways, either to improve the throughput between the initiator and the target or to implement redundancy for high availability.
Server setup – pre-requisite steps This section of the document discusses the basic server setup requirements and describes how to configure the server to meet them. The areas of consideration are: Ethernet interfaces; iSCSI Initiator and web browser configuration. Ethernet interfaces The server and the storage array communicate over Ethernet. While the basic functionality of the storage array can be demonstrated over a single Ethernet connection, the advanced features (e.g.
4) In this test configuration the iSCSI service was already enabled to execute on boot. If the system displays “off” for runlevels 3 and 5 - then use the following command to enable the service for boot: # chkconfig open-iscsi on Configuring disk timeout for Linux 2.6 Kernel SCSI devices The following text was extracted from the Dell document: “PS Series Storage Arrays – iSCSI Initiator and Operating System Considerations“ (Please refer to the ‘Revision Information’ section of this document for the URL).
http://www.java.com/en/download/manual.jsp In this configuration, the file downloaded was ‘jre-6u20-linux-x64.bin’ 2) Shutdown all instances of the web browser 3) Make the java installer file executable: # chmod 755 jre-6u20-linux-x64.bin 4) Execute the installer. This creates the java release directory (e.g. jre1.6.0_20): # ./jre-6u20-linux-x64.bin 5) Create the /usr/java directory, if it doesn’t already exist: # mkdir /usr/java 6) Move the java release directory to the /usr/java directory: # mv jre1.6.
Task #1 - Add a volume 1) Login to the PS Series storage array using the PS Group Manager GUI and create a new volume: Example settings: Volume name = sles1 Volume size = 40G iSCSI Access = 10.10.6.150 (IP Address of the eth2 interface) Access Type = set read/write (default) 2) Discover the newly added volume from the server: # iscsiadm -m discovery -t sendtargets -p 10.10.5.7 10.10.5.7:3260,1 iqn.2001-05.com.
Negotiated iSCSI params: ************************ HeaderDigest: None DataDigest: None MaxRecvDataSegmentLength: 262144 MaxXmitDataSegmentLength: 65536 FirstBurstLength: 65536 MaxBurstLength: 262144 ImmediateData: Yes InitialR2T: No MaxOutstandingR2T: 1 ************************ Attached SCSI devices: ************************ Host Number: 8 State: running scsi8 Channel 00 Id 0 Lun: 0 Attached scsi disk sdb State: running The command output indicates that for this test configuration /dev/sdb is the device na
This filesystem will be automatically checked every 28 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override. 6) Create the mount point and mount the filesystem: # mkdir /mnt/sles1 # mount –t ext3 /dev/sdb /mnt/sles1 7) Add the filesystem to the /etc/fstab file to mount it at boot.
Rescanning session [sid: 1, target: iqn.2001-05.com.equallogic: 0-8a0906-beee66602-27e79218c634bfec-sles1, portal: 10.10.5.7,3260] 4) Confirm the modified volume size was recognized: # dmesg | tail sdb: detected capacity change from 42954915840 to 53697576960 SCSI device sdb: 104878080 512-byte hdwr sectors (53698 MB) sdb: Write Protect is off sdb: Mode Sense: 91 00 00 00 SCSI device sdb: drive cache: write through 5) Resize the filesystem: # resize2fs /dev/sdb resize2fs 1.
Logging in to [iface: default, target: iqn.200105.com.equallogic:0-8a0906-ae2e66602-b156e11d6b04c0e7-sles12010-06-08-13:16:18.6512, portal: 10.10.5.7,3260] Login to [iface: default, target: iqn.2001-05.com.equallogic:08a0906-ae2e66602-b156e11d6b04c0e7-sles1-2010-06-0813:16:18.6512, portal: 10.10.5.7,3260]: successful 4) Find the iSCSI device name of the snapshot: # iscsiadm -m session -P3 iSCSI Transport Class version 2.0-871 version 2.0-871 Target: iqn.2001-05.com.
/dev/sda1 101086 12538 83329 8216020 0 8216020 /dev/sdb 51615928 184268 478816132 1% /mnt/sles1 /dev/sdc /mnt/slessnap 51615928 184268 478816132 1% tmpfs 14% /boot 0% /dev/shm Task #4 - Delete the volumes 1) Unmount the previously created filesystems: # umount /mnt/slessnap # umount /mnt/sles1 2) Logoff the iSCSI target volumes, using the complete ‘iqn’ strings for your targets: # iscsiadm -m node -T -p 10.10.5.7 --logout Logging out of session [sid: 1, target: iqn.200105.com.
Enabling Multipath I/O functionality on SLES 11 involves the iSCSI initiator, the multipath subsystem and device mapper. This configuration procedure details the steps required to utilize multiple Ethernet interface connections between a SLES 11 SP1 server and a PS Series storage array. Before beginning the multipath I/O configuration, it is recommended that existing iSCSI volumes be unmounted and the iscsiadm record database be empty.
iface.ipaddress = iface.hwaddress = iface.transport_name = tcp iface.initiatorname = # END RECORD 4) Acquire the iSCSI initiator name for your SLES server: # cat /etc/iscsi/initiatorname.iscsi InitiatorName=iqn.1994-05.com.default:6891f663d4ce 5) At this point, the two Ethernet interfaces should be accessible to the iSCSI initiator software running on the SLES server. In order to utilize both connection paths, the iSCSI volume must have appropriate iSCSI Access settings.
8) In order to allow multipath I/O access from the SLES server, the multipath software on the server needs to be configured. Check the installation status of the multipath package and install (if needed): # rpm –q device-mapper device-mapper-1.02.27-8.17.20. 9) SLES does not automatically create /etc/multipath.conf file. Perform the following copy to create the file. # cp /usr/share/doc/packages/multipath-tools/multipath.conf.synthetic /etc/multipath.
} Note: Edit the blacklist section for your server, using either a regular expression or WWID to exclude the appropriate devices. Refer to the “SUSE Linux Enterprise Server 11 SP1 Storage Administration Guide” listed in the Revision section of this document for more information on blacklisting devices. 11) Continue the multipath software configuration on the server. Edit the ‘devices’ section of the multipath configuration file.
Note: the string highlighted in RED text is the WWID, a unique identifier and persistent name for this volume, 14) Edit the ‘multipaths’ section of the /etc/multipath.conf file to associate this WWID with a more user friendly name for this volume. Add these lines to your multipath configuration file, immediately after the ‘devices’ section that was added earlier.
crw------brw-rw---brw------brw------- 1 1 1 1 root root root root root 10, 63 Jun 4 14:21 controlif disk 253, 3 Jun 10 15:31 mpio root 253, 0 Jun 4 14:22 VolGroup00-LogVol00 root 253, 1 Jun 4 14:21 VolGroup00-LogVol01 17) Verify the configuration using the ‘dd’ command. Test that an I/O load is distributed across the two Ethernet paths. Open the PS Group Manager and view the volume named mpio. Open the ‘Connections’ tab and verify that both Ethernet IP addresses are listed.
# mke2fs –j –L mpio –v /dev/mapper/mpio mke2fs 1.39 (29-May-2006) Filesystem label=mpio OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) 6557152 inodes, 13109760 blocks 655488 blocks (5.
Technical Support and Customer Service Dell's support service is available to answer your questions about PS Series SAN arrays. If you have an Express Service Code, have it ready when you call. The code helps Dell's automated-support telephone system direct your call more efficiently. Contacting Dell Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services might not be available in your area.