HP P6000 Cluster Extension Software Installation Guide This guide contains detailed instructions for installing and removing HP P6000 Cluster Extension Software in Windows and Linux environments. The intended audience has independent knowledge of related software and of the HP P6000/EVA Array and its software.
Legal and notice information © Copyright 2006-2011 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 P6000 Cluster Extension .......................................... 7 Ideal environment ....................................................................................................................... 7 Network communication requirements ........................................................................................... 7 Data backup requirements ...........................................................................................................
Installing and configuring the HP P6000/EVA SMI-S server on all management servers ............... Configuring the HP P6000/EVA storage system ..................................................................... Creating hosts ................................................................................................................... Creating vdisks and adding a LUN presentation ..................................................................... Creating DR groups .................................
Figures 1 Zoning example ........................................................................................................
Tables 1 Windows remote installation error codes .................................................................... 26 2 Document conventions .............................................................................................
1 Preparing to install P6000 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 HP P6000 Continuous Access.
• Windows: Using an MNS quorum requires an odd number of cluster nodes, with at least one system in a third location. • Linux: For SLE HA and RHCS data backup requirements, see the SLE HA and RHCS documentation. CAUTION: P6000 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.
General installation prerequisites This section describes general installation prerequisites for P6000 Cluster Extension. Environmental setup Ensure that the following conditions are met before installing P6000 Cluster Extension Software: • • • • • P6000 Continuous Access links (including extender hardware) are redundant and bidirectional. Alternate I/O paths between servers and the P6000/EVA storage system are set up. Cluster and client networks are redundant.
Disk space and system memory requirements Linux • 10 MB for /opt/hpclxeva • 10 MB for /etc/opt/hpclxeva • 100 MB for /var/opt/hpclxeva • 5 MB for /opt/OV Windows • 50 MB for the P6000 Cluster Extension installation directory (%ProgramFiles%\HewlettPackard\Cluster Extension EVA) • At least 25 MB of system memory Required firmware and software For specific firmware and software versions, see the HP SPOCK website: http://www.hp.com/storage/ spock.
2 Installing P6000 Cluster Extension Software for Windows This chapter describes the installation of P6000 Cluster Extension in MSCS environments with HP P6000/EVA disk arrays. This version of P6000 Cluster Extension allows you to install, uninstall, modify, and repair P6000 Cluster Extension on all of the nodes in a cluster by running the installer from one node in the cluster. This feature is not available for performing P6000 Cluster Extension upgrade procedures.
7. 8. 9. 10. Creating vdisks and adding a LUN presentation, page 13 Creating DR groups, page 14 Setting read-only mode and adding a LUN presentation to the destination vdisk, page 14 Installing MSCS on all nodes, page 15 Checking the IP network setup and SAN configuration Verify that your IP network setup and SAN configuration meet the following requirements: • For Windows Server 2003 only, MSCS requires that a single IP subnet be dispersed over all sites in a disaster-tolerant cluster setup.
Installing and configuring HP P6000/EVA SMI-S on all management servers Install the HP P6000/EVA SMI-S server component on all of the management servers that run the HP P6000 Command View software. Review the HP P6000 Command View Installation Guide and the HP P6000 Command View Release Notes to set the access properties.
Creating DR groups Before you can use P6000 Cluster Extension, you must create a DR group that includes your previously created vdisk(s). When you create the DR group with a local vdisk (or vdisks), a replica of the vdisk(s) on the remote destination storage system is created automatically. The disk pair is called a DR group member or copy set. When you create a DR group, note the following: • Set Write mode to Synchronous or Asynchronous.
Installing MSCS on all nodes This section describes the steps for installing MSCS on the cluster nodes. 1. Before installing MSCS, create your disk configuration through the Disk Manager. If the disks are not visible, re-scan your disks in the Disk Manager. NOTE: You may need to shut down all but one server on the source storage system to successfully configure your disks in the Disk Manager.
You can use the CLI for custom cluster software integration. For example, you can write your own online and offline scripts using advanced DR group status checking options. NOTE: Installing the CLI is not required if you are using P6000 Cluster Extension Software with MSCS. To install P6000 Cluster Extension: 1. Make sure that the cluster service is running. 2. Make sure that the cluster management application is not running on the cluster nodes where you plan to install P6000 Cluster Extension.
6. In the Setup Type dialog box, select one of the following options, and then click Next: • Select Typical to install the resource DLL, cluster administrator extension DLL, and documentation. • Select Compact to install only the resource DLL and cluster administrator extension DLL. • Select Custom to select specific components to install. The Cluster node selection dialog box appears. 7. Select the cluster nodes for P6000 Cluster Extension installation, and then click Next.
10. Depending on your selection in the previous step, and your version of Windows, do one of the following: • For Windows Server 2008/2008 R2, if you specified the same location for all cluster nodes, go to Step 12. • If you specified that you will enter a different destination for each cluster node, the Remote Installation Location dialog box appears when you click Next in the previous step. Continue to Step 11. 11.
Upgrading P6000 Cluster Extension Software for Windows This version of P6000 Cluster Extension Software supports upgrading from version 2.01.00 or later. You can also upgrade P6000 Cluster Extension concurrently with P6000 Command View. Use one of the following procedures: • Upgrading from P6000 Cluster Extension 2.01.00 or later (Windows Server 2003), page 19 • Upgrading from P6000 Cluster Extension 2.01.
NOTE: For more information on using this tool, see the “CLI commands and utilities” chapter in the HP P6000 Cluster Extension Administrator Guide. b. Select (1) View existing entries. The Existing entries dialog appears. c. Save the information in the Existing entries window, and then close the clxpmu window. 4. Move all of the applications from the current node to another node. 5. Double-click the P6000 Cluster Extension installation package, and follow the on-screen instructions. 6.
Resetting the DR group GUI display After the upgrade is complete, the P6000 Cluster Extension resource configuration GUI displays a blank value for the DR group Write mode property for existing P6000 Cluster Extension resources. P6000 Cluster Extension will work as expected even though the Write mode is not displayed in the GUI. If you want to view the correct Write mode value in the GUI, perform the following procedure: 1.
Resetting the DR group GUI display After the upgrade is complete, the P6000 Cluster Extension resource configuration GUI displays a blank value for the DR group Write mode property for existing P6000 Cluster Extension resources. P6000 Cluster Extension will work as expected even though the Write mode is not displayed in the GUI. If you want to view the correct Write mode value in the GUI, perform the following procedure: 1.
7. Verify that the upgrade was successful by confirming that all of the configured cluster applications come online when moved to each of the possible owners (cluster nodes) of the application. P6000 Cluster Extension maintenance After installation, you can modify, repair, or remove P6000 Cluster Extension. In the Server Core or Hyper-V Server environment, the Control Panel Programs and Features function is not available.
1. Start the P6000 Cluster Extension InstallShield wizard: a. b. Depending on your version of Windows, do one of the following: • 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. • For Server Core or Hyper-V Server: Run the P6000 Cluster Extension installation package from the command line. Continue to Step 2. Select HP P6000 Cluster Extension.
6. Do one of the following: • Click Yes if you want to save the clxevacfg file. Enter a file name, and then click Save. 7. • 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 P6000 Cluster Extension from the last node in the cluster.
NOTE: If cluster installation fails with the message Could not get the system drive for the cluster node... or Setup was unable to run the installation in remote machine..., confirm that the WMI service is running. To use the P6000 Cluster Extension cluster-wide installation feature, the WMI service must be running. Table 1 Windows remote installation error codes ERROR code Description Corrective action ERROR_INSTALLATION_SUCCESS Installation was successful on the local cluster node.
ERROR code Description Corrective action ERROR_INSTALLDIR_NOT_FOUND Setup failed on the local cluster node. Run the setup on the local cluster node. Setup was not able to get the INSTALLDIR value. ERROR_CLUS_SERVICE_UNKNOWN Setup failed on the local cluster node. Run the setup on the local cluster node. Setup is not able to determine whether the cluster service is running. ERROR_CLUS_SERVICE_NOT_RUNNING Setup failed on the local cluster node. The cluster service is not running.
ERROR code Description Corrective action ERROR_CLXMSCSEX_UNREGISTER_FAILED Uninstall failed on the local cluster node. Setup was unable to unregister the P6000 Cluster Extension extension DLL. Unregister the resource extension DLL by running the following cluster command: Cluster / unregadminext:clxevamscsex.dll Uninstall completed on the local cluster node. Delete the file clxpcf from INSTALL_DIR\bin. ERROR_PCF_REMOVAL_FAILED Setup was unable to delete the PCF file.
1. Confirm that the resource type is registered with MSCS by entering the following cluster command: cluster resourcetype If the resource type is registered, the output includes the following information: Display Name Cluster Extension EVA Resource Type Name Cluster Extension EVA If the resource type is not registered: 2. a. Enter cluster resourcetype "Cluster Extension EVA" /CREATE / DLLNAME:clxevamscs.dll /TYPE:"Cluster Extension EVA". b.
Installing P6000 Cluster Extension Software for Windows
3 Installing P6000 Cluster Extension Software for Linux This chapter describes how to install the P6000 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 P6000 Cluster Extension Software in a Linux environment, see the HP P6000 Cluster Extension Software Administrator Guide.
Checking the IP network setup and SAN configuration RHCS and SLE HA require that a single IP subnet be dispersed over all sites in a disaster-tolerant cluster setup. This enables all nodes in a cluster to exchange heartbeat (alive) messages. Several VLAN technologies that can extend single subnets over long-distance connections are available. For information about latency and distance support, see your Linux cluster software documentation.
Creating hosts 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 P6000/EVA storage system. For detailed information, see the HP P6000 Command View User Guide or the HP Storage System Scripting Utility Reference.
NOTE: HP recommends using the same LUN for all servers in the cluster. This step assumes that you have created your remote host entry on the destination storage system as described in “Creating hosts” on page 13. For detailed instructions, see the HP P6000 Command View User Guide or the HP Storage System Scripting Utility Reference.
• SLE HA and RHCS integration executable (clxevalxcs). • CLI (clxevarun) To install the software: 1. Log in as root. 2. Download the P6000 Cluster Extension Software installer. 3. a. Browse to http://www.hp.com/go/softwaredepot. b. Click Storage and NAS in the product category list. c. Follow the on-screen instructions to download the installer.
Removing P6000 Cluster Extension Software for Linux To remove the P6000 Cluster Extension software from a node, move all of the P6000 resources to another node, or delete the P6000 resources and then enter the following command: # /opt/hpclxeva/bin/CLX_UNINSTALL This command removes all files and resets all environment variables installed by the installation script.
4 Licensing This chapter explains how to obtain and install the product license keys. A license key is required to use all of the product features. The License Entitlement Certificate provides instructions on how to obtain a license key. In the meantime, a temporary, instant-on license key is available so that you can immediately start using all of the features. The instant-on key is valid for 60 days from the first use.
Using the clxautopass command-line utility In addition to using the clxautopass command to start AutoPass, you can also use the command at the CLI to install the instant-on license and import a password from the license key file. Installing the license If the installation process failed to install the license, you can use the command line to install it.
3. Select any installed instant-on license key, and then click Remove.
Licensing
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
• HP Storage System Scripting Utility Reference Guide • HP Enterprise Virtual Array Compatibility Reference You can find the HP documents on the Manuals page of the HP Business Support Center website: http://www.hp.com/support/manuals In the Storage section, click Storage software, and then select a product. White papers The following white papers are available at www.hp.
Convention Element Italic text Text emphasis • File and directory names Monospace text • System output • Code • Commands, their arguments, and argument values Monospace, italic text Monospace, bold text • Code variables • Command variables Emphasized monospace text CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information.
Support and other resources
Glossary array A synonym of storage array, storage system, and virtual array. A group of disks in one or more disk enclosures combined with controller software that presents disk storage capacity as one or more virtual disks. CA HP P6000 Continuous Access. CA lets you create and maintain duplicate copies of local logical volumes on a remote storage system. CLI Command-line interface. An interface comprised of various commands which are used to control operating system responses.
failover An operation that reverses replication direction so that the destination becomes the source and the source becomes the destination. Failovers can be planned or unplanned and can occur between DR groups, managed sets, fabrics or paths, and array controllers. FC Fibre Channel. A network technology primarily used for storage networks. GUI Graphical User Interface. HBA Host bus adapter.
SAN Storage area network. A network of storage devices available to one or more servers. SCSI Small Computer Systems Interface. A standard, intelligent parallel interface for attaching peripheral devices to computers, based on a device-independent protocol. secondary site The data center location with the mirror copy of the quorum disk pair. SLE HA SUSE Linux Enterprise High Availability Extension SMI-S Storage Management Initiative Specification.
WDM Wavelength division multiplexing. The technique of placing multiple optical signals on a single optical cable simultaneously. WWN World Wide Name. A unique identifier assigned to a Fibre Channel device.
Index A AutoPass command-line utility, 38 AutoPass license program, 37 C clxautopass command-line utility, 38 clxpmu, 19 contacting HP, 41 conventions document, 42 D data backup requirements, 7 disk space requirements, 10 document conventions, 42 documentation HP website, 42 providing feedback on, 43 related, 41 DR groups creating, 14 Linux, 33 F failover, 8 firmware supported versions, 10 H HBA drivers SLE HA, 32 HBA drivers RHCS, 32 help obtaining, 41 HP technical support, 41 HP P6000/EVA SMI-S RHCS,
N network requirements, 7 P P6000 storage system configuration, 13 host entries, 13 P6000 Cluster Extension failover function, 8 internal database, 8 pre-installation requirements, 9 supported features, 10 supported versions, 10 upgrading Windows, 19 vdisks, 8 P6000 Cluster Extension installation RHCS, 34 SLE HA, 34 removing RHCS, 36 SLE HA, 36 P6000 Command View upgrading with P6000 Cluster Extension, 22 permanent license key, 37 pre-installation RHCS, 31 create hosts, 33 DR groups, 33 HBA drivers, 32 HP
RHCS installation, 31 integration with P6000 Cluster Extension, 31 pre-installation, 31 cluster software, 34 configuring LVM, 34 create hosts, 33 creating vdisks, 33 DR groups, 33 HBA drivers, 32 HP P6000/EVA SMI-S, 32 IP network, 32 multipath software, 32 SAN configuration, 32 vdisks, 33 pre-installation P6000/EVA storage system, 32 prerequisites, 31 S SAN configuration Windows, 12 SLE HA integration with P6000 Cluster Extension, 31 pre-installation, 31 cluster software, 34 configuring LVM, 34 create host
