Host Integration Tools
Installation and User Guide
Version 3.4
Copyright 2010 Dell, Inc. All rights reserved.
EqualLogic is a registered trademark of Dell, Inc.
Dell is a trademark of Dell, Inc.
All trademarks and registered trademarks mentioned herein are the property of their respective owners.
Information in this document is subject to change without notice.
Reproduction in any manner whatsoever without written permission is strictly forbidden.
July 2010
Part Number: 110-6037-EN-R1
Table of Contents
Preface ... vii
Audience ... vii
Organization ... vii
Conventions ... viii
Overview of EqualLogic Products... ix
Related Documentation ... x
Technical Support and Customer Service... x
Online Services... xi
1 Installation ... 1-1
Host Integration Tools Components... 1-1 Supported Applications ... 1-2 Microsoft Exchange Server... 1-2 Microsoft SQL Server... 1-3 Microsoft Hyper-V... 1-4 Installing Host Integration Tools on a Microsoft Failover Cluster... 1-4 Considerations when Configuring Failover Clusters... 1-4 Joining a Computer into a Windows Failover Cluster... 1-5 ASM/ME Cluster Administrative Account... 1-5 Changing the EqlReqService Logon Account ... 1-6 PS Series Group Network Recommendations ... 1-6 Installing the Host Integration Tools ... 1-7 Installation Considerations... 1-7 Windows Server 2008 Installation Considerations ... 1-8 Windows Server 2008 Core Additional Considerations ... 1-8 Preparing to Install ... 1-9 First Time Installation Summary ... 1-9 Updating, Maintaining, and Removing an Installation ... 1-11 Performing an Unattended Installation ... 1-112 Remote Setup Wizard... 2-1
Remote Setup Wizard Overview ... 2-1 Remote Setup Wizard Computer and Group Requirements ... 2-1 Using the Remote Setup Wizard to Configure Groups ... 2-2 Launching the Remote Setup Wizard ... 2-2 Initializing an Array and Creating a Group ... 2-2 Using Remote Setup Wizard to Identify a PS Series Array ... 2-4 PS Series Array Initialization Procedure ... 2-5 Initializing an Array and Expanding a Group ...2-7 Enabling (or Modifying) Computer Access to a Group... 2-9 Disabling Microsoft Service Access to a Group ... 2-113 Remote Setup Command Line Utility ... 3-1
General Command Syntax for the RSWCLI ... 3-1 Entering Commands ... 3-1 Discovering a PS Series Array ... 3-2 Command Syntax... 3-2 Initializing a PS Series Array ... 3-2Host Integration Tools Installation and User Guide Table of Contents
Adding Access to the PS Series Array Group ... 3-3 Command Syntax... 3-4 Listing Accessible PS Array Groups ... 3-4 Command Syntax... 3-5 Modifying Access to PS Series Array Group ... 3-5 Command Syntax... 3-5 Removing Host Access to a PS Series Array Group ... 3-6 Command Syntax... 3-6 Listing or Modifying MPIO Settings... 3-6 Command Syntax... 3-6 Listing Included and Excluded Subnets for MPIO... 3-7 Command Syntax... 3-7 Including a Subnet for Use by MPIO ... 3-8 Command Syntax... 3-8 Excluding a Subnet for User By MPIO ... 3-9 Command Syntax... 3-9
4 Using the Multipath I/O DSM ... 4-1
Introduction to Multipath I/O DSM... 4-1 Prerequisites for Configuring Multipath I/O DSM... 4-3 Information Required to Configure Multipath I/O ... 4-4 Configuring Multipath I/O Between a Computer and a Group ... 4-4 Logging into a Volume with Multipath I/O ... 4-5 Logging Off a Volume with Multipath I/O... 4-5 Viewing MPIO Sessions... 4-6 Setting the MPIO Load Balancing Policy ... 4-8 Procedure to display the connections to a target and optionally change its load balancing policy on operating systems other than Windows Server 2008 R2: ... 4-8Procedure to display the connections to a target and optionally change its load balancing policy on Windows Server 2008 R2: ... 4-8 Excluding an IP Address from a Subnet... 4-9
5 Using the VDS Provider ... 5-1
VDS Provider Requirements ... 5-1 VDS Provider Guidelines and Restrictions ... 5-1 Simple Target and LUN Naming... 5-2 Importing VSS Snapshots... 5-2 Modifying Access Controls ... 5-3 Creating a Volume Using Storage Manager for SANs... 5-3 Starting the Storage Manager for SANs ... 5-36 Using the EqualLogic HPC iSCSI Provider ... 6-1
HPC iSCSI Provider Installation ... 6-1 Configuring the PS Series Array ... 6-1 Settings ...6-17 Tools and Utilities ... 7-1
The EqlXcp Utility ... 7-1 EqlXcp Utility Restrictions... 7-1 Using the EqlXcp Utility... 7-1 Debug Tracing and the EqlLog Utility ... 7-2Host Integration Tools Installation and User Guide Table of Contents
Running the EqlLog utility ... 7-2 EqlLog Command Line Options ... 7-2 Trace Log Daemon... 7-3
Glossary ... Glossary-1
Index... Index-1
Host Integration Tools Installation and User Guide Table of Contents
Host Integration Tools Installation and User Guide
Preface
The Host Integration Tools is a collection of applications and utilities that simplifies the configuration and administration of EqualLogic PS Series storage arrays on Microsoft® Windows® computers.
Audience
The information in this guide is intended for computer system administrators who are responsible for, and have appropriate knowledge of, the following tasks:
• Installing and using the Host Integration Tools.
• PS Series group administration.
• Windows and Windows Server operating environment administration.
• iSCSI initiator operation.
• Windows Exchange database and SQL Server database administration.
Organization
The organization of this guide is as follows:
• Chapter 1, Installation – Describes the Host Integration Tools kit components, operating system support, and how to install the tools.
• Chapter 2, Remote Setup Wizard – Describes how to use the Remote Setup Wizard to initialize arrays and create or expand groups, configure system access to a group, and configure multipath I/O between a system and group.
• Chapter 3, Remote Setup Command Line Utility – Describes how to use the Remote Setup Command Line Interface to manage PS Series arrays.
• Chapter 4, Using the Multipath I/O DSM – Describes how to use the EqualLogic Multipath I/O (MPIO) DSM (Device Specific Module) to manage redundant network paths to PS Series volumes for improved availability and performance.
• Chapter 5, Using the VDS Provider – Describes how to create volumes by using the VDS provider in conjunction with Microsoft VDS and Microsoft Storage Manager for SANS.
• Chapter 6, Using the EqualLogic HPC iSCSI Provider – Describes how to install and configure the HPC iSCSI Provider, which enables Microsoft HPC Server provisioning of iSCSI volumes.
• Chapter 7, Tools and Utilities – Describes the EqlXcp and EqlLog utilities, which are included with the Host Integration Toolkit.
• Glossary – Defines storage technology terminology that is specific to EqualLogic.
Host Integration Tools Installation and User Guide
Conventions
Typographical conventions are shown in the following table.
Convention Usage
fixed width font Command, parameter, output, file name, link, button, field, URL address, or e-mail address.
bold fixed width Input to command prompt.
fixed_width_italics Indicates that you replace the variable with a command, parameter, file name, etc.
{text1 | text2} Indicates that you can choose one of the items presented.
parameter ... Trailing dots indicate that you can enter multiple parameters on a command line, separated by spaces.
option[,...] Trailing dots, preceded by a comma, indicate you can enter multiple variables, separated by commas and no spaces.
[parameter] Brackets indicate that the item inside the bracket is optional.
> A greater than symbol represents a Windows system prompt.
Host Integration Tools Installation and User Guide
Overview of EqualLogic Products
Thank you for your interest in 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 performance and network load balancing. Additionally, PS Series arrays offer all-inclusive array management software, host software, and free firmware updates. The features and products described next are available at no additional cost.
PS Series Software
• Firmware - Installed on each array, PS Series firmware allows you to manage your storage environment and provides capabilities such as volume snapshots, cloning, and replication to ensure data hosted on the arrays is protected in the event of an error or disaster.
- Group Manager GUI: Provides a graphical user interface for managing a group.
- Group Manager CLI: Provides a command line interface for managing a group.
• Manual Transfer Utility (MTU) – Runs on Windows and Linux systems and enables you to use physical media to securely transfer large amounts of data to a replication partner, facilitating replication and preventing network congestion.
Host Software for Windows
• Host Integration Tools:
- Remote Setup Wizard (RSW): Initializes new PS Series arrays, configures host connections to PS Series groups, and configures and manages multipathing.
- Multipath I/O Device Specific Module (MPIO DSM): Includes a connection awareness-module that understands PS Series network load balancing and facilitates host connections to PS Series volumes.
- VSS and VDS Provider Services: Allows 3rd party backup software vendors to perform off-host backups.
- Auto-Snapshot Manager/Microsoft Edition (ASM/ME): ASM/ME is a VSS requesting application that uses PS Series snapshots, cloning, and replication to provide point-in-time protection of critical data for
supported applications, including SQL Server, Exchange Server, Hyper-V, and NTFS file shares.
• SAN HeadQuarters (SANHQ): Provides centralized monitoring, historical performance trending, and event reporting for multiple PS Series groups.
Host Software for VMware
• Storage Adapter for Site Recovery Manager (SRM): Allows SRM to understand and recognize PS Series replication for full SRM integration.
• 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.
Current Customers Please Note: You may not be running the latest versions of the tools and software listed above.
If you are under a valid warranty or support agreement for your PS Series array, you are entitled to obtain the latest updates and new releases as they become available.
Host Integration Tools Installation and User Guide
Related Documentation
For detailed information about PS Series arrays, groups, volumes, array software, and host software, see the following documentation:
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.
For customers in the United States, call 800-945-3355.
Note: If you do not have access to an Internet connection, contact information is printed on your invoice, packing slip, bill, or Dell product catalog.
Use the following procedure to contact Dell for sales, technical support, or customer service issues:
1. Visit support.dell.com or the Dell support URL specified in information provided with the Dell product.
Host Integration Tools Installation and User Guide
2. Select your locale. Use the locale menu or click on the link that specifies your country or region.
3. Select the required service. Click the "Contact Us" link, or select the Dell support service from the list of services provided.
4. Choose your preferred method of contacting Dell support, such as e-mail or telephone.
Online Services
You can learn about Dell products and services using the following procedure:
1. Visit www.dell.com (or the URL specified in any Dell product information).
2. Use the locale menu or click on the link that specifies your country or region.
Host Integration Tools Installation and User Guide Installation
1 Installation
Host Integration Tools installation topics include the following:
• Host Integration Tools Components on page 1-1
• Supported Applications on page 1-2
• Joining a Computer into a Windows Failover Cluster on page 1-5
• Installing the Host Integration Tools on page 1-7 Before you begin any installation procedures:
• Check the Dell Technical Support Web site to make sure you have the latest Host Integration Tools kit and documentation.
• Read the current revision of the Release Notes for the most recent information about:
– Supported and required software and firmware releases.
– Supported operating system versions.
– The latest information about Host Integration Tools known issues and usage constraints.
On a single computer, you must log in to Windows as administrator or be a member of the administrators group to install and use the Host Integration Tools. When installing on a cluster, you must run the installation from an account that is a member of the domain administrators group.
Note: If a previous version of a component is already installed on your computer, the installation program updates it to the latest version.
Host Integration Tools Components
The Host Integration Tools installation program enables you to choose which components to install on your computer. The components are listed in Table 1-1.
Table 1-1: Host Integration Tools Components
Component Description
Remote Setup Wizard Enables you to initialize a PS Series SAN array and set up or expand a PS Series group.
You can also configure multipath
I/O. See Chapter 2, Remote Setup Wizard.
Remote Setup Wizard Command Line Utility (RSWCLI)
Provides an alternative to using the Remote Setup Wizard, with set up commands that you can execute at the Windows command prompt instead of using the GUI. The RSWCLI is described in Chapter 3, Remote Setup Command Line Utility.
Dell Auto-Snapshot Manager/
Microsoft Edition (ASM/ME)
A Microsoft Management Console (MMC) snap-in tool that enables you to create and manage Smart Copies (snapshots, clones, and replicas). An alternate command-line interface facilitates custom operations and scripting. See the Auto-Snapshot Manager/
Microsoft Edition User’s Guide
EqualLogic VSS Provider Supports VSS management of application-consistent Smart Copies.
Host Integration Tools Installation and User Guide Installation
Supported Applications
The applications described here are supported for use with Host Integration Tools, subject to any issues and constraints specified in the Release Notes.
Microsoft Exchange Server
Host Integration Tools supports online backup and quick restore of Exchange components by using the ASM/ME GUI.
The installer verifies that a supported version of Microsoft Exchange Server exists on the target installation computer. If the installed version is not supported, you have the following options:
• Cancel the ASM/ME installation and update Microsoft Exchange Server.
• Proceed with the ASM/ME installation. In this case, ASM/ME operations that are specific to Microsoft Exchange Server will not function until you have updated to a supported version.
Note: If ASM/ME detects an unsupported version of Microsoft Exchange Server, a red arrow appears next to the application in the ASM/ME console tree.
Supported features for Microsoft Exchange Server include:
• Creating snapshot, replica, and clone Smart Copies of Microsoft Exchange Server mailbox databases (for Exchange 2010) or storage groups (for Exchange 2007 and 2003) residing on PS Series volumes.
• Automatic discovery of the Microsoft Exchange Server instance and its components.
• Consistent, online backup and quick restore of Microsoft Exchange mailbox databases (for Exchange 2010) or storage groups (for Exchange 2007 and 2003) residing on PS Series volumes
The following types of Microsoft Exchange Server application behaviors are supported for Smart Copies:
EqualLogic VDS Provider Enables you to use Microsoft VDS and Microsoft Storage Manager for SANs to create and manage volumes in a PS Series group. See Chapter 5, Using the VDS Provider.
EqualLogic Multipath I/O DSM (MPIO DSM)
A driver module that works in conjunction with the Microsoft MPIO driver to support multipathing. This feature dynamically balances your iSCSI SAN traffic load over multiple network paths between the computer and the PS Series group. You need multiple iSCSI host bus adapters to use this feature. Configure EqualLogic Multipath I/O DSM by using the Remote Setup Wizard, as described in Chapter 2, Remote Setup Wizard. As an alternative to the Remote Setup Wizard, you can use the RSWCLI, described in Chapter 3, Remote Setup Command Line Utility.
Microsoft iSCSI Initiator Enables connections to iSCSI targets. Required by Remote Setup Wizard, ASM/ME, and the VDS provider. For information about using the initiator, see the Microsoft
documentation. See Installation Considerations on page 1-7.
iSCSI Initiator properties tab Provides information about the status and history of the multipath connections supported by the Multipath I/O DSM.
Java Runtime Environment Enables you to use the EqualLogic Java-based graphical user interfaces (GUIs).
Table 1-1: Host Integration Tools Components (Continued)
Component Description
Host Integration Tools Installation and User Guide Installation
• Copy backup type (on Microsoft Exchange Server 2010, 2007 and 2003 sp2).
• Scheduling Smart Copy creation for Microsoft Exchange mailbox databases (for Exchange 2010) or storage groups (for Exchange 2007 and 2003).
• Recovery Mailbox Database creation for Microsoft Exchange 2010 item level restores.
• Automated Recovery Storage Group setup for Microsoft Exchange 2007 item level restores.
• Recovery Storage Group creation setup for Microsoft Exchange 2003 item level restores.
• The Clone and Restore All as New option is available for Microsoft Exchange 2010 and 2007 Smart Copies.
The Clone and Restore All as New feature allows you to clone a mailbox database from a source Exchange server, and then set it up as a new mailbox database on a target Exchange server.
• The option to perform checksum verification (database and transaction log) and optional soft recovery
immediately after Smart Copy creation. You can also use this feature by setting up a global verification task on the Exchange Server host or a remote host.
See the ASM/ME User Guide for more information.
Microsoft SQL Server
Host Integration Tools supports online backup and quick restore of Microsoft SQL Server databases using the Auto-Snapshot Manager/Microsoft Edition (ASM/ME) GUI.
Although it is not detected during installation, ASM/ME verifies the compatibility of the installed version of SQL Server. The ASM/ME Applications writer node is disabled if the installed version and service pack level of Microsoft SQL Server is unsupported. Supported Microsoft SQL Server versions with required service pack updates are described in the Release Notes.
Note: If ASM/ME detects an unsupported version of Microsoft SQL Server, a red arrow appears next to the application in the ASM/ME console tree.
Supported features for Microsoft SQL Server include:
• Support for creating snapshots, replicas, or clones of Microsoft SQL Server databases residing on PS Series volumes.
• Automatic discovery of Microsoft SQL Server instance and all SQL databases.
• Consistent, online backups and quick restores of Microsoft SQL Server databases residing on PS Series volumes.
Microsoft SQL Server application supports both full and copy backup type Smart Copies on Microsoft SQL Server 2005 and 2008.
The following Microsoft SQL Server database restore operations are supported:
• Restore All - Restores databases to the point-in-time represented by a Smart Copy. Optionally, you can apply transaction log backups to a database being restored.
• Restore named_databases - Selectively restores one or more databases sharing the same volume (uses an automated file copy operation after the Smart Copy is imported, if volume sharing is detected).
Host Integration Tools Installation and User Guide Installation
• Clone and Restore as New - Recovers a database from a cloned replica Smart Copy on the secondary group.
Optionally, you can mount a read-only copy of the replica Smart Copy for backup to tape or for data mining (volume replication stops while replica is mounted).
See the ASM/ME User Guide for more information.
Microsoft Hyper-V
Hyper-V enables you to run a client virtual machine (also called a guest O/S) in child partitions. ASM/ME enables you create application-consistent and crash-consistent Smart Copies of virtual machines, dependent on Guest O/S type. You can also:
• Define collections of virtual machines.
• Set up schedules for creating Smart Copies of virtual machines.
• Restore Smart Copies of virtual machines.
• Restore virtual hard drive (VHD) volumes.
See the ASM/ME User Guide for more information.
Installing Host Integration Tools on a Microsoft Failover Cluster
The following parallel installation requirements apply when you configure the Host Integration Tools on more than one node in the Microsoft Failover Cluster:
• You must install the same version of Host Integration Tools on every cluster node.
• You must select the same set of components (such as ASM/ME or VDS) on each node.
• You must run the Remote Setup Wizard on each node, specifying identical responses for each screen.
• If you are using multipathing with the EqualLogic MPIO DSM, you must use an identical configuration on each node.
Considerations when Configuring Failover Clusters
Information on configuring, using and troubleshooting Microsoft Failover Clusters can be found on Microsoft's TechNet website.
• Computers running Windows Server 2003 and using the cluster service might be unable to join a cluster after the computer is first restarted. See the Microsoft Knowledgebase article at:
http://support.microsoft.com/kb/938615
• The cluster service might not start after you restrict the available IP Ports for remote procedure calls. See the Microsoft Knowledgebase article at:
http://support.microsoft.com/kb/258469
• In a server cluster that uses only iSCSI technology for shared storage devices, you must make the cluster service dependent on the Microsoft iSCSI Initiator service. This makes the Microsoft iSCSI Initiator service
Host Integration Tools Installation and User Guide Installation
start before the cluster service. See the Microsoft Knowledgebase article at:
http://support.microsoft.com/kb/883397
• When you start your Microsoft Windows Server 2003-based computer that is running Windows Clustering, an Event ID: 57 might be logged. See the Microsoft Knowledgebase article at:
http://support.microsoft.com/default.aspx/kb/885688/en-us
See also the ASM/ME User’s Guide for information about configuring ASM/ME for use on Windows Failover Clusters and for information about cluster resource ownership.
Joining a Computer into a Windows Failover Cluster
The following considerations apply when you join a single computer running Host Integration Tools into a Microsoft Failover Cluster:
• If you are using continuous cluster replication (CCR) or a Database Availability Group (DAG) under Microsoft Exchange, you do not need to supply Host Integration Tools with cluster access information during the installation. You are prompted to check a box during the installation indicating that CCR or DAG is in use and subsequently you do not need to supply a user name or password.
• You must maintain parallel installations (see Installing Host Integration Tools on a Microsoft Failover Cluster on page 1-4)
• You must use an account with the correct credentials (see ASM/ME Cluster Administrative Account on page 1-5)
• You must change the logon account for the EQLReqService (see Changing the EqlReqService Logon Account on page 1-6)
Note: If you install Host Integration Tools on a running cluster, you are prompted to configure the installation for cluster operation and it is not necessary to complete the tasks described in the following sections.
ASM/ME Cluster Administrative Account
You perform many operations across cluster nodes. Therefore, you must log in using a user account that has the following characteristics:
• The account is a Microsoft domain user account
• The account has local administrative access
Consider creating a named account such as ASMadmin to use for ASM/ME operations on the cluster. You can use this account to log on to required services as described in Changing the EqlReqService Logon Account on page 1-6.
If any cluster node is running Microsoft Exchange and Microsoft SQL Server, (using PS Series iSCSI volumes) you must also make sure that your user account has the appropriate security group access for those applications.
Note: Certain operations may fail with an error message if you do not use an appropriate account.
Host Integration Tools Installation and User Guide Installation
Changing the EqlReqService Logon Account
To join a system running Host Integration Tools to a cluster, you must change the logon for the EQLReqService.
Use the ASM/ME cluster administrative account referenced in ASM/ME Cluster Administrative Account on page 1-5.
1. Open the Windows Control Panel 2. Double-click AdministrativeTools.
3. Double-click Services. The Services window appears.
4. Double-click EQLReqService.
5. Select the LogOn tab and change the logon account to the ASM/ME administrative account, or any account with appropriate access credentials.
PS Series Group Network Recommendations
Table 1-2 describes the network recommendations for PS Series group operation and for computer access to group.
All the normal networking rules apply; however, network configuration is beyond the scope of this manual.
Table 1-2: PS Series Group Network Recommendations Recommendation Description
Switched Gigabit Ethernet network
Connect arrays and computers to a switched network. Dell recommends that all network connections between computers and arrays are Gigabit Ethernet. (An array can operate at 10 and 100 Mbits, but performance will be significantly degraded.)
Network interface cards (NICs) or host bus adapters (HBAs) must operate at a minimum of 1 gigabit per second (1Gb/sec). NICs that operate at speeds of less than 1Gb/sec are not used for multipath I/O by default.
Network switch types Dell recommends using enterprise class switches of a non-blocking design for your iSCSI SAN.
If using multiple switches, link the switches to enable communication across different subnets. Use a link of sufficient bandwidth.
Multiple network connections For increased bandwidth and availability, connect multiple network interfaces on an array to the network (use different switches, if possible). Connect interfaces in the following order:
Port 0, Port 1, and Port 2. Multiple network connections are required for multipath I/O.
The initial group setup configures only one network interface on an array (Port 0). After creating the group, use the Group Manager GUI or CLI to assign an IP address and netmask to other network interfaces.
Access to the group IP address
In a multi-subnet group, each configured network interface should have access to the subnet on which the group IP address resides.
Redundant network paths Multipath I/O provides a highly-available network path between computers and arrays.
For replication, a reliable, adequately sized network link
For effective and predictable replication, make sure that the network link between the primary and secondary groups is reliable and provides sufficient bandwidth for copying data.
Flow Control enabled on switches and NICs
Enable flow control on each switch port and NIC that handles iSCSI traffic. PS Series arrays will correctly respond to Flow Control.
Host Integration Tools Installation and User Guide Installation
Installing the Host Integration Tools
This section describes the prerequisites for an installation and guides you through the graphical installation procedure.
Installation Considerations
Consider the following before you begin an installation:
• Microsoft iSCSI Initiator Version
Host Integration Tools supports specific versions of the Microsoft iSCSI Initiator as described in the Release Notes. Depending on the version currently installed on your computer, you might be required to update to a more recent version. Some Windows operating system variants include the Microsoft iSCSI Initiator as a service.
• Using a Firewall
If you are using a firewall and you intend to install the EqualLogic Multipath I/O DSM, you must configure the firewall to allow ICMP echo requests (pings). See the Release Notes for more information.
Note: If your computer is running Windows Server 2008 or Windows Server 2003, the installation procedure detects whether you are using a firewall service and offers to automate Windows firewall configuration.
• Computer Downtime
You do not need to reboot the computer unless you choose to install the MPIO DSM component. Be aware that rediscovery of the network after a shutdown might take several minutes.
• Installation Options
Review the documentation (this manual and the Release Notes) to determine:
– Whether you require a typical installation or a custom installation.
– Whether Host Integration Tools supports the installed applications and operating system versions.
Unicast storm control disabled on switches
Disable unicast storm control on each switch that handles iSCSI traffic, if the switch provides this feature. However, the use of broadcast and multicast storm control is encouraged on switches.
Jumbo Frames enabled on switches and NICs
Enable jumbo frames on each switch and NIC that handles iSCSI traffic to obtain performance benefits and for consistency of behavior.
No STP functionality on switch ports that connect end nodes
Do not use spanning-tree (STP) on switch ports that connect end nodes (iSCSI initiators or storage array network interfaces).
However, if you want to use STP or RSTP (preferable to STP), you should enable the port settings available on some switches that let the port immediately transition into
STP-forwarding state upon linkup. This can reduce network interruptions that occur when devices restart, and should only be enabled on switch ports that connect end nodes.
Dell encourages you to use spanning-tree for a single-cable connection between switches and also to use trunking for multi-cable connections between switches.
VLANs Configure network switches to use VLANs to separate iSCSI SAN traffic from other network traffic.
Table 1-2: PS Series Group Network Recommendations (Continued) Recommendation Description
Host Integration Tools Installation and User Guide Installation
– Which Host Integration Tools components are applicable to your site.
• Installation Location
Decide whether you want to install the Host Integration Tools in the default location of C:\Program Files\EqualLogic, or a different location.
See also the specific requirements for ASM/ME operations in the ASM/ME User Guide.
Windows Server 2008 Installation Considerations
If you are installing Host Integration Tools on a computer running Windows Server 2008, review the requirements and support statements included in the Release Notes.
During the installation, you might be prompted to perform the following configuration tasks, depending on the current state of your Windows installation:
• Microsoft iSCSI Initiator service
The Microsoft iSCSI Initiator is integrated into Windows Server 2008 rather than provided as an installation package. During the installation of Host Installation Tools, you have the option to start the Initiator service.
When started, the installer launches the Initiator properties interface so that you can optionally configure connections to your SAN. Close the Initiator properties interface to continue with the Host Integration Tools installation.
• Windows Firewall and Equallogic MPIO
This consideration applies only if you decide to use EqualLogic MPIO. If Windows Firewall is enabled, you must configure it to allow echo requests (pings). During the installation of Host Installation Tools, you have the option to configure the firewall automatically.
• Microsoft MPIO service
This consideration applies only if you decide to use EqualLogic MPIO. Microsoft MPIO service is required to run MPIO. During the installation of Host Installation Tools, you have the option to configure the MPIO service automatically.
If you decide not to configure any of these services during the Host Integration Tools installation, you must configure them as a post-installation task. Otherwise, the related Host Integration Tools features will not function.
For example, you cannot run Remote Setup Wizard to set up EqualLogic MPIO if you did not opt to start the Microsoft MPIO service.
Windows Server 2008 Core Additional Considerations
If you are installing Host Integration Tools on a computer running Windows Server 2008 Core, review the
requirements and support statements included in the Release Notes. Because Windows Server 2008 Core does not provide a Desktop graphical user interface, you must begin the installation as follows:
1. Copy the installation package (such as setup64.exe) to a location on the computer. Write down the path to the file.
2. Connect to the computer running Windows Server 2008 Core and open the Windows command line terminal.
3. Type the following command and press enter:
run<pathname>setup64.exe.
Host Integration Tools Installation and User Guide Installation
4. The Host Installation Tools graphical installer launches. Follow the procedure described in First Time Installation Summary on page 1-9. Only supported components are installed.
Note: To uninstall Host Integration Tools from a computer running Windows Server 2008 Core, run the installation package a second time and select the option to Modify the current installation.
Preparing to Install
Obtain the installation kit by using one of the following methods:
• Find the Host Integration Tools distribution CD-ROM that shipped with your PS Series array. The CD-ROM uses autorun to start automatically (if your computer is configured to allow autorun).
• Download the installation kit (approximately 60MB for the 32-bit version and 91MB for the 64-bit version).
This requires a EqualLogic Customer User account, which you can set up at the following URL:
https://support.dell.com/equallogic.
When you have set up the support account, obtain the kit as follows:
1. Log in to your account and click the Customer Service Home tab.
2. Click Downloads in the navigation bar and select Host Integration Toolkit. 3. Click the latest revision of the toolkit to display the Web page for that revision.
4. Click Host Integration Tools version in the right-hand column, under Current Software.
5. Click Accept to accept the terms and conditions of the download.
6. Save the executable installation image to a temporary location on your local computer.
First Time Installation Summary
If you have installed a previous version the Host Integration Tools, see Updating, Maintaining, and Removing an Installation on page 1-11 for information about modifying or updating an existing installation.
When installing on a failover cluster, you must perform the installation from an account that is a member of the domain administrator group.
Follow the prompts on the CD-ROM installation dialog or double-click the downloaded setup.exe package to start the installation. A summary of each installation window is provided in Table 1-3:
Table 1-3: Installation Summary Window Title User Actions and Options
Host Integration Tools Welcome Screen The installer detects unsupported versions of related applications, such as Microsoft Exchange. You can abort the installation and update the applications to supported revisions, or proceed and defer the application update to a later time.
ClickNextto proceed.
License Agreements You are prompted to read and accept the EqualLogic license and associated product licenses for third-party software.
Host Integration Tools Installation and User Guide Installation
Note: If you deferred the task of configuring services such as the Microsoft iSCSI Initiator service or the
Microsoft MPIO service, configure the services manually before you launch the Remote Setup Wizard. The related Host Integration Tools components will not work until the required services are running.
Installation Type Choose a Typical (the default) or a Custom installation. A Typical
installation automatically installs the Multipath I/O software (where supported), which requires a post-installation reboot. A custom installation allows you select which components are installed, depending on which version of Windows you are using.
Microsoft iSCSI Initiator Service. Depending on which version of Windows you are using, you might be prompted to start the Initiator service. Close the Initiator properties interface to resume the installation.
Choose Destination Location (custom installations only).
Specify an installation folder for the kit, or accept the default location on the system C:\ drive.
[Optional] Windows Firewall Configuration
To use EqualLogic MPIO, you must configure the Windows Firewall. The Installer performs this configuration automatically, or you can defer it as a post-installation task.
(If you defer firewall configuration, you must configure the firewall manually before you run the Remote Setup Wizard to configure MPIO.)
Select Components (custom installations only).
Specify which components you want to install. (A reboot is required for installations that include the EqualLogic MPIO DSM.)
Cluster Access Information (failover clusters only).
Specify the name and password of a domain account with the credentials described in ASM/ME Cluster Administrative Account on page 1-5.
Specify a network file share for the ASM/ME backup documents using UNC format (\\host\folder).
Ready to install the components You can proceed to install or click Back to optionally review your selections.
Click Cancel to abort the installation.
[Optional] Microsoft MPIO Service To use EqualLogic MPIO, you must configure the Windows MPIO service. The Installer performs this configuration automatically, or you can defer it as a post-installation task.
(If you defer configuring the MPIO service, you must configure it manually before you run the Remote Setup Wizard to configure MPIO.)
Installation Status The installer displays the installation progress. If the installer encounters any problems, dialog messages guide you through the recovery process. If any unrecoverable problems occur, one or more diagnostic messages might appear as part of this sequence. Write down these messages for troubleshooting purposes.
Installation Complete You can run the Remote Setup Wizard, which launches immediately if no system reboot is required.
A reboot is mandatory to restart the MPIO DSM component and the Remote Setup Wizard launches automatically when the reboot is complete.
Table 1-3: Installation Summary (Continued) Window Title User Actions and Options
Host Integration Tools Installation and User Guide Installation
Updating, Maintaining, and Removing an Installation
After you have installed the Host Integration Tools for the first time, running the same installation procedure subsequently enables you to do the following tasks:
• Add and remove components.
• For versions of Windows that have a desktop GUI, remove most of the components originally installed. To completely remove all components, use the software management option in the Windows Control Panel.
• For versions of windows without a desktop GUI (such as Windows Server 2008 R2 Core), remove the entire Host integration tools installation.
When installing on a failover cluster, you must perform the installation from an account that is a member of the domain administrator group.
If you have previously installed a version of the Host Integration Tools you will see the following differences in an update installation procedure:
• The installer detects the previous version and notifies you that it will attempt to update the installed version to the latest version.
• You are prompted to deselect components (which removes those components) or select additional components for installation.
• If you select the EqualLogic MPIO DSM component, you are prompted to restart the computer.
Performing an Unattended Installation
Use the procedure described in this section to perform an unattended installation of the Host Integration Tools (that is, an installation that does not require you to monitor and respond to the installation prompts). You create a template of your installation selections as you perform an installation. You can then clone this installation template to other computers, if the other computers have:
• Very similar or identical hardware configurations.
• The same operating system and service pack level.
• The same system configuration for all optionally-installed features that are affected by the installation, including (but not limited to) firewall, iSCSI initiator version and configuration, Microsoft MPIO.
Cloning an installation works best when you are setting up a large number of identically-configured and newly-installed computers.
The following considerations apply when performing an unattended installation:
• During the installation process, installation messages from third-party products might appear, indicating what software is being installed. However, these messages do not interfere with the installation and can be ignored.
• The drive letter you specify in the installation script is used on every computer on which you run the script. For example, if you specified F:\Eql in the script, all the other computers on which you run the script will attempt to install the kit on the F:\ drive.
Host Integration Tools Installation and User Guide Installation
• The installation applies the selections you make when you create the original recording of an installation.
However, only those Host Installation Tools components that are supported by the target computer are installed.
• When installing on a failover clusters, you must perform the installation from an account that is a member of the domain administrator group.
To perform an unattended installation:
1. Launch the windows command prompt by clicking Start, then Run. Then type cmd. 2. Start the installation script in record mode by using the following command syntax:
C:\> setup.exe /r /f1"file_name.iss"
Where file_name is a string specifying the full path name of the installation resource file. For example:
C:\hit_install.iss.
3. Select the installation options that you want to clone to other computers. The installation procedure saves these options to the .iss file.
4. Copy the .iss file to any computer on which you want to install the Host Integration Tools.
5. Run the installation script in unattended mode by using the following command:
C:\> setup.exe /s /f1"file_name"
Where file_name is a string specifying the full path name of the installation resource file. For example:
C:\hit_install.iss.
2 Remote Setup Wizard
The Remote Setup Wizard simplifies array, group, and Windows setup. Remote Setup Wizard topics include the following:
• Remote Setup Wizard Overview on page 2-1
• Remote Setup Wizard Computer and Group Requirements on page 2-1
• Using the Remote Setup Wizard to Configure Groups on page 2-2
• Launching the Remote Setup Wizard on page 2-2
• Initializing an Array and Creating a Group on page 2-2
• Initializing an Array and Expanding a Group on page 2-7
• Enabling (or Modifying) Computer Access to a Group on page 2-9
• Disabling Microsoft Service Access to a Group on page 2-11
To install the Remote Setup Wizard, see Chapter 1, Installation. See the Host Integration Tools Release Notes for the latest information about the wizard.
The Host Integration Tools also include the Remote Setup Command Line Interface (RSWCLI). Use the RSWCLI utility to manage PS Series groups, instead of using the Remote Setup Wizard. For details, see Chapter 3, Remote Setup Command Line Utility.
Remote Setup Wizard Overview
The Remote Setup Wizard simplifies PS Series group (SAN) and Windows computer setup, enabling you to perform the following tasks:
• Initialize a PS Series array and either create or expand a group. The wizard will also automatically set up computer access to the group, configuring the group IP address as the iSCSI target discovery address and, for new groups, enabling Microsoft service (VSS or VDS) access to the group through CHAP authentication.
• Configure the computer to access a group. The wizard will configure the group IP address as the iSCSI target discovery address and also configure Microsoft service (VSS or VDS) access to the group if CHAP
authentication is being used to restrict access. You can also use the wizard to modify access information or disallow computer access to a group.
• Configure multipath I/O. Redundant network paths between a computer and group volumes provide
highly-available and high-performance access to data. See Chapter 4, Using the Multipath I/O DSM for details about how to configure multipath I/O.
Note: If you deferred setting up required services during Host Integration Tools installation, you must configure the services before you run the Remote Setup Wizard
Remote Setup Wizard Computer and Group Requirements
Windows computer and PS Series group requirements for using the Remote Setup Wizard are as follows:
Host Integration Tools Installation and User Guide Remote Setup Wizard
• Computer running a supported operating system and a supported version of the Microsoft iSCSI Software Initiator. See the Release Notes for information about Remote Setup Wizard operating system support.
• For versions of the Windows operating system that include the iSCSI Initiator as a service, make sure that the Initiator service is running.
• Two or more supported network interface cards (NICs) or host bus adapters (HBAs) that are at least 1 Gbps.
Multipath I/O does not utilize NICs with speeds of less than 1 Gbps.
• If you want to create or expand a group:
- Uninitialized PS Series array running the minimum supported firmware revision. The array hardware must be installed and a network cable must be attached to Ethernet Port 0. Follow the hardware installation procedure described in the setup documentation for your array model. You do not require a serial cable if you are using the Remote Setup Wizard, although you should keep the serial cable for later use in case there is no network access to the array or group.
- Connection between the array and computer. There are two connection options:
• Connect the computer to the same Ethernet segment as the array, and make sure that Layer 2
multicasting is not blocked between the array and the computer. This is the required connection method if you want to configure computer access to a group or configure multipath I/O between the computer and a group.
• Use an RJ45 network cable to connect the computer to Ethernet Port 0 on the uninitialized PS Series array.
Using the Remote Setup Wizard to Configure Groups
Use the procedures in this section to configure groups on your PS Series array.
Launching the Remote Setup Wizard
After you install the Host Integration tools, you can select the option to launch the Remote Setup Wizard automatically. You can also run by clicking Start, then Programs, then EqualLogic, then Remote Setup Wizard.
In the dialog box, select the task you want to perform:
• Initialize an array (and create or expand a group).
• Configure the computer to access a group, if supported by the computer.
• Set up multipath I/O, if supported by the computer.
Initializing an Array and Creating a Group
Using the Remote Setup Wizard, you can initialize a PS Series array and create a PS Series group with the array as the first member. In addition, the wizard will set up computer access to the group, configuring the group IP address as the iSCSI target discovery address and enabling Microsoft service (VSS or VDS) access to the group through CHAP authentication.
If the Remote Setup Wizard is interrupted while initializing an array and the operation fails, you must reset the array before running the wizard again. To reset an array:
Host Integration Tools Installation and User Guide Remote Setup Wizard
1. Connect the serial cable that was shipped with the array, between the active control module and a console terminal, or a computer running a terminal emulator.
2. Enter the reset command and wait for the reset operation to complete.
3. Disconnect the serial cable, and launch the Remote Setup Wizard from the computer where it is installed.
Before you initialize an array and create a group, gather information about the array configuration and the group configuration, as described in Table 2-1 and Table 2-2.
The Remote Setup Wizard will prompt you for this information.
Table 2-1: Array Configuration
Prompt Description
Member name Unique name used to identify the array in the group. The name string must be fewer than 64 alphanumeric characters or hyphens. No other characters are permitted. The first character must be a letter or number.
IP address (IPv4) Network address for the Ethernet 0 network interface, which must be an IPv4 address. Each member must have at least one network interface on the same subnet as the group IP address, described in Table 2-2.
Netmask Combines with the IP address to identify the subnet on which the Ethernet 0 network interface resides.
Default gateway Network address for the device used to connect subnets and forward network traffic beyond the local network. A default gateway is used to allow the Ethernet 0 network interface to
communicate outside the local network (for example, to allow access to volumes from computers outside the local network). The default gateway must be on the same subnet as the Ethernet 0 network interface.
RAID policy RAID policy configured on the first member of the group:
RAID 10 — Striping on top of multiple RAID 1 (mirrored) sets, with one or two spare disks.
RAID 10 provides good performance for random writes, in addition to the highest availability.
RAID 50 — Striping on top of multiple RAID 5 (distributed-parity) sets, with one or two spare disks. RAID 50 provides a good balance of performance (especially for sequential writes), availability, and capacity.
RAID 5 — One RAID 5 set, with one spare disk. RAID 5 is similar to RAID 50, with more capacity (two additional disks) but lower availability and performance.
RAID 6 — Of the total number of disks installed in the array, two disks are used for parity and one disk is a spare. The remainder are data disks.
RAID 6-Accelerated — This has the same disk configuration as RAID 6, but is used on PS Series arrays that have a mix of HDD (hard disk drives) and SDD (solid state disk drives).
If you are adding an array to an existing group, use the Group Manager GUI or CLI to set the RAID policy for the new member.
Table 2-2: Group Configuration
Prompt Description
Group name Unique name used to identify the group. The name string must be fewer than 64 alphanumeric characters or hyphens. No other characters are permitted. The first character must be a letter or number.
Host Integration Tools Installation and User Guide Remote Setup Wizard
Using Remote Setup Wizard to Identify a PS Series Array
The remote Setup Wizard discovers and displays (as a formatted list) all accessible uninitialized arrays in your SAN.
You can search and sort this list of arrays to identify a specific PS Series array that you want to initialize and set up as a member of a group. You enter an alphanumeric string, (such as part of the manufacturing serial number printed on an array chassis) and the first matching array is returned. Repeat the search to find the next matching array, and so on.
You can enter an alphanumeric string fragment of any of the following data items in each column in the list of discovered arrays:
• Serial Number
The array’s serial number. Typical PS Series serial numbers are SHU946170103CB8, or B035687.
• Firmware
The revision number of the PS Series firmware that is running on the array, such as: 4.1.1.
• RAID Levels
The RAID level supported by the array, such as 5, 10, 50, 6, and 6-accelerated. For example, the string
5,10, matches any arrays that support RAID level 5, and RAID level 10.
• Host Adapter Name
The name of the hardware or software host bus adapter (or NIC) to which the array is connected, such as:
Intel(r) Pro/1000 PT Adaptor.
If the search feature matches an array in the list , you can hover the cursor over any line item to display additional information as follows:
• The array MAC address for ethernet port 0 (eth0)
• The array MAC address for the host adapter to which the array is connected.
Group IP address Network address for the group. The group IP address is used for group administration and computer access to data stored in the group.You cannot specify IPv6 addresses when initializing a group. However, you can add host access to a group that is already configured to use IPv6 addresses. See Enabling (or Modifying) Computer Access to a Group on page 2-9
Password for managing group membership
Password required when adding members to the group. The password must have 3 to 16 alphanumeric characters and is case-sensitive.
Password for the default group administration account
Password that will override the factory-set password (grpadmin) for the default grpadmin account. The password must have 3 to 16 alphanumeric characters and is case-sensitive.
Microsoft service user name and password
CHAP user name and password used to enable Microsoft service (VSS or VDS) access to the group. The user name must have between 3 and 54 alphanumeric characters. The password must have 12 to 16 alphanumeric characters, and is case-sensitive.
Microsoft services running on a computer must be allowed access to the group in order to create VSS snapshots in the group or use VDS.
Table 2-2: Group Configuration (Continued)
Prompt Description
Host Integration Tools Installation and User Guide Remote Setup Wizard
You can also sort the list of discovered arrays by clicking on the button that contains a list column heading. For example, click on the Firmware heading to sort firmware revisions in ascending order. Click a second time to sort in descending order. A triangle to the right of the column header indicates the current sort column, if any, and the sort direction.
PS Series Array Initialization Procedure
Use the following procedure to initialize an array and create a group:
1. Start the Remote Setup Wizard. as described in Launching the Remote Setup Wizard on page 2-2. The Welcome dialog (Figure 2-1) appears.
Figure 2-1: Remote Setup Wizard - Welcome
2. Select the option to Initialize a PS Series array and click Next. A message notifies you that the remote Setup Wizard is discovering all uninitialized arrays accessible to the computer.
A list of arrays is provided in the Select an Array to Initialize dialog (Figure 2-2).
Figure 2-2: Remote Setup Wizard - Select an Array to Initialize
Host Integration Tools Installation and User Guide Remote Setup Wizard
Note: If no arrays appear, click the Rediscover button. If arrays still do not appear, review the requirements described in Remote Setup Wizard Computer and Group Requirements on page 2-1.
3. Do either of the following:
– Select a PS Series array. (Hover the cursor over an array to see details.)
– Use the search feature described in Using Remote Setup Wizard to Identify a PS Series Array on page 2-4 to find and select a specific array or to sort the list of arrays.
4. Enter the Group member information in the Initialize Array dialog box, (Figure 2-3). This is the information described in Table 2-1. Click a field name link to display help on the field. In addition, select the option to create a new group. Then, click Next.
Figure 2-3: Remote Setup Wizard - Initialize Array
5. Enter the group configuration in the Creating a Group dialog box (Figure 2-4). This is the information described in Table 2-2. Then, click Next.
Note: The RAIDPolicy field contains only those RAID levels that are supported by the PS Series array firmware.
Figure 2-4: Remote Setup Wizard - Creating a Group
Host Integration Tools Installation and User Guide Remote Setup Wizard
6. Click OK. A message appears indicating that the array has been initialized and the Finish dialog box appears (Figure 2-5).
7. Select from the following options:
– View Log to display a summary of the configuration.
– Next to initialize another array and add it to the group.
– Finish to complete the configuration and exit the wizard.
Figure 2-5: Remote Setup Wizard - Finish
When you exit the wizard, it performs these tasks:
• Configures the group IP address as an iSCSI target discovery address. This enables the computer to discover volumes and snapshots (iSCSI targets) in the group.
• Stores the CHAP user name and password that allow Microsoft services (VDS or VSS) access to the group.
• Creates a corresponding VSS/VDS access control record and local CHAP account in the group. In the group, to view the VSS/VDS access control record, click Group Configuration, then click on the VDS/VSS tab.
To display the local CHAP account in the group, click Group Configuration, then click on the iSCSI tab.
After you create a group, you can use the Group Manager GUI or CLI to create and manage volumes. If you are running Windows Server 2003 SP2, by default, the wizard launches Storage Manager for SANs (if it is installed), which also enables you to create and manage volumes.
Initializing an Array and Expanding a Group
Using the Remote Setup Wizard, you can initialize a PS Series array and add the array to an existing group. In addition, the wizard will configure the group IP address as an iSCSI discovery address on the computer.
Note: If the Remote Setup Wizard is interrupted while initializing an array and the operation fails, you must reset the array before running the wizard again. To reset an array, connect the serial cable that was shipped with the array to the active control module and to a console terminal or a computer running a terminal emulator.
Then, enter the reset command.
Host Integration Tools Installation and User Guide Remote Setup Wizard
Before you initialize an array and expand a group, gather the information about the array configuration, as
described in Table 2-1. You will also need the group name, IP address, and membership password, as described in Table 2-2. The Remote Setup Wizard will prompt you for this information. Consult your network administrator for the necessary IP addresses.
Use the following procedure to initialize an array and expand an existing group:
1. Start the Remote Setup Wizard, as described in Launching the Remote Setup Wizard on page 2-2.
2. Select the option to initialize an array in the Welcome dialog box (Figure 2-1) and click Next.
Note: If no arrays appear, click the Rediscover button. If arrays still do not appear, make sure you meet the requirements described in Remote Setup Wizard Computer and Group Requirements on page 2-1.
3. Select the array you want to initialize (Figure 2-2) and click Next.
4. Enter the member information in the Initialize Array dialog box (Figure 2-3). This is the information described in Table 2-1.
Click a field name link to display help on the field. In addition, select the option to add the array to an existing group. Then, click Next.
5. Enter the group name and IP address and the membership password in the Joining a Group dialog box.
6. Click Next. When the initialized array successfully joins the group, the following screen appears (Figure 2-6).
Figure 2-6: Member Successfully Added to Group
7. Click Yes to open the Group Manager GUI immediately so you can configure a RAID policy for the new member, or click No if you will configure RAID later.
8. Select from the following options in the Finish dialog box:
– Click View Log to display a summary of the configuration.
– Click Next to initialize another array and add it to the group.
– Click Finish to complete the configuration and exit the wizard.
When you exit the wizard, it will configure the group IP address as an iSCSI discovery address on the computer, if not already present.
Note: After you add an array to an existing group, you must use the Group Manager GUI or CLI to set the RAID policy for the new group member. For more information, see the Group Administration or CLI Reference manual.
If you are running Windows Server 2003 SP2, the wizard will launch Storage Manager for SANs by default (if it is installed), which also enables you to create and manage volumes.
