HP StorageWorks Replication Solutions Manager installation guide Part number: T3680-96016 Third edition: July 2006
Legal and notice information Copyright 2005-2006 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. 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. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. Linux is a U.S. registered trademark of Linus Torvalds. UNIX is a registered trademark of The Open Group. Oracle is a registered US trademark of Oracle Corporation, Redwood City, California. Itanium is a registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.
Contents About this guide.......................... 7 Intended audience...................................... 7 Related documentation.................................... 7 Document conventions and symbols.............................. 8 HP technical support..................................... 9 Subscription service..................................... 9 HP web sites........................................ 9 Documentation feedback................................... 9 Product feedback...................................... 9 1 Preparation........................... 11 Kit or download contents.................................. 11 HP Replication Solutions Manager server software..................... 11 HP Replication Solutions Manager host agent software................... 11 HP JREserver..................................... 11 HP Replication Solutions Manager integrator........................ 11 Downloading the software................................. 12 Simulation mode...................................... 12 Prerequisites....................................... 12 Management server types.................................. 13 Installation requirements.................................. 13 Installation tips...................................... 13 Setting credentials..................................... 14 Management server.................................. 14 Host server...................................... 15 Oracle account.................................... 16 2 Server software......................... 17 Installing the server software................................. 17 Upgrade and reinstallation tips............................... 18 Upgrading a Storage Area Manager management server.................... 18 Verifying the installation.................................. 19 Removing the server software................................ 19 3Hostagentsoftware....................... 21 Operating system requirements............................... 21 HP OpenVMS on Alpha servers............................. 21 HP OpenVMS on Integrity servers............................ 21 HP Tru64 UNIX.................................... 21 Linux......................................... 21 Sun Solaris...................................... 22 Conflict between cfgadm utility and SNIA libraries................... 22 Windows....................................... 22 Installing the host agent software............................... 22 HP OpenVMS..................................... 23 Verifying the installation.................................. 24 Removing the host agent software.............................. 24 HP StorageWorks Replication Solutions Manager installation guide 3
4Troubleshooting......................... 25 Insufficient space in the temporary directory.......................... 25 Port already in use..................................... 25 User interface does not open................................ 25 No login server error message................................ 25 Glossary............................. 27 Index.............................. 29 4
Tables 1 Document conventions................................. 8 HP StorageWorks Replication Solutions Manager installation guide 5
6
About this guide This guide describes procedures for installing and removing: HP StorageWorks Replication Solutions Manager server software HP StorageWorks Replication Solutions Manager host agent software Intended audience This guide is intended for personnel who install software in storage area networks that include HP StorageWorks Enterprise Virtual Arrays (EVAs). Readers need skills in: Storage area networks Operating systems HP StorageWorks Enterprise Virtual Arrays HP StorageWorks Command View EVA Related documentation The following documents are referenced in this guide: HP StorageWorks EVA software compatibility reference HP StorageWorks EVA replication software consolidated release notes HP StorageWorks JREserver installation instructions HP StorageWorks Replication Solutions Manager command line user interface reference HP StorageWorks Replication Solutions Manager online help and user guide (accessible from the HP Replication Solutions Manager user interface) You can find these documents from the Manuals page of the HP Business Support Center web site: http://www.hp.com/support/manuals In the Storage section, click Storage software and then select your product. HP StorageWorks Replication Solutions Manager installation guide 7
Document conventions and symbols Table 1 Document conventions Convention Blue text: Table 1 Blue, underlined text: http://www.hp.com Bold text Italic text Monospace text Monospace, italic text Monospace, bold text Element Cross-reference links and e-mail addresses Web site addresses Keys that are pressed Text typed into a GUI element, such as a box GUI elements that are clicked or selected, such as menu and list items,buttons,tabs,and check boxes Text emphasis File and directory names System output Code Commands, their arguments, and argument values 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. TIP: Provides helpful hints and shortcuts. 8 About this guide
HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/. Collect the following information before calling: Technical support registration number (if applicable) Product serial numbers Product model names and numbers Error messages Operating system type and revision level Detailed questions For continuous quality improvement, calls may be recorded or monitored. Subscription service HP recommends that you register your product at the Subscriber's choice for business web site: http://www.hp.com/go/e-updates. After registering, you will receive e-mail notification of product enhancements, new driver versions, firmware updates, and other product resources. HP web sites For additional information, see the following HP web sites: http://www.hp.com http://www.hp.com/go/storage http://www.hp.com/service_locator http://www.docs.hp.com Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to storagedocs.feedback@hp.com. All submissions become the property of HP. Product feedback To make comments and suggestions about HP Replication Solutions Manager, please send a message to EVAReplication@hp.com. HP StorageWorks Replication Solutions Manager installation guide 9
10 About this guide
1Preparation This chapter describes the contents of the software CDs and downloads and explains the prerequisites for installing HP Replication Solutions Manager. Kit or download contents When you obtain HP Replication Solutions Manager (you can order the software in a kit or download it free from the Web), you receive the following: Server software Host agent software HP JREserver RSM integrator HP Replication Solutions Manager server software HP Replication Solutions Manager (the replication manager) is a graphical and command line user interface for managing replication on HP storage arrays. See HP StorageWorks Replication Solutions Manager administrator guide for a description of the software features. HP Replication Solutions Manager host agent software HP JREserver The replication manager host agent software is installed on a supported host server. The host agent software facilitates communication between the management server and the host server. There is no user interface associated with the host agent software. When you install the host agent software, you also install the HP Replication Solutions Manager CLUI client. The CLUI client is a command line utility that enables you to run replication manager commands from thehostserver. The host agent software CD also contains HP DButil. HP DButil is a command line utility that facilitates application-consistent replication of Microsoft SQL Server 2000 databases. You can install HP DButil on Windows hostservers only. A supported JRE is required to browse to the replication manager. See HP StorageWorks JREserver installation instructions for more information. HP Replication Solutions Manager integrator Install the HP Replication Solutions Manager integrator on the management server to register the replication manager with Systems Insight Manager or System Management Homepage. When you install this integrator, it creates a link on either Systems Insight Manager or System Management Homepage to monitor the management server. HP StorageWorks Replication Solutions Manager installation guide 11
Downloading the software To download the software free from the Web: 1. Go to the HP StorageWorks Continuous Access EVA web site: (You can use this site whether you use HP Continuous AccessEVA or not.) http://h18006.www1.hp.com/products/storage/software/conaccesseva/index.html 2. Click Software & drivers. 3. Download the replication manager server software. Only one download is required. 4. If you have Windows hosts, download the replication manager host agent software for Windows. Only one download is required. 5. If you have UNIX or Linux hosts, download the replication manager host agent software for UNIX/Linux. Only one download is required. Simulation mode You can perform any replication manager function in simulation mode that you can perform in a production environment, with the following restrictions: Only the Windows host agent is simulated. Other host platforms are not available for simulation. The simulated host volumes can have only one virtual disk under them. In a production environment, a host volume can comprise multiple virtual disks. Simulation mode enables you to use all replication manager features without using production data and resources. This functionality is built into the replication manager and does not require separate installation or activation. If you plan to use simulation mode, HP recommends that you: Install the replication manager on a Windows server that: Does not have HP Command View EVA installed on it. Is running a supported version of Windows and has sufficient space for the installation. See HP StorageWorks EVA software compatibility reference for details. Not install the host agent software. For information about using simulation mode, see HP StorageWorks Replication Solutions Manager simulation guide. Prerequisites Before you install the software: Read HP StorageWorks EVA replication software consolidated release notes for any installation or post-installation requirements specific tothisrelease. Ensure that your environment includes: One or more Enterprise Virtual Arrays A management server running a supported version of Microsoft Windows (for more information, see HP StorageWorks EVA software compatibility reference) A host server that contains sufficient space and is running a supported operating system (for more information, see HP StorageWorks EVA software compatibility reference) Ensure that the management server and host servers are connected to the same local area network. Ensure that the management server is not a domain controller. You can install the software on a management server that is on a domain, but not on a management server that is the domain controller. 12 Preparation
Before you upgrade the software, ensure that the required minimum versions of HP Replication Solutions Manager server software, HP Replication Solutions Manager host agent software, and HP Command View EVA are installed. See HP StorageWorks EVA replication software consolidated release notes and HP StorageWorks Command View EVA release notes for the minimum required versions. After installing the software, the following licenses are required to use replication and application features: HP Business Copy EVA (snapshots, snapclones, and mirrorclones) HP Continuous Access EVA (data replication) Oracle You must have sufficient licenses for the capacity of each array where snapshots, snapclones, and mirrorclones will be made or that will be the source or destination of replicated data. See the QuickSpecs for HP Business Copy EVA and HP Continuous Access EVA for more information. Management server types You can install the server software on the following servers: HP OpenView Storage Management Appliance (SMA) A centralized, dedicated monitoring and management hardware-software solution for the storage area network. NOTE: If the SMA is running HP OpenView Storage Area Manager, the SMA is considered a dedicated management server and HP Replication Solutions Manager will not be accessible from the SMA's web interface. HP Replication Solutions Manager is accessible only from the desktop icon or the Start menu. General-purpose server A server other than the HP OpenView Storage Management Appliance that runs customer applications, such as file and print services. Dedicated management server A Windows host that is intended solely for HP storage software, such as HP OpenView Storage Node Manager, HP OpenView Storage Area Manager add-on software modules, or HP StorageWorks EVA software. HP ProLiant storage server A server similar to the general-purpose server; it can be used for managing EVAs in the SAN as well as traditional NAS-based applications. For hardware and software specifications, see the HP EVA software compatibility reference. Installation requirements Before installing the software, you must: Install HP Command View EVA on the management server. Ensure the appropriate groups and users are created on the management server. See "Setting credentials" on page 14 for more information. Installation tips When installing over a network, use one of the following methods to install (and remove) the software: For Windows, use Terminal Services and Add/Remove Programs. Ensure that Terminal Services is configured for administrator mode. For UNIX hosts, use Telnet in a secure environment; otherwise, use Secure Shell (SSH) client. NOTE: Telnet is not supported on Windows. HP StorageWorks Replication Solutions Manager installation guide 13
Install the software on the SMA using the setup files and Add/Remove Programs, not the SMA software interface. Immediately install the HP JREserver to facilitate obtaining the preferred JRE for browsing to the replication manager. A supported JRE is required on the browsing client. For supported JRE versions, see HP StorageWorks EVA software compatibility reference. For installation instructions, see HP StorageWorks JREserver installation instructions. In remote replication configurations, HP recommends installing the server software on the same management server type at the local and remote sites. If the files that exist on the management server or host server are newer than the software installation files, HP recommends that you do not replace these files. Setting credentials Setting credentials requires that local or domain groups are created on the servers where you will install the replication manager server software and host software. Each group must contain at least one user. You must set credentials so the replication manager can: Authenticate users with the operating system Assign default privileges based on the operating system groups to which users belong Authenticate application integration NOTE: In this section, unless a specific reference is made to the HP Storage Users group, use refers to all people who can access the software. Management server The management server credentials are created during the HP Command View EVA installation process. The manual procedure for creating the credentials is listed in this section for ease of reference. To set credentials on the management server: 1. Use the Windows operating system feature to create the following groups: HP Storage Admins HP Storage Users IMPORTANT: You must specify the group names exactly as described in this step; otherwise the replication manager will be unable to authorize these groups when you log in to the replication manager. See your Windows documentation for instructions about creating groups. These groups have default privileges assigned to them. Anyone in the HP Storage Admins group can view and perform all tasks. Anyone in the HP Storage Users group can only view information. 2. Create users and assign them to these groups. Enter a name and password for the user and select agroup forthe user. 14 Preparation
Ensuring successful authorization After creating these groups, complete the following steps: 1. Access the Local Security Policy feature on the Windows operating system. The Local Security Settings window opens. 2. Select Security Settings > Local Policies > User Rights Assignment. 3. Double-click the Access this computer from the network policy in the right Content pane. 4. Click AddUserorGroup. 5. Add the users you have created to this permission. See your operating system-specific documentation for further instructions. NOTE: If you are installing the replication manager on a Windows XP server (for simulation mode only), see your Windows XP documentation for instructions about setting this policy. Host server Setting credentials on the host server is optional. During the installation process, you will be prompted about host-enabled authentication. If you choose to set credentials prior to the installation, it is at this prompt in the installation process that you are enabling this feature. To set credentials on a supported host server: 1. Use the operating system feature to create the appropriate group: HP Host Agent Admins (supported Windows host) hphaadm (all other supported hosts) IMPORTANT: You must specify the group name exactly as shown in this step; otherwise, authentication will fail. See your operating system documentation for instructions about creating groups. 2. Create users and assign them to a group (only one user is required for authentication). Enter a name and password for the user and select a group for the user. See your operating system documentation for instructions about creating users. NOTE: On SLES (Linux) hosts, root cannot be a member of the hphaadm group. You must create a user other than root and assign it to the hphaadm group. 3. Enter the user's account credentials in the HP Replication Solutions Manager graphical user interface: a. In the Navigation pane, select Enabled Hosts. b. From the List view in the Content pane, select the enabled host for which you want to set credentials. c. In the Content pane, select Actions > Set Credentials. The Set Credentials for Enabled Host window opens. d. Enter the user name and password for the account created in Step 2. e. Click OK. HP StorageWorks Replication Solutions Manager installation guide 15
Oracle account If you plan to use Oracle replication features, an Oracle database administrator must create an account for HP Replication Solutions Manager on each Oracle database. NOTE: The Oracle features require a license. The process for using Oracle on the replication manager follows: 1. The Oracle database administrator creates the HP Replication Solutions Manager account on the Oracle databases. 2. Install the HP Replication Solutions Manager server software. 3. Complete the initial setup and configuration of the replication manager. 4. Perform a discovery (global) to discover all known Oracle databases. 5. Select a database and select Set Credentials. Enter the user name and password of the account created in Step 1. Repeat this step for each database. 6. Perform a global refresh. 16 Preparation
2Serversoftware This chapter describes how to install and remove the server software. Installing the server software The default installation directory is C:\Program Files\Hewlett-Packard\; however, you can install the server software in another directory. NOTE: If you specify an alternate installation directory, the installation software will not detect the previous installation and will allow the software to be installed again. This will not prevent the server software from working, but you will not know which instance of the server software is running. To install the server software: 1. Close all applications that are on or open to the management server. 2. Perform one of the following: Insert the installation CD into the drive. Download the software from the following web site: http://www.hp.com/support/downloads 3. Browse to the installation CD or the directory where you downloaded the software. 4. Double-click setupwin32.exe to start the installation. The InstallShield Wizard Welcome window opens. 5. Click Next. The license agreement window opens. 6. Read and accept the terms of the license agreement, and then click Next. The InstallShield Wizard summary window opens. 7. Click Install. 8. During the installation, the InstallShield wizard checks for the existence of local groups and users and creates them if they are not present. 9. If the installer detects the server is a domain member, you have the option to set credentials for administrator and user domain groups. Do one of the following: a. Select yes, and then click Next. Continue with Step 10. b. Select no, and then click Next. Continue with Step 11. 10. Enter the domain and domain group names for storage administrators, and then click Next. When entering names, remember the following: Use the shortened DNS format for the domain name. For example, enter americas, not americas.mycompany.com. Valid characters for names are A-Z, a-z, 0-9, and -. Invalid characters for names are \ / [ ] : ; = +, *? < >. The maximum length of the domain name is 63 characters. The maximum length of the domain group name is 255 characters. HP StorageWorks Replication Solutions Manager installation guide 17
1 1. The installer displays the default database port. 12. Click Check Port Availability. If a Port available message appears, click Next. If the port is not available, enter an alternate port number in the Port box. 13. Repeat Step 12 if necessary. When the installation has finished, the installation summary window opens. 14. Click Finish. Alternatively, open a command window and enter the following command to start the installation: setupwin32.exe -console Upgrade and reinstallation tips When upgrading or reinstalling the server software, consider the following: Ensure that all jobs have completed before upgrading the software. If prompted during the upgrade process, reboot the management server. The current software will discover which version is installed, and you will see a blue bar indicating that the software is being installed. If you cancelled the database migration during an upgrade, you are prompted to restart the services. After upgrading the server software, the events of the previous version will not be available in the current version. Upgrading a Storage Area Manager management server If you are upgrading the server software on a management server that is currently running Storage Area Manager, complete the following steps to ensure a successful upgrade: 1. Remove the host agent software: NOTE: The following steps (a f) are identical for all supported operating systems except for selecting the desired package. HP recommends removing the host agent software from the host before removing the Storage Area Manager Host Agent. a. From the management server, open the Storage Area Manager interface. b. Select Tools > Manage Host Agent > Install/Modify Host Agent Software. c. Right-click on the host, and select Modify Host Packages Selection. A list of the available packages appears. d. Under Action to Take for Replication Solutions Manager Host Agent, select Uninstall. e. Click OK. f. Select Host, and then select Install/Modify Selected Host. After removing the host agent software, the following Windows and UNIX subdirectories are not removed: C:\Program Files\Hewlett-Packard\sanmgr\hostagent /opt/sanmgr/hostagent /etc/opt/sanmgr/hostagent /var/opt/sanmgr/hostagent 18 Server software
The filesinthese directoriesweremodified using Storage Area Manager. Do not remove these directories if you think you will use the host to link to previous jobs and logs. 2. Back up the replication database using the Export feature. For instructions, see HP StorageWorks Replication Solutions Manager administrator guide. 3. Remove the server software from the management server. For instructions, see "Removing the server software" onpage19. 4. Install the new server software on the management server. For instructions, see "Installing the server software" on page 17. 5. Restore the replication database using the Import feature. For instructions, see HP StorageWorks Replication Solutions Manager administrator guide. Verifying the installation To verify that the software was installed successfully, ensure that: The software icon appears on the desktop. Thesoftwareis available from thestart menu (Start > Programs > Hewlett-Packard > HP Replication Solutions Manager). HP Replication Solutions Manager is listed in Add/Remove Programs. If you experience any issues, see "Troubleshooting" on page 25, and then repeat the installation. If you require the product code for the replication manager (for example, to include the product code in scripts that track installed applications), open Registry Editor and go to the following directory: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Current Version\Uninstall The product code is b6f613d678bfa387048dae940c9d2fe and is appended with eight hexadecimal characters. These characters are generated based on the directory in which the server software is installed. Removing the server software When removing the server software, consider the following: To prevent data loss, allow all replication jobs to run to completion, or disable scheduled jobs before removing the software. Removing thesoftwareoveranetworkwithout remoteconnectionsoftwareisnot supported and could cause errors. You cannotuse thesma software interface toremovethe software. Removethe software from the SMA using Windows Add/Remove Programs only. Close all applications and windows on or open to the management server. Use Windows Add/Remove Programs to remove the software. You can remove the server software remotely (using remote connection software) or locally. When removing the server software remotely, use Terminal Services to access the management server and log in. The InstallShield Wizard indicates if a reboot is necessary after software removal. HP StorageWorks Replication Solutions Manager installation guide 19
20 Server software
3Hostagentsoftware This chapter describes how to install and remove the host agent software. An installation is required on every host that interacts with the replication manager. Operating system requirements This section describes the operating system-specific requirements for installing the replication manager host agent. HP OpenVMS on Alpha servers The following SNIA libraries are required on the HP OpenVMS (Alpha) host to ensure that the host agent software works properly: HBA_VMS.EXE LIBHBAAPI.EXE These SNIA libraries are included on the host agent software CD. Compare the versions of the libraries on the CD against those listed in SYS$LIBRARY. If the versions on the CD are newer, copy the SNIA libraries from the CD to SYS$LIBRARY, and then restart the host agent. HP OpenVMS on Integrity servers The following patches are required on the HP OpenVMS (Integrity) host to ensure the host agent software works properly: HP I64VMS VMS821I_UPDATE V3.0 HP I64VMS VMS821I_SYS V3.0 HP I64VMS VMS821I_PCSI V1.0 HP I64VMS VMS821I_FIBRE_SCSI V2.0 HP I64VMS VMS821I_ICXXL V1.0 You can download these patches from the following web site: http://www.itrc.hp.com HP Tru64 UNIX CXX 7.1 runtime libraries must be installed on the HP Tru64 UNIX host. Download the libraries from the following link: ftp://ftp.compaq.com/pub/products/c-cxx/tru64/cxx/cxxredist710.tar You can install the libraries before or after installing the replication host agent, but they must be installed before you start the replication manager. Linux Before installing the replication manager host agent on a Linux host, ensure that you have: Installed the QLogic failover driver. Disabled LDAP authentication. See your Linux documentation for more information. HP StorageWorks Replication Solutions Manager installation guide 21
Sun Solaris Ensure that you install the appropriate SNIA libraries on the Solaris host; otherwise, incorrect HBA information is reported in the replication manager HBA/ports tab of the Enabled Host properties window. This condition does not affect HBA operation, only the information reported to the replication manager. The following SNIA libraries are required: For JNI and Sun native HBAs, install the JNI SNIA Fibre Channel HBA library. The package name is JNIsnia. For QLogic HBAs, install the QLogic SDM library. The package name is QLSDMLIB. The SNIA libraries are included with HP Secure Path for Sun Solaris, but are not installed by default. You can install the SNIA libraries before or after installing the replication manager host agent. Conflict between cfgadm utility and SNIA libraries Windows There is a conflict between the cfgadm utility and the SNIA libraries that are distributed with HP Secure Path 3.0d on Solaris 10, which prevents the Solaris 10 host from working properly. To resolve this conflict, install the 119974 patch on the Solaris 10 host before installing the SNIA libraries. Before installing the host agent software on a Windows host, you must: Have system administrator authority on the server on which you want to install the host agent software. Remove version 1.0 before installing the current version (if applicable). Install the appropriate SNIA libraries for Windows. Go to the Fibre Channel Host Bus Adapters section on the following web site and download the software for your HBA: http://h18006.www1.hp.com/storage/saninfrastructure.com. Installing the host agent software To install the host agent software: 1. Do one of the following: Copy the host agent software files (.exe and.jar for Windows,.bin and.jar for UNIX) to the host. Insert the software CD into the drive of the host. On an HP OpenVMS host, enter the following command to mount the software CD: mount /MEDIA_FORMAT=CDROM /UNDEFINED_FAT=fixed:none:8192 /over=id IA641$DQA0: 2. Do one of the following to initiate the installation: a. Double-click the file for the applicable operating system listed in the following table. b. For UNIX hosts, enter the command./<file name>. Ensurethatyou areaccessing the directory where the host agent software file is located when you enter this command. c. For HP OpenVMS hosts, enter the following command: $ product install rsmha /source=<abolute path of the host agent software file location> 22 Host agent software
Operating system HP HP-UX 11.11 (11i v1) HP HP-UX 11.23 PI (PA) HP HP-UX 11.23 PI (IA) HP OpenVMS (on Alpha servers) HP OpenVMS (on Integrity servers) HP Tru64 UNIX IBM AIX Linux (Red Hat and SuSE) Microsoft Windows (32 bit) Microsoft Windows (64 bit) Sun Solaris File name setuphppa.bin setuphpia64.bin HP-AXPVMS-RSMHA-V0100--1.PCSI;1 HP-IA64VMS-RSMHA-V02001--1.PCSI;1 setuptru64.bin setupaix.bin setuplinux.bin setupwin32.exe setupwinia64.exe setupsolaris.bin 3. During installation, the following prompt appears: Do you want to enable host-based authentication for this replication host agent? 4. Do one of the following: If you created the host agent group and user(s) prior to installation (see "Setting credentials" onpage14), click Enable. If you did not create the host agent group and user(s) prior to installation, click Disable. You will not have the security that the host agent group and user(s) provides. 5. Follow the instructions online to complete the installation. When the software is installed, the InstallShield Wizard Complete window opens. 6. Click Finish. Alternatively, open a command window and enter the following command to start the installation (this command is not applicable on HP OpenVMS hosts): <file name> -console When you install the host agent software, the CLUI client is installed automatically. If you want to install only the CLUI client, select the Custom installation type during installation. On the Custom installation type window, both the host agent software and the CLUI client are selected by default. Clear the Host Agent Software check box and continue with the installation. TIP: After installing the host agent software, add the host using the HP Command View EVA user interface. For more information about adding hosts, see HP Command View EVA online help. HP OpenVMS After installing the host agent on an HP OpenVMS server, run the following commands to complete the installation: set def sys$system $mc authorize UAF> add/identifier HPHAADM UAF> grant/id HPHAADM system UAF> exit HP StorageWorks Replication Solutions Manager installation guide 23
To add other user names, run the add/identifier HPHAADM command again, and enter the appropriate user name with the grant/id HPHAADM command. Verifying the installation Verify that the host agent software was installed successfully: On Windows hosts, HP StorageWorks Replication Solutions Manager Host Agent is listed in Add/Remove Programs. On UNIX and Linux hosts, HPSWRSMHA, HPOVSAMHA, and HPOVSAMJR are listed when you execute the following OS-specific command: Operating system HP HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux (Red Hat and SuSE) Sun Solaris Command swlist grep HP product show product rsmha setld -i grep HPRSMHA lslpp -L all grep HP rpm -qa grep HP pkginfo grep HP If you experience any issues, see "Troubleshooting" on page 25, and then repeat the installation. Removing the host agent software Before you remove any software: Allow all software jobs to run to completion, or stop them before initiating a removal. If removing software from a host over a network, use remote connection software to access thehostand log in. For Windows hosts, use Add/Remove Programs to remove the software. To remove the host agent software from a UNIX or Linux host: 1. Open a command window and navigate to the _uninst directory. For example, the default directory is: opt/hewlett-packard/rsmhostsw/_uninst/ 2. Enter the following command:./uninstall.bin Alternatively, open a command window and enter the following command to start the software removal:./uninstall.bin -console To remove the host agent software from an HP OpenVMS host, open a command window and enter the following command: product remove rsmha CAUTION: If HP Replication Solutions Manager is running, the management server requires a reboot to complete the removal. 24 Host agent software
4 Troubleshooting This chapter describes known problems and suggested resolutions for troubleshooting the software installation. Insufficient space in the temporary directory When you install HP Replication Solutions Manager, the contents of the.jar file are extracted to a temporary directory. If there is insufficient space in the directory, an error message may appear. If you do not know whether the temporary directory has sufficient space to complete the installation, you can specify an alternate directory: 1. Open a command window. 2. Enter the following command: -is:tempdir <directory> The value directory is the name of the alternate directory (for example, -is:tempdir C:\My Documents\temp). Port already in use During the server software installation, if you select a port that is already in use, the ReplicationDB service will not start, and the following error message appears when you start the software: The system database rejected the configured userid or password. You must remove and then reinstall the server software. When prompted during the installation to enter a port, be sure to specify a different port. NOTE: On a Windows 2000 server, a reboot is usually required after removal. If you are prompted to reboot, do so before reinstalling the software; otherwise, the ReplServer service is deleted the next time you reboot the server. User interface does not open The user interface does not open after starting the software. This can occur if Terminal Services is not configured for administrator mode. Using Add/Remove Programs, remove the software from the management server and install the software again. See "Installing the software" onpage17for instructions. No login server error message This error message may appear due to an invalid or unavailable server IP address. Verify the server IP address in your browser. Verify that the services are running on the management server. HP StorageWorks Replication Solutions Manager installation guide 25
26 Troubleshooting
Glossary This glossary defines terms that are used in this guide or are related to the software. array client Data replication (DR) group enabled host Enterprise Virtual Array (EVA) failover general-purpose server host job management server Storage Management Appliance (SMA) See storage system and virtual array. An intelligent device that requests services from other intelligent devices. In the context of HP Replication Solutions Manager, a client is a computer used to access the software remotely using a supported browser. A logical group of virtual disks in a remote replication relationship with a corresponding group on another array. A hostthatisequippedwithareplicationhostagent. An HP StorageWorks disk array product that allows pooled disk capacity to be presented to hosts as one or more variably sized physical devices. An EVA consists of disks, controllers, cables, power supplies, and controller software. Storage system, virtual array, and storage array are other names for an EVA. See also virtual disk. 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. A server that runs customer applications such as file and print services. HP Command View EVA and HP Replication Solutions Manager can be used on a general-purpose server in limited configurations. A computer that runs user applications and uses (or potentially uses) one or more virtual disks that are created and presented by the array controller. A repeatable custom script that automates replication tasks. A job can be simple (for example, create a DR group) or complex (for example, perform cascaded replication). Jobs can be run from the GUI, from the command line, from batch files, or by a scheduler. A server where HP StorageWorks Enterprise Virtual Array (EVA) management software is installed, including HP Command View EVA and HP Replication Solutions Manager, if used. A dedicated management server runs EVA management software exclusively. Other management servers are general purpose servers, HP ProLiant Storage Server (NAS) models, and the Storage Management Appliance. When there are multiple management servers in a SAN, two active instances of HP Command View EVA are allowed, but each array will only be managed by one instance. The active management server actively manages the array, while the standby management server takes control of the array if there is a failure on the active management server. There is only one active management server at a time for any given management zone in asan. HP OpenView Storage Management Appliance, an HP hardware-software product designed to run SAN management applications such as HP Command View EVA and HP Replication Solutions Manager. HP StorageWorks Replication Solutions Manager installation guide 27
storage system Universal Naming Convention (UNC) virtual array virtual disk Synonymous with virtual array. The HP Enterprise Virtual Array consists of one or more storage systems. See also virtual disk. Referenced in many Edit panels of verbs in the Jobs Creation Interface. Synonymous with disk array and storage system, a group of disks in one or more disk enclosures combined with control software that presents disk storage capacity as one or more virtual disks. See also virtual disk. Variable disk capacity that is defined and managed by the array controller and presented to hosts as a disk. 28 Glossary
Index A audience, 7 C CLUI client, 11 contents kit or download, 11 conventions document, 8 credentials host server, 15 management server, 14 Oracle account, 16 setting, 14 D DButil, 11 default installation directory, 17 document conventions, 8 related documentation, 7 documentation HP web site, 7 providing feedback, 9 download contents, 11 downloading the software, 12 F feedback documentation, 9 product, 9 H help obtaining, 9 host agent software description, 11 installation, 22 removal, 24 requirements, 21 host server credentials, 15 HP technical support, 9 HP Tru64 UNIX, 21 I installation host agent software verification, 24 prerequisites, 12 requirements, 13 server software verification, 19 tips, 13 troubleshooting, 25 installing host agent software, 22 replication manager server software, 17 insufficient space, 25 J JREserver, 11, 14 K kit contents, 11 L licensing prerequisites, 13 Linux, 21 M management server credentials, 14 management server types, 13 minimum required versions, 12 N no login server error message, 25 O operating system requirements, 21 HP Tru64 UNIX, 21 Linux, 21 Sun Solaris, 22 Windows, 22 Oracle account credentials, 16 overview HP Replication Solutions Manager, 11 P port in use, 25 preparation, 11 HP StorageWorks Replication Solutions Manager installation guide 29
prerequisites host agent software, 21 licensing, 13 replication manager, 12 simulation mode, 12 procedures installing replication manager server software, 17 installing host agent software, 22 removing host agent software, 24 removing server software, 19 upgrading a Storage Area Manager management server, 18 product code, replication manager, 19 R reinstallation tips, 18 related documentation, 7 removing deployed host agents, 18 host agent software, 24 server software, 19 replication manager default installation directory, 17 installation requirements, 12 installing, 17 product code, 19 removal requirements, 19 removing deployed host agents, 18 software description, 11 troubleshooting installation or removal, 25 Replications Solutions Manager integrator, 11 requirements installation, 13 operating systems, 21 S server software installation, 17 prerequisites, 12 removal, 19 settings credentials, 14 simulation mode, 12 SNIA libraries, 22 software description CLUI client, 11 DButil, 11 host agent software, 11 JREserver, 11 replication manager, 11 Replication Solutions Manager integrator, 11 Storage Area Manager, 18 Subscriber's choice, HP, 9 Sun Solaris, 22 T technical support HP, 9 service locator web site, 9 Telnet, 13 temporary directory, 25 Terminal Services, 13 tips for installation, 13 troubleshooting, 25 no login server error message, 25 port in use, 25 temporary directory space, 25 user interface does not open, 25 U upgrading minimum required versions, 12 tips, 18 user interface not opening, 25 V verifying host agent installation, 24 server software installation, 19 W web sites HP, 9 HP Subscriber's choice for business, 9 product manuals, 7 Windows, 22 30