HP 3PAR Recovery Manager Diagnostics Tool User Guide
For HP 3PAR Recovery Manager Software for
VMware® vSphere™
Abstract
This document describes the diagnostic checks for the Recovery Manager Software for VMware® vSphere™ using the HP 3PAR
Recovery Manager Diagnostics tool.
HP Part Number: QL226-97311
Published: February 2014
Edition: 1.0
© Copyright 2014 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®, Windows®, are U.S. registered trademarks of Microsoft Corporation. Adobe® and Acrobat® are trademarks of Adobe Systems
Incorporated. VMware® is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other trademarks
and registered trademarks are owned by their respective owners.
Contents
1 Introduction...............................................................................................4
2 System requirements for installation...............................................................5
Hardware requirements.............................................................................................................5
Software requirements...............................................................................................................5
3 Installing and removing the RMD tool............................................................6
Installing the RMD tool on the backup server................................................................................6
Verifying installation..................................................................................................................6
Removing the RMD tool.............................................................................................................6
4 Using the RMD tool....................................................................................8
Launching the RMD tool.............................................................................................................8
Performing diagnostic checks.....................................................................................................8
Diagnostic checks................................................................................................................9
Viewing diagnostic test status...................................................................................................10
Viewing diagnostic reports.......................................................................................................11
Viewing archived reports.........................................................................................................12
5 Troubleshooting........................................................................................13
6 Support and other resources......................................................................17
Contacting HP........................................................................................................................17
HP 3PAR documentation..........................................................................................................17
Typographic conventions.........................................................................................................19
HP 3PAR branding information.................................................................................................19
7 Documentation feedback...........................................................................20
Glossary....................................................................................................21
Contents 3
1 Introduction
The RMD tool (HP 3PAR Recovery Manager Diagnostics tool) is a web-based application that
identifies discrepancies in the environment running HP 3PAR RMV products. The RMD tool scans
the servers managed by Recovery Manager (both RMV and vCenter servers), gathers RMV
environment information, identifies discrepancies, and provides corrective actions for proper
functioning of the RMV products.
Recovery Manager Diagnostic tool for RMV runs on the RMV server and performs only RMV specific
tests. These tests collect RMV application specific information, vCenter and ESX Host information,
vCenter and RMV log files, troubleshooting recurrent customer issues in RMV, such as, RMV
configuration issues, vCenter and HP 3PAR StoreServ connectivity issues, and so on. RMV refers
to RMV application package including RMV Management Plug-in and VASA Provider.
The RMD tool 1.0 is supported on RMV 2.4.0 and RMV 2.4 Patch 01 releases.
4 Introduction
2 System requirements for installation
Hardware requirements
The RMD tool has no specific hardware requirements for installation, except for the hardware
requirements for RMV installation.
Software requirements
RMV must be installed and running on the RMV and vCenter servers. The RMD tool must be installed
on the RMV server. The RMD tool can diagnose only the RMV Server and vCenter servers managed
by the RMV server. If multiple vCenter servers are available, then the RMD tool must be installed
on each vCenter server to perform the diagnosis.
The RMD tool uses WMI to perform checks on the backup server and hence you must set the
required firewall exception for WMI. For more information about configuring and setting exceptions
for WMI, see http://msdn.microsoft.com/.
In the MSDN website, navigate to the Library and search for the following:
• Securing a Remote WMI Connection
• Connecting Through Windows Firewall
Hardware requirements 5
3 Installing and removing the RMD tool
Installing the RMD tool on the backup server
The RMD tool must be installed only on the backup server. To install the RMD tool:
1. Navigate to the folder containing the HP 3PAR Recovery Manager Diagnostics Tool installation
executable.
2. Double-click the setup.exe file to start installation.
The HP 3PAR Recovery Manager Diagnostics Tool—InstallShield Wizard window appears.
3. Click Next to continue.
The End User License Agreement window appears.
4. If you agree with the end user license agreement, select I accept the terms in the license
agreement and then click Next.
The Destination Folder window appears.
5. Click Next to install the Tool in the default folder location.
The User Credentials window appears.
6. Enter the logged-in user credentials and click Next.
NOTE: If port number 9942 is busy, you are prompted to enter an alternate port number.
7. Click Install.
The InstallShield Wizard Completed window appears. The installation takes approximately
two minutes to complete.
8. When the installation is complete, click Finish.
NOTE: After successful installation:
• The HP 3PAR Recovery Manager Diagnostics Tool for Recovery Manager
for VMware vSphere service is created.
• The Recovery Manager Diagnostics Tool for RM for VMware vSphere shortcut
is created on the desktop.
Verifying installation
To verify the installation of the RMD tool for Windows Server 2008 R2:
1. Log on as system administrator.
2. Click Start →Control Panel→Programs and Features.
3. Verify that HP 3PAR Recovery Manager Diagnostics Tool for RM for VMware
vSphere appears in the Currently installed programs column.
To verify the installation of the RMD tool for Windows Server 2012:
1. Log on as system administrator.
2. Navigate to the Start page, click Control Panel→Programs→Programs and Features.
3. Verify that HP 3PAR Recovery Manager Diagnostics Tool for RM for VMware
vSphere appears in the installed program list.
Removing the RMD tool
To remove the RMD tool from Windows Server 2008 R2:
1. Log on as system administrator.
2. Click Start→Control Panel→Programs and Features.
6 Installing and removing the RMD tool
3. Select HP 3PAR Recovery Manager Diagnostics Tool for RM for VMware
vSphere.
4. Click Remove.
The Program Maintenance dialog box appears.
5. Select Remove and click Next.
The RMD tool is removed from the backup server.
To remove the RMD tool from Windows Server 2012:
1. Log on as system administrator.
2. Navigate to the Start page, click Control Panel→Uninstall a Program.
3. Select HP 3PAR Recovery Manager Diagnostics Tool for RM for VMware
vSphere.
4. Click Uninstall. A dialog box appears.
5. Click Yes. The RMD tool is removed from the backup server.
Removing the RMD tool 7
4 Using the RMD tool
Launching the RMD tool
Double-click the Recovery Manager Diagnostics Tool for RM for VMware vSphere shortcut icon
available on the desktop to launch the RMD tool.
Performing diagnostic checks
To perform the diagnostic checks:
1. Select the servers to run the diagnostic checks.
The RMD tool automatically discovers and lists all the RMV and vCenter servers managed by
RMV. By default, all the vCenter servers are selected for diagnosis. However, you can also
select servers to run the diagnostic checks. The RMV server is selected by default for running
the diagnostic checks.
NOTE:
• To select or clear all the listed servers, click Select All or Deselect All, respectively.
• If more than eight servers are listed, then to expand or collapse all the listed servers, click
View more or Collapse, respectively.
2. Click Enter Credentials to provide the logon credentials if any server requires a different logon
credential.
By default, the RMD tool uses the logon credentials provided during installation to log on to
the different servers.
NOTE: If the logon credentials are incorrect, then during test execution, RMD tool displays
the error message Connection to remote machine failed.
3. Select Collect Application Specific Logs to include log tests during diagnostics. If you select this
check box, then after the diagnosis is complete, the log files are available in the RMV Log
Files Information section of the Test Report. By default, the check box is cleared.
8 Using the RMD tool
TIP: You can also navigate to C:\Program
Files\3PAR\RMD\RMV\tomcat\webapps\RMDWeb\RMDReport\RMV\time_stamp\RMV_Server
to view the application specific log files,
where:
time_stamp is the time stamp of the diagnostics check.
RMV_Server is the name of the RMV server selected for the diagnostics check.
4. Click Start Diagnostics.
The RMD tool runs the diagnostic checks on all the selected servers.
Diagnostic checks
Table 1 (page 10) lists the diagnostic checks that you can perform on the selected RMV and vCenter
servers.
Performing diagnostic checks 9
Table 1 Diagnostic checks
ParametersDiagnostic checks
RMV Settings
vCenter Information
StoreServ Information
• RMV installed on RMV server
• Installed RMV path
• RMV path set in system variable
• RMV has enough access permission to database files
• RMV component name
• RMV component version
• RMV component running status
• RMV component configuration
• vCenter server name
• vCenter product name, version, OS type
• vCenter connectivity check
• ESX hosts associated with the vCenter
• ESX host name
• ESX host product name, version, OS type
• ESX host connect state, power state, and standby mode
• StoreServ host name, system ID, and node number
• StoreServ credential validation
• StoreServ connectivity check
Scheduler Information
RMV and vCenter Log Files
System Settings
Viewing diagnostic test status
The RMD tool displays the following details during diagnosis:
• Target Application
• Scheduler task name
• Scheduler user name
• Scheduler task next run time
• Scheduler task last run status
• Scheduler task last run output result
• RMV log file list
• RMV log file name hyperlink
• vCenter log file list
• vCenter log file name hyperlink
• System name
• Windows version
• Processor
• Processor type
.Net Framework version installed on systemApplication Settings
• Executed\Total Number of Servers
• Target Server
• Tests Executed
• Total Number of Tests to be Executed in this Server
10 Using the RMD tool
The RMD tool displays details of the checks executed on selected servers. A green check mark
against a test indicates that the test execution is complete. A red cross indicates that the test
execution is not complete.
NOTE: The green check mark against each test indicates that the test execution is complete.
However, this does not imply that the test result is always successful.
You can stop the diagnosis by clicking STOP. However, if you manually stop the test execution,
you will not be able to see any test results. Click BACK to return to the RMD tool home page.
NOTE: The RMD tool automatically discovers and lists all the servers managed by RMV, when
you return to the home page.
Viewing diagnostic reports
The RMD tool does not generate the report if you press STOP or BACK during test execution. All
the tests must be completed for a successful report generation.
Click View Report to view a detailed report of all the diagnostic checks.
Viewing diagnostic reports 11
The Test Report window has the following summary sections:
• Report by Product—Lists the servers with the corresponding test status. Click the required server
link to view the test details.
• Report by Server—Lists the tests with the corresponding test status. Click the required test link
to view the test details.
The test result status can be any of the following:
• Success—Indicates that there are no failures or warnings in the test result.
• Warning—Indicates that there are no failures in the test result, however, there are one or more
warnings.
• Failure—Indicates that there are one or more failures in the test result.
CAUTION: Ensure that you resolve all the failures and warnings before starting the RMV supported
functionality. Ignoring failures can cause failure of RMV functionalities.
NOTE: The Report Summary section for a test lists the warnings or failures, if any.
Viewing archived reports
To view the archived reports:
1. Click View Archive Reports from the Home Page.
The View Reports screen appears.
2. Click the appropriate Time Stamp from Report Date to view the archived diagnostic report.
NOTE: The time stamp is displayed in the mmddyyyyhhmmss format.
12 Using the RMD tool
5 Troubleshooting
Q1. During installation of the RMD tool, the error message, RMD components were
successfully installed, but unable to start service with given
credential, is displayed.
A1. Ensure that the Login Account service is set correctly. If the Login Account service is incorrect,
then enter the correct details, and restart the service.
To open the Services window in Windows Server 2008, click Start→Run. Enter services.msc
and click OK. The Services window appears.
To open the Services window in Windows Server 2012, click Search. Enter services.msc. Press
Enter. The Services window appears.
Q2. The login user password is changed.
A2. Update the service login credential using the Windows Services panel, and restart the service.
Q3. Test execution failed due to the large number of array connectivity tests and network traffic.
A3. Increase testExecutionTimeoutInSeconds in Application_Folder\3PAR\RMD\RMV\tomcat\
webapps\RMDWeb\resources\applications\applicationConfigurationXml\
RMV_Config.xml and restart the "HP 3PAR RM Diagnostics Tool Server Exchange" service,
where,
Application_Folder is the folder where the RMD tool for RMV is installed.
NOTE: The default timeout value is 600 seconds.
Ensure that the SSL certificates for all the connected HP 3PAR StoreServs are saved locally using
CLI commands if they are running one of the following OS:
• HP 3PAR Inform OS 3.1.1 MU3 P27 or later
• HP 3PAR Inform OS 3.1.2 MU3 P16 or later
• HP 3PAR Inform OS 3.1.3
Q4. The session is timed out and displays the message, Your Session has expired, while
running the RMD tool.
A4. Close the browser and restart the RMD tool.
Q5. An exception occurred while refreshing the RMD tool browser window.
A5. Close the browser and restart the RMD tool.
Q6. When you install the RMD tool for RME on a VFC system in a domain, an error message
appears.
13
A6. Perform the following procedure to resolve the issue:
Installation procedure
1. When the error message appears, click OK to resume the installation and click Finish to
complete the installation.
2. After completing the installation, click Start→Run and enter the command, services.msc.
3. Start the service HP 3PAR Recovery Manager Diagnostics Tool for Recovery Manager for
VMware and the following error message appears.
14 Troubleshooting
4. Assign Log on as a service to the service account on your system and do the following:
• If your system is a node in a cluster—Check if user rights are assigned to the cluster service
account on all nodes in the cluster.
• If user rights are already assigned—If you have already assigned the user right to the
cluster service account, and if the user right is removed, then confirm with your domain
administrator if a Group Policy object associated with this node can be removing the
rights.
Adding Log on as a service right
To manually add Log on as a service right, perform the following:
1. Click Administrative Tools→Local Security Policy.
The Local Security Policy window appears.
TIP: Click Start→Run and enter the command secpol.msc. The Local Security Policy
window appears.
2. From the left navigation pane, click Local Policies→User Rights Assignment.
3. From the details pane, click Log on as a service.
15
4. Click Add User or Group and then add the appropriate details to the list of accounts that
possess the Log on as a service right.
The account details appear as shown in the figure.
5. Click OK to close the window.
Log on as a service right is added to the account.
16 Troubleshooting
6 Support and other resources
Contacting HP
For worldwide technical support information, see the HP support website:
http://www.hp.com/support
Before contacting HP, collect the following information:
• Product model names and numbers
• Technical support registration number (if applicable)
• Product serial numbers
• Error messages
• Operating system type and revision level
• Detailed questions
HP 3PAR documentation
Table 2 Documentation list
See:For information about:
Supported hardware and software platforms
HP 3PAR storage system software
configure and administer HP 3PAR storage systems
storage systems
manage host configuration and connectivity information
Information Model) to manage HP 3PAR storage systems
another
SPOCK (Single Point of Connectivity Knowledge for HP
Storage Products) website:
http://www.hp.com/storage/spock
The HP 3PAR StoreServ Storage site:Locating HP 3PAR documents
http://www.hp.com/go/3par
To access HP 3PAR documents, click the Support link for
your product.
HP 3PAR StoreServ Storage Concepts GuideStorage concepts and terminology
HP 3PAR Management Console User's GuideUsing the HP 3PAR Management Console (GUI) to
HP 3PAR Command Line Interface Administrator’s ManualUsing the HP 3PAR CLI to configure and administer
HP 3PAR Command Line Interface ReferenceCLI commands
HP 3PAR System Reporter Software User's GuideAnalyzing system performance
HP 3PAR Host Explorer User’s GuideInstalling and maintaining the Host Explorer agent to
HP 3PAR CIM API Programming ReferenceCreating applications compliant with the CIM (Common
HP 3PAR-to-3PAR Storage Peer Motion GuideMigrating data from one HP 3PAR storage system to
Configuring the Secure Service Custodian server to
monitor and control HP 3PAR storage systems
Copy
HP 3PAR Secure Service Custodian Configuration Utility
Reference
HP 3PAR Remote Copy Software User’s GuideUsing the CLI to configure and manage HP 3PAR Remote
HP 3PAR Upgrade Pre-Planning GuideUpdating HP 3PAR operating systems
Contacting HP 17
Table 2 Documentation list (continued)
See:For information about:
Identifying storage system components, troubleshooting
information, and detailed alert information
Policy Server
Planning for HP 3PAR storage system setup
Hardware specifications, installation considerations, power requirements, networking options, and cabling information
for HP 3PAR storage systems
HP 3PAR 10000 storage systems
Installing and maintaining HP 3PAR 7200 and 7400 storage systems
the Service Processor
storage systems
HP 3PAR F-Class, T-Class, and StoreServ 10000 Storage
Troubleshooting Guide
HP 3PAR Policy Server Installation and Setup GuideInstalling, configuring, and maintaining the HP 3PAR
HP 3PAR Policy Server Administration Guide
HP 3PAR StoreServ 7000 Storage Site Planning ManualHP 3PAR 7200 and 7400 storage systems
HP 3PAR StoreServ 10000 Storage Physical Planning
Manual
HP 3PAR StoreServ 10000 Storage Third-Party Rack Physical
Planning Manual
HP 3PAR StoreServ 7000 Storage Installation GuideInstalling 7200 and 7400 storage systems and initializing
HP 3PAR StoreServ 7000 Storage SmartStart Software User’s
Guide
HP 3PAR StoreServ 7000 Storage Service GuideMaintaining, servicing, and upgrading 7200 and 7400
HP 3PAR StoreServ 7000 Storage Troubleshooting GuideTroubleshooting 7200 and 7400 storage systems
HP 3PAR host application solutions
Backing up Oracle databases and using backups for
disaster recovery
Backing up Exchange databases and using backups for
disaster recovery
Backing up SQL databases and using backups for disaster
recovery
Backing up VMware databases and using backups for
disaster recovery
Installing and using the HP 3PAR VSS (Volume Shadow
Copy Service) Provider software for Microsoft Windows
Best practices for setting up the Storage Replication
Adapter for VMware vCenter
Troubleshooting the Storage Replication Adapter for
VMware vCenter Site Recovery Manager
Installing and using VAAI plug-in (vSphere Storage APIs
for Array Integration plug-in) software for VMware
vSphere
HP 3PAR Service Processor Software User GuideMaintaining the Service Processor
HP 3PAR Service Processor Onsite Customer Care (SPOCC)
User's Guide
HP 3PAR Recovery Manager Software for Oracle User's
Guide
HP 3PAR Recovery Manager Software for Microsoft
Exchange 2007 and 2010 User's Guide
HP 3PAR Recovery Manager Software for Microsoft SQL
Server User’s Guide
HP 3PAR Management Plug-in and Recovery Manager
Software for VMware vSphere User's Guide
HP 3PAR VSS Provider Software for Microsoft Windows
User's Guide
HP 3PAR Storage Replication Adapter for VMware vCenter
Site Recovery Manager Implementation Guide
HP 3PAR Storage Replication Adapter for VMware vCenter
Site Recovery Manager Troubleshooting Guide
HP 3PAR VAAI Plug-in Software for VMware vSphere User's
Guide
18 Support and other resources
Typographic conventions
Table 3 Document conventions
ElementConvention
Bold text
Monospace text
<Monospace text in angle brackets>
Bold monospace text
• Keys that you press
• Text you typed into a GUI element, such as a text box
• GUI elements that you click or select, such as menu items, buttons,
and so on
• File and directory names
• System output
• Code
• Commands, their arguments, and argument values
• Code variables
• Command variables
• Commands you enter into a command line interface
• System output emphasized for scannability
WARNING! Indicates that failure to follow directions could result in bodily harm or death, or in
irreversible damage to data or to the operating system.
CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.
NOTE: Provides additional information.
Required
Indicates that a procedure must be followed as directed to achieve a functional and supported
implementation based on testing at HP.
HP 3PAR branding information
• The server previously called "InServ" is now called "HP 3PAR StoreServ Storage system."
• The operating system previously called "InForm OS" is now called "HP 3PAR OS."
• The user interface previously called IMC (InForm Management Console) is now called "HP
3PAR Management Console."
• All products previously called “3PAR” products are now called "HP 3PAR" products.
Typographic conventions 19
7 Documentation feedback
HP is committed to provide documentation that meets your needs. To help us improve the
documentation, send any errors, suggestions, or comments to Documentation Feedback
(docsfeedback@hp.com). Include the document title and part number, version number, or the URL
when submitting your feedback.
20 Documentation feedback
Glossary
MPIO Multipath I/O
MSDN Microsoft Developer Network
RM Recovery Manager
RMD HP 3PAR Recovery Manager Diagnostics
RMV HP 3PAR Management Plug-in and Recovery Manager Software for VMware® vSphere™
WMI Windows Management Interface
21
Loading...