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.
© Copyright 2012 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Preparing to install HP 3PAR Cluster Extension................................................5 Ideal environment.....................................................................................................................5 Network communication requirements.........................................................................................5 Storage replication link requirements...........................................................................................
Using AutoPass to retrieve permanent license keys.......................................................................27 Using the clxautopass command-line utility.................................................................................27 Installing the license...........................................................................................................27 Importing a license key from a file........................................................................................
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.
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.
Disk space and system memory requirements Windows • 50 MB for the HP 3PAR Cluster Extension installation directory (%ProgramFiles%\HewlettPackard\Cluster Extension 3PAR) • At least 25 MB of system memory Linux • 5 MB for /opt/hpclx3par • 1 MB for /etc/opt/hpclx3par • 100 MB for /var/opt/hpclx3par Required firmware and software For specific firmware and software versions, see the HP SPOCK website: http://www.hp.com/ storage/spock.
2 Installing HP 3PAR Cluster Extension Software for Windows 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.
• In an MNS 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 to one of the storage systems.
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.
You must reboot the server(s) on the destination storage system or re-scan the disks in the Disk Manager before and after installing the cluster software, and when you add storage in read-only mode on the destination side. 2. 3. Install MSCS on all cluster nodes. Select Majority Node Set quorum with file share witness as the cluster's quorum resource. Quorum disks as a quorum resource are not supported with HP 3PAR Cluster Extension Software. 4.
The Cluster node selection dialog box appears. 6. Select the cluster nodes for 3PAR Cluster Extension installation, and then click Next. The Choose Destination Location dialog box appears. 7. 12 Accept the default location, or click Browse and specify a new destination.
8. Specify whether the installation directory will apply to all nodes selected for installation: • If you want to use the same destination location for all nodes selected in the previous step, select the Use the same destination location for all the selected remote cluster nodes check box, and then click Next.
6. Click Finish to close the InstallShield wizard. Repairing the 3PAR Cluster Extension installation Once 3PAR Cluster Extension is installed, you can repair the installation. 1. Start the 3PAR Cluster Extension InstallShield wizard: a. Depending on your version of Windows, do one of the following: b. • For Windows Server 2003: Select Start→Control Panel→Add or Remove Programs. • For Windows Server 2008/2008 R2: Select Start→Control Panel→Programs and Features.
6. 7. Do one of the following: • Click Yes if you want to save the Cluster Extension configuration file. Enter a file name, and then click Save. • Click No. Click OK. The install wizard asks if you want to unregister the cluster resource type from all nodes in the cluster. HP recommends that you do not unregister the cluster resource type until you are uninstalling 3PARCluster Extension from the last node in the cluster.
Table 1 Windows remote installation error codes ERROR code Description Corrective action ERROR_INSTALLATION_SUCCESS Installation was successful on the local N/A cluster node. ERROR_REMOVAL_SUCCESS HP 3PAR Cluster Extension was successfully removed from the local cluster node. N/A ERROR_REPAIR_SUCCESS HP 3PAR Cluster Extension was successfully repaired on the local cluster node. N/A ERROR_MODIFY_SUCCESS HP 3PAR Cluster Extension was successfully modified on the local cluster node.
Table 1 Windows remote installation error codes (continued) ERROR code Description Corrective action Extension will not function correctly until the AutoPass package is properly installed. ERROR_CLXAUTOPASS_INSTANTON_FAILED Installation completed on the local cluster node. Setup was unable to run clxautopass.exe –installinstanton on the local cluster node. Install the instant-on license on the local node by running the following command: clxautopass.
Table 1 Windows remote installation error codes (continued) ERROR code Description Corrective action HKEY_LOCAL_MACHINE\SOFTWARE\ HKEY_LOCAL_MACHINE\SOFTWARE\ Microsoft\Windows\ Microsoft\Windows\ CurrentVersion\SharedDlls CurrentVersion\SharedDlls ERROR_UNINSTALL_DRS_FILES_FAILED Uninstall completed on the local cluster Delete clx3parmscs.dll and node. clx3parmscsex.dll from the Could not delete clx3parmscs.dll following registry entry: and clx3parmscsex.
Upgrading from HP 3PAR Cluster Extension 1.00.00 (Windows Server 2003/2008/2008 R2) IMPORTANT: Before starting the upgrade procedure, save the HP 3PAR Cluster Extension configuration file, if it exists. You can save the file by using the Export feature in the HP 3PAR Cluster Extension configuration tool. For instructions on saving the file, see the HP 3PAR Cluster Extension Administrator Guide.
3 Installing HP 3PAR Cluster Extension Software for Linux This chapter describes how to install the HP 3PAR Cluster Extension Software in a Linux environment. The software provides integration with SUSE Linux Enterprise High Availability Extension, Red Hat Cluster Suite, and a standalone application that can be used for other solutions. NOTE: For information on configuring HP 3PAR Cluster Extension Software in a Linux environment, see the HP 3PAR Cluster Extension Software Administrator Guide.
Pre-installation procedures Pre-installation procedures 21
NOTE: In RHEL, before starting CLX installation, HP 3PAR Inform CLI should be installed. The default installation path of the HP 3PAR Inform CLI version 3.1.1 is mentioned as a value for the variable INFORM_CLI_PATH in the file /usr/share/cluster/clx3par.sh for CLX to work in a desired fashion (clx3par.sh gets installed during the CLX installation). The default path of the HP 3PAR Inform CLI version 3.1.1 mentioned for the variable INFORM_CLI_PATH is “/opt/3PAR/inform_cli_3.1.1/bin”.
And so on for other services … Before installing HP 3PAR Cluster Extension, perform the following configuration procedures: • “Checking the IP network setup and SAN configuration” (page 23) • “Configuring native multipath software” (page 23) • “Configuring the HP 3PAR storage system” (page 23) • “Creating hosts and setting host persona” (page 23) • “Creating virtual volumes and adding a LUN presentation” (page 24) • “Creating Remote Copy volume groups” (page 24) • “LUN pre
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 or iSCSI 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.
Complete the following procedure to make each disk accessible to the nodes in the remote data center: • On the source side (local data center), create the volume groups, logical volumes, and file systems that will be used with the Linux clusters. • Use HP 3PAR Inform CLI to switch the replication mode of the destination side volume groups to source. This allows nodes in the remote data center to access the shared disks with read/write access.
9. After installation, read the release notes in the /opt/hpclx3par/docs directory. NOTE: After you install a permanent license key on a cluster node, make sure the instant-on license is removed. For instructions, see “Removing an instant-on license key” (page 28).
4 Licensing Retrieving a license key When you purchase this product, you receive a License Entitlement Certificate. You will need information from this certificate to retrieve and enter your license keys. You can use any of the following methods to request a license key: • Obtain a license key from http://webware.hp.com. • Use AutoPass to retrieve permanent license keys. See “Using AutoPass to retrieve permanent license keys” (page 27).
Using the HP 3PAR Cluster Extension registration tool NOTE: This procedure is applicable only for Windows. To install a license key: 1. Select Start→All Programs→Hewlett-Packard→HP 3PAR CLX Registration Tool. 2. Click Browse. 3. Browse to your license key file, and then click Install License. 4. Click Close when you are done installing license keys. Removing an instant-on license key 1. Start AutoPass, located in the product's bin directory: clxautopass -ovlicensemgr 2. 3.
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
Typographic conventions Table 2 Document conventions Convention Element Blue text: Table 2 (page 30) Cross-reference links and e-mail addresses Blue, underlined text: http://www.hp.
Glossary CLI Command-line interface. An interface comprised of various commands which are used to control operating system responses. DLL Dynamic-link library. failover A role-reversal process where the backup Remote Copy volume group is converted to the primary Remote Copy volume group. FC Fibre Channel. A network technology primarily used for storage networks. GUI Graphical User Interface.
Index A L adding LUN presentations, 10 AutoPass command-line utility, 27 AutoPass license program, 27 licensing installing license keys, 27 registration tool (Windows 2008/2008 R2), 28 retrieving license keys, 27 C Cluster Extension installation RHCS, 25 SLE HA, 25 clxautopass command-line utility, 27 Configuring HP 3PAR storage system, 9 contacting HP, 29 conventions document, 30 text symbols, 30 creating virtual volumes, 10 volume groups, 10 creating hosts, 9 D document conventions, 30 related inform
