Citrix StorageLink Installation Guide

Citrix Essentials

Copyright and Trademark Notices Use of the product documented herein is subject to your prior acceptance of the End User License Agreement. A printable copy of the End User License Agreement is included with your installation media. Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc.

2011 Citrix Systems, Inc. All rights reserved.

The product includes software developed by The Apache Software Foundation (http://www.apache.org/). tar-cs copyright (c) 2009, Vladimir Vasiltsov. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

w Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. w Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. w Names of its contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Trademark Acknowledgements
Brocade is a registered trademark of Brocade Communications Systems, Inc. Citrix is a registered trademark, and XenServer is a trademark of Citrix Systems, Inc. in the United States and other countries. Compellent is a registered trademark and Storage Center is a trademark of Compellent Technologies. DataCore, SANmelody, and SANsymphony are trademarks of DataCore Software Corporation. Dell and EqualLogic are trademarks of Dell Inc. Dot Hill is a trademark of Dot Hill Systems Corp. EMC and CLARiiON are registered trademarks of EMC Corporation. FalconStor and IPStor are registered trademarks of FalconStor Software, Inc., in the United States and other countries. Microsoft, MS, Windows, Windows Server, Win32, Outlook, ActiveX, Visual J#, ClearType, Excel, SQL Server, Microsoft Access, Windows Vista, .NET, Media Player, and Active Directory are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. NetApp is a trademark and FlexVol and ONTAP are registered trademarks of NetApp Inc. Nexenta and NexentaStor are trademarks of Nexenta Systems, Inc. All other trademarks and registered trademarks are the property of their respective owners. Document code: March 22 2011 15:55:56

Contents

About this document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

StorageLink documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Getting support and training. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Documentation conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

About Citrix StorageLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Introduction to Citrix StorageLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 What's new in this version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Product editions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 StorageLink Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 The StorageLink environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Hypervisor hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Storage infrastructure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 System requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 StorageLink Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 StorageLink Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Storage system support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Compellent Storage Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 DataCore SANmelody and SANsymphony. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Dell EqualLogic PS Series. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 EMC CLARiiON Storage Adapter (SMI-S). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 FalconStor IPStor Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Greenbytes GB-X Series. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 HP Enterprise Virtual Array (EVA). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 HP Modular Storage Array (MSA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 HP P4000 Series (SAN/iQ). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 HP StorageWorks XP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 NetApp/IBM N Series Storage Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 Nexenta NexentaStor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 Pillar Axiom 600. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 XioTech Emprise 7000 Series. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 iii

Contents

Universal SMI-S Fabrics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Installing Citrix StorageLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Installation process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 Installing Citrix License Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 Getting and activating your license file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Installing the license file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24 Installing the StorageLink Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Installing StorageLink Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

After installing StorageLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

A Using SQL Server with StorageLink Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Switching to SQL Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

iv

Chapter 1

About this document

Topics:
StorageLink documentation Getting support and training Documentation conventions The guide describes how to use Citrix StorageLink to easily manage Microsoft Hyper-V and Citrix XenServer hypervisor hosts and network storage systems to deploy virtual machines. It is assumed that the various components have already been installed in your environment as described in the Citrix StorageLink Installation Guide. This guide is intended for experienced virtual machine administrators, storage administrators, and testers of software applications in a small-to-medium or enterprise business environment.

Chapter 1

About this document

StorageLink documentation
The following documents are provided for Citrix StorageLink and are available on the Citrix website: w Citrix StorageLink Installation Guide w Citrix StorageLink User's Guide w Citrix StorageLink PowerShell Guide w Citrix StorageLink Release Notes In addition, the StorageLink Manager user interface includes a Windows Help system.

Getting support and training

The Citrix Knowledge Center, http://support.citrix.com/, offers a variety of technical support services, tools, and developer resources. There you will find links to the latest versions of product documentation as well as Tech Notes and learning resources: w Links to product documentation in PDF form are at http://support.citrix.com/ product/emhv/esv5.6/#tab-doc and in the new Citrix eDocs site as an Eclipse plugin at http://support.citrix.com/proddocs/index.jsp under the Essentials for Hyper-V node. w Links to Tech Notes are at http://support.citrix.com/product/emhv/esv5.6/#tabtopic w Links to learning resources (how-to videos, whitepapers, Citrix Education courses) are at http://support.citrix.com/product/emhv/esv5.5/#tab-learn For StorageLink support, visit the Citrix StorageLink forum at http://forums.citrix.com/ category.jspa?categoryID=172 Technical support may be purchased from Citrix Solution Advisors or directly from Citrix. For a complete list of Citrix Technical Support options, please refer to the Technical Support Programs page on the Citrix website:

Documentation conventions
For consistency, Windows 7, Windows Vista and Windows Server 2008 terminology is used throughout the documentation set; for example, "Documents" rather than "My Documents" and "Computer" rather than "My Computer" are used. For other Windows operating systems, substitute "My Documents" for "Documents" and "My Computer" for "Computer". Citrix StorageLink documentation uses the following typographic conventions.

Citrix StorageLink Installation Guide

Presentation or Convention User interface controls Command names Variable names

Description Names of buttons, boxes, options, or other controls in the user interface. Names of commands, such as ipconfig. Variable placeholders for information you provide. For example, filename means you type the actual name of a file. Terms newly introduced or otherwise emphasized. Text displayed in code or a text file. In a command, a series of items, one of which is required. For example, {yes | no } means you must type yes or no. Do not type the braces themselves. In a command, optional items. For example, [/ping] means you can type /ping with the command. Do not type the brackets themselves. In a command, a separator between items in braces or brackets. For example, { /hold | /release | /delete } means you must type /hold or / release or /delete. The previous item(s) in the command can be repeated. For example, /route:devicename[,] means you can type additional devicenames separated by commas.

Terms Code examples {braces}

[brackets]

| (vertical bar)

... (ellipsis)

Chapter 1

About this document

Chapter 2

About Citrix StorageLink

Topics:
Introduction to Citrix StorageLink What's new in this version Product editions StorageLink Components The StorageLink environment System requirements Storage system support This chapter describes Citrix StorageLink. It provides a brief overview of the product and its available editions. It also describes the components of the system, the system requirements and prerequisites for its use, and lists the supported storage systems.

Chapter 2

About Citrix StorageLink

Introduction to Citrix StorageLink

Citrix StorageLink is part of the Citrix Essentials product offering. Citrix Essentials is enterprise-class virtual infrastructure that enhances the scalability and agility of Citrix XenServer and Microsoft Hyper-V and Virtual Machine Manager with simplified storage set-up and operation, powerful virtual machine lifecycle management, and dynamic server provisioning. By seamlessly integrating storage infrastructure with hypervisor-layer functions, Citrix StorageLink provides a set of virtualization management and automation capabilities that allows access to the full feature sets of supported storage systems through a single interface, helping IT managers quickly and easily deploy and provision Microsoft HyperV and Citrix XenServer virtual machines in the datacenter. Citrix StorageLink allows you to w leverage the full capabilities of supported storage arrays (thin provisioning, data deduplication, etc.) w move applications into production faster with automated lab development, test and deployment tools w increase business agility and speed new servers into production quickly with built-in virtual machine cloning and snapshot support Citrix Essentials enables IT Professionals to accelerate virtualization projects using XenServer and/or Hyper-V quickly, with less effort, and scale as business needs grow.

What's new in this version

StorageLink 2.4 contains the following new features: w Site Recovery support for XenServer virtual machines on LVHD volumes w Site Recovery support for XenServer virtual machines with more than three disks w Support for the HP StorageWorks XP (including Site Recovery support) and Pillar Axiom 600 storage systems w various scalability enhancements

Product editions
Citrix Essentials is available in three editions: Platinum Edition provides site recovery, workload lifecycle automation, and dynamic provisioning of server workloads to help reduce server and storage sprawl, and minimize repetitive administrative operations for large lab environments, complex server environments or large server farms 10

Citrix StorageLink Installation Guide Enterprise Edition provides advanced StorageLink technology and dynamic provisioning of virtual machine workloads to improve storage operations and utilization, and deliver server workloads more quickly and efficiently for environments with shared storage architectures and large server farms Site Recovery Express Edition provides a limited version of Site Recovery for Microsoft Hyper-V deployments. It supports up to two Hyper-V servers and one storage array on a primary site and the same configuration on a secondary site for failover

StorageLink Components
The core of Citrix StorageLink is the StorageLink Gateway, which runs on a Windows 2008 server (physical or virtual machine) and serves as a platform for managing your storage and virtual machines. There are three ways to manage and use the rich feature set provided by StorageLink Gateway: w the StorageLink Manager, a MMC-based graphical user interface w the StorageLink CLI, a command-line interface that can be used in a Windows Command Prompt w the StorageLink PowerShell plug-in for Windows PowerShell, the new command line shell and task-based scripting technology from Microsoft All components can be installed on the same system, or on separate physical or virtual machines. This guide is an overview for using Citrix StorageLink Manager. The Citrix StorageLink PowerShell Guide describes the PowerShell plug-in.

The StorageLink environment

When you first install StorageLink, the service contains no information about the hypervisor hosts or the storage systems (storage arrays) in your environment. You need one or more servers to use as hosts for Hyper-V and/or XenServer virtual machines, and one or more of the supported storage systems.

Hypervisor hosts
Hyper-V hosts StorageLink 2.4 works with any version of Microsoft Hyper-V. To act as a host for Hyper-V virtual machines, in addition to the systems requirements for Windows Server 2008, the server must be a 64-bit environment and support hardware-assisted virtualization (Intel VT or AMD-V) technology. 11

Chapter 2

About Citrix StorageLink On installation, a Windows 2008 Server is not configured to act as a Hyper-V host. You must enable this capability using the Server Manager. XenServer hosts StorageLink 2.4 requires XenServer version 5.6 or above. An upcoming 2.4.1 hotfix will be available that will allow use of XenServer version 5.5. To act as a host for XenServer virtual machines, the server must be a 64-bit environment. For running Windows virtual machines, it must also support hardwareassisted virtualization (Intel VT or AMD-V) technology.

Storage infrastructure
The other key element in your environment is the presence of one or more of the supported storage systems (see Storage system support on page 14 for a list).

System requirements
StorageLink Gateway
The StorageLink Gateway can be installed on a physical or virtual machine. Note: If you are using the Windows firewall, the appropriate firewall rule will be added automatically during installation. If you are using a 3rd party firewall, you must manually create a firewall rule to open port 21605, or disable your firewall all together. Another alternative is to run both the Citrix StorageLink Manager and the Citrix StorageLink service on the same machine. Operating system Microsoft Windows Server 2008 or 2008 R2 RAM 1 GB or more Disk space Minimum of 100 MB for Gateway installation Software prerequisites An embedded SQLite database is installed with the StorageLink Gateway. Alternatively, you can use a pre-installed Microsoft SQL Server if you so choose. There is a script called cslg_db_config.cmd to help you configure SQL Server for the StorageLink Gateway. The supported versions are Microsoft SQL Server 2005 and SQL Server 2005. Only Windows Authentication mode is supported. For setting up the StorageLink Gateway with Microsoft SQL Server, the script syntax is: 12

Citrix StorageLink Installation Guide cslg_db_config mssql [Database Server Name] [Database Instance Name] [Database Name] Also please remember to attach the StorageLink Gateway Microsoft SQL database files ( cslg_db.mdf and cslg_db_1.ldf ) to your Microsoft SQL Server database instance. The StorageLink Gateway Microsoft SQL database files are in the <% StorageLink Gateway Install Directory %\database> directory, which by default is C:\Program Files (x86)\Citrix\StorageLink\database For setting up StorageLink Gateway with embedded SQLite, the script syntax is: cslg_db_config.cmd sqlite [StorageLink Gateway Install Directory] The default StorageLink Gateway installation directory is c:\Program Files (x86)\Citrix\StorageLink

StorageLink Manager
StorageLink Manager can be installed on a physical or virtual machine. Operating system Microsoft Windows Server 2008 or 2008 R2 (recommended), 2003, Vista, or Windows 7 RAM 1 GB or more Disk space minimum of 100 MB Software prerequisites The following software components must be present on the computer on which you install the StorageLink Manager: Prerequisite Microsoft .NET Framework version 3.5 Microsoft Management Console 3.0 Notes Older versions of .NET result in improper appearance of some of the user interface elements. Required for StorageLink Manager http://www.microsoft.com/downloads/details.aspx? FamilyID=61fc1c66-06f2-463c-82a2cf20902ffae0&displaylang=en Required to use the StorageLink PowerShell plug-in On Windows 2008 the Windows PowerShell feature needs to be added. This can be done from the Windows Server Manager under Features. Previous to Windows 2008,

Microsoft Windows PowerShell

13

Chapter 2

About Citrix StorageLink

Prerequisite

Notes Windows PowerShell needs to be downloaded from Microsoft and installed.

Storage system support

For the latest information on supported storage systems, see the Citrix StorageLink Hardware Compatability List on the web at http://hcl.vmd.citrix.com/SLGHCLHome.aspx.

Compellent Storage Center

supported for Site Recovery The Compellent Storage Adapter has been validated with Storage Center 4.5 and Storage Center 5.2. Using the Compellent Storage Adapter requires Dynamic Capacity and Data Instant Replay licenses on Storage Center. Contact your Compellent representative to obtain the licenses. The latest adapter updates and best practices documentation can be downloaded from Compellent Knowledge Center at http://kc.compellent.com (note: requires a Compellent Knowledge Center user account).

DataCore SANmelody and SANsymphony

StorageLink supports DataCore SANmelody version 3.0 PSP3 (v 3.0.3) and SANsymphony version 7.0 PSP3 (v 7.0.3) storage systems. Only these specified versions are supported. Note: For a DataCore array, you will need a minimum of 3 disks - one for the boot OS (Windows), one for a linear volume, and one for a dynamic volume. The DataCore architecture can create snapshots from the dynamic volume only. If you don't have one, you can't create a virtual machine via snap/clone.

Dell EqualLogic PS Series

StorageLink supports Dell EqualLogic PS series storage systems. Firmware version 5.0.0 is required. To use this storage system with StorageLink, all virtual IP and ports must be in the same subnet. The RAID type cannot be set from StorageLink on Dell EqualLogic PS Series systems when creating a storage repository. 14

Citrix StorageLink Installation Guide There is a Windows registry value called VolumeReservedPercentage for the Dell EqualLogic adapter. This allows you to set the reserved percentage attribute on volume creation for snapshots. The current default value is 100%. This allows you to work around a limitation in the EqualLogic user interface where a value entered for default snapshot space in the Group Configuration tab does not get used by the EqualLogic API.

EMC CLARiiON Storage Adapter (SMI-S)

StorageLink supports EMC CLARiiON CX3 and CX4 series storage systems. Note: For snapshots made of XenServer 5.5 virtual machines, the XenCenter operations New VM from snapshot, Create template from snapshot, and Export snapshot as template (and their command-line equivalents) operate slowly as the hardware does not support creation of hardware clones from snapshots.

FalconStor IPStor Platform

StorageLink supports FalconStor Network Storage Server (NSS) & Continuous Data Protector (CDP). Note: Only iSCSI has been tested with StorageLink.

Greenbytes GB-X Series

StorageLink supports the Greenbytes GB-X Series. Note: The Greenbytes adapter is not shipped with the StorageLink product, so it does not appear in the list of adapters you will see after initially installing StorageLink. The GreenBytes StorageLink adapter can be downloaded from http:// gbupdate.getgreenbytes.com/gbctxstorlink/citrix_100909.zip

HP Enterprise Virtual Array (EVA)

StorageLink supports HP Enterprise Virtual Array (EVA)4100/4000/4400, 6000/6100, 8000/8100 series storage systems. Each comes with Command View EVA management software. When the management software is installed, there is an option for installing the EVA SMI-S provider. This provider must be installed. StorageLink was tested for use with HP Storage Works Command View EVA version 9.1. Note: For snapshots made of XenServer 5.5 virtual machines, the XenCenter operations New VM from snapshot, Create template from snapshot, and Export snapshot as template (and their command-line equivalents) operate slowly as the hardware does not support creation of hardware clones from snapshots.

15

Chapter 2

About Citrix StorageLink If connected via Fibre Channel, you must install the HP Device Specific Module (DSM) software on any Hyper-V hypervisor hosts.

HP Modular Storage Array (MSA)

StorageLink supports HP Modular Storage Array (MSA) 2000/2200/2300 series storage systems. ActivePerl must be installed on the host where the StorageLink Gateway was installed. This is a free download from ActiveState.com: http://www.activestate.com/downloads Note: For snapshots made of XenServer 5.5 virtual machines, the XenCenter operations New VM from snapshot, Create template from snapshot, and Export snapshot as template (and their command-line equivalents) operate slowly, as the hardware does not support creation of hardware clones from snapshots.

HP P4000 Series (SAN/iQ)

supported for Site Recovery StorageLink supports HP P4000 series storage systems (formerly known as HP LeftHand P4000). The storage system must have HP SAN/iQ firmware version 8.5.0.0 for StorageLink to function with it. HP CLiQ library version 8.5.0.479 must be installed on the host where StorageLink Gateway is installed. Additionally, the iSCSI service must be started on the host where CLiQ is installed. The StorageLink service does not utilize this locally running iSCSI initiator, but it is required for the proper functioning of CLiQ. Please contact your local HP representative for download information.

HP StorageWorks XP
supported for Site Recovery StorageLink supports HP StorageWorks XP storage systems. The HP StorageWorks XP storage system requires that a physical server with a Fibre Channel HBA be used as the Control Host. The Control Host consists of the following components: w HP XP RAID Manager. Version 1-23 is required w HP XP Device Manager CLI w Java JRE w Citrix StorageLink 16

Citrix StorageLink Installation Guide Also required is the HP XP Command View AE (CVAE) Server, also known as the Device Manager Server. Version 6.3.0-04 is required. The Device Manager Server can also be run on a separate host, either a physical or virtual machine, or it can be run on the Control Host. Raid Manager Install the RAID Manager if you have not already done so from the media provided by HP on the Control Host. Follow the steps in the installer wizard. Ensure that Centrally Managed is checked, and accept the defaults everywhere else. Note: RAID Manager is installed by default in C:\HORCM. Changing this location requires additional overrides within StorageLink. Keeping this location will ensure that additional overrides won't be required in StorageLink. Device Manager Server Install the Device Manager Server if you have not already done so from the media provided by HP, on either the Control Host or another host. Make sure the Device Manager Server is properly licensed. Note: One Device Manager on each site can manage multiple arrays on that site, but individual array should not be managed by more that one Device Manager Server. Add each array to its corresponding Device Manager Server through the Device Manager web interface using Add Subsystem. This should initiate a full discovery of the array. Device Manager CLI Download the Device Manager CLI from the Device Manager Server web interface to the Control Host. Extract (unzip) everything into the C:\dvmcli directory (there is no installer to run). Note: Extracting the Device Manager CLI to any location other than C:\dvmcli requires additional overrides within StorageLink. The Device Manager CLI requires Java to run. Install the JRE and make sure $JAVA_HOME\bin is added to the system path. Important: $JAVA_HOME\bin must be in the Control Host's system path for the Device Manager CLI to work.

17

Chapter 2

About Citrix StorageLink Citrix StorageLink Install StorageLink on the Control Host. Follow the steps in the installer wizard, providing the location of the Citrix License Server and a password for the Gateway service when prompted. For details see the Citrix StorageLink Installation Guide. Additional HP XP setup StorageLink does not create new Logical Units (LDEVs) on the storage system. It only uses pre-created LDEVs for all its purposes. The creation of LDEVs is a timeconsuming process and is generally considered a preparatory step with the HP XP. Any LDEV that is not assigned to a Host Group is treated as available for StorageLink use. Any that is assigned to a Host Group is not assigned by StorageLink when a new LUN is requested. 1. Once the Control Hosts are set up, create at least one Command Device per array for each control host. Turn off Command Device Security on the Command Devices. Important: Be sure to turn off Command Device Security on the Command Devices. 2. StorageLink does not create Host Groups (HSDs) on the array. This gives the administrator more control over the routing of data into and out of the system through appropriate target ports. Therefore, you should do the following: a. Create a Host Group for each Control Host. b. Create a Host Group for each StorageLink-managed hypervisor host that will be using the array. Add host WWNs to the appropriate Host Groups. c. StorageLink creates a special-purpose Host Group called Citrix_SL_Reservation_HSD that is used to reserve LDEVs that are in use by StorageLink. 3. Add the Command Devices created above to the Host Groups corresponding to the respective Control Hosts. For remote replication, ensure that there is a Command Device on each array for each of the two Control Hosts. 4. For remote replication, StorageLink requires that HP Continuous Access is enabled on each of the arrays and that the arrays are set up as remote replication pairs (see the HP-XP documentation). HP XP overrides The following are the StorageLink overrides for an advanced user who might want more control over the behavior of various aspects of StorageLink management of the array. To set these, edit the Windows Registry on the Control Host. HKLM\Software\Wow6432Node\Citrix\StorageLink\1.0\Server\Adapters\hitachi

18

Citrix StorageLink Installation Guide

Registry key name CliPath_HPXP UseVolumeNames

Type REG_SZ REG_DWORD

Description The full OS path to the Device Manager CLI for HP XP systems. Enables/Disables the use of volume name labels on LUNs

HKLM\Software\Wow6432Node\Citrix\StorageLink\1.0\Server\Adapters\hitachi\Hosts \default Registry key name ReplicationHostGroupName Type REG_SZ Description The name of the Host Group (HSD) to which Command Devices as well as volumes that are involved in replication operations are mapped.

HKLM\Software\Wow6432Node\Citrix\StorageLink\1.0\Server\Adapters\hitachi\Hosts \default\Systems\<array serial number> Registry key name HorcmInstanceLocalPvol Type REG_SZ Description The number of the HORCM instance used for the primary side of local replications. The number of the HORCM instance used for the secondary side of local replications. The number of the HORCM instance used for any remote replications into or out of the system.

HorcmInstanceLocalSvol

REG_SZ

HorcmInstanceRemote

REG_SZ

NetApp/IBM N Series Storage Adapter

supported for Site Recovery StorageLink supports NetApp FAS/S/V series storage systems and the IBM-branded N series. Your storage system should have ONTAPI 1.6 firmware installed. If connected via Fibre Channel, you must install the NetApp Device Specific Module (DSM) software on any Hyper-V hypervisor hosts. Note: If you want to use a NetApp array with the Site Recovery feature, you must 19

Chapter 2

About Citrix StorageLink

w assure that the NetApp array is configured for DNS w assure that the checkIP flag in the SnapMirror configuration is turned on w assure that snapmirror.access is set to all w assure that iSCSI has been started by logging on to the array and issuing the iscsi start command Refer to your NetApp documentation for details.

Nexenta NexentaStor
supported for Site Recovery StorageLink supports NexentaStor storage systems. Note: in order use NexentaStor with StorageLink, you need to create a username and password on the array specifically for StorageLink. To do this, log onto the appliance via the console or ssh with the root password, then run the command setup storagelink password. You will prompted for the username and password. Use these credentials when you connect the StorageLink gateway to the array.

Pillar Axiom 600

StorageLink supports Pillar Axiom 600 storage systems. Requires Axiom software version 4.2.14. Note: In order to establish proper array initiator groups for XenServer, please contact Pillar Support to download the Linux axiompm RPM and install on each XenServer host prior to assigning storage to the hosts.

XioTech Emprise 7000 Series

StorageLink supports the XioTech Emprise 7000 Series. Note: The XioTech adapter is not shipped with the StorageLink product, so it does not appear in the list of adapters you will see after initially installing StorageLink. The link to the XioTech StorageLink adapter is on XioTech's support site and access to it requires an account. See http://xiotech.com/support.php. For more information contact Eric_Lomascolo@xiotech.com

Universal SMI-S Fabrics

StorageLink supports all models of Brocade Fibre Channel switches. 20

Chapter 3

Installing Citrix StorageLink

Topics:
Installation process Installing Citrix License Server Getting and activating your license file Installing the license file Installing the StorageLink Gateway Installing StorageLink Manager This chapter describes the installation and licensing of Citrix StorageLink. After an overview of the installation process, the steps to install the various components are presented in detail.

21

Chapter 3

Installing Citrix StorageLink

Installation process
In summary, the installation process for Citrix StorageLink goes as follows: 1. Install and apply Citrix License Server the StorageLink Gateway and StorageLink Manager require that you install Citrix License Server and apply that license to your host (Platinum and Enterprise editions only - Express edition requires no license). 2. Install StorageLink Gateway The StorageLink Gateway can be installed on Windows 2008 or Windows 2008 R2 3. Install StorageLink Manager the StorageLink Manager is the graphical user interface used to manage StorageLink Gateway. The installation file also contains the Windows command-line interface and the PowerShell plugin. Either before or after StorageLink installation, the overall environment requirements for use with StorageLink are: w One of the supported storage systems must be available w One or more hypervisor hosts running either Windows 2008 or 2008 R2 with the HyperV role enabled, or Citrix XenServer must be available Configuration of storage systems and hypervisor hosts is described in detail in the Citrix StorageLink User Guide. To begin the installation process, insert the DVD into the DVD drive. If autorun is disabled on your machine, browse to the drive and launch autorun.exe.

Installing Citrix License Server

Citrix License Server version 11.6.1 is required for StorageLink Platinum and Enterprise editions. Note: Citrix License Server is not required for the free Citrix Site Recovery Express edition. If you are installing the Site Recovery Express edition, skip this section. 1. From the autorun home screen, select Install Citrix License Server. 2. If prompted with a security warning message, select Run . 3. Select I accept the terms in the License Agreement and then click Next to continue. 4. Use the default installation path or click Browse to browse to your preferred installation destination, and then click Next to continue. 5. The installer proceeds to install the License Server software. 6. When the installation has completed, click Finish at the bottom of the screen to exit. 22

Citrix StorageLink Installation Guide The License Server Configuration Tool appears.

7. Enter the port numbers for the License Server Port, the Vendor Daemon Port, and the Management Console Web Port if desired, or just to use the default values (recommended). Set a password for the admin user and enter it a second time to confirm it. Click OK to complete the License Server configuration.

Getting and activating your license file

When you purchase StorageLink, you are provided with a license code that will allow you to download a license file from the Citrix website. To activate your license, you need w an account on the My Citrix website (if you don't already have an account, go to http:// citrix.com/English/myCitrix/loginNewUser.asp to create one) w the host name of the machine on which you installed Citrix License Server

23

Chapter 3

Installing Citrix StorageLink

Note: A Citrix license is required for Citrix Essentials Platinum and Enterprise editions only. It is not required for the free Citrix Essentials Express edition. If you are installing the Express edition, skip this section. 1. Log in to your account on My Citrix. 2. Go to https://www.citrix.com/English/mycitrix/appcontext.asp?applicationID=10. This is the start page of the Citrix Activation System. Click I Agree to confirm that your company owns the license you are about to activate, and that you are not activating the license on behalf of one of your customers. 3. The next page prompts for your license code. Enter it in the field provided, and then click Continue. 4. The next page prompts you to select a Solution Advisor. You can search for a Solution Advisor by Country, State, and/or Name. Select the Solution Advisor from the list returned by the search, or choose I cannot find my reseller and click Continue. 5. If you chose I cannot find my reseller, browse the list of contacts, or click Add a New Contact. This will open a form that will allow you to add new contact information to the database. Fill it out appropriately and click Continue. 6. The next page prompts you to select licenses to allocate. Follow the instructions on the web page, and enter the hostname of your Citrix License Server in the field provided. Click Continue. 7. The next page gives you a download link for your license file. Download the file to a known location.

Installing the license file

Once you have downloaded your StorageLink license file, you need to install it. Note: A Citrix license is required for Citrix Essentials Platinum and Enterprise editions only. It is not required for the free Citrix Essentials Express edition. If you are installing the Express edition, skip this section. To install the license file 1. Copy the license file to C:\program files\Citrix\Licensing\MyFiles (or wherever you installed License Server). 2. In a Command Prompt, change directories to the license server location C: \program files\Citrix\Licensing\LS and enter the following command: lmreread -c @localhost License Server reads the license file.

24

Citrix StorageLink Installation Guide

Installing the StorageLink Gateway

The StorageLink Gateway can be installed on Windows 2008 or Windows 2008 R2 Server. To begin the installation process, insert the DVD into the DVD drive. To install the StorageLink Gateway 1. Log on to your Microsoft Windows host as the Administrator user or as a user who is a member of the Windows Administrators group. The Gateway installation process will ask you for your Administrator account login information, as the Gateway must run at an elevated permission level in order for it to manage other hosts in the environment. 2. Insert the DVD created from the ISO image downloaded from the Citrix website. If autorun is disabled on your machine, browse to the drive and launch autorun.exe. 3. Click Install StorageLink Gateway from the autorun screen. 4. The setup wizard starts. Click the Next button at the bottom of the Welcome screen to continue. 5. The License Agreement screen appears. Click I Agree to continue. 6. If installing the Citrix Essentials Platinum or Enterprise Edition, the License Server Setting screen appears. If you have a Platinum Edition or Enterprise Edition license, check the Use License Server checkbox and enter the License Host Name and License Port Number in the provided fields. Otherwise, uncheck the checkbox and the Express Edition will be installed. Click Next to continue. If installing the Citrix Essentials Express Edition, the License Server Setting screen is not displayed. 7. The StorageLink Gateway Service Password screen appears. Provide a password and type it a second time to confirm it, then click Next. Note: You must enter a password that contains ASCII characters only. 8. The Choose Install Location screen appears. Use the default installation path or click Browse to specify your preferred installation destination, and then click Install at the bottom of the screen to continue. The installer has gathered the necessary information and begins installing the software. 9. When the installation has completed, click the Finish button at the bottom of the installer

25

Chapter 3

Installing Citrix StorageLink

Installing StorageLink Manager

The StorageLink Manager can be installed on Windows 2003 Server or Windows 2008 Server, Windows XP, Windows Vista, or Windows 7. To begin the installation process, insert the DVD into the DVD drive. If autorun is disabled on your machine, browse to the drive and launch autorun.exe. 1. Select Install StorageLink Manager from the autorun screen. The setup wizard starts. 2. Click Next at the bottom of the Welcome screen to continue. The License Agreement screen appears. 3. The Choose Install Location screen appears. Use the default installation path or click Browse to specify your preferred installation destination, and then click Install at the bottom of the screen to continue. The installer has gathered the necessary information and begins installing the software. 4. When the installation has completed, click the Finish at the bottom of the wizard to complete the installation.

26

Chapter 4

After installing StorageLink

The following tasks need to be performed before you can assign storage and create virtual machines with StorageLink. Most of these tasks can be accomplished using the StorageLink Manager, the command line interface, or the PowerShell interface. w Configure your hypervisor hosts For Hyper-V hosts: First, enable each server to function as a Hyper-V host. To do so, open the Server Manager and click on the Roles node in the tree in the left pane; then in the right, click on Add Role to launch the Add Roles wizard, and select Hyper-V from the list of roles the wizard presents. Enabling this role requires a reboot. After the reboot, make sure that you open Hyper-V Manager and accept the EULA that it will present to you on first launch. Second, enable the iSCSI initiator. From the Start menu, select Administrative Tools>iSCSI initiator, and confirm that you do want to enable the iSCSI initiator service when so prompted. For XenServer hosts, no special configuration is required. w Connect to the StorageLink Gateway Connect the StorageLink Manager administrative console to the Gateway. w Connect to your hypervisor hosts Once the StorageLink Gateway and StorageLink Manager are connected, add your hypervisor hosts. w Add Storage Array Adapters in order to interface with your storage systems, they must also be added to the StorageLink Gateway. Once you've taken care of these steps, StorageLink is ready to use. For information on using StorageLink, see the Citrix StorageLink User Guide or the StorageLink Manager Help.

27

Chapter 4

After installing StorageLink

28

Appendix A

Using SQL Server with StorageLink Gateway

Topics:
Requirements Installation Switching to SQL Server StorageLink Gateway supports SQLite and Microsoft SQL Server 2008 databases (for SQL Server, only Windows Authentication mode is supported.) SQLite is installed with StorageLink Gateway and is used by default. This appendix describes how you can use SQL Server 2008 with StorageLink in place of the default SQLite database.

29

Appendix A

Using SQL Server with StorageLink Gateway

Requirements
If you want to use SQL Server, there are a couple of requirements and recommendations for best performance: w Use the same server (physical or virtual machine) on which the StorageLink Gateway service and SQL Server both run. SQL Server must be collocated with StorageLink Gateway in order to allow for Windows authentication, which is the only kind of authentication StorageLink Gateway supports. w Use a server with two or more CPUs (physical or virtual machine) for best performance. If you do use a single-CPU host, run the SQL Server service at a higher process priority than the StorageLink Gateway service. To do this, open the Windows Task Manager and click on the Processes tab. Find the StorageLink Gateway process (listed as cslg_service.exe*32), right-click on it, and select Set Priority from the context menu. Set it to Normal if it not already set to that choice. Next, find the SQL Server process (listed as sqlservr.exe *32 or something similar), right-click and choose Set Priority, and select Above Normal or High. Click Change Priority in the confirmation box that appears, then close the Task Manager. If neither of these recommendations are followed, you will see a heavy slowdown of certain operations (particularly while using Site Recovery and validating virtual machine failover configuration on a secondary site), as well as spurious failures of site recovery plan validation with database timeouts registered in the StorageLink service logs. w We also recommend that you install StorageLink Manager on a different host (physical server or virtual machine) than the one running StorageLink Gateway SQL Server.

Installation
Installation instructions for Microsoft SQL Server 2008 can be found at http:// msdn.microsoft.com/en-us/library/ms143219.aspx

Switching to SQL Server

You can change the database used by StorageLink to Microsoft SQL Server 2008 by using the script cslg_db_config.cmd, located in <%StorageLink Gateway Installation Directory%>\Server\ (which by default is C:\Program Files (x86)\Citrix\StorageLink\Server). For setting up the StorageLink Gateway with Microsoft SQL Server, the script syntax is: cslg_db_config.cmd mssql [Database Server Name] [Database Instance Name] Note: The server name and instance name parameters depend on a couple of factors:

30

Citrix StorageLink Installation Guide

w SQL Server compact edition uses (local) for the Database Server Name. All editions other than the compact edition use a real server name, localhost in most cases. w For editions other than SQL Server Compact Edition, the Database Instance Name may or may not exist depending on whether SQL Server was installed as a "named instance" or as an "unnamed default instance." In the case of SQL Server Compact edition, there is no named instance; only the unnamed default instance" can be used. Also attach the StorageLink Gateway Microsoft SQL database files (cslg_db.mdf and cslg_db_1.ldf) to your SQL Server database instance. These files are in the < %StorageLink Gateway Data Directory%>\Server\Database directory (which by default is C:\ProgramData\Citrix\StorageLink\Server\Database). You can also use this script to switch back to using the default embedded SQLite database. The script syntax is then: cslg_db_config.cmd sqlite <%StorageLink Gateway Data Directory%> \Server where the default StorageLink Gateway data directory is c:\ProgramData\Citrix \StorageLink Note: The cslg_db_config.cmd script stops and restarts the StorageLink Gateway service. If you run the script with erroneous parameters, the StorageLink Gateway service will be stuck in Starting mode. If this happens, you will need to manually stop the service (Start >Administrative Tools>Services ) and run the script again with correct parameters.

31