HP 5992-3838 User Manual

Hewlett-packard computer accessories user manual
Table of Contents

Quick Links

HP Application Discovery Version 4.0 User's
Guide
HP Part Number: 5992-3838
Published: May 2008
Table of Contents
loading

Summary of Contents for HP 5992-3838

  • Page 1 HP Application Discovery Version 4.0 User's Guide HP Part Number: 5992-3838 Published: May 2008...
  • Page 2 The information contained herein is subject to change without notice. The only warranties for HP products and services are set 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.
  • Page 3: Table Of Contents

    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...
  • Page 4 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...
  • Page 5 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...
  • Page 7 List of Figures 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...31...
  • Page 9 An Example Comparison of Match Behavior in AD and gWLM for Same Executable Path and Arguments...46 Description of Event Types Used in HP Application Discovery...67 Event Severity Types Used in HP Application Discovery...68 Event Types Specific to HP Application Discovery...68...
  • Page 11: About This Document

    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.
  • Page 12: Related Information

    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/.
  • Page 13: Introduction

    The HP Application Discovery server and user interface run on the (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.
  • Page 15: Components And Concepts

    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. •...
  • Page 16: Refining Application Discovery

    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"...
  • Page 17: Warm-Up Ratio

    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.
  • Page 18: Refine Discovery By Creating Application Templates

    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.
  • Page 19: How Memory Usage Is Calculated

    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.
  • Page 20 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...
  • Page 21: Procedures

    Using HP SIM to Start the Agent Initiate this task by selecting Configure the HP SIM top menu. Using the HP SIM system list, select the HP-UX systems where you want to start an agent. Click Apply. Verify the system selection and click Next.
  • Page 22: Using Hp Sim To Stop The Ad Agent

    Using HP SIM to Stop the AD Agent Initiate this task by selecting Configure 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.
  • Page 23: Explanation Of Agent States

    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: •...
  • Page 24: Adjusting The User Interface

    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.
  • Page 25: Set Number Of Table Rows

    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"...
  • Page 26: Other Controls Available From Right-Clicking On A View Table

    NOTE: Hidden applications. 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. To quickly see how many applications might be hidden from view, look at the upper right hand corner of the application table: Other Controls Available from Right-Clicking on a View Table Refresh the page data.
  • Page 27: Set Visibility For Matched Applications

    'Show All Running Applications'. In essence, this check box allows you to reveal all running applications that have been previously marked as hidden in HP Application Discovery by a user or by default. See “Add Selection by Application” in HP Virtualization Manager Help for usage instructions.
  • Page 28: Modifying The Maximum Size Of An Event List

    Modifying the Maximum Size of an Event List To set event list size, do the following steps. 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.
  • Page 29: Setting Event Attributes

    Application Discovery (by clicking the Events tab) or in HP SIM (by looking at the uncleared events lists). Lists that allow you to specify where event notifications shall post for viewing.
  • Page 30: Managing Application Templates

    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.
  • Page 31: Template Summary Including Applications Affected By The Template

    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...
  • Page 32: Create A New Template

    Attribute Fields These fields let you set limits on how many users and how many processes can be associated with the template. You can also set visibility of the resulting application in HP Application Discovery screens. Rule Fields These fields let you build a rule that describes the process constituents for the resulting application.
  • Page 33: An Example Comparison Of Match Behavior In Ad And Gwlm For Same Executable Path And

    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. Therefore, to successfully construct an application that HP Application Discovery recognizes, you must provide attributes (data strings) that describe the running process.
  • Page 34: Summary Fields And Their Descriptions

    Application Discovery tries to match the template within all operating systems for which it has information. Operating system version to which the template applies. If this field is left blank, HP Application Discovery tries to match the template against all operating system versions for which it has information.
  • Page 35 Is visible? 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.
  • Page 36: Rule Fields And Their Descriptions

    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.
  • Page 37: Create An Application Template Rule

    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 38: Aggregation Rule Examples

    You can add a new type after "User" within the original And statement by clicking the Add Rule button at And statement by clicking the Add Rule button at . Continue in this way until you have added all the types that you want in the rule. Fill in the empty values to complete the rule description for this template, and click Apply.
  • Page 39: How To Remove Types From The Aggregation Rule

    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.
  • Page 40: Check Unmatched Processes To Find Application Candidates

    This example shows which Del Rule button to click to statement and to remove the entire And statement. 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.
  • Page 41: Filling In The Template Attribute Fields

    For more details about this part of an application template, see 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.
  • Page 42 HP Insight Control Management Quick Setup Poster. For information on backing up data for all VSE components, see the vseinitconfig options in the command reference of the VSE Management Software Installation and Update Guide for HP-UX or for Windows, as appropriate for your setup.
  • Page 43: Troubleshooting And Error Messages

    OpenSSL software releases. 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 manageability page on HP Software Depot web site (http://software.hp.com/).
  • Page 44: Data Missing In Application Discovery Screens

    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. Data Missing in Application Discovery Screens Issues listed in this section include the following: •...
  • Page 45 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.
  • Page 46: Host Not Visible In Application Discovery Screens

    See also the suggestions in Host Not Visible in Application Discovery Screens Check 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.
  • Page 47 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.
  • Page 48: Packages Not Visible In Application Discovery Screens

    “Configuring the WBEM Provider Password” (page 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.
  • Page 49: Application Errors In Vse Workload Screens

    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. It is possible that certificate exchange has not been completed.
  • Page 50: No 'By Application' Entry In Vse Workload Definition Criteria Drop-Down

    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 VSE Agents Check AD Agent States . Follow the instructions for selecting hosts and checking agent state.
  • Page 51: Cannot Enter Application Discovery User Interface

    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.
  • Page 52: Java 'Ui Exception' Message Displays

    'root' 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 Comments” (page 12).
  • Page 53: Getting Assistance In Using Application Discovery

    For information on network and browser compatibility, see VSE Management Software Help topics, which are accessible from any VSE product interface help link. Expect updates to this software release. You can obtain updated versions by visiting HP Software Depot (http://software.hp.com/).
  • Page 55: A Commands For Controlling Hp Application Discovery Agent And Certificates

    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...
  • Page 56: Amgrd

    [-ping] DESCRIPTION The amgrd command allows you to interact with an HP Application Discovery agent to start or stop its operation, to change its mode of operation, to collect information about it, and to change its data collection frequency on the system where it resides. You will need root access to use this command.
  • Page 57 -start -stop -verbose v Installation The amgrd command can be installed from a depot available on the HP VSE Managed Node Software Update Web site. For installation instructions, please visit the VSE Management Web site at the following URL: http://docs.hp.com/en/vsemgmt/agents.html Beginning with VSE Management Software Version A.03.00.00, amgrd is installed on the CMS...
  • Page 58 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.com/en/vse Related manpage: agent_config Commands for Controlling HP Application Discovery Agent and Certificates Has 2 MB limit;...
  • Page 59: Agent_Config

    AD agent, or to stop an AD agent. You can use agent_config remotely from the HP SIM graphical user interface or from the command line on a managed system. You will need root access to use this command.
  • Page 60 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.com/en/vse Related manpage: amgrd Commands for Controlling HP Application Discovery Agent and Certificates...
  • Page 61: Amgr_Remote_Config (1M)

    From the central management server, the amgr_remote_config command allows you to interact with an HP Application Discovery agent on a managed node to print its certificate or to remove a counterpart CMS certificate, and to check the status of the agent on that node.
  • Page 62 /var/opt/amgr/ssl on the managed node: # amgr_remote_config -a -n foo.hp.com -u aduser -dir /var/opt/amgr/ssl Check the state of HP Application Discovery agent on managed node foo.hp.com using HP System Insight Manager mxexec: # amgr_remote_config -c -mx -n foo.hp.com AUTHORS amgr_remote_config was developed by Hewlett-Packard Company.
  • Page 63: B Completing Certificate Exchange

    Initiate certificate exchange by selecting Configure AD Agent Certificates from the HP SIM top menu. Select the HP-UX systems where you want the exchange to occur using the HP SIM system selection list. Click Apply. Verify the system selection and click Next.
  • Page 64 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.
  • Page 65: C Configuring The Wbem Provider Password

    In case of failure Any failed login attempts discovered by the Application Discovery user interface create an entry in the HP SIM audit log. The WBEM provider on each managed system is responsible for logging failed WBEM login attempts. Introduction...
  • Page 67: D Key To Event Attributes

    D Key to Event Attributes Event Types Table D-1 Description of Event Types Used in HP Application Discovery Event Type Name Data Center Events Application installed Application started Application stopped Application template created Application template parse error Application template removed...
  • Page 68: Event Severity Types

    Meaning/Location Do not show this event in event views. Show this event only in HP Application Discovery event views. Show this event in HP Systems Insight Manager event views as well as in HP Application Discovery views.
  • Page 69: Glossary

    In system management applications, the process of finding and identifying network objects. In HP Systems Insight Manager, discovery finds and identifies all the HP systems within a specified network. In Application Discovery, discovery finds and identifies all running and installed applications within a specified network.
  • Page 70 Refer to the gWLM online help for a description of nPartition requirements. See also virtual partition. package A package groups application services (individual HP-UX processes) together. parked workload workload that is not currently associated with a system. A workload becomes parked if its system is set to “none”...
  • Page 71 A software entity provided by HP Server. This technology allows a single act as a VM Host operating system (referred to as a guest OS). Virtual machines are managed systems in the HP Virtual Server Environment (VSE). virtual partition A software partition own instance of an operating system.
  • Page 72 See also managed workload, monitored workload, Serviceguard workload. Glossary nPartition virtual machine compartment. HP Global Workload Manager (gWLM) compartment, virtual partition extends...
  • Page 73: Index

    67 finding current state, 22 modifying behavior, 21 reconfigure while running, 22 setting polling intervals, 28 start, 21 starting from within HP Systems Insight Manager, 21 status, 22 stop, 21 stopping from within HP Systems Insight Manager, tab, 17 agent_wbem_cleanup...
  • Page 74 50 check that workload is defined, 50 event set to be seen in Application Discovery only, 29 set to be seen in HP Systems Insight Manager, 29 set to ignore, 29 set viewing location, 29 event type application running, 68...
  • Page 75 46 not displayed in Application Discovery screens, 46 visibility in Application Discovery table display, 46 HP Systems Insight Manager menus finding HP Application Discovery from, 63 starting agent from, 21 stopping AD agent from, 22 installation errors Application Discovery, 43...
  • Page 76 Application Discovery, 46 no indicators in Virtualization Manager real-time utilization meters, 50 no packages in Application Discovery, 48 OpenSSL obtaining for HP-UX and Linux, 43 defining an application template rule, 36 OS (operating system) template attribute, 34 OSver (OS version)
  • Page 77 Application Discovery, 45 gWLM as compared to Application Discovery, 45 Summary fields data for in unmatched process table, 40 support, 53 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...
  • Page 78 configuring password, 65 uninstall for Application Discovery, 43 workload definition process map error, 50 Index...

Table of Contents