 |
» |
|
|
 |
This page is organized
by symptom, each of which is followed by possible indicators or causes
to investigate. To check logs containing Application Discovery messages,
see the following locations: /var/opt/vse/logs/appdiscovery_*.log.* (on HP-UX CMS) C:\Program Files\HP\Virtual Server Environment\vse\logs\appdiscovery_*.log.* (on Microsoft® Windows® CMS)
Errors in Installation |  |
Failure message on installation of Application Discovery agent (AppDiscAgent)Check that OpenSSL is installed on the managed node and that it is
free of outstanding security issues. To learn about the latest security bulletins, check http://www.openssl.org/news. Check that HP WBEM Services software is installed on the managed
node and that it is a compatible version. To obtain a new version of HP WBEM Services for HP-UX,
go to the Security and manageability page on HP Software Depot web
site (http://software.hp.com/). Find 'WBEM Services for HP-UX'. For details on which
is the appropriate version to download by operating system version,
please consult the VSE Management Software Installation
and Update Guide system requirements for WBEM. AppDiscAgent
runs with any 2.x version of HP WBEM Services for HP-UX. To obtain a new version of HP WBEM Services for
Linux, go to the Internet ready and networking page on HP Software Depot web
site (http://software.hp.com/). Find HP WBEM Services for Linux, and click the download link. Check that the Application Discovery WBEM provider has been installed on the
managed node. Type
the following command on the command line of the managed node: # cimprovider -l -m AmgrAgentProviderModule
AmgrAgentProvider |
A return of AmgrAgentProvider indicates that the WBEM provider is installed. If this value is not returned, first clean up
the provider by typing: # /opt/amgr/bin/agent_wbem_cleanup
Removing the AmgrAgentProvider
|
Then configure the provider by typing the following
on the command line: # /opt/amgr/bin/agent_wbem_config
Loading Application Discovery schema
Loading Application Discovery metadata |
See also: Errors Due to Incompatibilities Between
Different Versions of Application Discovery Agents and Servers Data Missing in Application Discovery Screens |  |
Issues listed in this section include the following: Applications Not Visible in Application Discovery ScreensConfirm
that your user login has the appropriate permissions on the host where
the application resides, including appropriate user authorization on HP SIM. Check that the application is not hidden from view in the application
table. Tables that list applications
are preceded by the 'Application Visibility' drop-down that
lets you toggle to Show hidden apps. Select this
option and scan the table for your application. Also, check that no filters are in operation in
the table. (If one or more filters have been applied to the table,
they are listed on the right in the dark gray table header bar.) To
remove current filters, right-click anywhere on the table, and select Clear all filters. If you cannot find the application, Application Discovery is
not currently recognizing the application as matched to a template. Check that Application Discovery is showing that the discovery ratio is 100%. Click the following tabs in Application Discovery: Admin/Config, then Discovery. Find the following column headings in the data table
on this screen. Check that the value for Discovery ratio is 100%. When the discovery ratio is less than 100%, this may indicate
that an inventory is still being taken for that host. Expect the warm-up
period for completing the process inventory to take about 20 minutes.
Check that any usage of regular expression syntax in the defining
application template is correct. Application Discovery recognizes regular
expressions constructed using Perl 5 or POSIX syntax and semantics. To learn how to review and change application
template attributes, see “Change AD Application Template Values” Check that any string or regular expression used in the executable
path field of the defining application template describes the desired
running process. Application Discovery differs from Global Workload Manager (gWLM) in how it matches
user input data to discovered applications. gWLM uses a combination
of a fully qualified path and retrieved inode information to find
a process on one managed node. Application Discovery does not infer the location
of running processes based on the presence or location of installed
applications. For broader coverage of all running processes (not just
those associated with installed software packages) within a network
of machines, Application Discovery matches strings and regular expressions exactly
when comparing templates to running processes. It may help to think of the difference between
AD and gWLM this way: In AD, an executable and arg[0] are compared directly
to one another to make a match. In gWLM, the inode of an executable and the inode
of arg[0] are compared to one another to make a match.
See Table 3-3 for a demonstration of the different results
that you can expect when using the same executable and arguments in Application Discovery as
compared to Global Workload Manager (gWLM).To check your application template data against
the process data that Application Discovery has catalogued, you can consult the
following: "Processes unmatched by this template" table for a
particular host. "Applications effected by this template" table.
Or, to see examples of working templates, click the
following tabs: Admin/Config, then AD Templates. Click a template name to see its attributes. |  |  |  |  | NOTE: Where large amounts of data are present in tables,
it can be useful to sort or filter the data to find the exact process and associated
attributes for which you are searching. |  |  |  |  |
Host Not Visible in Application Discovery ScreensCheck that the host appears on the list of hosts managed via HP Systems Insight Manager. An unlisted host is not being managed
via HP Systems Insight Manager, and therefore, cannot be discovered by Application Discovery. To learn how to add a managed system
to HP Systems Insight Manager's system list, see “Setting up
managed systems” in HP Systems Insight Manager User Guide. Check that
an Application Discovery agent is running on the managed host. To view
the list of hosts running an Application Discovery agent, click the Admin/Config tab, and then the Agents tab. The Agents tab lists all discovered hosts
running the Application Discovery agent. Check that the host is marked as 'visible' in Application Discovery. Click the following tabs
in Application Discovery: Admin/Config, then Discovery. Find the column heading
"Visible". Hosts marked with 'Y' are currently visible in Application Discovery screens.
Hosts marked with 'N' are hidden.
Check that no firewall is blocking port 22 (used by SSH) or port
5989 (used by WBEM) on managed systems. Unblock
the ports. Once this action is taken, check that Application Discovery is
receiving messages from the host. (See #8 in this section.) Check that the managed node has been configured to allow remote command
execution by the CMS. To
set the managed node to allow remote command execution, type the following: /opt/mx/bin/mxagentconfig -a -n hostname -u root |
Once this action is taken, check that Application Discovery is
receiving messages from the host. (See #8 in this section.) Check that SSH is configured correctly on the managed node . In this case, you may need to repair the HP Systems Insight Manager agent
on the managed system. Click the following menu selections: Configure, then Configure or Repair Agents. Make sure to check the box for 'configure SSH access'
before running the repair agent. To verify that the repair action has resolved
any SSH configuration problem, you can issue a remote ls command toward the managed system by doing the following: Select Tools Command Line Tools UNIX/Linux ls... In the text field, type /tmp
If the contents in /tmp are visible,
then SSH is working correctly.If the configuration is still not working, you
may see an error message: Ssh Operation failed for node:managed_node.
The connection could not be established.
Reason:Failed to read remote identification |
In conjunction with this, you may also notice
that running mxagentconfig and selecting Configure Configure or Repair Agents fail on the target managed node. To reconfigure SSH on the managed node, do the
following steps: Log
on the managed node as user root. # cd /.ssh /* <root_user_home_directory>/.ssh */ # rm * /* Erase all
possible corrupted contents */ # ssh-keygen -b 2048 -t rsa /* Generate root ssh key */ # ps -elf|fgrep sshd /* Find the sshd PID */ # kill -1 <pid> /* Re-start sshd */ # mxagentconfig -a -n managed_node # amgr_remote_config -a -n managed_node -mx
Once this action is taken, check that Application Discovery is
receiving messages from the host. (See #8 in this section.) Check that the WBEM connection is working correctly on the managed
node. To check the status of the WBEM connection,
do the following in Application Discovery user interface: Click the AD Agents tab. Look for the WBEM Stat column in the 'Hosts/Agents' table. If the status message for WBEM is not 'OK', do the following: Check that HP Systems Insight Manager CMS has
an authorized logon with the managed system. See Appendix E to complete this authorization. Alternatively, you can configure the managed system's WBEM
authorization to trust the CMS to perform a remote "root" WBEM user
logon. Do this by clicking Configure Configure or Repair Agents. Make sure to mark the box for 'Configure WBEM client certificate
authentication' before you run the tool. Once this action is taken, check that Application Discovery is receiving
messages from the host. (See #8 in this section.)
Check that Application Discovery is receiving
messages from the host. Click the following tabs
in Application Discovery: Admin/Config, then AD
Agents. Find the column headings
providing message data on the far right of the data table on this
screen. Check that the cells have data and that the time stamp is
within the period set by the Global Host/Process Interval selector
on that screen.
See also: Errors Due to Incompatibilities Between
Different Versions of Application Discovery Agents and Servers Packages Not Visible in Application Discovery Screens
Check that the package is marked
as 'visible' in Application Discovery. Click the following tabs in Application Discovery: Admin/Config , then Packages. Find the column heading "Visible". Packages marked
with 'Y' are currently visible in Application Discovery screens. Packages
marked with 'N' are hidden.
Check that Application Discovery is showing
that total packages and completed packages have the same value. Click the following tabs in Application Discovery: Admin/Config , then Discovery. Find the following column headings in the data table
on this screen. Check that the values for Tot Pkg and Cmplt Pkg are the same, and that the Warmup ratio is 100%. When the values are not the same and the warm-up ratio is less
than 100%, this may indicate that an inventory is still being taken
for that host. Expect the warm-up period for completing the package
inventory to take about 20 minutes.
Application Errors in VSE Workload Screens |  |
Issues listed in this section include the following: Error Message Indicates Application Discovery Server Is Not Available Application Discovery may not be correctly configured. Run vseinitconfig -a on the command
line to correct the configuration of Application Discovery. (See also vseinitconfig(1M.)  |  |  |  |  | TIP: Alternatively, you can run I300appdisc.pl --a on the command line to limit the configuration change to Application
Discovery. |  |  |  |  |
To identify other configuration problems
that may be affecting Application Discovery server, check the “Troubleshooting” notes in the VSE Management Software Help instructions, or use vseassist(1M). Check that Application Discovery server is running on the CMS. On HP-UX, type ps -elf
| grep amgrserver.jar on the command line of the CMS. You
should see a Java process running the Application Discovery server. If you do not see this Java process, type /opt/amgr/bin/cms_start . You must be logged in as user 'root' on the CMS to initiate
this command. On Microsoft Windows, type C:>net
start on the command line of the CMS. You should see a service
called HP Application Discovery in the list of
running services. If you do not see this service, type /opt/amgr/bin/cms_start from any directory in the VSE installed
drive. You must be logged in as Administrator on the CMS to initiate
this command.
No 'Applications' Icon for System Listed on Virtualization Manager Visualization
Tab Screen[ The Application Discovery icon appears on a system shown on the Visualization tab when Application Discovery agent and server are running correctly and the
host system is known to Application Discovery.] Check that Application Discovery server is running on the CMS. On HP-UX, type ps -elf
| grep amgrserver.jar on the command line of the CMS. You
should see a Java process running the Application Discovery server. If you do not see this Java process, type /opt/amgr/bin/cms_start . You must be logged in as user 'root' on the CMS to initiate
this command. On Microsoft Windows, type C:>net
start on the command line of the CMS. You should see a service
called HP Application Discovery in the list of
running services. If you do not see this service, type /opt/amgr/bin/cms_start from any directory in the VSE installed
drive. You must be logged in as Administrator on the CMS to initiate
this command. Check that the host is known to Application Discovery. Click the following tabs in Application Discovery: Admin/Config, then Discovery. Find the column heading "Host".
Hosts recognized by Application Discovery are listed here. If the host that you
are looking for is not listed here, it may be that you need to deploy
an agent on the host so that the host is recognized and inventoried
by Application Discovery.
No 'by application' Entry in VSE Workload Definition
Criteria Drop-down Check that Application Discovery server is running on the CMS. On HP-UX, type ps -elf
| grep amgrserver.jar on the command line of the CMS. You
should see a Java process running the Application Discovery server. If you do not see this Java process, type /opt/amgr/bin/cms_start . You must be logged in as user 'root' on the CMS to initiate
this command. On Microsoft Windows, type C:>net
start on the command line of the CMS. You should see a service
called HP Application Discovery in the list of
running services. If you do not see this service, type /opt/amgr/bin/cms_start from any directory in the VSE installed
drive. You must be logged in as Administrator on the CMS to initiate
this command. Check that the host is known to Application Discovery. Click the following tabs in Application Discovery: Admin/Config, then Discovery. Find the column heading "Host".
Hosts recognized by Application Discovery are listed here. If the host that you
are looking for is not listed here, it may be that you need to deploy
an agent on the host so that the host is recognized and inventoried
by Application Discovery.
No Indicators Showing in VSE Workload Real-Time Utilization
Meters This information applies to workloads associated
with Application Discovery applications. Check that the Application Discovery agent is running. Click the
following menu choices in HP Systems Insight Manager: Configure Configure VSE Agents Check AD Agent States . Follow
the instructions for selecting hosts and checking agent state. If the Application Discovery agent is installed, but is not running, click Configure Configure VSE Agents Start AD
Agents and follow the instructions for
selecting hosts and starting agents. Check that Application Discovery agent is writing process maps for this workload
on the managed system. Log
on to the managed system. Go
to /var/opt/amgr/procmaps . Check
for the existence of files. Note that file names are internally generated
and do not have a logical correlation with user-known names; specifically
there is no correlation to user-assigned workload names. Check
the file timestamps. If any file is more than 60 seconds old (this
is already conservative), process maps are not being updated.
If you confirm that process maps are not being
updated, you can try the following actions to get process maps working
correctly. Check that the workload is defined for this host. A workload receives process
maps only for the host or hosts for or on which it is deployed. To
check that a workload is defined for a host, click the Workloads tab
in Virtualization Manager. You may need to modify a workload to include this
host or create a new workload for it. For
help on this topic, see the Virtualization Manager Help reference. Check to see if the workload is parked. A
parked workload does not generate process maps anywhere. Process maps
that existed prior to parking the workload are deleted. See the discussion
of “General Workload Properties” in Virtualization Manager Help and the glossary for information about parked workloads. Check to see that the application associated with the workload is
currently running. In Application Discovery, click the Applications tab. Then, under the Running tab, sort
by host. (Click the 'Host' column header to toggle the list
to sort in ascending or descending alphabetical order.) To rule out
the possibility that the running application is hidden, click the
drop-down menu above the 'Application Instances' to 'Show
hidden apps'. If the application that you are looking for is
not in this list, you must run the application so that it can be discovered. Check that Application Discovery server is running on the CMS. On HP-UX, type ps -elf | grep amgrserver.jar on the command line of the
CMS. You should see a Java process running the Application Discovery server. If you do not see this Java process, type /opt/amgr/bin/cms_start . You must be logged in as user 'root' on the CMS to initiate
this command. On Microsoft Windows, type C:>net
start on the command line of the CMS. You should see a service
called HP Application Discovery in the list of
running services. If you do not see this service, type /opt/amgr/bin/cms_start from any directory in the VSE installed
drive. You must be logged in as Administrator on the CMS to initiate
this command.  |  |  |  |  | NOTE: If none of these measures are sufficient, other
underlying problems may be the cause. See also the suggestions in “Host Not Visible in Application Discovery Screens” that relate to communication
between the Application Discovery server and the WBEM provider and between the
WBEM provider and the Application Discovery agent. |  |  |  |  |
Errors in Application Discovery User Interface Operation |  |
Issues listed in this section include the following: UI “Unable to Connect to Server” Messages Application Discovery might not be correctly configured. Run vseinitconfig -a on the command
line to correct the configuration of Application Discovery. (See also vseinitconfig(1M.)  |  |  |  |  | TIP: Alternatively, you can run I300appdisc.pl --a on the command line to limit the configuration change to Application
Discovery. |  |  |  |  |
To identify other configuration problems that
might be affecting Application Discovery server, check the “Troubleshooting” notes in the VSE Management Software Help instructions, or use vseassist(1M). Check that Application Discovery server is running on the CMS. On HP-UX, type ps -elf
| grep amgrserver.jar on the command line of the CMS. You
should see a Java process running the Application Discovery server. If you do not see this Java process, type /opt/amgr/bin/cms_start . You must be logged in as user 'root' on the CMS to initiate
this command. On Microsoft Windows, type C:>net
start on the command line of the CMS. You should see a service
called HP Application Discovery in the list of
running services. If you do not see this service, type /opt/amgr/bin/cms_start from any directory in the VSE installed
drive. You must be logged in as Administrator on the CMS to initiate
this command.
Java 'UI exception' Message Displays'UI exception' errors indicate that
a problem internal to the Application Discovery user interface exists. Please
contact HP to report the error and receive assistance. See Chapter 5 . Errors Due to Incompatibilities Between Different Versions
of Application Discovery Agents and Servers |  |
Because not all versions of Application Discovery agent communicate
with all versions of Application Discovery server, diagnosing problems
with agent-server communication can be simplified by first checking
that the Application Discovery server that you are running on your
CMS is compatible with the agents that you are running on your managed
systems. For version 4.1 of Application Discovery server, the following
statements are true: The version 4.1 server can communicate with 4.x versions
of the agent. The version 4.1 server cannot communicate with 3.x
agents. The version 4.0 server cannot communicate with 4.1
agents.
In addition, it will help to keep in mind the following information: The version 4.1 agent does not require Application
Discovery certificate exchange in order to secure server-agent communication
between itself and the version 4.1 server. In Version 4.1, Application
Discovery relies on standard VSE authorizations that do not require
an additional certificate exchange.
The version 4.0 agent does require
Application Discovery certificate exchange. Therefore, certificate
exchange must occur for the 4.1 server to communicate with a 4.0 agent.
Therefore, for ease of use, HP recommends that you update Application
Discovery agent to version 4.1 on managed systems when you update
Application Discovery server on the CMS to version 4.1. If you find that you have version 4.0 agents within your computing
network, and you suspect that there are problems in the agent-server
communication, the following troubleshooting information may be helpful. If you are running a version 4.0 Application Discovery agent
on a managed node (or on a CMS server on HP-UX), check that the Application Discovery agent
certificate has been installed on the managed node (or CMS server). Type the following on the command line
of the system of concern: # ls /var/opt/amgr/ssl/agent_cert.pem
/var/opt/amgr/ssl/agent_cert.pem |
If agent_cert.pem is not listed,
you can create the certificate by typing the following on the command
line: # /opt/amgr/bin/make_agent_cert
Host name is xyz.cup.hp.com
...
Finished agent certificate creation. |
See Appendix D. The Application Discovery agent starts running
(and begins sending data to the Application Discovery server) on completion of
the certificate exchange. If you are updating VSE in
an environment that includes Linux managed nodes, check that the Application
Discovery agent updated to the latest version on the Linux managed
nodes. You will know this step is necessary
when starting the AD agents fails with the following error: Missing directory /var/opt/amgr/ssl |
To fix this error, do one of the following: On the managed node(s), run the command: /opt/amgr/bin/make_agent_cert |
Then, from the CMS user interface, run Configure Configure VSE Agents Start AD Agents for the affected
node(s). Or, uninstall the previous version
of AD agent from each Linux managed node using the following commands. to list the AD agent package installed
on the machine, then: Next, from
the CMS user interface, install the correct agent: Configure Configure VSE Agents Install Linux VSE Agents Then, run Configure Configure VSE Agents Start AD Agents for the affected node(s).
If you are running a 4.0 agent
on a managed node, and the node is not visible in Application Discovery, check the following in addition to the advice given in this section
(above) and in “Host Not Visible in Application Discovery Screens”: Click the Admin/Config tab and then
the Events tab. Check the setting for the entry “Application Discovery
agent accessible”. For 4.0 agents, this setting must be set to “Show in AD” for managed nodes to be listed
within Application Discovery screens. For more information
on using these events settings, see “Introduction to Event Settings in Application Discovery”.
|