Read Configuring HP Device Mapper multipathing and Fibre Channel utilities with Citrix XenServer 5.5 text version

Configuring HP Device Mapper multipathing and Fibre Channel utilities with Citrix XenServer 5.5

Table of contents

Executive summary............................................................................................................................... 2 Introduction ......................................................................................................................................... 2 Downloading the packages .................................................................................................................. 2 HPDM Multipath package ................................................................................................................. 2 HP Fibre Channel utilities package ..................................................................................................... 3 Installation and configuration ................................................................................................................ 3 For more information ............................................................................................................................ 8

Executive summary

This white paper describes the procedures required to enhance multipathing I/O functionality within Citrix XenServer using tools and utilities designed for use with HP StorageWorks products. These procedures were validated by HP in July 2009. Target audience: The procedures contained in this document are designed for system administrators and hardware integrators.

Introduction

Citrix has officially supported Device Mapper Multipath IO (DM-MPIO) since the release of XenServer 5.x, which provides a generic version of /etc/multipath.conf that can be modified to properly interface with your attached storage devices. HP provides utilities to support DM-MPIO on HP ProLiant servers attached to HP StorageWorks storage devices. At this time, HP does not offer DM-MPIO packages intended specifically for Citrix XenServer; however, the packages designed for Red Hat Enterprise Linux (RHEL) 5.x can be used with Citrix XenServer. This document shows how to configure the HP Device Mapper Multipath (HPDM Multipath) Enablement Kit for HP StorageWorks Disk Arrays and Fibre Channel utilities packages from HP on retail editions of Citrix XenServer 5.5. Procedures apply to HP StorageWorks arrays with Fibre Channel connectivity.

Note: These packages cannot be used in conjunction with Citrix XenServer editions from HP.

Downloading the packages

Procedures are provided for downloading HPDM Multipath and Fibre Channel utilities packages from the HP website.

HPDM Multipath package

The current version of the HPDM Multipath package (distributed as HPDMmultipath-4.3.0.tar.gz) is 4.3.01. Perform the following steps to download the appropriate HP Device Mapper Multipath Enablement Kit and release notes for HP StorageWorks disk arrays:

1. Go to http://www.hp.com/support/downloads. 2. Under Storage, click Storage Software. 3. Under Storage Infrastructure Software, click Multi-path Device Mapper for Linux Software and then

select Red Hat Enterprise Linux 5 Server (x86).

4. In the Description column, click the title, "Device Mapper Multipath Enablement Kit for HP

StorageWorks Disk Arrays" associated with the latest version.

5. To download the enablement kit, click Download.

1

1 June 2009

2

HP Fibre Channel utilities package

The current version of the HP Fibre Channel utilities (distributed as hp-fc-enablement-2009-0330.tar.gz) is 8.02.00.06.05.03-k2. Perform the following steps to download the HP Linux Inbox driver enablement kit and release notes for QLogic host bus adapters (HBAs) and mezzanine cards:

1. Go to http://www.hp.com/support/downloads. 2. Under Storage, click Storage Networking. 3. Under Host Bus Adapters, click HP StorageWorks PCIe 4Gb Host Bus Adapter, click HP

StorageWorks FC1142SR 4Gb PCIe Host Bus Adapter, and then select Red Hat Enterprise Linux 5 Server (x86).

4. In the Description column, click the title, "Linux Inbox driver kit". 5. To download the driver kit, click Download.

Note: The RPM package that will be extracted from the above download supports both QLogic and Emulex HBAs.

Installation and configuration

The following procedure provides instructions for installing and configuring HPDM Multipath and Fibre Channel utilities packages on Citrix XenServer 5.5. On completion, multipathing is enabled. Perform the following steps:

1. Copy the two files (HPDMmultipath-4.3.0.tar.gz and hp-fc-enablement-2009-03-30.tar.gz) into

/tmp on the Citrix XenServer host.

2. Extract multipath.conf.HPTemplate.RHEL5 from HPDMmultipath-4.3.0.tar.gz via a console session

on the Citrix XenServer host: [[email protected] ~]# cd /tmp [[email protected] ~]# ls HPDMmultipath-4.3.0.tar.gz hp-fc-enablement-2009-03-30.tar.gz [[email protected] ~]# tar -zxvf HPDMmultipath-4.3.0.tar.gz --strip=2 HPDMmultipath-4.3.0/conf/multipath.conf.HPTemplate.RHEL5 [roo[email protected] ~]# cp /etc/multipath.conf /etc/multipath.conf.original [[email protected] ~]# cp multipath.conf.HPTemplate.RHEL5 /etc/multipathenable.conf [[email protected] ~]# vi /etc/multipath-enable.conf

2

15 April 2009

3

3. Within the file loaded by the vi command, make the following changes (as shown below):

­ Change user_friendly_names from yes to no ­ Remove comment # from the devnode ^cciss!c[0-9]d[0-9]* line ### The Device Mapper Multipath Template configuration file for RHEL5 ### releases to be used with HP StorageWorks Arrays. ### Device Mapper Multipath Enablement Kit v4.3.0 ### Use this configuration file as your /etc/multipath.conf file. ### If you already have a valid working configuration file, refer here ### for the recommended configuration for HP arrays. ### For a list of configuration options with descriptions, please refer ### to /usr/share/doc/<multipath-tools version>/multipath.conf.annotated # The defaults section defaults { udev_dir polling_interval selector path_grouping_policy getuid_callout prio_callout path_checker rr_min_io rr_weight failback no_path_retry user_friendly_names }

/dev 10 "round-robin 0" failover "/sbin/scsi_id -g -u -s /block/%n" "/bin/true" tur 100 uniform immediate 12 no

# The blacklist section - use this to blacklist a multipath device based on # it's wwid ( using wwid ) or device names ( using devnode ) or # vendor and product id ( using device block). blacklist { # wwid devnode devnode devnode #

26353900f02796769 "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*" "^hd[a-z][[0-9]*]" "^cciss!c[0-9]d[0-9]*"

4

4. Save the file you have just edited. 5. Extract and install fibreutils-3.0-3.i386.rpm from hp-fc-enablement-2009-03-30.tar.gz:

[[email protected] ~]# tar -zxvf hp-fc-enablement-2009-03-30.tar.gz --strip=1 hp-fc-enablement-2009-03-30/fibreutils-3.0-3.i386.rpm [[email protected] ~]# rpm -ivh fibreutils-3.0-3.i386.rpm

6. Test the Fibre Channel utilities package by running hp_rescan ­l to list HBAs in the server:

[[email protected] ~]# hp_rescan -l QLogic adapters: /sys/class/scsi_host/2 /sys/class/scsi_host/3 Emulex adapters: [[email protected] ~]# Complete the procedure as follows using the Citrix XenCenter console:

7. 8.

Put the XenServer host in maintenance mode. Select the General tab and then select Properties.

5

9.

Select Multipathing. Check Enable multipathing on this server, as shown in Figure 1.

Figure 1. Enabling multipathing on this server

10. Exit from maintenance mode. 11. Create a storage repository and select a LUN located on the SAN.

6

After configuration, the paths will be displayed as shown in Figure 2.

Figure 2. In this example, there are four paths to SAN storage

7

For more information

HP ProLiant servers HP storage Citrix XenServer http://www.hp.com/go/proliant http://www.hp.com/go/storage http://h71019.www7.hp.com/ActiveAnswers/cache/457122-0-0-225121.html http://www.citrix.com/English/ps2/products/product.asp?contentID=683148

To help us improve our documents, please provide feedback at http://h20219.www2.hp.com/ActiveAnswers/us/en/solutions/technical_tools_feedback.html.

Technology for better business outcomes

© Copyright 2009 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. 4AA2-9969ENW, October 2009

Information

Configuring HP Device Mapper multipathing and Fibre Channel utilities with Citrix XenServer 5.5

8 pages

Report File (DMCA)

Our content is added by our users. We aim to remove reported files within 1 working day. Please use this link to notify us:

Report this file as copyright or inappropriate

171973


You might also be interested in

BETA
Configuring HP Device Mapper multipathing and Fibre Channel utilities with Citrix XenServer 5.5