HP 3PAR Citrix Implementation Guide Abstract This implementation guide provides the information you need to configure an HP 3PAR StoreServ Storage with Citrix 5.x or 6.x. General information is also provided on the basic steps required to allocate storage on the HP 3PAR StoreServ Storage that can then be accessed by the Citrix host.
© Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Introduction...............................................................................................5 Supported Configurations..........................................................................................................5 HP 3PAR OS Upgrade Considerations.........................................................................................5 Audience................................................................................................................................
Setting Up the Bidirectional CHAP on the HP 3PAR StoreServ Storage.......................................31 Setting the Bidirectional CHAP for Citrix................................................................................31 6 Allocating Storage for Access by the Citrix Host...........................................33 Creating Storage on the HP 3PAR StoreServ Storage...................................................................33 Creating Virtual Volumes........................................
1 Introduction This implementation guide provides the information you need to configure an HP 3PAR StoreServ Storage with Citrix 5.x or 6.x XenServer. General information is also provided on the basic steps required to allocate storage on the HP 3PAR StoreServ Storage that can then be accessed by the Citrix host.
Audience This implementation guide is intended for system and storage administrators who monitor and direct system configurations and resource allocation for the HP 3PAR StoreServ Storage. The tasks described in this manual assume that the administrator is familiar with Citrix 5.x or 6.x and the HP 3PAR OS.
2 Configuring the HP 3PAR StoreServ Storage for Fibre Channel This chapter explains how to establish a Fibre Channel connection between an HP 3PAR StoreServ Storage and a Citrix host using Fibre Channel and covers HP 3PAR OS 3.1.x. For information on setting up the physical connection for a particular HP 3PAR StoreServ Storage, see the appropriate HP 3PAR installation manual.
# controlport offline 1:5:1 # controlport config host -ct loop 1:5:1 # controlport rst 1:5:1 2. After all ports have been configured, verify that the ports are configured for a host in a direct connection by issuing the showport -par command on the HP 3PAR StoreServ Storage.
1. To determine whether a port has already been configured for a host port in fabric mode, issue showport -par on the HP 3PAR StoreServ Storage. 2. If the port has not been configured, take the port offline before configuring it for connection to a host. To take the port offline, issue the HP 3PAR OS command line interface (CLI) command controlport offline . # controlport offline 1:5:1 3.
2. To verify that the host has been created, issue the showhost command. # showhost Id Name Persona 6 Citrixhost Generic -WWN/iSCSI_Name1122334455667788 1122334455667799 Port ----- NOTE: HP recommends host persona 1. Using Host Persona 1 will enable the SES device on this host. As a result, exporting a LUN on ID 254 will require a host reboot before it can be discovered and used as a storage repository.
The HP 3PAR StoreServ Storage arrays support the following zoning configurations: • One initiator to one target per zone • One initiator to multiple targets per zone (zoning by HBA). This zoning configuration is recommended for the HP 3PAR StoreServ Storage. NOTE: For high availability/clustered environments that require multiple initiators to access the same set of target ports, HP recommends that separate zones be created for each initiator with the same set of target ports.
In addition, some HP switches, such as the HP SN8000B 8-slot SAN backbone director switch, the HP SN8000B 4-slot SAN director switch, the HP SN6000B 16 Gb FC switch, or the HP SN3000B 16 Gb FC switch automatically select the proper fill-word mode 3 as the default setting. • McDATA switch or director ports should be in their default modes as G or GX-port (depending on the switch model), with their speed setting permitting them to autonegotiate.
HP 3PAR OS Persistent Ports The HP 3PAR OS Persistent Ports (or virtual ports) feature minimizes I/O disruption during an HP 3PAR StoreServ Storage online upgrade or node-down event (online upgrade, node reboot, or cable pull test). Port shutdown or reset events do not trigger this feature. Each FC target storage array port has a partner array port automatically assigned by the system. Partner ports are assigned across array node pairs.
3 Configuring the HP 3PAR StoreServ Storage for iSCSI Configuring the HP 3PAR StoreServ Storage To configure 1 Gb iSCSI target ports on the HP 3PAR StoreServ Storage for connection to an iSCSI Initiator, perform the following steps: 1. Check the current settings of the iSCSI ports by issuing the showport -iscsi command. The following examples are for the 1 Gb iSCSI ports on the array. 2. # showport -iscsi N:S:P State IPAddr 0:3:1 offline 0.0.0.0 0:3:2 loss-sync 0.0.0.0 1:3:1 offline 0.0.0.0 Netmask 0.0.
N:S:P Brand Model 0:3:1 QLOGIC QLE8242 0:3:2 QLOGIC QLE8242 2. Rev Firmware 58 0.0.0.0 58 0.0.0.0 Serial HWType PCGLT0ARC1K3SK CNA PCGLT0ARC1K3SK CNA If State=config_wait or Firmware=0.0.0.0, use the controlport config iscsi command to configure. Use the showport and showport -i commands to verify the configuration setting. For example: # controlport config iscsi 0:3:1 # controlport config iscsi 0:3:2 # showport N:S:P Mode State ----Node_WWN---- -Port_WWN/HW_Addr- Type Protocol ...
NOTE: When the host initiator port and the HP 3PAR StoreServ Storage array iSCSI port are in different IP subnets, the gateway address for the HP 3PAR StoreServ Storage array iSCSI port should be configured in order to avoid unexpected behavior. Creating the Software iSCSI Host Definition This section describes how to create a software iSCSI host definition. NOTE: If multiple initiator ports are used, add the following to /etc/sysctl.conf: net.ipv4.conf.all.
Target Port Limits and Specifications To avoid overwhelming a target port and ensure continuous I/O operations, observe the following limitations on a target port: • I/O queue depth on each HP 3PAR StoreServ Storage HBA model, as follows: ◦ QLogic 1G: 512 ◦ QLogic 10G: 2048 (HP 3PAR StoreServ Storage 10000 and HP 3PAR StoreServ Storage 7000 systems only) • The I/O queues are shared among the connected host HBA ports on a first-come, first-served basis.
HP Support Center • the HP 3PAR Command Line Interface Administrator’s Manual, “Using Persistent Ports for Nondisruptive Online Software Upgrades” This document is available on the following HP SC website: HP Support Center iSCSI HP 3PAR OS Persistent Ports Setup and Connectivity Guidelines for iSCSI Starting with HP 3PAR OS 3.1.3, the HP 3PAR OS Persistent Ports feature is supported for iSCSI. Starting with HP 3PAR OS 3.1.
4 Connecting a Host with Fibre Channel/FCoE This chapter describes the tasks necessary for connecting the host Fibre Channel or Fibre Channel over Ethernet (FCoE). Installing the Emulex HBA/CNA Install the Emulex host bus adapter(s) (HBAs) or CNAs in the host according to the documentation provided with the HBAs/CNAs and host. Emulex OneCommand Command Line Interface 1.
5. To verify that the parameter is set correctly, issue the following command: # ./hbacmd GetDriverParam Output from the foregoing commands is shown below: # ./hbacmd ListHBAs Manageable HBA List Port WWN : Node WWN : Fabric Name: Flags : Host Name : Mfg : Serial No. : Port Number: Mode : . . . 10:00:00:00:c9:7b:07:52 20:00:00:00:c9:7b:07:52 10:00:08:00:88:a0:5c:ad 8000f100 sqa-dl380g5-08 Emulex Corporation VM82281959 0 Initiator # ./hbacmd Help DriverParams . . .
SCLI Command Line Interface Use scli with the in-box QLogic driver from the Citrix installation. • For FC, the scli utility is installed under /opt/QLogic_Corporation/SANsurferCLI. • For FCoE, the scli utility is installed under /opt/QLogic_Corporation/ QConvergeConsoleCLI. • Verify version installed with rpm. Example: # rpm -qa scli scli-1.7.1-23 Make the following selection from the scli menu: • Select HBA Parameters from the Main Menu.
Modifying the /etc/multipath-enabled.conf File for Citrix 5.5 The /etc/multipath.conf file is used by device mapper where the multipathing parameters have been set. Do not modify /etc/multipath.conf. Citrix links it to either /etc/multipath-enabled.conf or /etc/multipath-disabled.conf depending on whether multipathing is enabled or disabled. The default installed /etc/multipath-enabled.conf file must be edited to make the following changes: 1.
devnode devnode devnode devnode devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*" "^hd[a-z]" "^sda$" "^sda[0-9]" "^cciss!c[0-9]d[0-9]*" } NOTE: Add other devices as necessary to the blacklist structure as per the configured host. Modifying the /etc/multipath.conf File for Citrix 5.6 or 6.x The /etc/multipath.conf file is used by device mapper where the multipathing parameters have been set. The default installed /etc/multipath.conf file must be edited to make the following changes: 1.
Example: The system is booted through an internal SCSI boot disk and has a device instance sda, which is excluded from being seen by the device mapper by adding the devnode blacklist structure. The resulting /etc/multipath.conf file blacklist section appears as follows: # cat /etc/multipath.
HP Support Center • the HP 3PAR Command Line Interface Administrator’s Manual, “Using Persistent Ports for Nondisruptive Online Software Upgrades” This document is available on the following HP SC website: HP Support Center Fibre Channel over Ethernet NOTE: For information regarding the Persistent Ports feature for an FCoE initiator to FC target configuration (FCoE to FC switched), see “Configuring the HP 3PAR StoreServ Storage for Fibre Channel” (page 7).
5 Connecting a Host with Software iSCSI Configuring Citrix 5.6 or 6.x for iSCSI iSCSI on Citrix 5.6 or 6.x iSCSI is installed by default by Citrix 5.6 or 6.x. The iscsiadm utility is a command-line tool that allows discovery and login to iSCSI targets. This tool also provides access and management of the open-iscsi database. The following steps are required to discover LUNs: 1. Discover targets at a given IP address. 2. Establish iSCSI login with the node record ID found during the target discovery process.
3. To control how often a ping is sent by the iSCSI initiator to the iSCSI target, change the following parameter. node.conn[0].timeo.noop_out_interval = [replacement_timeout] To detect problems quickly in the network, the iSCSI layer sends iSCSI pings to the target. If the ping times out, the iSCSI layer responds by failing running commands on the path where the pings failed. 4. Set this parameter to 10 seconds. node.conn[0].timeo.noop_out_interval = 10 5. 6. 7.
2. After open-iscsi is started, you can check the state of the open-iSCSI service run level information with the chkconfig command. Run level 5 should be on. For example: # chkconfig --list | grep iscsi iscsi 0:off 1:off 2:off 3:off 4:off 5:on 6:off Creating the iSCSI Connection in Citrix 5.6 or 6.x Using the iscsiadm Command After connecting the host to the HP 3PAR StoreServ Storage iSCSI target port, use the iscsiadm command to create the iSCSI connection, complete following steps: 1.
Discovering iSCSI Devices and Creating Storage Repositories with Citrix 5.6 or 6.x NOTE: iSCSI is not supported with Citrix 5.5. To discover iSCSI devices and create storage repositories with XenCenter, follow these steps: 1. In the Resources pane, select the server to create a new storage repository. 2. On the toolbar, click Storage, and then click New SR. 3. Select Software iSCSI, and then click Next. 4. Change the default name if necessary, and then click Next. 5.
Setting the Host CHAP for Citrix To set the host CHAP for Citrix, complete the following steps: 1. Go to the iSCSI Initiator host console, or, at a terminal, edit the /etc/iscsid.conf file and enable CHAP authentication: # To enable CHAP authentication set node.session.auth.authmethod # to CHAP. The default is None. node.session.auth.authmethod = CHAP 2. Configure the host CHAP password for the discovery and login session by again editing the configuration file /etc/iscsid.conf file.
e. Repeat the steps as described in “Setting the Host CHAP Authentication on the HP 3PAR StoreServ Storage” (page 29) to rediscover the iSCSI target nodes and create the iSCSI login sessions. Setting Up the Bidirectional CHAP on the HP 3PAR StoreServ Storage To set bidirectional CHAP (mutual), complete the following steps. The HP 3PAR OS CLI sethost initchap and sethost targetchap commands must be used to set bidirectional CHAP on the HP 3PAR StoreServ Storage. 1.
node.session.auth.username = citrix node.session.auth.password = host_secret0 2. Perform the CHAP configuration setting for the target: # 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 = S121 discovery.sendtargets.auth.password_in = target_secret0 # To set a CHAP username and password for target(s) # authentication by the initiator, uncomment the following lines: node.session.auth.
6 Allocating Storage for Access by the Citrix Host Creating Storage on the HP 3PAR StoreServ Storage This section describes the general steps and commands that are required to create the virtual volumes (VVs) that can then be exported for discovery by the Citrix host. For additional information, see the HP 3PAR Command Line Interface Administrator’s Manual. For complete details on creating virtual volumes, see the appropriate HP 3PAR documentation.
Creating Thinly-Provisioned Virtual Volumes To create thinly-provisioned virtual volumes, see the following documents: • HP 3PAR StoreServ Storage Concepts Guide • HP 3PAR Command Line Interface Administrator’s Manual • HP 3PAR Command Line Interface Reference Exporting LUNs to the Host This section explains how to export LUNs to the host as VVs, referred to as virtual LUNs (VLUNs). To export VVs as virtual LUNs, issue the following command: createvlun [–cnt] [.
In the example above, there are five paths to the HP 3PAR StoreServ Storage from each HBA port. Restrictions on Volume Size and Number Follow the guidelines for creating virtual volumes (VVs) and virtual LUNs (VLUNs) in the HP 3PAR Command Line Interface Administrator’s Manual while adhering to these cautions and guidelines: • This configuration supports sparse LUNs (meaning that LUNs may be skipped). LUNs may also be exported in non-ascending order (e.g., 0, 5, 7, 3).
7 Booting the Host from the HP 3PAR StoreServ Storage HP 3PAR StoreServ Storage Setup Requirements Booting from the HP 3PAR StoreServ Storage is supported from version 5.6 Feature Pack 1 onwards and on fabric and direct connect topologies. During the Citrix installation perform the following steps: 1. On the Welcome to XenServer screen, press F2. 2. At the boot prompt, enter multipath. 3.
Booting from the HP 3PAR StoreServ Storage Using Emulex HBAs When booting from the HP 3PAR StoreServ Storage using an Emulex HBA, complete the following steps: 1. During the host boot, press Alt-E or Ctrl-E when prompted by the Emulex HBA Utility, a screen appears that will show the Emulex adapters in the system. Select and press Enter. a. A screen displays: The BIOS of the Adapter is Disabled. If the screen displays, The BIOS of the Adapter is Enabled, then skip to Step 2. b.
5. Configure the following: BIOS Enabled, Port Speed Auto and Boot LUN Flash Values. Press Esc to return to the previous menu. 6. From the Adapter configuration menu select Boot Device settings. 7. Select ID0 followed by the target device you want to boot from, press Enter. 8. Select your next HBA port to boot from and repeat these steps. 9. Use Alt-S to save the configuration. 10. Reboot the system.
8 Modifying HP 3PAR Devices on the Host Displaying Detailed Device Mapper Node Information Use Citrix XenServer or the command line interface provided by Citrix to obtain node information. If applicable, use the sg3_utils packaged with the Citrix installation to collect details. NOTE: In the following examples, multipath and dmsetup usage provides information only; do not use these commands to change the node setting. Use multipath -l for listing of devices and dmsetup to get detailed dm node information.
Citrix XenServer provides the following methods for removing virtual volumes and storage repositories: • Method 1—Detach • Method 2—Forget • Method 3—Destroy After removing the storage volume from the host, remove the VLUN from the HP 3PAR StoreServ Storage by issuing removevlun . # removevlun testvlun 0 Citrixhost WARNING! While removing the device, make sure the correct underlying device is used.
9 Configuring Citrix Resource Pools HP 3PAR supports the use of Citrix Resource Pools. On the HP 3PAR StoreServ Storage, LUNs for the pool must exported to each host in the pool using the createvlun command. The following example shows the exporting of poolLun.0 to pool with two hosts, poolHost1 and poolHost2. # createvlun poolLun.0 0 poolHost1 # createvlun -f poolLun.0 0 poolHost2 For setup instructions, see the Citrix online help topic Configuring Resource Pools.
10 Using Citrix High Availability HP 3PAR supports the use of Citrix High Availability (HA). There are no special setup considerations for the HP 3PAR StoreServ Storage.
11 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
For information about: See: Migrating data from one HP 3PAR storage system to another HP 3PAR-to-3PAR Storage Peer Motion Guide 44 Configuring the Secure Service Custodian server in order to monitor and control HP 3PAR storage systems HP 3PAR Secure Service Custodian Configuration Utility Reference Using the CLI to configure and manage HP 3PAR Remote Copy HP 3PAR Remote Copy Software User’s Guide Updating HP 3PAR operating systems HP 3PAR Upgrade Pre-Planning Guide Identifying storage system compo
For information about: See: Planning for HP 3PAR storage system setup Hardware specifications, installation considerations, power requirements, networking options, and cabling information for HP 3PAR storage systems HP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7000 Storage Site Planning Manual HP 3PAR StoreServ 7450 Storage Site Planning Manual HP 3PAR 10000 storage systems HP 3PAR StoreServ 10000 Storage Physical Planning Manual HP 3PAR StoreServ 10000 Storage Third-Party Rack Physic
Typographic conventions Table 2 Document conventions Convention Element Bold text • Keys that you press • Text you typed into a GUI element, such as a text box • GUI elements that you click or select, such as menu items, buttons, and so on Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values • Code variables • Command variables Bold monospace text • Commands you enter into a command line interface • System
12 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.