background image

HP Application Discovery Version 4.0 User's
Guide

HP Part Number: 5992-3838
Published: May 2008

Summary of Contents for 5992-3838

Page 1: ...HP Application Discovery Version 4 0 User s Guide HP Part Number 5992 3838 Published May 2008 ...

Page 2: ...onstrued 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 brand...

Page 3: ...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 Reconf...

Page 4: ... 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 I...

Page 5: ... 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 T...

Page 6: ...6 ...

Page 7: ...f 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 ...

Page 8: ...8 ...

Page 9: ... 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 ...

Page 10: ...10 ...

Page 11: ...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 ...

Page 12: ...upported Operating Systems Software Version Document Part Number May 2008 For information on support for specific operating system versions please consult the appropriate installation guide viewable at http docs hp com en vse html For managed nodes HP UX Linux For CMS HP UX Microsoft Windows A 04 00 07 5992 3838 HP Encourages Your Comments Your comments and suggestions regarding product features w...

Page 13: ...y 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 application...

Page 14: ...14 ...

Page 15: ...y 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 exchan...

Page 16: ... 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...

Page 17: ...ackages 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 p...

Page 18: ...ing 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 yo...

Page 19: ...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 ...

Page 20: ...ge by the Application Discovery server Used mem Maximum memory available for use Max mem Total number of processes found matched and unmatched to known templates or packages Tot procs Total number of processes found that have not been matched to known templates or packages Tot unmatched procs Total number of expected packages according to initial survey Pack total Total packages found during and o...

Page 21: ...oftware 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 Usin...

Page 22: ... 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 frequenc...

Page 23: ...hed 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 Meaning Value Installed daemon running connected able to transfer data Connected Installed daemon running disconn...

Page 24: ...plication 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 a...

Page 25: ...iteria for the order may be numeric or alphabetical Changing the sort column To change which column is driving the sort order for the table click on or near the title of the column containing the criteria by which you want to sort The background color of the newly selected column heading changes from medium grey to dark grey revealing the sort arrow indicator Changing the sort order Click the arro...

Page 26: ...ion Discovery provides two navigation aids to help you move from data view to data view Navigating with Tabs Application Discovery provides a set of tabs for navigating among the aggregated data views At the top level these views are categorized as Applications Hosts and Events Under the Admin Config tab you can find additional views for AD Templates Packages and AD Agents Click the tabs to move f...

Page 27: ...n in HP Application Discovery by a user or by default See Add Selection by Application in HP Virtualization Manager Help for usage instructions Set Visibility for Packages on Application Discovery Screens To help you control the amount of data presented to you Application Discovery provides several ways to modify the visibility of objects in Application Discovery screens In addition to modifying p...

Page 28: ...et in Max Events The new setting is applied the next time the list is pruned Setting Data Polling Interval You can set the frequency at which the Application Discovery agent sends fresh data to the Application Discovery server You can set polling for processes and for packages separately 1 Click the following tabs Admin Config then AD Agents 2 Find the global settings box on the left of the screen...

Page 29: ...managed Drop down lists that allow you to set the level of severity for each event type Each severity has an iconic indicator associated with it that can be seen in 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 Setting Event Severity 1 Click the drop down arrow ...

Page 30: ...cess individual application templates by clicking the AD Templates tab then the Admin Config tab In the Templates table click the name of the template that you want to modify The data for that template opens in a new screen TIP Another way to get to a template for editing is to click on the associated application name in an application table listing When the information for the application is disp...

Page 31: ...esulting values are stored in the VSE installed directory C Program Files HP Virtual Server Environment data templates local filename atd where filename is the same as the original template file name HP does not support altering the original application templates supplied with Application Discovery in the C Program Files HP Virtual Server Environment data templates directory Once you apply the app...

Page 32: ...emplates tab 2 Click the Create New AD Template button The application template editor opens 3 Fill in the application template values as desired See Key to Application Template Values page 32 4 Apply the changes This action saves the new template under the unique name that you have supplied You might need to scroll to the right to locate the Apply and Cancel buttons Your new application template ...

Page 33: ...ooks across your entire network for likely matches and not just on one particular managed node It might help to think of the difference between AD and gWLM this way In AD an executable and arg 0 are compared directly to one another to make a match In gWLM the inode of an executable and the inode of arg 0 are compared to one another to make a match The following examples demonstrate the different r...

Page 34: ...ation Discovery tries to match the template against all operating system versions for which it has information OSver Architecture to which the template applies If this field is left blank HP Application Discovery tries to match the template against all architectures for which it has information Architecture NOTE If you want to define a template based on where the processes that you want to collect...

Page 35: ... concurrent terminal windows you can have two separate instances of this running application This effect is similar to that obtained by setting user scope one any any number of pids per application Effect Pids have no specific effect on defining the application described by this template Pid scope How many users processes can be associated with one instance of this application one one user s proce...

Page 36: ... one of the rules within this statement can be true to match a process to the application And Can contain a list of one or more And Or User Group Path or Cmdline values Effect All of the rules within this statement must be true to match a process to the application User Supply the user name associated with the process In addition to literal names regular expressions are allowed Effect Make matchin...

Page 37: ...discovery of the application that you have defined You can create rules that apply generally or specifically to a process user or group Create an Aggregation Rule An aggregation rule is one in which you designate one or more characteristics in order to collect the associated process or processes into an application that can be matched by Application Discovery The following procedure assumes that y...

Page 38: ... to scroll to the right to locate the Apply and Cancel buttons For guidance on the values that work in each field see Key to Application Template Values page 32 and Check Unmatched Processes to Find Application Candidates page 40 Aggregation Rule Examples The following images demonstrate several ways to construct an aggregation rule in Application Discovery that will collect exactly the processes ...

Page 39: ...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 To delete And or Or statements click the Del AND or the Del OR button to the right of the closing brace for that statement When an And or an Or rule is deleted all the rules that it encloses are deleted als...

Page 40: ...t on each individual host page in a table called Unmatched Processes You can sort or filter this table to find processes with which you want to define an application TIP One way to reduce the amount of noise cluttering your tables is to create a template that collects uninteresting processes into an application that can be hidden Using the Table Data to Fill in An Application Template Find data in...

Page 41: ...ons can help you determine what relationships you want to define in the application template For details about setting attributes in an application template see Attribute Fields and Their Descriptions page 34 Filling in the Rule Fields Using Table Data In the following image you can see the columns directly relevant to the Rule fields in an application template By entering one or more users User g...

Page 42: ...binaries are stored in the Virtual Server Environment install directory in C Program Files HP Virtual Server Environment data For information on where HP VSE is installed by default see 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 Upda...

Page 43: ...advisories and dates on various historical OpenSSL software releases 2 Check that HP WBEM Services software is installed on the managed node and that it is a compatible version To obtain a new version of HP WBEM Services for HP UX go to the Security and manageability page on HP Software Depot web site http software hp com Find WBEM Services for HP UX For details on which is the appropriate version...

Page 44: ...e in Application Discovery Screens 1 Check that the application is not hidden from view in the application table Tables that list applications are preceded by the Application Visibility drop down that lets you toggle to Show hidden apps Select this option and scan the table for your application Also check that no filters are in operation in the table If one or more filters have been applied to the...

Page 45: ... 5 or POSIX syntax and semantics 5 Check that any string or regular expression used in the executable path field of the defining application template describes the desired running process Application Discovery differs from Global Workload Manager gWLM in how it matches user input data to discovered applications gWLM uses a combination of a fully qualified path and retrieved inode information to fi...

Page 46: ... Visible in Application Discovery Screens page 46 Host Not Visible in Application Discovery Screens 1 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 To learn how to add a managed system to HP Systems Insight Manager s system list ...

Page 47: ...y ssh 3 rm Erase all possible corrupted contents 4 ssh keygen b 2048 t rsa Generate root ssh key 5 ps elf fgrep sshd Find the sshd PID 6 kill 1 pid Re start sshd 7 mxagentconfig a n managed_node 8 amgr_remote_config a n managed_node mx Once this action is taken check that Application Discovery is receiving messages from the host See 8 in this section 6 Check that Application Discovery agent is aut...

Page 48: ...ta on the far right of the data table on this screen Check that the cells have data and that the time stamp is within the period set by the Global Host Process Interval selector on that screen Packages Not Visible in Application Discovery Screens 1 Check that the package is marked as visible in Application Discovery a Click the following tabs in Application Discovery Admin Config then Packages b F...

Page 49: ...zation Manager Visualization Tab Screen page 49 No by application Entry in VSE Workload Definition Criteria Drop down page 50 No Indicators Showing in VSE Workload Real Time Utilization Meters page 50 Cannot Enter Application Discovery User Interface page 51 Error Message Indicates Application Discovery Server Is Not Available 1 Application Discovery may not be correctly configured Run vseinitconf...

Page 50: ...tors Showing in VSE Workload Real Time Utilization Meters This information applies to workloads associated with Application Discovery applications 1 Check that the Application Discovery agent is running Click the following menu choices in HP Systems Insight Manager Configure Configure VSE Agents Check AD Agent States Follow the instructions for selecting hosts and checking agent state If the Appli...

Page 51: ...ese measures are sufficient other underlying problems may be the cause See also the suggestions in Host Not Visible in Application Discovery Screens page 46 that relate to communication between the Application Discovery server and the WBEM provider and between the WBEM provider and the Application Discovery agent Cannot Enter Application Discovery User Interface You can see this message when this ...

Page 52: ...ry before using vseinitconfig a 2 Check that Application Discovery server is running on the CMS Type ps elf grep amgrserver jar on the command line of the CMS You should see a Java process running the Application Discovery server If you do not see this Java process type opt amgr bin cms_start You must be logged in as user root on the CMS to initiate this command Java UI exception Message Displays ...

Page 53: ...e VSE Management Software Version 4 0 Installation and Update Guide for HP UX For information on troubleshooting the configuration of Application Discovery components see the Troubleshooting section in VSE Management Software Help This document is available with the installed software To check for updated information look on the Web at http docs hp com en vse For information on network and browser...

Page 54: ...54 ...

Page 55: ... 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 55 ...

Page 56: ...communication type of WBEM as these are the command defaults The agent will then look for configuration options in a file var opt amgr agent properties and run If var opt amgr agent properties does not exist or does not contain a server name property then the agent will run but it will not know the location of the CMS to which it should send data The amgrd command recognizes the following options ...

Page 57: ...p Stop a running agent u usage Show current usage information and exit v version Show current HP Application Discovery version and exit verbose v Set log verbose to v which can have the following values 0 Disable log 1 LOG_FATAL 2 LOG_ERROR 3 LOG_WARN 4 LOG_ALWAYS 5 LOG_NOTE default 6 LOG_TRACE Installation The amgrd command can be installed from a depot available on the HP VSE Managed Node Softwa...

Page 58: ...mgr amgrd log 2 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 com en vse Related manpage agent_config 58 Commands for Controlling HP Application Discovery Agent and Certifi...

Page 59: ...he CMS Agent certificate is printed to standard output amx Print agent certificate to standard output c Check agent state on a managed node dir config_directory Destination to which to copy the certificate printAgentTrust Print the trusted certificate of the HP Application Discovery agent pushWbemAccessList Store HP Application Discovery WBEM provider access list from standard input r Remove the t...

Page 60: ... binary file var opt amgr ssl agent_cert pem Agent public certificate var opt amgr ssl agenttrust pem Agent trust file var opt amgr agent properties Agent property file 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 U...

Page 61: ...ode c Check agent state on a managed node Agent state is printed dir path Designate the path to the directory where the certificates are located The default location for certificates is var opt amgr ssl mx Use HP Systems Insight Manager s CMS credential to invoke the remote HP Application Discovery agent configuration program Note u and dir are ignored when mx is specified n hostname Name of syste...

Page 62: ...pt 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 FILES opt amgr bin amgr_remote_config Remote HP Application Discovery agent configuration program opt amgr lib AmgrRemoteConfig jar Helper Java program for amgr_remote...

Page 63: ...lick Run now to complete the certificate exchange NOTE If you find that you are unable to exchange certificates from within HP SIM check the following That you have the correct permissions associated with your login ID That the targeted managed node is authorized to accept remote commands from HP SIM To set the correct SSH configuration that authorizes the acceptance of remote commands type the fo...

Page 64: ...y agents can now transfer data securely to the CMS and the CMS can authenticate the transmission 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...

Page 65: ...SIM root bin and amgr Registering any one of these IDs enables the WBEM provider to be connected to from the Application Discovery CMS Every registered WBEM user must have a valid password To register a WBEM user ID and password with HP SIM do the following For global configuration across multiple machines select Options Protocol Settings Global Protocol Settings Find the section Default WBEM Sett...

Page 66: ...66 ...

Page 67: ...load data is lost to HP Application Discovery Unable to refresh workload Administrative Events Agent is available for communication and data transfer Application Discovery agent accessible The agent has registered a change in the host operating system or architecture Application Discovery agent changed identity The agent has dropped a message Application Discovery agent dropped message The agent i...

Page 68: ...scovery Meaning Icon Indicates that an activity has not completed Transitional Indicates that an object usually an HP Application Discovery agent is connected and ready for data transmission Newly Available Indicates that the application is running Application is running Indicates that this application has run in the past but is not running now Application is not running Event Viewing Locations Ta...

Page 69: ...ions 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 discovery ratio As used by Application Discovery this is a comparison of matched to unmatched processes running...

Page 70: ...ified A parked workload that was previously associated with a system may have historical data associated with it from HP Capacity Advisor or HP Global Workload Manager gWLM As with any workload the historical data will be lost if the workload is deleted When migrating a workload from one system to another it may be useful to park the workload removing the association with the original system until...

Page 71: ...k In HP Application Discovery templates specify the data collection and matching rules to be used to define and discover an application When referring to a logical server a template is the collection of information that defines the logical server and its attributes A template logical server has no actual resources associated with it unmatched process A process that Application Discovery can discov...

Page 72: ...Management See WBEM workload The collection of processes in a standalone server nPartition compartment virtual partition compartment or virtual machine compartment HP Global Workload Manager gWLM extends this concept to include processor set compartments and Fair Share Scheduler group compartments gWLM enables you to monitor and manage workloads by automatically adjusting the resource allocations ...

Page 73: ...hange example 63 amgrd 21 22 And defining an application template rule 36 application event types 67 hide 34 setting visibility for 27 show 34 Application Discovery accessing from HP Systems Insight Manager 21 Application Discovery agent modifying behavior 21 Application Discovery procedures 21 Application Discovery server about 15 memory use graph 27 application template format 18 precedence 18 r...

Page 74: ... refining by changing templates 18 refining by creating new templates 18 statistics 19 understanding state 16 warm up 17 discovery ratio 45 display reducing number of processes shown in Application Discovery unmatched process table 40 documentation 53 product 53 E edit AD application templates 30 edit template to define application 18 editing discovery templates 16 errors Application Discovery ins...

Page 75: ... Discovery table display 46 HP Systems Insight Manager menus finding HP Application Discovery from 63 starting agent from 21 stopping AD agent from 22 I installation errors Application Discovery 43 Application Discovery agent certificate 43 Application Discovery WBEM provider 43 HP WBEM Services 43 OpenSSL for HP UX 43 OpenSSL for Linux 43 interval setting for data refresh 24 intervals setting for...

Page 76: ...ier setting scope 34 process interval using to find wait time for template matching 32 process inventory 16 process maps no running application error 51 workload definition error 50 workload parked error 51 writing error 50 processes shared memory calculation 19 R refresh data screen 24 page view data 26 Refresh page 26 regular expressions Perl 5 45 POSIX 45 syntax errors and Application Discovery...

Page 77: ...S configuration 49 U UI tab 24 unmatched process defined 16 unmatched processes understanding 40 User defining an application template rule 36 user authorizations lack of blocks entry to Application Discovery user interface 51 user identifier setting scope 34 user interface about 15 changing behavior of Application Discovery 24 changing the look of Application Discovery 24 controlling screen table...

Page 78: ...configuring password 65 uninstall for Application Discovery 43 workload definition process map error 50 78 Index ...

Reviews: