HP 3PAR Host Explorer 2.1.1 Software User Guide Abstract This document provides the information about installing, configuring, and using the HP 3PAR Host Explorer Software for Solaris SPARC and x86, Linux (RHEL and SUSE), Microsoft Windows, HP-UX, and VMware administrators who are responsible for maintaining the operating environment and HP 3PAR StoreServ Storage system.
© Copyright 2014 Hewlett-Packard company. 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 Introduction...............................................................................................5 HP 3PAR Host Explorer..............................................................................................................5 Related documentation..............................................................................................................5 HP 3PAR documentation.......................................................................................................
Typographic conventions.........................................................................................................32 Index.........................................................................................................
1 Introduction This guide provides information about installing and removing the HP 3PAR Host Explorer on the following platforms: • Microsoft Windows Server 2003, 2008 (32-bit and 64-bit), and 2012 (64-bit) • Linux systems running RHEL 4 update 6 or later; RHEL 5 and RHEL 6, SLES 10, and SLES 11 • SPARC and x86 systems running Solaris 10, and 11 • HP-UX Systems running 11i V3 The guide also provides information about installing, and removing the HP 3PAR Host Explorer for VMware on Microsoft Windows
HP 3PAR documentation Table 1 Documentation list For information about: See: Supported hardware and software platforms The Single Point of Connectivity Knowledge for HP Storage Products (SPOCK) website: http://www.hp.com/storage/spock Locating HP 3PAR documents The HP 3PAR StoreServ Storage site: http://www.hp.com/go/3par To access HP 3PAR documents, click the Support link for your product.
Table 1 Documentation list (continued) For information about: See: Maintaining, servicing, and upgrading 7200 and 7400 storage systems HP 3PAR StoreServ 7000 Storage Service Guide Troubleshooting 7200 and 7400 storage systems HP 3PAR StoreServ 7000 Storage Troubleshooting Guide Maintaining the Service Processor HP 3PAR Service Processor Software User Guide HP 3PAR Service Processor Onsite Customer Care (SPOCC) User's Guide HP 3PAR host application solutions Backing up Oracle databases and using back
2 Installing and removing HP 3PAR Host Explorer This chapter describes how to install, verify, and remove the agent on the following platforms: • Microsoft Windows Server 2003, 2008 (32-bit and 64-bit), and 2012 (64-bit) • Linux systems running RHEL 4 update 6 or later; RHEL 5 and RHEL 6, SLES 10, and SLES 11 • SPARC and x86 systems running Solaris 10, and 11 • HP-UX Systems running 11i V3 The guide also describes how to install, verify, and remove the HP 3PAR Host Explorer for VMware on Microsoft W
1. 2. Log on as the System Administrator. Select Start > Control Panel > Add/Remove Programs. Result: The Add/Remove Programs window appears. 3. Verify HP StoreServ Host Explorer for Microsoft Windows appears in the Currently installed programs column. Installing on Linux (RHEL/SLES) systems To install the Host Explorer agent on a Linux (RHEL/SLES) system: 1. Log on as the root user. 2. Insert the HP 3PAR Host Explorer CD into a CD-ROM drive. 3. Change directory to the CD-ROM drive. 4.
1. 2. Log on as the System Administrator. Issue the following command: # pkginfo -l HostExplorer Installation on HP-UX Systems To install the Host Explorer agent on HP-UX Systems: 1. Log in as the root user. 2. Insert the HP 3PAR Host Explorer CD into a CD-ROM drive. 3. Change to the CD-ROM drive. 4. Issue the following command: swinstall -s HostExplorer-HPUX_11.31.IA-.depot \* Verifying the installation on HP-UX Systems Verify the installation for the HP-UX Systems: 1.
NOTE: h. i. For Windows users on 64-bit systems: • Progra~1 = 'Program Files' • Progra~2 = 'Program Files(x86)' Click OK. Click Apply Changes. Close if any existing command windows are open before you have made these changes, and open a new command window. You cannot reload the environment variables from an active command prompt. Installing Host Explorer for VMware on Microsoft Windows Server systems To install the Host Explorer for VMware on a Microsoft Windows Server 2008 and 2012 system: 1.
3. 4. Select HP StoreServ Host Explorer for Microsoft Windows. Click Remove. Removing the Host Explorer agent from Linux (RHEL/SLES) systems To remove the Host Explorer agent from a Linux (RHEL/SLES) system: 1. Log on as the root user. 2. Issue the following command: • For RHEL: rpm -e HostExplorer-rhel • For SLES: rpm -e HostExplorer-sles Removing the Host Explorer agent from Solaris systems To remove the Host Explorer agent from a Solaris system: 1. Log on as the root user. 2.
3 Using the Host Explorer The chapter provides instructions for using the HP 3PAR Host Explorer. Verifying the Host Explorer package is installed To verify that the Host Explorer package has been installed correctly, see the appropriate section below: • To find out if the product is installed on a Solaris system, see “Verifying the installation on Solaris Sparc/x86 systems” (page 10).
Supporting VMware with FC and iSCSI The HP 3PAR Host Explorer for VMware supports VMware ESX Hosts connected to the HP 3PAR StoreServ Storage systems with FC or iSCSI connectivity. No enclosure devices are presented to ESX Hosts. HP 3PAR Host Explorer for VMware establishes the connectivity between the ESX hosts, and HP 3PAR StoreServ Storage systems using REST calls to the Storage System. Hence, it is recommended to ensure that the HTTPs port 8080, and Web services are enabled on the Storage System.
NOTE: • While creating the Host on HP 3PAR StoreServ Storage system corresponding to ESX Hosts, it is recommended to set "VMWare" persona. • While creating the Host on HP 3PAR StoreServ Storage system corresponding to HP-UX Hosts, it is recommended to set "HPUX" persona.
NOTE: If the GUI doe not launch when opened from the desktop shortcut, then the user has to launch the GUI from the command line to troubleshoot. For more information, see “VMTpdHostExplorer Command” (page 28).
Figure 2 Storage System Configuration Add storage system To add a storage system: 1. Click Add button. The Add Storage System dialog box appears. Figure 3 Add storage system 2. Enter the HP 3PAR StoreServ Storage System IP, User Name, and Password entries, then click OK. Storage System SSL certificate is displayed to the user for validation.
Figure 4 Accept and Save 3. Click the Accept and Save button to accept the SSL certificate, or click Decline button to reject it. If Accept and Save is clicked and if the validation succeeds, then it is added to the list of the storage systems shown under the Storage System Configuration option. If Decline is clicked, then the StoreServ will not be added to the Storage system Configuration.
Validate Storage System Certificate Storage System's Certificate Validation status can be: • Success: If the Storage System SSL certificate is successfully validated by the user. • Failed: If the Storage System SSL certificate is changed, and the push operation is performed by the user after that, or if the previous Storage System SSL certificate validation was rejected.
This option lists all the vCenter credentials that are currently configured. The fields shown are as follows: • vCenter IP - IP for the configured vCenter server. • vCenter Username - User name associated with the vCenter server. Figure 7 vCenter Configuration Add vCenter To add a vCenter: 1. Click Add button. The Add vCenter dialog box appears. 2. Enter the vCenter IP, User Name, and Password entries, then click OK.
Remove vCenter To remove a vCenter: • Select the row containing the entry, then click the Remove button. You can remove one entry at a time. Figure 9 Remove vCenter Configuring ESX Host The ESX Host Configuration option appears as shown in Figure 10 (page 21). This option lists all the ESX Host credentials that are currently configured. The fields shown are as follows: • ESX Host IP - IP for the configured ESX Host. • ESX Host Username - User name associated with the ESX Host.
1. 2. Click Add button. The Add ESX Host dialog box appears. Enter the ESX Host IP, User Name, and Password entries, then click OK. If the validation of the credential succeeds, it is added to the list of ESX Host shown by the ESX Host Configuration option. Figure 11 Add ESX Host Remove ESX Host To remove a ESX Host: • Select the row containing the entry, then click the Remove button. You can remove one entry at a time.
Table 2 Host Explorer Configuration Option Fields Field Description Start Service Starts the Host Explorer service. Stop Service Stops the Host Explorer service. Refresh Service Refreshes or restarts the Host Explorer service. Change Refresh Interval Allows to change the refresh interval that determines the frequency of the host explorer service that checks for the host changes.
Figure 14 Change Refresh Interval 24 Using the Host Explorer
4 TpdHostAgent Command The TpdHostAgent is a simple command line interface for maintaining and managing the various options to be used in conjunction with the Host Explorer daemon on Microsoft Windows, Linux, HP UX, and Solaris operating systems. This command must be run as a Superuser or an Administrator from the host where it is installed. TpdHostAgent Command COMMAND TpdHostAgent DESCRIPTION Command line utility for management of a HP 3PAR Host Explorer.
This option is only available on the Windows operating system. • 1 - Displays error messages. • 2 - Display warning messages and all messages below this level. • 3 - Displays information messages and all messages below this level. • 4 - Displays verbose messages and all messages below this level. • 5 - Displays debug messages and all messages below this level. SPECIFIERS None. RESTRICTIONS None. EXAMPLES Starting the Host Explorer deamon.
HBA0DRVRVER=8.2.0.87.1p HBA0FIRMWARE=1.11A5 (U3D1.11A5), sli-3 HBA0SPEEDCURRENT=4 Gbit HBA1WWN=10000000c9af018d HBA1VEN=Emulex HBA1MODEL=AJ763A/AH403A HBA1DRVR=lpfc HBA1DRVRVER=8.2.0.87.1p HBA1FIRMWARE=1.11A5 (U3D1.11A5), sli-3 HBA1SPEEDCURRENT=4 Gbit HBA2WWN=iqn.1994-05.com.redhat:d29583fa2e2b HBA2VEN=ISCSI HBA2DRVRVER=2.6.18-238.
5 VMTpdHostExplorer Command The VMTpdHostExplorer is a simple command line interface for maintaining, and managing the various options to be used in conjunction with the Host Explorer for VMware. This command must be run as a Superuser or an Administrator from the host where it is installed. VMTpdHostExplorer Command COMMAND VMTpdHostExplorer.bat DESCRIPTION Command line utility for management of a HP 3PAR Host Explorer for VMware. SYNTAX VMTpdHostExplorer.
-ListStoreServ Displays the StoreServ details. -ValidateStoreServCert Validates and saves the StoreServ SSL certificate. -AddInserv Adds the StoreServ details. -RemoveInServ Removes the StoreServ details. -ListInserv Displays the StoreServ details. NOTE: The commands AddInserv, RemoveInserv and ListInserv are deprecated. -AddVCInfo Adds the VCserver user credentials. -RemVCInfo Removes the VCserver user credentials.
EXAMPLES Starting the Host Explorer service. #VMTpdHostExplorer.bat start HP HostExplorer VMware service started successfully Stopping the Host Explorer service #VMTpdHostExplorer.bat stop HP HostExplorer VMware service stopped successfully Checking the status of the Host Explorer service #VMTpdHostExplorer.bat status HP HostExplorer VMware service is running Sending the latest Host Explorer token information to the HP 3PAR StoreServ Storage system. #VMTpdHostExplorer.bat push Data collection started...
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Printing ESX Host [2] related Token information: >>>>>>>>>>>>>>>>>>>>>>>>>>>> TPDAGENTVER=2.1.1 HOSTID=32393636-3335-4753-4832-343948454d56 HNAME=VMware ESXi 5.1.0 build-799733 OS=VMware ESX Server 5.0 OSVER=5.1.0 OSPATCH=799733 ARCH=vmnix-x86 CPU=Intel(R) Xeon(R) CPU E5-2430 0 @ 2.20GHz IP=XX.XXX.XX.XXX VCENTERSERVER=XX.XXX.XX.XXX CLUSTERNAME=ESXCluster CLUSTERSWVER=5.1.0 MPSW=NMP-VMW_SATP_DEFAULT_AA MPSWVER=5.1.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
CAUTION: IMPORTANT: NOTE: TIP: Indicates that failure to follow directions could result in damage to equipment or data. Provides clarifying information or specific instructions. Provides additional information. Provides helpful hints and shortcuts.
Index H HP 3PAR host explorer, 5 I installation on HP-UX systems, 10 installing and removing HP 3PAR Host Explorer, 8 installing and verifying, 8 installing HE for VMware on microsoft windows server systems, 11 installing on linux (RHEL/SLES) systems, 9 installing on microsoft windows server systems, 8 installing on oracle solaris sparc systems, 9 Installing on oracle solaris x86 systems, 9 introduction, 5 P prerequisites of HE for VMware on microsoft windows server systems, 10 R related documentation, 5