HP StorageWorks EVA Cluster Extension Software Installation Guide This guide contains detailed instructions for installing and removing HP StorageWorks EVA Cluster Extension Software in Windows and Linux environments. The intended audience has independent knowledge of related software and of the HP StorageWorks Enterprise Virtual Array and its software.
Legal and notice information © Copyright 2006-2010 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 EVA Cluster Extension .............................................. 7 Ideal environment ....................................................................................................................... 7 Network communication requirements ........................................................................................... 7 Data backup requirements ...........................................................................................................
Installing and configuring the HP SMI-S EVA server on all management servers .......................... Configuring the HP 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 .................................................................... 27 2 Document conventions .............................................................................................
1 Preparing to install EVA 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 Continuous Access EVA.
• Linux: For SLE HA and RHCS data backup requirements, see the SLE HA and RHCS documentation. CAUTION: EVA 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 EVA Cluster Extension. Environmental setup Ensure that the following conditions are met before installing EVA Cluster Extension Software: • • • • • Continuous Access EVA links (including extender hardware) are redundant and bidirectional. Alternate I/O paths between servers and the EVA storage system are set up. Cluster and client networks are redundant.
Windows • 50 MB for the EVA 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 EVA Cluster Extension Software for Windows This chapter describes the installation of EVA Cluster Extension in MSCS environments with HP EVA disk arrays. This version of EVA Cluster Extension allows you to install, uninstall, modify, and repair EVA 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 EVA 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 SMI-S EVA on all management servers Install the HP SMI-S EVA server component on all of the management servers that run the HP Command View EVA software. Review the HP StorageWorks Command View EVA Installation Guide and the HP StorageWorks Command View EVA Release Notes to set the access properties.
Creating DR groups Before you can use EVA 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 EVA Cluster Extension Software with MSCS. To install EVA 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 EVA 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 EVA Cluster Extension installation, and then click Next. The Choose Destination Location dialog box appears. 8. Accept the default location, or click Browse and specify a new destination. 9.
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 EVA Cluster Extension Software for Windows This version of EVA Cluster Extension Software supports upgrading from version 2.01.00 or later. You can also upgrade EVA Cluster Extension concurrently with Command View EVA. Use one of the following procedures: • Upgrading from EVA Cluster Extension 2.01.00 or later (Windows Server 2003), page 20 • Upgrading from EVA Cluster Extension 2.01.
NOTE: For more information on using this tool, see the “CLI commands and utilities” chapter in the HP StorageWorks EVA 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 EVA Cluster Extension installation package, and follow the on-screen instructions. 6.
Resetting the DR group GUI display After the upgrade is complete, the EVA Cluster Extension resource configuration GUI displays a blank value for the DR group Write mode property for existing EVA Cluster Extension resources. EVA 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 EVA Cluster Extension resource configuration GUI displays a blank value for the DR group Write mode property for existing EVA Cluster Extension resources. EVA 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.
EVA Cluster Extension maintenance After installation, you can modify, repair, or remove EVA Cluster Extension. In the Server Core or Hyper-V Server environment, the Control Panel Programs and Features function is not available. To perform maintenance operations in a Server Core or Hyper-V Server environment, run the EVA Cluster Extension installation package from the command prompt.
1. Start the EVA 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 EVA Cluster Extension installation package from the command line. Continue to Step 2. Select HP StorageWorks EVA 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 EVA 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 EVA 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_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. Please start the cluster service. ERROR_PCF_CREATION_FAILED Installation failed on the local cluster node. The PCF file could not be created.
ERROR code Description Corrective action ERROR_PCF_REMOVAL_FAILED Uninstall completed on the local cluster node. Delete the file clxpcf from INSTALL_DIR\bin. Setup was unable to delete the PCF file. CLXUNSETPATH_FAILED ERROR_DELETE_EVENTLOG_DLL_FAILED Uninstall completed on the local cluster node. Could not unset the path variables. Remove the environment variable HPCLX_PATH from the local cluster node. Uninstall completed on the local cluster node. Delete the clxeventlog.
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.
3 Installing EVA Cluster Extension Software for Linux This chapter describes how to install the EVA 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 EVA Cluster Extension Software in a Linux environment, see the HP StorageWorks EVA 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 EVA storage system. For detailed information, see the HP StorageWorks Command View EVA User Guide or the HP StorageWorks 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 StorageWorks Command View EVA User Guide or the HP StorageWorks Storage System Scripting Utility Reference.
• CLI (clxevarun) To install the software: 1. Log in as root. 2. Download the EVA 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. Uncompress and extract the contents of this downloaded file to the hpclxeva_version directory (created during extraction) by entering the following command: # tar xvfz downloaded_file 4.
Removing EVA Cluster Extension Software for Linux To remove the EVA Cluster Extension software from a node, move all of the EVA resources to another node, or delete the EVA 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 StorageWorks Storage System Scripting Utility Reference Guide • HP StorageWorks 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 StorageWorks Continuous Access EVA. 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.
quorum In MSCS: A cluster resource that has been configured to control the cluster, maintaining essential cluster data and recovery information. In the event of a node failure, the quorum acts as a tiebreaker and is transferred to a surviving node to ensure that data remains consistent within the cluster. RHCS Red Hat Cluster Suite RPM Red Hat package manager. SAN Storage area network. A network of storage devices available to one or more servers. SCSI Small Computer Systems Interface.
virtual array General term for an EVA. See also virtual disk. virtual disk Variable disk capacity that is defined and managed by the array controller and presentable to hosts as a disk. VLAN Virtual LAN. VSC Volume size customization. Also known as CVS. 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 EVA storage system configuration, 13 host entries, 13 A AutoPass command-line utility, 38 AutoPass license program, 37 F C clxautopass command-line utility, 38 clxpmu, 20 Command View EVA upgrading with EVA Cluster Extension, 23 contacting HP, 41 conventions document, 42 D data backup requirements, 7 disk space requirements, 9 document conventions, 42 documentation HP website, 42 providing feedback, 43 related, 41 DR groups creating, 14 Linux, 33 E EVA Cluster Extension failover function, 8 insta
L licensing, 37 installing license keys, 38 registration tool (Windows 2008/2008 R2), 38 retrieving license keys, 37 Logical Volume Manager, 34 M maintenance Windows, 24 memory requirements, 9 MSCS installation, 15 integration with EVA Cluster Extension, 11 multipath software RHCS, 32 SLE HA, 32 Windows, 12 N network requirements, 7 P permanent license key, 37 pre-installation RHCS, 31 create hosts, 33 DR groups, 33 EVA storage system, 32 HBA drivers, 32 HP SMI-S EVA, 32 installing cluster software, 34
RHCS installation, 31 integration with EVA 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 SMI-S EVA, 32 IP network, 32 multipath software, 32 SAN configuration, 32 vdisks, 33 pre-installation EVA storage system, prerequisites, 31 S SAN configuration Windows, 12 SLE HA installation, 31 integration with EVA Cluster Extension, 31 pre-installation, 31 cluster software, 34 configuring LVM, 34 create hosts,
