You are on page 1of 13

HP Insight Remote Support Software

Installation Advisor Readme v.A.05.50.200

Legal notices Copyright 2010 Hewlett-Packard Development Company, L.P.; Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.

Contents
1-1 Overview ........................................................................................................................................................ 2 1-2 Installation Advisor Contents .......................................................................................................................... 2 1-3 Using the Installation Advisor ......................................................................................................................... 3 1-3-1 Using the Installation Advisor on the Central Management Server/Hosting Device .............................. 3 1-3-1-1 Install HP Insight Remote Support ............................................................................................... 3 1-3-1-2 Use LaunchWHC to verify that event protocols are configured properly ...................................... 3 1-3-1-3 Use InsightRsDataCollectionCheck to verify and/or trigger data collections ............................... 4 1-3-1-4 Verifying connectivity to HP data center ....................................................................................... 6 1-3-1-5 Collecting Logs to Attach to a Support Case ................................................................................ 6 1-3-2 HP-UX Endpoint Configuration Assistants ............................................................................................ 6 1-3-2-1 InsightRsPrereqCheckv24.sh ....................................................................................................... 6 1-3-2-2 InsightRsHpuxSetup.sh ................................................................................................................ 7 1-4 Appendices .................................................................................................................................................... 7 1-4-1 Appendix A: Example Output: Desta LaunchWHC................................................................................ 7 1-4-2 Appendix B: Example Output: InsightRsHpuxSetup.sh (previously known as rspCheck08.sh.) ....... 8 1-4-3 Appendix C: Example Output: InsightRsPrereqCheckv24.sh (previously known as TestRSPv24.sh) ...................................................................................................................................................................... 11

Second Edition: June 2010

1-1 Overview
HP Insight Remote Support Standard and Advanced provides two types of functionality: 1. Submits Incidents when monitored systems in your enterprise have hardware problems 2. Optionally sends configuration collections to your hardware vendor so sales consultants can help you make the most efficient and cost effective future purchasing decisions Some customers have had problems verifying that all managed systems in their enterprises are configured to properly communicate with the Central Management Server/Hosting Device and to HP. The Service Health tab, initially released in Insight Remote Support version A.05.50, provides utilities that help resolve these problems. More information about the Service Health Tab is available from: Insight Remote Support Standard: Insight Remote Support Standard Hosting Device Configuration (http://www.hp.com/go/insightremotestandard-docs) Insight Remote Support Advanced: Insight Remote Support Advanced CMS Configuration and Usage Guide (http://www.hp.com/go/insightremoteadvanced-docs)

This Installation Advisor provides additional utilities that are suitable for both HP Insight Remote Support Advanced (Insight RSA) and HP Insight Remote Support Standard (Insight RSS) installations. These Utilities: Verify managed systems are communicating properly Collect all relevant log files if a problem is encountered Configure monitored endpoint devices to communicate properly Verify that Insight Remote Support data collections are working

1-2 Installation Advisor Contents


The Installation Advisor contains tools to configure and verify the function of the Central Management Server/Hosting Device and the managed devices in your environment. These tools can be used to test that a system is prepared to install the HP Insight Remote Support (Insight RS) software and to test that a previously installed HP Insight RS environment is still running properly.

Table 1 Installation Advisor Contents Utility Name


WEBES utility: Desta LaunchWHC InsightRsDataCollectionCheck.exe CollectRsLogs InsightRsPrereqCheck InsightRsHpuxSetup

Function
Post-install Configuration & Troubleshooting Troubleshooting Troubleshooting Pre-Install Setup Configuration

Used On
CMS/Host Device CMS/Host Device CMS/HostDevice Monitored HP-UX Device Monitored HP-UX Device

1-3 Using the Installation Advisor


The Installation Advisor contains utilities to run on a Central Management Server/Host Device and Monitored HP-UX devices. The procedure for each device type is detailed below.

1-3-1 Using the Installation Advisor on the Central Management Server/Hosting Device
1-3-1-1 Install HP Insight Remote Support
Install HP Insight Remote Support Standard or Advanced as described in the remote support documentation. Discover devices, and configure data collections if desired.

1-3-1-2 Use LaunchWHC to verify that event protocols are configured properly
Use the Desta LaunchWHC utility to verify WEBES event protocols from endpoints to the Central Management Server/Hosting Device: IMPORTANT: This command only verifies WEBES connectivity. This command does not check systems monitored with OSEM. OSEM will be obsolete and replaced by WEBES in late 2009. Please see the migration appendix in the CMS migration utility document for further information. 1. Check your version of Web Based Enterprise Services (WEBES) through add/remove programs. If it is less than version 5.6 patch 1:
a. Run net stop desta_service b. Rename <InstallDir>/svctools/common/jars/WebesHealthChk.jar to

WebesHealthCheck.jar1
c. Place the WebesHealthChk.jar file from the Installation Advisor in this folder d. Run net start desta_service

2. Open a command window. For every device you are monitoring, execute desta.bat LaunchWHC hostname
a. This will generate output about the connection protocols used to communicate with the

device and their states. Ignore any output related to MC3 providers. The first section of output to pay attention to is the listing of device protocols used. For example: ELMC Protocol: DefaultELMC SNMP Protocol: DefaultSNMP WBEM Protocol: Not Assigned Use this output to determine what sections are relevant further down in the output. In this example we would want to check the information further down about the DefaultELMC and DefaultSNMP protocols, but ignore any problems reported with the WBEM protocol.
b. Scan the output to verify that no problems were reported for any of the protocols used. In

this example, the following example indicates that no problems were found with the ELMC Protocol. ----------------------ELMC Protocol Test

SUCCESS -> Protocol Name: DefaultELMC *Assigned* SUCCESS -> Protocol Name: CVEVA ----------------------c. Ignore any warnings or errors relating to unused protocols. In this example we would

ignore the following output because this protocol is not used. ----------------------WMI Protocol Test No WMI Protocols Defined ----------------------d. When warnings or errors are reported for protocols that are in use:

If a failure with a particular protocol is reported, determine if the protocol is really appropriate for the device. If the protocol is appropriate for the device, use the remote support documentation to troubleshoot and repair the protocol. The Installation Advisor contains utilities to help configure and set up protocols on monitored Windows and HP-UX devices. See sections below for more information. If the protocol is not appropriate for the device, you can remove the protocol using the Remote Support Standard and Advanced user interfaces. After repairing or removing the protocol for the device, you can re-run Desta.bat LaunchWHC hostname to verify that no more problems are reported.

1-3-1-3 Use InsightRsDataCollectionCheck to verify and/or trigger data collections


To test that monitored systems can run data collections, execute InsightRsDataCollectionCheck.exe. This will bring up the following user interface that lists all devices configured to send collections:

When the application opens it verifies the results of previously run collections. The date that the collections were run is displayed in the Collection Time column. Clicking Run Collection and Verify Results of Selected Devices will run a new collection on every selected device and analyze the results. If a collection on a device takes more than five minutes to run (which is typical of many missioncritical Remote Support Advanced collections), the utility will indicate that the collection took too long and move on to the next device. The collection will continue to run in the background. After the collection eventually completes, clicking Refresh will display the results and the time at which the collection eventually completed. Any collection that came back empty, was timed out, or was not able to be run will be highlighted in red. The specific problem will be listed in the collection_error column. See the section on Data Collection Failures in this document for more information. When exiting the Interface, you will be prompted to optionally send data to HP to improve the product. If you select yes, the troubleshooting kit will attempt to send an xml representation of the table to HP via an RS Client submit data call. This will only succeed if the RS Client is installed and operational.

Data Collection Failures


Known failure modes include: Return Code of ucadmin.exe = 1, and no collection is generated: The socket used by SOAP is corrupted. Rebooting the host device typically fixes the problem. Collection_Error= ERROR: SNMP agents are not installed or set up properly - SnmpMgrRequest returned error (40) Check the setup of SNMP agents on the monitored devices. ERROR: Namespace specified cannot be found - 0x8004100E The Providers are probably not installed. ERROR: WMI providers are not installed properly or the user credentials are wrong 0x80070005 The hostname of the monitored device may not be correct check that the name is correct in the user interface. Also check the setup of the WMI agents on the monitored devices and that they are using valid credentials.

ConnectServer() failed (HRESULT=0x800706BA). Collection halted Verify connectivity between the host device and monitored server.

1-3-1-4 Verifying connectivity to HP data center


Insight Remote Support Advanced:
It is possible to check connectivity to the HP datacenter by generating an incident on the monitored device and checking that its status is changed to indicate that it has been received and closed in HP SIM. Please see the Remote Support usage guide for more information. Connectivity status is also available in the Service Health tab in the Insight Remote Support interface. The Service Health tab is described in detail in the Insight Remote Support Advanced CMS Configuration and Usage Guide available from http://www.hp.com/go/insightremoteadvanced-docs

Insight Remote Support Standard:


Connectivity status is also available in the Service Health tab in the Insight Remote Support interface. The Service Health tab is described in detail in the Insight Remote Support Standard Hosting Device Configuration available from http://www.hp.com/go/insightremotestandard-docs

1-3-1-5 Collecting Logs to Attach to a Support Case


HP Insight Remote Support software comprises of many different software components, each with many different log files. This can make it challenging to get all the relevant log files to HP Support. To gather all appropriate log files, execute: collectRsLogs.bat This will create a zip file in the C:\temp\Tools_Check folder. This folder will be created if it does not exist. Ignore any output about services not runningthis is not relevant to the log file collection. This zip file can be attached to a support case and should provide HP Support with all the supporting data they need to troubleshoot your case.

1-3-2 HP-UX Endpoint Configuration Assistants


The Installation Advisor includes two utilities to assist in the setup of monitored HP-UX devices: InsightRsHpuxSetup.sh and InsightRsPrereqCheckv24.sh To use these utilities, simply copy them to a monitored HPUX device and execute them.

1-3-2-1 InsightRsPrereqCheckv24.sh
InsightRsPrereqCheckv24.sh is typically run on an HP-UX device prior to configuring it to be monitored by Remote Support. This script verifies that all remote support prerequisites are met. Execute this script on the HP-UX device, follow any recommendations it suggests, and then re-run the script to verify that the system is ready to be monitored. InsightRsPrereqCheck was previously known as TestRSPv24.sh Sample output is in the appendix below. Once InsightRsPrereqCheckv24.sh reports success, execute InsightRsHpuxSetup.sh.

1-3-2-2 InsightRsHpuxSetup.sh
InsightRsHpuxSetup.sh is a set of scripted configuration steps that help you configure necessary software on HP-UX systems for remote support. Execute this script on the HP-UX device and follow the steps it suggests. At the end of a successful execution of this script, the system should be ready to be discovered by Insight Remote Support. Go back to the Central Management Server/Hosting Device and configure Insight Remote Support to monitor the HP-UX device. InsightRsHpuxSetup.sh was previously known as rspCheck08.sh. Sample output of InsightRsHpuxSetup.sh is in the appendix below.

1-4 Appendices
1-4-1 Appendix A: Example Output: Desta LaunchWHC
Webes Protocol Analyzer ----------------------Address Lookup Test webes-harry.fc.hp.com address = webes-harry.fc.hp.com/15.6.34.251 ----------------------Located Managed System for host webes-harry.fc.hp.com Database ID = 90f14a2f2411bc64012411c3233e0008 ELMC Protocol: Not Assigned SNMP Protocol: DefaultSNMP WBEM Protocol: HPUX ----------------------Generate MC3 CSID No MC3 CSID Returned ----------------------Generate SNMP CSID No SNMP CSID Returned ----------------------Generate WBEM CSID <?xml version="1.0" encoding="UTF-8"?> <HP_OOSIdentifiers> <CSID> <Section name="SYSTEM_IDENTIFIERS"> <Property name="TimestampGenerated" value="2009/10/01 14:30:29 MDT" /> <Property name="CoreSystemModel" value="ia64 hp server rx4640" /> <Property name="UserApprovedSystemSerialNumber" value="" /> <Property name="AutoDetectedSystemSerialNumber" value="USE4439HAA" /> <Property name="CsidRule" value="HPUX" /> <Property name="CollectorVersion" value="V5.6 (Build 128)" /> <Property name="IpAddress" value="15.6.34.251" /> <Property name="UserApprovedProductId" value="" /> <Property name="CollectorType" value="WEBES" /> <Property name="Manufacturer" value="HP" /> <Property name="MacAddress" value="00306E5DC3FA" /> 7

<Property name="SPID" value="-1" /> <Property name="GDIDSIDSchemaVersion" value="1.2" /> <Property name="CollectorSource" value="WBEM" /> <Property name="HPID" value="-1" /> <Property name="SystemIdent" value="48ece13b-2734-11d9-8ef6-886231873f18" /> <Property name="OSNameAndVersionString" value="HP-UX B.11.23" /> <Property name="CsidRuleVersion" value="2.0" /> <Property name="FQDN" value="webes-harry.fc.hp.com" /> <Property name="Hostname" value="webes-harry" /> </Section> <Section name="NETWORK_INTERFACE_IDENTIFIERS"> <Property name="InterfaceMacAddress" value="00306E5DC3FA" /> <Property name="InterfaceIpAddress" value="15.6.34.251" /> <Property name="InterfaceName" value="lan0" /> <Property name="InterfaceDescription" value="lan0 HP PCI 1000Base-T Release B.11.23.0712" /> </Section> <Section name="NETWORK_INTERFACE_IDENTIFIERS"> <Property name="InterfaceMacAddress" value="00306E5DC3FB" /> <Property name="InterfaceName" value="lan1" /> <Property name="InterfaceDescription" value="lan1 HP PCI 1000Base-T Release B.11.23.0712" /> </Section> </CSID> </HP_OOSIdentifiers>

----------------------ELMC Protocol Test FAILURE -> Protocol Name: DefaultELMC ----------------------Command View Protocol Test No Command View Protocols Defined ----------------------SNMP Protocol Test SUCCESS -> Protocol Name: DefaultSNMP *Assigned* ----------------------WBEM Protocol Test SUCCESS -> Protocol Name: HPUX *Assigned* ----------------------WMI Protocol Test No WMI Protocols Defined -----------------------

1-4-2 Appendix B: Example Output: InsightRsHpuxSetup.sh (previously known as rspCheck08.sh.)


# ./InsightRsHpuxSetup.sh ######################################################################################## 8

######## RSP Installiationcheck for RSP 5.20 Version 0.4 2009_03_05..2009_04_21 #########################################################################################

read installed Software done

######## ########################### reflist used for B.11.23 ################################## #B_11_23#PRODUCT #PHKL_34795 #B_11_23#PRODUCT #PHKL_36288 #B_11_23#PRODUCT #PHSS_35055 #B_11_23#PRODUCT #PHSS_37552 #B_11_23#PRODUCT #PHSS_37947 #B_11_23#PRODUCT #PHSS_36345 #1.0 #1.0 #1.0 #1.0 #1.0 #1.0 #Cumulative IPMI driver patch #Cumulative diag2 driver and vPars enablement #aC++ Runtime #Aries cumulative patch #linker + fdp cumulative patch #Integrity Unwind Library #HP-UX System Management Homepage - Web#WBEM Services CORE Product #HPUX System Fault Management #HPUX 11.23 Support Tools Bundle

#B_11_23#PRODUCT #SysMgmtHomepage #A.2.2.7 Based User Interfaces #B_11_23#PRODUCT #WBEMServices #A.02.05.08 #B_11_23#BUNDLE #SysFaultMgmt #B.05.00.05 #B_11_23#BUNDLE #OnlineDiag #B_11_23#PRODUCT #openssl #B.11.23.10.05

#A.00.09.07i.012 #Secure Network Communications Protocol #A.2.2.7 #HP-UX Web Based System Management User

#B_11_23#BUNDLE #SysMgmtWeb Interfaces #B_11_23#BUNDLE #QPKBASE

#B.11.23.0712.070a #Base Quality Pack Bundle for HP-UX 11i v2 #HP-UX Apache-based Web Server

#B_11_23#PRODUCT #hpuxwsAPACHE #A.2.0.49

######################################################################################### Recommended Software: PHKL_34795 1.0 Cumulative IPMI driver patch Installed Software: PHKL_34795 1.0 Cumulative IPMI driver patch Recommended Software: PHKL_36288 1.0 Cumulative diag2 driver and vPars enablement Installed Software: PHKL_32653 1.0 Cumulative diag2 driver and vPars enablement mismatch ***** Recommended Software: PHSS_35055 1.0 aC++ Runtime Installed Software: PHSS_35055 1.0 aC++ Runtime (IA: A.06.10, PA: A.03.71) Recommended Software: PHSS_37552 1.0 Aries cumulative patch Installed Software: PHSS_38526 1.0 Aries cumulative patch Recommended Software: PHSS_37947 1.0 linker + fdp cumulative patch Installed Software: PHSS_38134 1.0 linker + fdp cumulative patch Recommended Software: PHSS_36345 1.0 Integrity Unwind Library Installed Software: PHSS_34859 1.0 Integrity Unwind Library ***** version mismatch ***** ***** version

Recommended Software: SysMgmtHomepage A.2.2.7 HP-UX System Management Homepage - Web-Based User Interfaces 9

Installed Software: SysMgmtHomepage A.2.2.6.1 HP-UX System Management Homepage - Web-Based User Interfaces ***** version mismatch ***** Recommended Software: WBEMServices A.02.05.08 WBEM Services CORE Product Installed Software: WBEMServices A.02.05.04 WBEM Services CORE Product ***** ***** version mismatch

Recommended Software: SysFaultMgmt B.05.00.05 HPUX System Fault Management Installed Software: SysFaultMgmt B.04.00.06.02 mismatch ***** HPUX System Fault Management ***** version

Recommended Software: OnlineDiag B.11.23.10.05 HPUX 11.23 Support Tools Bundle Installed Software: OnlineDiag B.11.23.09.05 HPUX 11.23 Support Tools Bundle mismatch ***** ***** version

Recommended Software: openssl A.00.09.07i.012 Secure Network Communications Protocol Installed Software: openssl A.00.09.07l.003 Secure Network Communications Protocol Recommended Software: SysMgmtWeb A.2.2.7 Installed Software: SysMgmtWeb A.2.2.6.1 ***** version mismatch ***** HP-UX Web Based System Management User Interfaces

HP-UX Web Based System Management User Interfaces

Recommended Software: QPKBASE B.11.23.0712.070a Base Quality Pack Bundle for HP-UX 11i v2 Installed Software: QPKBASE B.11.23.0706.064 Base Quality Pack Bundle for HP-UX 11i v2 mismatch ***** Recommended Software: hpuxwsAPACHE A.2.0.49 HP-UX Apache-based Web Server ***** version

Installed Software: hpuxwsAPACHE B.2.0.58.01 HP-UX Apache-based Web Server

######################################################################################### ######## WARNING, this script does not check all necessary SW dependencies ######## checks not mentioned above are not done ######## please consult most recent RSP prerequisites manual ######################################################################################### ........checking now for old software to be removed as a prerequisite for RSP..... WARNING: must remove any software containing substring ISEEPlatform before migrating to RSP !!! ISEEPlatform A.03.95.500.44.05 ISEE Platform

OK: Software containing substring WEBES is not found with swlist, this is a prerequisite for RSP installation OK: Software containing substring availability is not found with swlist, this is a prerequisite for RSP installation OK: Software containing substring VAEH is not found with swlist, this is a prerequisite for RSP installation OK: Software containing substring CCMON is not found with swlist, this is a prerequisite for RSP installation

ERRROR: occured on Softwarecheck on host splash B.11.23 see filename: ./InsightRsHpuxSetup.sh_splash.log as listed here

10

Patch PHKL_36288 or newer must be installed Patch PHSS_36345 or newer must be installed SysMgmtHomepage Version to low WBEMServices Version to low SysFaultMgmt Version to low OnlineDiag Version to low SysMgmtWeb Version to low QPKBASE Version to low Installed:A.2.2.6.1 Needed minimum: A.2.2.7

Installed:A.02.05.04 Needed minimum: A.02.05.08 Installed:B.04.00.06.02 Needed minimum: B.05.00.05 Installed:B.11.23.09.05 Needed minimum: B.11.23.10.05 Installed:A.2.2.6.1 Needed minimum: A.2.2.7 Needed minimum: B.11.23.0712.070a

Installed:B.11.23.0706.064

WARNING: must remove any software containing substring ISEEPlatform before migrating to RSP !!!

1-4-3 Appendix C: Example Output: InsightRsPrereqCheckv24.sh (previously known as TestRSPv24.sh)


# sh InsightRsPrereqCheckv24.sh ============================== Personal Productivity Tool to perform initial checks for HP-UX readiness to configure Remote Support Pack and a connection to the HP-SIM Server. This tool is version A.00.22. This tool is currently under development. Verify it's reports, in the event of a discrepancy send the this system's /var/adm/sw/products/INDEX file, the output this tool produced and a description of the discrepancy to Brad.Cunningham@hp.com. uname -a : "HP-UX B.11.23 U ia64 2644837219" Current time is : 20-Jul-2009 @ 17:03. ============================== Some questions on your planned configuration before this tool gets started. What is the user name of the CIM user (default=root)? ============================== LDAP appears to be installed but not configured on this system. The messages which may follow about various users, are now simply informational and can be used to ensure consistency of UIDs and GIDs between systems. There is no concern about conflicts with LDAP entries since they are not used in place of the password file. ============================== If this system is entitled to use the HP Support Advanced Configuration

11

Collector (RS-ACC) the user hp_sca will be created in the local password file. You can create this user before installing the HP Advanced Configuration Collector fileset or or leave it to the RS-ACC configuration script to run useradd(1M) to create this user. ============================== ISEE is still installed on this system. It needs to be removed ============================== EMS is monitoring this system. See /etc/opt/resmon/lbin/monconfig for more information. ============================== HP-UX Operating Environment is too old, update from Sept 2004 (May 2005 if vPAR is loaded) or later OE which you can order from: 1) HP's ITRC (http://itrc.hp.com and click on the SUM link) as a part of your paid HP Services Updated Media support agreement 2) Order from HP, ask for the latest HP-UX 11i Version 2 Operating Environment ============================== WARNING: PHKL_36288 or a successor patch is missing. Install the Recommended or latest successor to PHKL_36288 from itrc.hp.com. ============================== WARNING: PHSS_36345 or a successor patch is missing. Install the Recommended or latest successor to PHSS_36345 from itrc.hp.com. ============================== Update Online Diags to B.11.23.10.05 (Dec 2007) or later, you can find the current Diagnostics on the latest Installation DVD set for your HP-UX Operating Environment. You can order this from: 1) HP's ITRC (http://itrc.hp.com and click on the SUM link) as a part of your paid HP Services Updated Media support agreement 2) Order from HP, ask for the latest HP-UX 11i Version 2 Operating Environment ============================== Update SysMgmtWeb to Rev A.2.2.7 (Sep 2007) or later. You can find current version of SysMgmtWeb on the HP Software Depot at http://www.hp.com/go/softwaredepot and search for "SysMgmtWeb" for HP-UX B.11.23. NOTE: SysMgmtWeb version A.2.2.9.1 and later contain an important security fix. ==============================

12

Update SysFaultMgmt to Rev B.05.00.05.01 or later, you can find current version of SysFaultMgmt on the HP Software Depot at http://www.hp.com/go/softwaredepot and search for "SysFaultMgmt" for HP-UX B.11.23. ============================== Update WBEMServices to Rev A.02.05.08 or later, you can find current version of WBEMServices on the HP Software Depot at http://www.hp.com/go/softwaredepot and search for "WBEMSvcs" for HP-UX B.11.23. ============================== WARNING: Some WARNings were issued above, check them to be aware of future trouble spots. ============================== WARNING: You are missing some pre-requirements for RSP, see messages above for more information. Where you are directed to install or update software you should also review the installation documents as this personal productivity tool makes no attempt to correctly figure out which software should be installed first, or which software should be removed before installation or update. ============================== Missing some pre-requirements

13