HP 5992-3838 User Manual

HP Application Discovery Version 4.0 User's Guide

HP Part Number: 5992-3838
Published: May 2008

© Copyright 2008 Hewlett-Packard Development Company, L.P.

Legal Notices

Confidential computersoftware. 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 informationcontained hereinis subject to change without notice. Theonly warranties for HP products andservices areset 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.

Acknowledgments

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

HP-UX Release 10.20 and later and HP-UX Release 11.00 and later (in both 32 and 64-bit configurations) on all HP 9000 computers are Open

Group UNIX 95 branded products.

Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a U.S. registered trademark of Linus Torvalds.

Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.

Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California.

UNIX is a registered trademark of The Open Group.

Table of Contents

About This Document.......................................................................................................11

Intended Audience................................................................................................................................11

New and Changed Information in This Edition...................................................................................11

Typographic Conventions.....................................................................................................................11

Related Information..............................................................................................................................12

Publishing History................................................................................................................................12

HP Encourages Your Comments..........................................................................................................12

1 Introduction...................................................................................................................13

Features of Application Discovery.......................................................................................................13

2 Components and Concepts.........................................................................................15

Application Discovery Components.....................................................................................................15

Refining Application Discovery...........................................................................................................16

How Discovery Works.....................................................................................................................16

Understand Your Current Discovery State......................................................................................16

Discovery Ratio..........................................................................................................................16

Warm-up Ratio...........................................................................................................................17

Refine Discovery by Checking Agent State.....................................................................................17

Refine Discovery by Creating Application Templates....................................................................18

Understanding Application Templates................................................................................................18

How Memory Usage is Calculated.......................................................................................................19

Understanding Server Resource Consumption....................................................................................19

3 Procedures....................................................................................................................21

Starting Application Discovery.............................................................................................................21

Modifying Agent Behavior...................................................................................................................21

Install the HP Application Discovery Agent on a Managed Node.................................................21

Start the HP Application Discovery Agent.....................................................................................21

Using HP SIM to Start the Agent...............................................................................................21

Starting the Agent from the Command Line.............................................................................21

Stop a Running Agent ....................................................................................................................21

Using HP SIM to Stop the AD Agent.........................................................................................22

Stopping the Agent from the Command Line...........................................................................22

Reconfigure a Running Agent from the Command Line................................................................22

Checking Agent State............................................................................................................................22

Explanation of Agent States............................................................................................................23

Working With Data Views....................................................................................................................23

Adjusting the User Interface............................................................................................................24

Set Screen Data Refresh Interval................................................................................................24

Set General Visibility .................................................................................................................24

Set Color Theme.........................................................................................................................24

Set Number of Table Rows.........................................................................................................25

Change the Data View.....................................................................................................................25

Sort Data in View Tables............................................................................................................25

Filter Data in View Tables..........................................................................................................25

Other Controls Available from Right-Clicking on a View Table...............................................26

Navigate Between Views............................................................................................................26

Table of Contents 3

Navigating with Tabs ...........................................................................................................26

Navigating with Table Links ................................................................................................26

Adjusting Visibility of Applications Within Application Discovery Data Tables...........................26

Set Visibility for Hosts on Application Discovery Screens........................................................26

Set Visibility for Matched Applications.....................................................................................27

Set Visibility for Packages on Application Discovery Screens...................................................27

Modifying the Graphic Display of Application Discovery Server Activity....................................27

The Impact of Discovery on Application Discovery Server Memory Usage.............................27

Modifying the Maximum Size of an Event List...............................................................................28

Setting Data Polling Interval............................................................................................................28

Setting Event Attributes........................................................................................................................29

Introduction to Event Settings in Application Discovery...............................................................29

Setting Event Severity......................................................................................................................29

Setting Alert Location......................................................................................................................29

Managing Application Templates.........................................................................................................30

Find an Application Template.........................................................................................................30

Change AD Application Template Values.......................................................................................30

Create a New Template...................................................................................................................32

Key to Application Template Values...............................................................................................32

Summary Fields and Their Descriptions...................................................................................34

Attribute Fields and Their Descriptions....................................................................................34

Rule Fields and Their Descriptions............................................................................................36

Create an Application Template Rule.............................................................................................37

Create an Aggregation Rule.......................................................................................................37

Aggregation Rule Examples.................................................................................................38

How to Remove Types from the Aggregation Rule...................................................................39

Check Unmatched Processes to Find Application Candidates.......................................................40

Understanding the Tables Showing Unmatched Processes.......................................................40

Using the Table Data to Fill in An Application Template..........................................................40

Filling in the Summary Fields Using Table Data.......................................................................40

Filling in the Template Attribute Fields ....................................................................................41

Filling in the Rule Fields Using Table Data................................................................................41

Backing Up Application Discovery Files..............................................................................................41

4 Troubleshooting and Error Messages.........................................................................43

Introduction..........................................................................................................................................43

Errors in Installation........................................................................................................................43

Failure message on installation of Application Discovery agent (AppDiscAgent)...................43

Data Missing in Application Discovery Screens.............................................................................44

Applications Not Visible in Application Discovery Screens.....................................................44

Host Not Visible in Application Discovery Screens..................................................................46

Packages Not Visible in Application Discovery Screens............................................................48

Application Errors in VSE Workload Screens.................................................................................49

Error Message Indicates Application Discovery Server Is Not Available.................................49

No 'Applications' Icon for System Listed on Virtualization Manager Visualization Tab

Screen.........................................................................................................................................49

No 'by application' Entry in VSE Workload Definition Criteria Drop-down............................50

No Indicators Showing in VSE Workload Real-Time Utilization Meters..................................50

Cannot Enter Application Discovery User Interface.................................................................51

Errors in Application Discovery User Interface Operation.............................................................51

UI “Unable to Connect to Server” Messages.............................................................................51

Java 'UI exception' Message Displays........................................................................................52

4 Table of Contents

5 Getting Assistance in Using Application Discovery.................................................53

Application Discovery Resources.........................................................................................................53

A Commands for Controlling HP Application Discovery Agent and Certificates.....55

amgrd....................................................................................................................................................56

agent_config .........................................................................................................................................59

amgr_remote_config (1M)....................................................................................................................61

B Completing Certificate Exchange...............................................................................63

Introduction..........................................................................................................................................63

Using HP SIM to Complete Certificate Exchange...........................................................................63

Completing Certificate Exchange from the Command Line...........................................................63

C Configuring the WBEM Provider Password..............................................................65

Introduction..........................................................................................................................................65

D Key to Event Attributes.................................................................................................67

Event Types...........................................................................................................................................67

Event Severity Types.............................................................................................................................68

Additional Event Types Specific to HP Application Discovery...........................................................68

Event Viewing Locations......................................................................................................................68

Glossary............................................................................................................................69

Index.................................................................................................................................73

Table of Contents 5

6

List of Figures

2-1 Segment of Process Inventory Data...............................................................................................17

2-2 Segment of Package Inventory Data.............................................................................................17

3-1 Event Tab Showing Configuration Fields for Data Center and Administrative Events...............29

3-2 Template Summary Including Applications Affected by the Template.......................................31

7

8

List of Tables

3-1 Possible Values for Agent State.....................................................................................................23

3-2 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and

Arguments.....................................................................................................................................33

4-1 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and

Arguments.....................................................................................................................................46

D-1 Description of Event Types Used in HP Application Discovery..................................................67

D-2 Event Severity Types Used in HP Application Discovery............................................................68

D-3 Event Types Specific to HP Application Discovery......................................................................68

D-4 Event Viewing Location Types Used in HP Application Discovery.............................................68

9

10

About This Document

This document presents procedural and example information to help you become familiar
Application Discovery, how to manipulate the data presentation, and how to manage event
notification. It will help you understand how Application Discovery can be useful to you.

Intended Audience

This document is intended for system and application administrators responsible for installing,
configuring, and monitoring application health and availability within a network. Administrators
are expected to have knowledge of operating system concepts, commands, and configuration.
Parts of this document are also intended for data center operators. Operators are expected to be
able to identify significant events and communicate them to others. This document is not a
tutorial.

New and Changed Information in This Edition

This document is new, and contains conceptual, procedural, and example material to provide
detailed information about how to use Application Discovery. It contains the following
information:

• An Introduction to Application Discovery.

• Components and Concepts that underlie the workings of Application Discovery.

• Procedures that can be done within Application Discovery to modify the display of data

within Application Discovery and to create user-defined application definitions recognized
by HP Virtualization Manager, as well as by Application Discovery.

• Tasks and Examples that illustrate more complex ways to use Application Discovery.

• Troubleshooting instructions for solving errors in the configuration and operation of

Application Discovery.

Typographic Conventions

This document uses the following typographical conventions.

audit(5) A manpage with the name audit, located in Section 5.

Command
ComputerOut

Ctrl-x A key sequence. A sequence such as Ctrl-x indicates that you must hold down

ENVIRONVAR The name of an environment variable, for example, PATH.
[ERRORNAME]
Key The name of a keyboard key. Return and Enter both refer to the same key.

UserInput

Variable

[ ] The contents are optional in formats and command descriptions. If the contents

{ } The contentsare required in formats and command descriptions. Ifthe contents

... The preceding element can be repeated an arbitrary number of times.
 Indicates the continuation of a code example.
| Separates items in a list of choices.

A command name or qualified command phrase.
Text displayed by the computer.

the key labeled Ctrl while you press another key or button.

The name of an error, usually returned in the errno variable.

Commands and other text that you type.
The name of a placeholder in a command, function, or other syntax display

that you replace with an actual value.

are a list separated by |, you must choose one of the items.

are a list separated by |, you must choose one of the items.

Related Information

The following documents and resources contain useful additional information.

• HP WBEM Solutions:

http://h71028.www7.hp.com/enterprise/9920-0-0-225-121.html?jumpid=reg_R1002_USEN

• PCRE - Perl Compatible Regular Expressions at http://www.pcre.org/ for building aggregation

rules in application templates.

• Virtual Server Environment (VSE) documentation at http://docs.hp.com/en/vse.html.

• The HP VSE Managed Node Software Update web site (http://vsemgmt.external.hp.com)

Publishing History

The document printing date and part number indicate the document's current edition. The
printing date will change when a new edition is printed. Minor changes may be made at reprint
without changing the printing date. The document part number will change when extensive
changes are made. Document updates may be issued between editions to correct errors or
document product changes. To ensure that you receive the updated or new editions, subscribe
to the appropriate product support service. See your HP sales representative for details. You can
find the latest version of this document online at http://docs.hp.com/.

Software VersionDocument Part

Number

A.04.00.075992-3838

HP Encourages Your Comments

Your comments and suggestions regarding product features will help us develop future versions
of the Application Discovery and the VSE Management Software. Use the following e-mail
address to send feedback directly to the VSE Management Software development team:

[e-mail]

NOTE: HP cannot provide product support through this e-mail address. To obtain product
support, contact your HP Support Representative, your HP Services Representative, or your
authorized HP reseller. For more information about support services, visit

http://www.hp.com/go/support. For other ways to contact HP, visit
http://welcome.hp.com/country/us/en/contact_us.html.

Operating

Systems

For managed
nodes: HP-UX,

Linux

For CMS:
HP-UX,
Microsoft®
Windows

Publication DateSupported OS VersionsSupported

May 2008For information on support for specific
operating system versions, please
consult the appropriate installation
guide viewable at

http://docs.hp.com/en/vse.html.

We encourage your comments concerning this document. We are committed to providing
documentation that meets your needs.

Include the document title, manufacturing part number, and any comment, error found, or
suggestion for improvement you have concerning this document. Also, please let us know what
we did right so we can incorporate it into other documents.

1 Introduction

HP Application Discovery works from within HP Systems Insight Manager (HP SIM) to give
you the ability to inventory running and installed applications across your system network and
to centrally monitor application activity.

Within VSE Management Software, HP Application Discovery integrates with HP Virtualization
Manager to give you the power to group running processes into custom applications that can
be added to a workload for more comprehensive resource management.

The HP Application Discovery server and user interface run on the central management server
(CMS). Working in tandem with the agent that you install on your managed systems, HP
Application Discovery gives you access to system and process information captured by the
deployed agents.

With Application Discovery, you can do the following:

• Discover the location and number of recognized, running and installed applications in your

network or data center.

• Monitor the activity and resource usage of running processes and applications.

• Define and adapt application templates to your environment for better discovery of your
third-party and custom applications, and to make them available for adding to monitored
workloads.

• Select the event types for which you want to receive notifications and set their level of
importance.

Features of Application Discovery

You can use Application Discovery to do the following:

• Access application data from within the HP SIM user interface.

• Automate discovery of standard applications supplied with HP operating systems.

• Automate discovery of applications often run on HP operating systems within data centers.
For example, Application Discovery includes templates to discover common applications
generated by Oracle® and SAP software.

• Find unmatched processes that represent third-party or custom software.

• Edit or create an application discovery template to make it specific to your environment.

• Determine the location of running and installed applications.

• Monitor the activity of running processes and applications.

• Define severity for application-oriented events to trigger notification messages, and control
where the messages display (in Application Discovery and/or HP SIM).

• Discover the presence or absence of Application Discovery agents and check their status.

• Monitor the behavior and performance of the Application Discovery server.

Features of Application Discovery 13

14

2 Components and Concepts

Application Discovery Components

Application Discovery contains these components:

• The Application Discovery agent, which discovers the presence of applications and processes
on a managed system, collects information about the managed system and its applications,
and communicates that information to the Application Discovery server on the central
management server.

— An agent is fully autonomous.
— An agent is the only component that is platform-specific (by operating system type and

version).

• The ApplicationDiscovery server, which communicates with agents, runs all of the algorithms,
tracks events, stores templates, and passes data to the user interface.

• The Application Discovery WBEM provider, which provides transport for commands issued
by the Application Discovery server from the central management server (CMS) to the
agents.

• The Application Discovery user interface, which displays collected data and provides
mechanisms that allow the user to modify and refine aspects of user interface, agent, and
server behavior; and data display.

• SSL certificate helper files, which build necessary administrative command files. These files
include commands to manage and exchange SSL certificates, allowing the agent and the
CMS to authenticate the legitimacy of the transmission.

• The Application Discovery initialization scripts, which initialize the database, install the user
interface into HP SIM (including the help system for Application Discovery), and set up the
conditions for certificate exchange between agent and server.

• The Application Discovery templates, which define the objects of discovery for identification
and data collection.

Agents and WBEM providers are installed and run on the managed systems where applications
are to be discovered and monitored. The Application Discovery server and user interface are
installed on the CMS. The templates also reside on the CMS.

The data transmitted by Application Discovery agents includes the following:

• Running process information, including command lines and command-line arguments,
working directories, users, and environment variables

• Installed software information

• Operating system and architecture versions

Application Discovery uses installed software registries and templates (user-defined and those
provided by HP) to match known attributes to discovered data for analysis and presentation in
a user interface.

Application Discovery Components 15

NOTE: An application inventory in a data center or enterprise setting is sensitive material.
Therefore, all communication paths in Application Discovery are encrypted and authenticated
to check for proper user authorization. See VSE Management Software Version 4.0 Installation
and Update Guide for HP-UX for information about steps that must be taken to ensure that
Application Discovery's security measures are in place and functioning correctly. For a discussion
of access by user job roles, see "User Authorizations" in the VSE Software Management Help online
reference. For help with communication problems, see “Introduction” (page 43).

Refining Application Discovery

Refining discovery is the process of optimizing agent and template configurations to enrich data
display in HP Application Discovery.

How Discovery Works

HP Application Discovery includes a set of application templates that cover a spectrum of typical
application types expected to be found on systems operating within a network or data center. A
template is a set of rules that defines the matching criteria for the processes that constitute an
application. This default set of templates allows HP Application Discovery to find, identify, and
display information for a significant percentage of installed packages and running applications
and processes.

On any one system, a percentage of processes found to be active on a host might not be matched
to a provided template or a discovered package. These are referred to as unmatched processes. Of
these unmatched processes, some may reflect the presence of custom or third-party software.

HP Application Discovery helps you to refine discovery in the following ways:

• It provides a summary view into total discovery across your data center or network.

• It provides alist of candidate servers and indicates whether or not they have HP Application
Discovery agents running or installed for discovery.

• It provides a way to edit existing application templates and create new ones. When you
modify or add templates to better adapt them to your environment, you refine the ability
of HP Application Discovery to report application behavior in your particular network.

TIP: At times, you might simply need to find where an application is running or installed. For
this information, click the Applications tab to browse current data.

Understand Your Current Discovery State

To view the current state of discovery, click the Admin/Config tab, and then the Discovery tab.

Discovery Ratio

From the Discovery tab, you can see the discovery ratio for each managed system running an HP
Application Discovery agent, as well as the total discovery of processes and packages for all
monitored systems. Use this information to help determine where to expend effort to improve
discovery.

The following figure shows a segment of process inventory data.

16 Components and Concepts

Figure 2-1 Segment of Process Inventory Data

For example, if the discovery ratio is low, the number of processes that HP Application Discovery
is matching to templates is low. Because more data can be gathered from known relationships,
a low ratio indicates that much less can be known and displayed for the processes that are using
resources on that host.

Conversely, if the discovery ratio is high, HP Application Discovery can provide extensive
amounts of data on system behavior. This information is a richer source for informed
decision-making about resource allocation.

Warm-up Ratio

The warm-up ratio indicates the degree to which the HP Application Discovery agent has
completed an initial survey of packages on a managed host. Processes that are eventually
associated with a package are listed as unmatched processes until the packages are completely
catalogued.

A warm-up ratio of 100% indicates that an initial survey of packages has been completed since
the last startup of the HP Application Discovery agent on the managed host. A ratio of less than
100% indicates that the agent might still be in the process of cataloguing and displaying packages
present on the managed host. It might also indicate that a problem exists in the HP Application
Discovery agent/server communication.

The following figure shows a segment of package inventory data.

Figure 2-2 Segment of Package Inventory Data

Once you understand the current state of discovery on a managed host or across a network, you
can improve the quality of discovery. The next few sections discuss ways to refine discovery.

Refine Discovery by Checking Agent State

HP Application Discovery provides information about the operation of its agents so that you
can make decisions about where and when to use them, and so that you can know the state of
their health.

To learn about agent status, follow the process for checking agent state as described in the
following section.

The information provided can help you decide if you want to do one or more of the following:

Refining Application Discovery 17

• Install an HP Application Discovery agent in order to monitor processes and applications
on that host. See VSE Management Software Version 4.0 Installation and Update Guide for HP-UX
for instructions.

• Start an agent on a system where the agent is installed, but not running.

• Modify the behavior of an agent on a system to affect data freshness and retain history.

Refine Discovery by Creating Application Templates

HP Application Discovery is shipped with a set of default templates that it uses to discover
applications that are likely to be present within an extensive network or data center. These
templates can be copied and edited to quickly create new, similar templates, or you can create
a completely new template that contains no predetermined settings. To see your current list of
templates, click the Admin/Config tab, then the AD Templates tab.

To define an application, you can do the following:

• Edit an existing template to better define the application to which it applies.

• Copy an existing template and modify it to collect a new set of unmatched processes into
an application.

• Create a new template to collect a set of unmatched processes into an application.

See “Managing Application Templates” (page 30)for instructions on creating and editing
templates.

Understanding Application Templates

HP Application Discovery is shipped with a set of default application templates that it uses to
discover applications that are likely to be present within an extensive network or data center.
These templates can be copied and edited to quickly create a new, similar templates, or you can
create a completely new template that contains no predetermined settings.

Application template storage Template attributes are stored in the form of an XML document.
This means that each attribute is encapsulated in XML tags that must be valid in their structure.
HP Application Discovery provides a template editor to help you build valid XML template
documents.

Application template recognition HP Application Discovery recognizes the uniqueness of a
template based on its name and its version, and informs you when you try to use a name and
version combination that is already in use by another application template.

Application template precedence On HP-UX, HP Application Discovery looks for templates
stored in the /var/opt/amgr/templates/local directory before applying the standard
templates supplied with HP Application Discovery. Application templates found in the local
directory have precedence over templates supplied with the product.

18 Components and Concepts

On HP-UX:

Supplied templates are stored in /var/opt/amgr/templates/amgr/ to make it easier to
update templates with new releases of HP Application Discovery. New application templates
provided by HP can replace templates in this directory. Copies of these templates, which are
stored in /var/opt/amgr/templates/local/, are unaffected by release updates to the
software.

On Microsoft® Windows:

Templates are stored in the VSE install directory (C:\Program Files\HP\Virtual Server
Environment\data\templates\). For information on where HP VSE is installed by default,

see HP Insight Control Management Quick Setup Poster.

How Memory Usage is Calculated

Processes have private memory, which is owned privately by each process, and they have shared
memory. Shared memory can be shared (in theory) with none, one, some, or all other processes
on the same system.

In Application Discovery memory calculations aremade formatched applicationsand displayed
in the detail screen of a host (total memory usage and by application), as shown in the following
image.

In Application Discovery, application memory shown is the sum of all private memory in use
by all the processes in that application and the sum of all shared memory in use by all the processes
in that application. That is, shared memory is displayed as though it is not shared. This means
that the totals shown for memory usage are an overstated approximation of actual memory usage
for any particular application.

Here is why accurately summing memory shared among processes is difficult to do:

• The degree of sharing among processes is unknown. For a given process, the shared memory
can be shared with every process on the system, only some processes on the system, only
some processes within the application, or with all of the processes within the application.

• The 'right' answer for how to sum shared memory for processes depends in part on how
the individual administrator uses the information for planning. For example, is the
administrator thinking of adding an application instance to the host? Is he or she thinking
of moving an application instance to another host? Is the administrator thinking of moving
the entire application to another host?

To arrive at a usable deterministic answer, all the shared memory for each process is summed.
This conservative calculation should allow you to safely estimate resource usage for the
applications shown.

Understanding Server Resource Consumption

Application Discovery consumes varying amounts of server resources as it goes about its work
of discovering application and system data for display and storage. To monitor this resource
usage, select the Admin/Config tab and then the AD Server tab.

How Memory Usage is Calculated 19

On the AD Server tab screen, you can see a graphic display of Application Discovery memory
consumption plotted against discovery data for processes and packages. The following figure is
an example of what you might see:

The key to the graphic is as follows:

Used mem

Max mem

Tot procs

Tot unmatched procs

Pack, total

Pack, complete

Memory usage by the Application Discovery server

Maximum memory available for use

Total number of processes found — matched and unmatched to known
templates or packages

Total number of processes found that have not been matched to known
templates or packages

Total number of expected packages according to initial survey.

Total packages found during and on completion of inventory.

20 Components and Concepts

3 Procedures

With Application Discovery, you can perform the following tasks:

• Check the progress of discovery.

• Define an application for discovery.

• Modify the behavior of agents running on managed systems.

• Set attributes that determine what events to display, where to display them, and the priority
they should have.

Starting Application Discovery

1. Enter your user name and ID into the HP Systems Insight Manager (HP SIM) interface.

2. Accept the certificate required by HP SIM.

3. Select Tools→Integrated Consoles→HP Application Discovery.

HP Application Discovery opens in the main display panel of the Applications view.

Modifying Agent Behavior

Use the information in this section to control the HP Application Discovery agent from the
command line and to adapt its behavior to your environment. For ways to manage and monitor
the agent from the user interface, see these sections:

• “Setting Data Polling Interval” (page 28)

• “Checking Agent State” (page 22)

Install the HP Application Discovery Agent on a Managed Node

See "Installing VSE Agent Software on Managed Systems" in the VSE Management Software:
Installation and Update Guide for instructions on how to install the HP Application Discovery
agent via the HP Systems Insight Manager (HP SIM) menus or manually. The VSE Management
Software: Installation and Update Guide is available with the software and on http://docs.hp.com/.

Start the HP Application Discovery Agent

You can start the agent from the HP SIM top menu or from the command line.

Using HP SIM to Start the Agent

1. Initiate this task byselecting Configure →Configure VSE Agents→Start AD Agents from
the HP SIM top menu.

2. Using the HP SIM system list, select the HP-UX systems where you want to start an agent.
Click Apply.

3. Verify the system selection and click Next.

4. A description of the action about to take place is displayed. When you are sure that you
want to complete the action, click Run now to start the agent.

Starting the Agent from the Command Line

To start the agent from the command line on the managed node, enter the following command:

/opt/amgr/bin/amgrd

For the full description of the options available for modifying agent behavior, see “Commands

for Controlling HP Application Discovery Agent and Certificates” (page 55).

Stop a Running Agent

You can stop the agent from the HP SIM top menu bar or from the command line.

Starting Application Discovery 21

Using HP SIM to Stop the AD Agent

1. Initiate this taskby selecting Configure →Configure VSE Agents→Stop AD Agents from
the HP SIM top menu bar.

2. Using the HP SIM system list, select the HP-UX systems where you want to stop an agent.
Click Apply.

3. Verify the system selection and click Next.

4. A description of the action about to take place is displayed. When you are sure that you
want to complete the action, click Run now to stop the agent.

Stopping the Agent from the Command Line

To stop a running agent, enter the following command:

/opt/amgr/bin/amgrd -stop

For the full description of the options available for modifying agent behavior, see “Commands

for Controlling HP Application Discovery Agent and Certificates” (page 55).

Reconfigure a Running Agent from the Command Line

To change attributes of the agent while it is running, type on the command line:

/opt/amgr/bin/amgrd [-option] [-option]

For example, the following command illustrates changing the frequency for collecting data about
processes and packages.

/opt/amgr/bin/amgrd [-procfreq interval{s|m|h}] [-packfreq interval{s|m|h}]

where

• -procfreq interval{s|m|h} changes the current frequency for collecting process data.

• -packfreq interval{s|m|h} changes the current frequency for collecting package
data.

and interval is the time span between polls. Interval may be given in seconds (s), minutes
(m), or hours (h).

For example, the following command designates a process collection frequency of 10 minutes
and a package collection frequency of 30 minutes:

/opt/amgr/bin/amgrd [-procfreq 10m] [-packfreq 30m]

For the full range of options, see “Commands for Controlling HP Application Discovery Agent

and Certificates” (page 55).

Checking Agent State

To check agent state, find agent state from within HP Systems Insight Manager (HP SIM).

1. Select Configure → Configure VSE Agents→ Check AD Agent States .

2. Select the HP-UX systems where you want to find agent status from the HP SIM system list.

3. Verify the system selection and click Next.

4. You can see a description of the action about to take place. When you are sure that you want

5. After a short time, the report appears in the main viewing window. It summarizes identifying

22 Procedures

Click Apply.

to continue with the task, click Run now to complete the agent status report.

information and providethe state for the machine(s) that you selected earlier in the process.

6. If desired, scroll down to access a printable copy of the report. Click the View Printable
Report button to open the printable version of the report.

NOTE: If you find that you are unable to obtain agent status from within HP SIM, check the
following:

• That you have the correct permissions associated with your login ID so that you can view
Application Discovery agent states. See “User Authorizations” in VSE Management Software
Help for information on Application Discovery authorizations.

• That the targeted managed node has been authorized to accept remote commands from HP
SIM.

To authorize the acceptance of remote commands, on the command line of the CMS, type

mxagentconfig -a -n managed_system

where managed_system is the name of the target system for which you want to enable
remote communication.

Have you recently restored or removed and reinstalled the CMS? :

A restore or removal of the central management server also removes the certificate recognition
previously established between Application Discovery server on the CMS and Application
Discovery agents on managed nodes. This relationship must be re-established when the CMS is
reinstalled or restored by completing the Application Discovery certificate exchange. See

“Completing Certificate Exchange” (page 63) for information.

Explanation of Agent States

Table 3-1 shows the possible values for agent state.

Table 3-1 Possible Values for Agent State

MeaningValue

Connected

Disconnected

Agent not running

No CMS Cert

Agent not installed

No contact

Installed, daemon running, connected; able to transfer data

Installed, daemon running, disconnected; unable to transfer data

Installed, daemon not running; unable to collect data

No certificates exchanged between Application Discovery server and agent; unable to
complete data transfer

Connected to target system; no agent found

The server cannot connect to the target system. The target system may be down or not
configured for remote command execution from HP SIM.

See VSE Management Software: Installation and Update Guide (for HP-UX or for Microsoft Windows)
for instructions on how to install an Application Discovery agent. Also see the following:

“Completing Certificate Exchange” (page 63)
“Start the HP Application Discovery Agent” (page 21)

Working With Data Views

For expanded discussions about what can be seen in each Application Discovery data view, see
the Application Discovery Help reference in the software.

Working With Data Views 23

Adjusting the User Interface

You can alter several visual and behavioral aspects of the Application Discovery user interface
for the duration of your user session. Application Discovery does not store these changes as user
preferences.

To take advantage of these settings, select the following tabs: Admin/Config, then UI. The
following images show the controls available from the UI tab.

Set Screen Data Refresh Interval

Application Discovery can refresh data to the interface screens at variable intervals. You can
select the interval you prefer, or you can turn the refresh interval off.

To change the refresh interval, use the "Refresh interval" drop-down to select the setting that
you prefer.

Your selection is applied automatically and immediately.

See also

“Other Controls Available from Right-Clicking on a View Table” (page 26)

Set General Visibility

You can alter application visibility by setting this configuration.

Use the "Application visibility" drop-down to affect visibility of applications across your network.

• Use Don't show hidden apps when you want to enable the hide functionality for

individual applications. This is the default setting.

• Use Show hidden apps when you want to quickly locate all discovered applications

without changing the hide settings for individual instances.

Your selection is applied automatically and immediately on all data tables in Application
Discovery.

Another way to do this is to use the drop-down selector the appears above tables that list
applications. The following figure shows these visibility selectors. The visibility setting selected
here is also applied to all application tables in Application Discovery screens.

See also

“Set Visibility for Packages on Application Discovery Screens” (page 27)
“Set Visibility for Matched Applications” (page 27)
“Set Visibility for Hosts on Application Discovery Screens” (page 26)

Set Color Theme

Select one of four color choices by setting the "Color Theme" attribute.

Your selection is applied automatically and immediately to the Application Discovery user
interface.

24 Procedures