HP Application Discovery Version 4.
© Copyright 2008 Hewlett-Packard Development Company, L.P. Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Table of Contents About This Document.......................................................................................................11 Intended Audience................................................................................................................................11 New and Changed Information in This Edition...................................................................................11 Typographic Conventions.....................................................................
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........................................................
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 ..................
List of Figures 2-1 2-2 3-1 3-2 Segment of Process Inventory Data...............................................................................................17 Segment of Package Inventory Data.............................................................................................17 Event Tab Showing Configuration Fields for Data Center and Administrative Events...............29 Template Summary Including Applications Affected by the Template.......................................
List of Tables 3-1 3-2 4-1 D-1 D-2 D-3 D-4 Possible Values for Agent State.....................................................................................................23 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and Arguments.....................................................................................................................................33 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and Arguments...........
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.
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.
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.
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.
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.
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.
• • • 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.
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\).
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.
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. 2. 3. Enter your user name and ID into the HP Systems Insight Manager (HP SIM) interface. Accept the certificate required by HP SIM.
Using HP SIM to Stop the AD Agent 1. 2. 3. 4. Initiate this task by selecting Configure →Configure VSE Agents→Stop AD Agents from the HP SIM top menu bar. Using the HP SIM system list, select the HP-UX systems where you want to stop an agent. Click Apply. Verify the system selection and click Next. 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.
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.
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.
Set Number of Table Rows To help you to view manageable chunks of data, you can select the maximum number of rows to display within an Application Discovery table. Application Discovery apportions the data into separate pages based on the number that you select. Use the "Table bucket size" drop-down to select the number of rows that you want to appear in each table per page. The default number of rows is set to 50, but you can select more or fewer rows for each table page.
NOTE: Hidden applications. Note that the filtering discussed in this section concerns manipulating data that is currently displayed in the tables. Some applications are not shown in the table. They might be common, low-level processes that are hidden by default, or they might have been hidden by a user.
2. 3. In the table listing all hosts, find the column labeled 'Visible'. Click the button to toggle visibility of hosts on Application Discovery screens to yes (Y) or no (N). Select N to prevent the host and its accompanying data from showing in Application Discovery data tables. Select Y to allow the host and its accompanying data to show in Application Discovery data tables.
Modifying the Maximum Size of an Event List To set event list size, do the following steps. 1. 2. 3. Click the Admin/Config tab, then the AD Server tab. Locate the drop-down 'Max Events' listed at the bottom of the "Server Configuration" box to the left of the graph. Select the maximum number of events to store in the primary event log. Event lists are pruned periodically to the number set in "Max Events". The new setting is applied the next time the list is pruned.
Setting Event Attributes Introduction to Event Settings in Application Discovery Application Discovery logs various application and administrative events occurring in the computing network. It records events that occur in association with applications, host machines, agents, and templates. You can set the desired severity for an event type and the location at which the event alert can be seen. To access and modify the attribute fields for events, click the Admin/Config tab, then the Events tab.
2. 3. Select the location desired for each event type. The default setting is "Show in AD", meaning show this event type in the Application Discovery event tables only. Use "Send to SIM" to show the event type in HP Systems Insight Manager event tables as well as Application Discovery event tables. Click Submit to save the change. The new settings are applied immediately to the data displays. If needed, you can Cancel the changes that you have made.
NOTE: HP supplies a default set of application templates with Application Discovery. Editing one of these templates does not actually change the original template. Instead, the original is automatically copied for editing. On HP-UX When you edit and save changes to an HP-supplied application template, the resulting values are stored as /var/opt/amgr/templates/local/filename.atd, where filename is the same as the original template file name.
NOTE: My application does not appear in the "Applications affected..." table. Why? There are several possible explanations for this to occur: • It takes some time for template matching to complete. Action: Wait a couple of minutes to see whether or not matching occurs.
Constructing Regular Expressions: HP Application Discovery recognizes regular expressions constructed using Perl 5 or POSIX syntax and semantics. To learn more, consult PCRE - Perl Compatible Regular Expressions at http://www.pcre.org/. NOTE: HP Application Discovery (AD) interprets executable path strings differently than HP Global Workload Manager (gWLM). HP Application Discovery looks at a process from the perspective of how it is named when it is running.
Summary Fields and Their Descriptions The following figure shows the Summary portion of an application template. Fields and their descriptions follow the image. Field Description Name Required. Unique name given to the template to represent the application. Version Required. Version number of the application this template matches. Title User-defined name for the template. Description User-defined summary describing the template. OS Operating system to which the template applies.
Field Description Is visible? By default during initial discovery, HP Application Discovery sets objects recognized as packages to "no" and objects recognized as templates to "yes". This field designates whether or not the application shall be visible to users of the HP Application Discovery user interface: • yes – show the application data associated with this object. • no – hide the application data associated with this object.
NOTE: If you want to define a template based on ownership or how many instances are currently running, you can check the 'Unmatched procs' table on a particular host screen or the 'Processes not matched by this template' table on a template editing screen to get this information. See for tips on finding specific process attributes. Rule Fields and Their Descriptions The following figure shows the Rules portion of an application template. Fields and their descriptions follow the image.
NOTE: If you want to define your application based on specific ownership, path, or command line arguments, you can check the 'Unmatched procs' table on a particular host screen or the 'Processes not matched by this template' table on a template editing screen to get this information. See“Filling in the Rule Fields Using Table Data” (page 41) for tips on finding specific process attributes for this purpose.
3. You can add a new type after "User" within the original And statement by clicking the Add Rule button at (below), or you can add additional statements or types after the original And statement by clicking the Add Rule button at . 4. Continue in this way until you have added all the types that you want in the rule. 5. Fill in the empty values to complete the rule description for this template, and click Apply. (You might need to scroll to the right to locate the Apply and Cancel buttons.
The following figure shows an aggregation of multiple processes by specified executable path into one application. The following figure shows an aggregation of multiple processes specified using regular expressions. How to Remove Types from the Aggregation Rule You might want to remove types from a rule to correct it or refine it. To remove a type, click the Del Rule button to the right of the type field that you want to remove.
This example shows which Del Rule button to click to statement and to remove the entire And statement. remove the Group type within an And Check Unmatched Processes to Find Application Candidates In Application Discovery, processes running on a host system that do not match existing template or package definitions are called unmatched processes. Characteristics of unmatched processes can be entered into a template to define an application.
For more details about this part of an application template, see “Summary Fields and Their Descriptions” (page 34). Filling in the Template Attribute Fields In the following image, you can see the columns indirectly relevant to the Attributes fields in an application template – pid, ppid, user, sid, and ct. These columns are indirectly relevant because you do not use the actual values in the columns to define the Attribute fields.
On HP-UX: On HP-UX, HP Application Discovery program binaries are installed in /opt/amgr. HP Application Discovery data are located in /var/opt/amgr. To back up HP Application Discovery, copy the entire contents of these two directories to storage media. On Microsoft® Windows: Program binaries are stored in the Virtual Server Environment install directory in C:\Program Files\HP\Virtual Server Environment\data\.
4 Troubleshooting and Error Messages Introduction This page is organized by symptom, each of which is followed by possible indicators or causes to investigate. Errors in Installation Failure message on installation of Application Discovery agent (AppDiscAgent) 1. 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.
# /opt/amgr/bin/agent_wbem_config Loading Application Discovery schema Loading Application Discovery metadata 4. Check that the Application Discovery agent certificate has been installed on the managed node. Type the following on the command line of the managed node: # 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 .
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. 3. Check that Application Discovery is showing that the discovery ratio is 100%. a. b.
Table 4-1 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and Arguments Example Inputs AD gWLM match match biod no match match ./biod no match match /usr/sbin/biod match not allowed biod match not allowed .
Once this action is taken, check that Application Discovery is receiving messages from the host. (See #8 in this section.) 5. 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.
See “Configuring the WBEM Provider Password” (page 65)to learn how to configure the WBEM provider 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.
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. 3. It is possible that certificate exchange has not been completed. See Appendix B for instructions on completing the certificate exchange..
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. 2. Check that the host is known to Application Discovery. a. b. Click the following tabs in Application Discovery: Admin/Config, then Discovery. Find the column heading "Host". Hosts recognized by Application Discovery are listed here.
4. 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. 5. 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.
NOTE: Be aware that one possible cause for incorrect configuration is the case where installation and startup deviate from the documented process. In this situation, you might see the following error message: Application Discovery UI encountered an error: The UI and server are out of sync. If Application Discovery web application and Application Discovery server are not from the same installation version, you must reinstall Application Discovery before using vseinitconfig -a. 2.
5 Getting Assistance in Using Application Discovery The following resources are available to help you learn how to best use Application Discovery or to help you if you encounter difficulties. Application Discovery Resources For expanded discussions of the topics in this document or for troubleshooting information, refer to the Application Discovery Help reference in the Application Discovery user interface.
A Commands for Controlling HP Application Discovery Agent and Certificates amgrd and agent_config can be run on HP-UX and Linux managed systems where the Application Discovery agent is deployed. amgr_remote_config can be run on HP-UX and Microsoft® Windows central management servers.
amgrd NAME amgrd -- Change Behavior of HP Application Discovery Agent on Managed System SYNOPSIS Path: /opt/amgr/bin/amgrd [options] amgrd [-start] [-noreload ] amgrd [-connectionstatus] amgrd [-enableRestart] amgrd [-enableRestart] [-start ] amgrd [-enableRestart] [-stop ] amgrd [-disableRestart] amgrd [-disableRestart] [-start ] amgrd [-disableRestart] [-stop ] amgrd [-procfreq interval{s|m|h}] amgrd [-packfreq interval{s|m|h}] amgrd [-ping] DESCRIPTION The amgrd command allows you to interact with an H
-[no]daemon -[no]debug -noreload -packfreq interval{s|m|h} -procfreq interval{s|m|h} -server s -start -stop -u -v -verbose v [Do not] run the agent as a daemon. -daemon is the default setting for amgrd. Use -nodaemon only for triage as the agent will die if the terminal session ends or the terminal is disconnected. [Do not] run the agent in debug mode. Do not read in persisted data (used when agent is started or restarted).
AUTHORS amgrd was developed by Hewlett-Packard Company. FILES /var/opt/amgr/amgrd.log /var/opt/amgr/amgrd.log.1 /var/opt/amgr/amgrd.log.2 Has 2 MB limit; then rolls over to alternating backup logs First alternate backup log Second alternate backup log SEE ALSO HP Application Discovery Help Reference HP Application Discovery Version 4.0 User's Guide VSE Management Software Version 4.0 Getting Started Guide VSE Management Software Version 4.0 Installation and Update Guide for HP-UX http://docs.hp.
agent_config NAME agent_config -- Access HP Application Discovery Certificate on Managed System SYNOPSIS Path: /opt/amgr/bin/agent_config agent_config -a [-dir config_directory] agent_config -amx agent_config -c agent_config -printAgentTrust agent_config -r agent_config -start agent_config -stop DESCRIPTION The agent_config command allows you to interact with an HP Application Discovery agent to print its certificate or to remove a counterpart CMS certificate, and to check the status of the agent, to star
EXAMPLES Check agent state. # /opt/amgr/bin/agent_config -c Agent not running Run the agent using amgrd. # /opt/amgr/bin/amgrd -start Check agent state again. # /opt/amgr/bin/agent_config -c Connected AUTHORS agent_config was developed by Hewlett-Packard Company. FILES /opt/amgr/bin/agent_config /opt/amgr/bin/amgrd /var/opt/amgr/ssl/agent_cert.pem /var/opt/amgr/ssl/agenttrust.pem /var/opt/amgr/agent.
amgr_remote_config (1M) NAME amgr_remote_config -- Access HP Application Discovery Certificates Remotely from the Central Management Server (CMS) SYNOPSIS Path: /opt/amgr/bin/amgr_remote_config amgr_remote_config -a [-mx] [-n hostname] [-u login] [-dir directory] amgr_remote_config -c [-mx] [-n hostname] [-u login] amgr_remote_config -r [-mx] [-n hostname] [-u login] amgr_remote_config -start [-mx] [-n hostname] [-u login] amgr_remote_config -stop [-mx] [-n hostname] [-u login] DESCRIPTION From the centra
2 3 4 5 6 An error occurred and the command did not complete successfully. Unrecognized command parameters are detected. Missing post-install configuration of AD agent is detected. Missing post-install configuration of AD CMS is detected. Specified host name contains invalid characters. EXAMPLES Exchange certificates between HP Application Discovery CMS and managed node foo.hp.com using HP System Insight Manager mxexec: # amgr_remote_config -a -mx -n foo.hp.
B Completing Certificate Exchange Introduction HP Application Discovery uses Secure Sockets Layer (SSL) certificates to authenticate and secure data transmission between HP Application Discovery agents and the HP Application Discovery server. Once HP Application Discovery components are installed, the accompanying certificate information for HP Application Discovery server and for HP Application Discovery agent must be exchanged to allow the server and agents to recognize legitimate transmissions.
-u option supported on HP-UX only: You might be prompted to provide a password for the specified user for each system login. You must supply the password in order to proceed. 3. Once the login is accomplished, the CMS sends its SSL certificate to the agent on the managed host, and the agent supplies its SSL certificate to the CMS. HP Application Discovery agents can now transfer data securely to the CMS, and the CMS can authenticate the transmission.
C Configuring the WBEM Provider Password Introduction WBEM is a management information retrieval and command protocol. Application Discovery uses a WBEM provider to allow the central management server (CMS) to send commands to agents running on managed nodes. Sending a WBEM command to a managed node requires remote login from the CMS to a managed node. An authorized user name and matching password are used to log in.
D Key to Event Attributes Event Types Table D-1 Description of Event Types Used in HP Application Discovery Event Type Name Description Data Center Events Application installed An application has been installed on a host. Application started An application has been started on a host. Application stopped An application has been stopped on a host. Application template created A new template has been found on the CMS.
Event Severity Types Table D-2 Event Severity Types Used in HP Application Discovery Icon Meaning Critical Indicates a failure and signals the need for immediate attention. Warning In a state that might become a problem. Major Indicates an impending failure. Minor Indicates a condition that can escalate into a more serious problem. Normal Indicates that this object is behaving as expected. Info Requires no attention; provides useful information.
Glossary agent A program with a well-defined task that runs in the background and that is used to capture information or do processing tasks. aggregate data views Screens in Application Discovery that display a collection of data about various objects, often including system, application, and event data for all known instances of each in one table, but with emphasis on one aspect of the data.
resources, yet each virtual machine is a complete environment in itself and runs its own instance of an operating system (referred to as a guest OS). See also virtual machine, VM Host. logical server A feature provided by HP Virtualization Manager, a logical server is a set of configuration and metadata that you create, activate, and assign to operate within a physical or virtual machine. An active logical server can be moved from one location to another, and its characteristics can be modified.
server 1. Physical server: Hardware that can run one or more operating systems, including a partitionable complex. Also, hardware that can run an instance of the vPars monitor. Server hardware includes one or more cabinets containing all the available processing cores, memory, I/O, and power and cooling components. HP Integrity servers include two types of server hardware: standalone servers and cell-based servers. 2. Virtual server: A software-based virtual environment that can run an operating system.
WBEM Web-Based Enterprise Management. A set of web-based information services standards developed by the Distributed Management Task Force, Inc. A WBEM provider offers access to a resource. WBEM clients send requests to providers to get information about and access to the registered resources. Web-Based Enterprise Management See WBEM. workload The collection of processes in a standalone server, nPartition compartment, virtual partition compartment, or virtual machine compartment.
Index Symbols -packfreq set package collection frequency, 22 -procfreq set process collection frequency, 22 -start start agent, 21 -stop stop agent, 21 A AD agent checking state, 50 failure on installation, 43 AD Agents tab, 26 AD server check for running server process, 49, 50, 51, 52 start, 49, 50, 51, 52 unable to connect to Application Discovery user interface, 51 AD server not available, 49 AD Template tab, 27 Admin/Config tab, 26 administration event types, 67 agent check state, 17 event types, 67 fi
C certificate create for Application Discovery agent, 44 exchanae incomplete for Application Discovery agent, 44, 49 certificates about, 15 completing the exchange, 63 exchange, 47 exchanging from the command line, 63 exchanging from within HP Systems Insight Manager, 63 cimprovider, 43 Clear filter, 25 clutter reducing number of processes shown in Application Discovery unmatched process table, 40 Cmdline defining an application template rule, 36 collapse tables, 26 Collapse table, 26 color set theme for us
events key to severity types, 68 key to types, 67 setting attributes for , 29, 67 setting attributes for applications, 29 setting list size, 28 examples Application Discovery and gWLM match behavior, 46 building aggregation rules for application templates, 38 exchange certificates, 44, 49 executable defining within an application template rule, 36 expand tables, 26 Expand table, 26 F features, 13 filter data in view tables, 25 in or out, 25 Filter in, 25 Filter out, 25 filters clear all, 44 firewall blocki
no 'Applications' icon in Virtualization Manager Visualization screen, 49 no 'by application' link in gWLM workload screens, 50 no 'by application' link in Virtualization Manager workload screens, 50 no applications in Application Discovery, 44 no hosts in Application Discovery, 46 no indicators in Virtualization Manager real-time utilization meters, 50 no packages in Application Discovery, 48 O OpenSSL obtaining for HP-UX and Linux, 43 Or defining an application template rule, 36 OS (operating system) tem
Application Discovery, 45 gWLM as compared to Application Discovery, 45 Summary fields data for in unmatched process table, 40 support, 53 T tab AD Agents, 17, 26 AD Templates, 30, 32, 37 Admin Event, 67 Admin/Config, 26 Admin/Config Event View, 29 Applications, 26 Discovery, 16 Events, 26 Hosts, 26 navigation, 25, 26 Packages, 26 Templates, 26 UI, 24 table collapse, 26 expand, 26 navigation to views via links, 26 unmatched processes, 40 table size restricting number of rows, 25 tabs navigation, 26 tasks c
configuring password, 65 uninstall for Application Discovery, 43 workload definition process map error, 50 78 Index
