HP 3PAR Cluster Extension Installation Guide

HP 3PAR Cluster Extension Software Installation Guide

Abstract

This guide contains detailed instructions for installing and removing HP 3PAR Cluster Extension Software. The intended audience has independent knowledge of related software and of the HP 3PAR Storage System and its software.

HP Part Number: 5697-2264 Published: November 2012 Edition: 3

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Acknowledgments

Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks or registered trademarks of Intel Corporation or its subsidiaries

in the United States and other countries.

Microsoft®, Windows®, Windows® XP, and Windows NT® are U.S. registered trademarks of Microsoft Corporation.

Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.

1 Preparing to install HP 3PAR Cluster Extension................................................5

Ideal environment.....................................................................................................................5

Network communication requirements.........................................................................................5

Storage replication link requirements...........................................................................................5

Server cluster infrastructure requirements......................................................................................5

How HP 3PAR Cluster Extension Software interacts with its environment...........................................5

Failover function..................................................................................................................6

How HP 3PAR Cluster Extension utilizes virtual volumes.............................................................6

How HP 3PAR Cluster Extension stores information...................................................................6

General installation prerequisites................................................................................................6

Disk space and system memory requirements...........................................................................6

Required firmware and software.................................................................................................7

2 Installing HP 3PAR Cluster Extension Software ...............................................8

Prerequisites.............................................................................................................................8

Pre-installation procedures.........................................................................................................8

Checking the IP network setup and SAN configuration..............................................................8

Installing the multipath software.............................................................................................9

Installing and configuring the JRE...........................................................................................9

Installing HP 3PAR Command Line Interface (CLI).....................................................................9

Configuring the HP 3PAR storage system.................................................................................9

Creating hosts and setting host persona..................................................................................9

Creating virtual volumes and adding a LUN presentation........................................................10

Creating Remote Copy volume groups..................................................................................10

LUN presentation to the secondary virtual volume(s)...............................................................10

Installing Microsoft Failover Cluster (MSFC) on all nodes.........................................................10

Installing HP 3PAR Cluster Extension Software ...........................................................................11

HP 3PAR Cluster Extension maintenance....................................................................................13

Modifying the 3PAR Cluster Extension installation...................................................................13

Repairing the 3PAR Cluster Extension installation....................................................................14

Removing 3PAR Cluster Extension ........................................................................................14

Troubleshooting installation and maintenance problems...............................................................15

Registering the resource type and resource extension DLL manually...............................................19

Unregistering the resource type and resource extension DLL manually............................................20

Registering the CLX PowerShell Cmdlet DLL manually [Windows Server 2012 only]..........................20

Unregistering the CLX PowerShell Cmdlet DLL manually [Windows Server 2012 only].......................21

Upgrading from HP 3PAR Cluster Extension 1.00.00 and 2.00.00 (Windows Server 2008/2008

R2).......................................................................................................................................21

3 Licensing.................................................................................................22

Retrieving a license key...........................................................................................................22

Using AutoPass to retrieve permanent license keys.......................................................................22

Two types of licensing model supported by CLX..........................................................................22

Using the clxautopass command-line utility.................................................................................23

Installing instanton license keys............................................................................................23

Applying host based permanent license ....................................................................................23

Importing a license key from a file........................................................................................23

Using the HP 3PAR Cluster Extension registration tool ............................................................23

Applying Device based permanent license.................................................................................23

Applying Device based permanent license keys in clustered environment...................................23

Applying Device based permanent license keys in non-clustered environment.............................24

Removing license key..............................................................................................................24

Contents 3

4 Support and other resources......................................................................26

Contacting HP........................................................................................................................26

New and changed information in this edition.............................................................................26

Related information.................................................................................................................26

Whitepapers.....................................................................................................................26

HP websites......................................................................................................................26

Typographic conventions.........................................................................................................27

Glossary....................................................................................................28

Index.........................................................................................................29

4 Contents

1 Preparing to install HP 3PAR Cluster Extension

This chapter provides information about general environment considerations and pre-installation requirements.

Ideal environment

The ideal configuration environment consists of at least five servers (two at each data center site and one as an arbitrator at a third site) with separate, redundant communications links for cluster heartbeats, client access, and a pair of HP 3PAR storage system with Remote Copy configuration. All communications interfaces must be installed in pairs to serve as failover components, in order to prevent single points of failure.

Network communication requirements

When using HP 3PAR Cluster Extension, note the following:

• Network communications links and components between the dispersed data centers must be

redundant and physically routed differently to prevent the “backhoe” issue that is created when all links between data centers are cut together. This redundancy and routing is especially important to prevent the split-brain syndrome that occurs when systems in both data centers form new clusters and allow access to both copies of the data. Using redundant and separately routed communication links and components, you can configure the failover behavior so that the application service startup procedure stops if none of the remote cluster members can be reached.

• Multi-pathing software must be used for host-to-storage connections.

Storage replication link requirements

To ensure reliable data backup between the local (primary) and remote (secondary) storage systems, at least two HP 3PAR Remote Copy links must be available when the storage systems are connected to provide redundancy and protection against single points of failure. Although communications links can cover considerable distances, each network segment must be extended to the dispersed data center to maintain a heartbeat among all servers. For extended distances, you must purchase extender components to bundle the HP 3PAR Remote Copy links.

Server cluster infrastructure requirements

Use two cluster nodes at each site to give local application service failover procedures among local cluster systems priority over remote, more time-consuming failover procedures. When failing over, the software must reconfigure the storage systems to change the mirroring direction. At the remote site, two systems should be available in case the primary failover system experiences a hardware or power failure.

For windows, using a Node Majority quorum requires an odd number of cluster nodes, with at least one system in a third location. Where as, using a Node Majority with file share witness requires even number of cluster nodes at each site with file share witness server at the third location.

CAUTION: HP 3PAR Cluster Extension works with one server at each location, with a single I/O

path between the server and storage system, and a single link between storage systems. However, any configuration with a single point of failure is not considered highly available or disaster tolerant. HP does not support configurations with single points of failure; configurations with one system at each location are supported only if there are no single points of failure.

How HP 3PAR Cluster Extension Software interacts with its environment

This section describes the ways in which HP 3PAR Cluster Extension interacts with its environment.

Ideal environment 5

Failover function

HP 3PAR Cluster Extension Software requires cluster software to automatically fail over among systems on a local site or between sites. Because the software manipulates the application startup process before storage system virtual volumes are accessed, it must be integrated as the first resource (in the order of resources). The software must be installed on all servers in the cluster that can run the application service.

How HP 3PAR Cluster Extension utilizes virtual volumes

To write to HP 3PAR Remote Copy paired virtual volumes, you must ensure that the paired virtual volumes are in read/write mode. Volume group members (paired virtual volumes) are in read/write mode on the source (primary) virtual volume only. The destination (secondary) virtual volume is in read-only mode.

• In case of a failover, HP 3PAR Cluster Extension Software automatically changes the direction

of the mirrored pair. A reboot of the server is not necessary.

• In case of a disaster, the storage system can have several different states for volume group

members. HP 3PAR Cluster Extension Software determines whether those virtual volumes can be accessed and made available to the application service.

How HP 3PAR Cluster Extension stores information

HP 3PAR Cluster Extension stores information about the application environment in an internal object database and uses HP 3PAR InForm CLI to gather information about the state of the associated volume group members. Information about the configured storage system environment and failover behavior is transferred either directly by the cluster software or by gathering it from the user configuration file. An internal object database provides the software with the format and default value of supported parameters.

Virtual volume states are stored in the internal object database, which uses a rule engine to process those states. The rule engine matches current volume group member states and configuration parameters with a defined rule, stores it in the database, and invokes predefined actions. Those actions prepare the volume group member virtual volumes to be enabled for access or stop the application service startup process if the matching rule requires a stop.

General installation prerequisites

This section describes general installation prerequisites for HP 3PAR Cluster Extension. Ensure that the following conditions are met before installing HP 3PAR Cluster Extension Software:

• HP Remote Copy links (including extender hardware) are redundant and bidirectional.

• Alternate I/O paths (network and storage links) between servers and the HP 3PAR storage

system are set up.

• Cluster and client networks are redundant.

• Cluster nodes can communicate with each other.

• The latest supported software and firmware versions, fixes, FC adapter firmware, and driver

versions for your servers and HP 3PAR storage systems are installed.

• The cluster nodes in your zoning configuration each recognize their respective (local) HP 3PAR

storage system, but not the remote HP 3PAR storage system.

Disk space and system memory requirements

• 50 MB for the HP 3PAR Cluster Extension installation directory (%ProgramFiles%\Hewlett-

Packard\Cluster Extension 3PAR)

• At least 25 MB of system memory

6 Preparing to install HP 3PAR Cluster Extension

Required firmware and software

For specific firmware and software versions, see the HP SPOCK website: http://www.hp.com/

storage/spock.

Required firmware and software 7

2 Installing HP 3PAR Cluster Extension Software

This chapter describes the installation of HP 3PAR Cluster Extension Software in Microsoft clustering environments with HP 3PAR storage systems.

NOTE:

• You can install, uninstall, modify, and repair HP 3PAR Cluster Extension on all of the nodes

in a cluster by running the installer from one node in the cluster.

• For information on configuring HP 3PAR Cluster Extension in a Microsoft clustering environment,

see the HP 3PAR Cluster Extension Software Administrator Guide.

Prerequisites

Before installing HP 3PAR Cluster Extension, perform the following tasks:

1. Check “General installation prerequisites” (page 6) to ensure that your setup meets the

general pre-installation requirements.

2. Perform the required Windows pre-installation procedures. For instructions, see “Pre-installation

procedures” (page 8).

3. Download the HP 3PAR Cluster Extension Software installer.

a. Browse to https://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?

productNumber=CLX.

b. Click HP Storage > Storage Software in the product category list. c. Follow the on-screen instructions to download the installer.

Pre-installation procedures

This section describes the procedures you must perform to prepare the data centers for HP 3PAR Cluster Extension installation and configuration. Perform these procedures before you install HP 3PAR Cluster Extension.

1. “Checking the IP network setup and SAN configuration” (page 8)

2. “Installing the multipath software” (page 9)

3. “Installing and configuring the JRE” (page 9)

4. “Installing HP 3PAR Command Line Interface (CLI)” (page 9)

5. “Configuring the HP 3PAR storage system” (page 9)

6. “Creating hosts and setting host persona” (page 9)

7. “Creating virtual volumes and adding a LUN presentation” (page 10)

8. “Creating Remote Copy volume groups” (page 10)

9. “Installing Microsoft Failover Cluster (MSFC) on all nodes” (page 10)

Checking the IP network setup and SAN configuration

Verify that your IP network setup and SAN configuration meet the following requirements:

• HP 3PAR Cluster Extension requires a cluster environment in which one location failure will

not cause the entire cluster to shut down.

• In a Node Majority quorum cluster, all nodes must be distributed so that an equal number of

nodes are located in the local and remote data centers and an additional node in a third location functions as a tiebreaker or arbitrator.

The third location can be a separate room in a separate fire protection zone with separate power connections. The arbitrator node can act as a regular cluster node and can be connected

8 Installing HP 3PAR Cluster Extension Software

to one of the storage systems. However, a connection to either storage system is not necessary for the node to act as a tiebreaker.

• SAN fabrics can be extended to allow array-based data replication. See the HP StorageWorks

SAN Design Reference Guide and the HP 3PAR Remote Copy Users Guide for supported SAN

extension configuration and instructions on setting up your HP 3PAR Remote Copy environment.

Installing the multipath software

You must use supported multipath software to take advantage of the I/O path failover feature. Install the multipath software on the cluster system before connecting the system to the second I/O path. For more information on installing the multipath software, see 3PAR Windows Implementation Guide located at: www.hp.com/go/saw.

Installing and configuring the JRE

To install the product license using the HP AutoPass GUI, you must first install the JRE. See the CLX SPOCK website for the supported JRE versions.

NOTE: This step is required only if you want to use the AutoPass GUI to manage license keys. If

you do not install the JRE, you can use the HP 3PAR Cluster Extension registration tool to install license keys. For more information about using the registration tool, see “Using the HP 3PAR Cluster

Extension registration tool ” (page 23).

Installing HP 3PAR Command Line Interface (CLI)

HP 3PAR Cluster Extension communicates with the HP 3PAR storage system using the HP 3PAR Command Line Interface (CLI). Ensure that you install and test the supported version of HP 3PAR Command Line Interface (CLI) on all cluster nodes where Cluster Extension software will be installed.

For more information, see 3PAR CLI Administrator’s Manual located at www.hp.com/go/saw.

NOTE: While installing or upgrading HP 3PAR Command Line Interface (CLI) on Windows, the

environment variable Path will be updated with the CLI install directory. Occasionally, this change does not take effect and you may have to re-login to Windows. HP recommends that you test the CLI commands after you install or upgrade HP 3PAR CLI and try to re-login, if the commands fail due to the binary not found error.

Configuring the HP 3PAR storage system

For detailed information on configuring the HP 3PAR storage system, see the 3PAR Management Console User Guide or the 3PAR CLI Administrator’s Manual. You can also consult your HP service representative for further assistance, including help with creating a geographically dispersed cluster environment.

Creating hosts and setting host persona

Before you can assign disk storage to a cluster node, you must create a host entry for the locally connected server/node on each HP 3PAR storage system. Each HP 3PAR storage system port connecting to a host HBA port through a fabric or direct connection must be set to the correct host persona. Host personas are a set of behaviors that permit hosts connected to FC ports on the HP 3PAR storage systems to deviate from the default host behavior. Host personas are tied to the host name and identified by the host persona number. Use the HP 3PAR CLI commands or the HP 3PAR Management Console to display, create, modify, and remove host personas. For more information, see the HP 3PAR CLI Administrator’s Manual or the HP 3PAR Management Console Online Help.

HP recommends that you run HP 3PAR Host Explorer software on hosts connected to HP 3PAR storage systems. When a host is created on a HP 3PAR storage system, unassigned WWNs are presented to the storage system. If the Host Explorer agents are not running on the attached hosts, the storage system cannot determine the WWNs assigned to the hosts, and you must manually

Pre-installation procedures 9

+ 20 hidden pages