hp automation insight…l look up hp support contacts ... (x) days from patch release 41 ......

HP Automation InsightFor the Red Hat Enterprise Linux ® and SUSE Enterprise Linux ® operating systems

AI SA Compliance User Guide

Document Release Date: July 2014

Software Release Date: July 2014

Legal Notices

WarrantyThe 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.

The information contained herein is subject to change without notice.

Restricted Rights LegendConfidential 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.

Copyright Notice© Copyright 2014 Hewlett-Packard Development Company, L.P.

Trademark NoticesAdobe™ is a trademark of Adobe Systems Incorporated.

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

UNIX® is a registered trademark of The Open Group.

This product includes an interface of the 'zlib' general purpose compression library, which is Copyright © 1995-2002 Jean-loup Gailly and Mark Adler.

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

Documentation UpdatesThe title page of this document contains the following identifying information:

l Software Version number, which indicates the software version. l Document Release Date, which changes each time the document is updated. l Software Release Date, which indicates the release date of this version of the software.

To check for recent updates or to verify that you are using the most recent edition of a document, go to: http://h20230.www2.hp.com/selfsolve/manuals

This site requires that you register for an HP Passport and sign in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html

Or click the New users - please register link on the HP Passport login page.

You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details.

SupportVisit the HP Software Support Online web site at: http://www.hp.com/go/hpsoftwaresupport

This web site provides contact information and details about the products, services, and support that HP Software offers.

HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to:

l Search for knowledge documents of interest l Submit and track support cases and enhancement requests l Download software patches l Manage support contracts l Look up HP support contacts l Review information about available services l Enter into discussions with other software customers l Research and register for software training

Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

To find more information about access levels, go to:

http://h20230.www2.hp.com/new_access_levels.jsp

HP Software Solutions Now accesses the HPSW Solution and Integration Portal Web site. This site enables you to explore HP Product Solutions to meet your business needs, includes a full list of Integrations between HP Products, as well as a listing of ITIL Processes. The URL for this Web site is http://h20230.www2.hp.com/sc/solutions/index.jsp

AI SA Compliance User Guide

HP Automation Insight (1.0) of 92

Contents

Welcome to HP Automation Insight 9

About HP AI Solution Packs 9

About HP AI Reporting Universes 9

Universe Elements 9

Universe Definitions 10

SA Audit Compliance Dashboard and Reports 12

Prerequisites for Displaying Meaningful Data 12

User Prompt Input 12

Graphic 13

Audit Policy Compliance Status Summary 14


User Prompt Inputs 14

Graph 14

Table 15

Audit Policy Compliance Status Details 15



Graph 16

Table 17

Audit Compliance Job Statuses for Last (X) Days 17



Tables 18

Audit Policy Compliance Rate Over Time 19



Graph 19

Audit Policy Compliance Rate by Device Group Over Time 20

AI SA Compliance User GuideContents




Graph 21

SA Audit Compliance Custom Reports 23

SA Audit Compliance Universe 24

Generic Class 24

Audit Server As Source 25

Data Source 26

Audit 26

Audit Policy 27

Audit Policy Rule 27

Cross Group Objects 28

Audit Compliance - Cross Grouping 29

Audit Inventory - Cross Grouping Source Server Info 29

Audit Inventory - Cross Grouping Target Server Info 30

Audit Compliance 30

Audit Compliance Server 31

Compliance Server Group 32

Audit Job 32

Audit Compliance Summary 33

Audit Results for Summary 34

Audit Compliance Details 34

Audit Compliance Audit Exceptions 35

Audit Inventory 35

Audit Server As Target 36

Audit Device Group As Target 37

Server Member 37

SA Patch Compliance Dashboard and Reports 39



Graph 40



Patch Rollout Status Summary for (X) days from Patch Release 41



Graph 42

Table 42

Patch Rollout Status Details for (X) Days from Patch Release 43



Graph 44

Table 44

Patch Policy Success Rate by Severity Over Time 45



Graph 46

Table 46

Patch Compliance Job Statuses for Last (X) Days 47



Table 48

Patch Policy Compliance Rate by Severity Over Time 48



Graph 49

Table 50

SA Patch Compliance Custom Reports 51

SA Patch Compliance Universe 52

Generic Class 52

Cross Group 53

Patch Compliance 54

Patch Inventory 54

SA Patch Inventory 55



Data Source Inventory 55

Facility Inventory 56

Device Group Inventory 56

OS Platform Inventory 56

Device Inventory 57

Patch Policy Inventory 57

Patch Policy Patches Inventory 58

SA Patch Compliance 58

Data Source 60

Facility 60

Device Group 60

OS Platform 61

Device 61

Patch Policy 62

Patch Policy Patches 62

Job 63

Patch Measure 64

Patch Exception 64

Server Patch Compliance 64

SA Software Compliance Dashboard and Reports 65



Graph 66

Software Policy Compliance Summary 67



Graph 67

Table 68

Software Policy Compliance Details 68





Graph 69

Table 70

Software Policy Compliance Rate by Severity Over Time 70



Graph 71

Software Compliance Job Statuses for Last (X) Days 72



Table 73

Top 10 Package or Software Installs by Failures and Success Count 74



Tables 74

SA Software Compliance Custom Reports 76

SA Software Compliance Universe 77

Generic Class 77

Cross Group 78

Software Compliance - Cross Grouping 79

Software Inventory - Cross Grouping 79

Software Inventory 80

Data Source Inventory 81

Device Group Inventory 81

Device Group Inventory Policy 81

Facility Inventory 82

OS Platform Inventory 82

Device Inventory 82

Child Software Policy Inventory 83

Software Policy Inventory 83

Software Package Inventory 84

App Config Inventory 84



Software Compliance 84

Data Source 86

Facility 86

Device 86

Device Group 87

OS Platform 87

Software Policy 88

Software Package 88

App Config Base 89

SA Job 89

Measure 90

SA Software Compliance 90

We appreciate your feedback! 91



Welcome to HP Automation InsightHP Automation Insight (HP AI) is an HP product that leverages HP Vertica Analytics Database technology and provides a complete set of ETL tools, a dimensional data model, reports, dashboards and analytics systems, and content for the HP suite of automation tools.

HP AI provides advanced analysis on cloud automation activities that enables you to leverage the suite of HP cloud and data center automation software to make decisions based on real-time and historical data. The data analyzed is collected from HP software products, such as HP Server Automation (SA), that perform automation and monitoring services in the cloud.

This document is designed for HP AI users who need to view, edit, create, and run content reports.

About HP AI Solution PacksYou can create and run reports for HP solution packs. Reporting universes determine which objects your reports can include.

A reporting universe provides an interface between a WEBi client and a database. The universe defines the relationship among database tables, based upon how the tables are connected.

HP AI leverages SAP BusinessObjects (BO) reporting technology to enable cross-product historical reporting. When you create a Web intelligence document, you use a report designer to select universe objects. HP AI uses information filtered through the universes to create an SQL query based on those objects.

HP AI provides the following types of packaged content to deploy HP AI components that are used to solve cloud and data-center problems:

l Data Models: Data tables, views and projections that are created in the HP Vertica database.

l Reports: HP created operational, tactical, and strategic reports on datacenter and cloud management operational data.

l Dashboards: HP-created dashboards for the SA Compliances, and SA Server Inventory and Usage Solution Packs. SA User Management and AI System Health do not provide dashboards.

l Data Management Jobs: Jobs available for rolling up data and transforming data.

The latest HP AI solution packs can be deployed automatically through HP Live Network (HPLN).

About HP AI Reporting UniversesFollowing are basic universe elements and definitions.

Universe ElementsUniverses contain three basic elements: objects, classes, and query filters.

AI SA Compliance User GuideWelcome to HP Automation Insight


Object

An object represents a specific set of data in your HP Server Automation database. Each object is given a term (such as Server or Device) that has specific meaning in HP Server Automation.

Types of objects are described below:

l Dimension

A dimension object ( ) retrieves the data that provides the basis for analysis in a report. Dimension objects typically retrieve character type data. For example, on an SA Server, the SA Server Inventory and Usage Universe contains dimensions such as Server Name, Host Name, OS name, or Serve Model.

l Measure

A measure object ( ) performs a numerical evaluation on the data in the database report. Two examples of measures are: Number of Managed Server and Number of Physical Servers.

Class

A class is a logical grouping of related objects. Web Intelligence represents a class with a folder () icon. Each class can contain one or more subclasses. Subclasses contain objects that are

further categorized into subcategories.

When you create queries on a universe, classes help you to find the objects that represent the information that you want to find.

Query Filter

A query filter object allows you to restrict the data returned by an object in a query. Query filters are represented by a yellow funnel ( ) icon. Two examples of query filters (in the server Inventory and Usage Universe) are: Dynamic Date and Date Range. These query filters enable you to select the time frame for the report.

Note: Date filters carry a timestamp of 00:00:00. A report with a date filter of "Today" will not include items that were inserted in the database after midnight. To capture items inserted in the database after midnight, you should set the date filter to tomorrow's date.

Universe DefinitionsHP AI provides the following reporting universes:

l SA Audit Compliance Universe: This universe contains information about the audit compliance status of SA servers.

l SA Patch Compliance Universe: This universe contains information about patch compliance status for SA servers.



l SA Software Compliance Universe: This universe contains information about software compliance status for SA servers.

l SA User Management Universe: This universe contains information about user management and activity on SA servers.

l SA Inventory and Usage Universe: This universe contains information about your SA servers and how you use those servers.

l AI System Health: AI System Health Reports use objects from other universes, such as SA Server Inventory and Usage. The AI System Health universe does not contain unique system health objects, but it does provide reports to help you evaluate how well your AI system can perform at your required quality level.



SA Audit Compliance Dashboard and ReportsRun a dashboard for an overview, or access individual reports to see audit compliance information in more detail.

Following are details about audit dashboard behavior:

l If a target server is repeated for different audits created from an audit policy, then the server status is reported according to the last scan among all the audit runs.

l If audit policy rules are changed, then compliance status is reported as "Scan Needed" until the next scan runs.

l If Number of days input is "1," then the last scan as of the current date for each selected audit policy is reported.

l If Number of days input is more than "1", then data is reported according to the following rules:

n If an audit is run multiple times during one day, then the dashboard uses only the last scan run for that audit on that day.

n If no scans run during a day, then data from the latest available scan is used.

Prerequisites for Displaying Meaningful DataBefore you run the dashboard, you must perform the following tasks on your HP SA server:

l Define at least one audit policy that contains rules.

l Attach the policy to an Audit and run the audit. An audit must be run after the initial data mine is completed.

l Run audit rollup jobs for the days in the report, so the dashboard results are accurate and current. By default, HP AI runs audit rollup jobs daily. See the "Managing Data Management Jobs" section in the HP Automation Insight Administrator Guide.

User Prompt InputSelect Number of Days(X): Enter he number of days you want to include in the report. Fo example, "30" gives you a report for the previous 30 days.

Note: HP AI does not contain data prior to your first data load. For example, if your first data load was 15 days ago, and you enter "30," your report contains information for only the previous15 days.

Select the Source Name: In a multi-mesh SA environment, select one core as the data source for the report.

AI SA Compliance User GuideSA Audit Compliance Dashboard and Reports


Select the Audit Policy Name(s): Select one or more audit policies.

Graphic

The SA Audit Compliance Dashboard reports on the following items:

1. A pie chart shows server status, and a count and percentage of servers with that status.

2. A pie chart shows job status, and a count and percentage of jobs with that status

3. A stack chart shows platform name, and a count and percentage of servers on the platform by server status.

In addition to the dashboard, you can run the following standard reports for more detailed audit compliance information:

l "Audit Policy Compliance Status Summary"

l "Audit Policy Compliance Status Details"

l "Audit Policy Compliance Rate Over Time"

l "Audit Policy Compliance Rate by Device Group Over Time"

l "Audit Compliance Job Statuses for Last (X) Days"



Audit Policy Compliance Status SummaryRun this report to see the compliance status of selected audit policies.

Following are details about report behavior:

l If an audit is run multiple times during one day, then the report uses only the last scan run for that audit on that day.


l If audit policy rules are changed, then compliance status is reported as "Scan Needed" until the next scan runs.

l If even one audit rule fails, overall audit compliance for that server is reported as "Scan Failed."

Prerequisites for Displaying Meaningful DataBefore you run this report, you must perform the following tasks on your SA server:


l Attach the policy to an Audit and run an audit. Run an audit job to learn whether the server is compliant. An audit must be run after the initial data mine is completed.

l Remediate non-compliant servers.

l Run audit rollup jobs for the days in the report, so the report results are accurate and current. By default, HP AI runs audit rollup jobs daily. See the "Managing Data Management Jobs" section in the HP Automation Insight Administrator Guide.

User Prompt InputsEnter a Source Name: In a multi-mesh SA environment, select one core as the data source for the report.

Enter Date: Enter or select a date. The default is today.

Enter values for Audit Policy Name: Select one or more audit policies.

After you run the report, you can filter the results by Facility and Device Group.

GraphA pie chart shows server status, and the percentage of servers with that status. Move your pointer over a section to see a count of servers and more detail.



TableA vertical table shows the server count by server status, the total targeted servers in each audit, and last scan time of the server.

Note: Click on the audit policy name in the vertical table to open the Audit Compliance Details report. See "Audit Policy Compliance Status Details".

Audit Policy Compliance Status DetailsRun this report to see detailed compliance status information for one selected audit policy and date. This report provides rule level information about the compliance scan run.




l If an audit is run multiple times during one day, then the report uses only the last scan run for that audit on that day.


l If audit policy rules are changed, then compliance status is reported as "Scan Needed" until the next scan runs. In this case, no rules are reported, so the rules section of the report does not show any details.

l If even one audit rule fails, overall audit compliance for that server is reported as "Scan Failed."



l Attach the policy to an Audit and run an audit. Start an audit job to know whether the server is compliant. An audit must be run after the initial data mine is completed.

l Run audit rollup jobs for the days in the report, so the report results are accurate and current. By default, HP AI runs audit rollup jobs daily. See the "Managing Data Management Jobs" section in the HP Automation Insight Administrator Guide.


User Prompt InputsYou can run this report from the Audit Compliance Summary Report. Click on a policy name in the table section. See "Audit Policy Compliance Status Summary".

Alternately, you can run this report by entering the following user prompts.

Enter Source Name: In a multi-mesh SA environment, select one core as the data source for the report.

Enter Audit Policy Name: Enter or select one audit policy to report upon.

Enter Date: Enter or select a date. The default is today.


GraphThe stack chart shows server status, and the server count with that status for the selected audit policy.



TableA table shows detailed information for the target servers.

Audit Compliance Job Statuses for Last (X) DaysRun this report to see audit compliance and remediation job statuses for a selected number of days previous to today.

In a multi-core environment, this report provides information for servers in all the cores. However, if an audit runs on servers in different cores, the information might display separately as different jobs.





l Attach the policy to an Audit and run an audit. An audit must be run after the initial data mine is completed.


User Prompt InputsEnter number of days (X): Enter the number of days you want to include in the report. For example, "30" will give you a report for the previous 30 days.

Enter Source Name: In a multi-mesh SA environment, select one core as the data source for the report.


After you run the report, you can filter the results by Facility, Device Group, and Audit Job Type.

TablesTables provide detailed information about job status, with a table for each job ID.



Audit Policy Compliance Rate Over TimeRun this report to see audit compliance trending by audit policy for 12 months (at most). The compliance trends are shown by compliance categories.


l This report includes all audit scans. If multiple audits are run during one day, the report includes all the scans for trending calculations.



l Attach the policy to an Audit and run an audit. Start an audit job to learn whether the server is compliant. An audit must be run after the initial data mine is completed.


User Prompt InputsSelect the Source Name: In a multi-mesh SA environment, select one core as the data source for the report.

Select the Audit Policy Names: Select one or more audit policies, but do not select more than 10-15 policies.

Select the Report Date: Enter or select a date. The default is today. The report will show compliance for the 12 months previous to the report date.



GraphA line graph shows the percentage of audit compliance over time. The compliance is shown by audit policy compliance categories.

Note: The scale of the time axis changes to use space optimally. The scale depends upon the age of your data: days, weeks, or months.



Audit Policy Compliance Rate by Device Group Over Time

Run this report to see audit compliance trending by device group for 12 months (at most). The compliance trends are shown by compliance categories.


l This report includes all audit scans. If multiple audits are run during one day, the report includes all the scans for trending calculations.





l Attach the policy to an Audit and run an audit. Run an audit job to learn whether the server is compliant. An audit must be run after the initial data mine is completed.



Select the Audit Policy Names: Select one or more audit policies. Do not select more than 10-15 policies.

Select the Report Date: Select a date. The default is today.

After you run the report, you can filter the results by Device Group and Facility.

GraphA line graph shows the percentage of audit compliance over time. The compliance is shown by device group.




SA Audit Compliance Custom ReportsYou can design and run custom audit compliance reports in addition to the standard reports. (For standard reports, see "SA Audit Compliance Dashboard and Reports".)

For details about the objects used to build both standard and custom reports, see "SA Audit Compliance Universe".

Use the following high-level steps to create a custom report:

1. In the Web Intelligence application, choose to create a Web Intelligence document.

2. Select the universe that you want to report upon.

3. Within that universe, select the objects that you want to report upon.

Note: Some objects cannot be used in reports and some objects cannot be combined with other objects.

4. Run the query.

See the "Build a Custom Report" section of the HP Automation Insight User Guide for more information about how to access custom report functionality.

See the "Working with documents" section of the SAP BusinessObjects Web Intelligence Users Guide for more information about how to use custom report functionality.

AI SA Compliance User GuideSA Audit Compliance Custom Reports


SA Audit Compliance UniverseThe Server Automation (SA) Audit Compliance Universe defines classes that contain typical SA objects related to audit compliance. When you run either a standard or a custom audit compliance report, you will use these objects. The resulting reports provide information about the compliance levels of your data center device.

The following graphic shows classes in the SA Audit Compliance Universe:

The following sections describe the classes and objects the classes contain:

l "Generic Class"

l "Cross Group Objects"

l "Audit Compliance"

l "Audit Inventory"

The General class contains a filter that is for internal use only.

Generic ClassThe Generic class represents a general folder. It contains the classes and objects that are shown in the following graphic.

AI SA Compliance User GuideSA Audit Compliance Universe



l "Audit Server As Source"

l "Data Source"

l "Audit"

l " Audit Policy"

Audit Server As SourceThe Audit Server As Source class represents the source server specified for the audit in HP Server Automation.

Object Type Description

Platform Family Name string The platform family name of the server in HP SA.

Generic class > Audit Server As Source class




Server Key number The key of the audit source server in HP SA.

Host Name string The host name of the server used as "Source" for the audit.

Server Name string The name of the audit source server in HP SA.

Notes string Notes on the audit source server.

Management IP string The management IP address of the audit source server in HP SA.

Primary IP string The primary IP address of the audit source server in HP SA.

Asset Tag string The asset tag of the audit source server in HP SA.

Use Name string Server Usage of the audit source server in HP SA.

Stage Name string Server State of the audit target server in HP SA.

Lifecycle Name string The lifecycle name of the audit source server in HP SA.

Platform Name string The platform name of the audit source server in HP SA.

Facility Name string The facility name of the audit source server in HP SA.

Generic class > Audit Server As Source class, continued

Data SourceThe Data Source class represents data sources such as Server Automation.


Created Date date Data source created date

Source Type string Data source type., for example: Server Automation.

Source Name string Data source name as defined in the HP AI Administration console.

Description string Description of the data source as defined in the HP AI Administration console.

Generic class > Data Source class

AuditThe Audit class represents audits defined in HP Server Automation.




Audit Name string Name of an audit in HP Server Automation.

Audit Description string Description of the audit in HP Server Automation.

Audit Key number The audit key of the audit in the HP Server Automation.

Created By string Name of the audit creator in HP Server Automation.

Modified Date date Modified date of the audit in HP Server Automation.

Created Date date Audit created date in HP Server Automation.

Generic class > Audit class

Audit PolicyThe Audit Policy class represents audit policies that are defined in HP Server Automation.


Created Date date Audit policy created date in HP Server Automation.

Modified Date date Audit policy modified date in HP Server Automation.

Ruleset Description string Audit policy rule set type description in HP Server Automation.

Ruleset Type Name string Audit policy rule set type in HP Server Automation.

Audit Policy Key number Unique audit policy key.

Audit Policy Name string Audit policy name in HP Server Automation.

Description string Audit Policy description in HP Server Automation.

Generic class > Audit Policy class

Audit Policy Rule The Audit Policy Rule class represents rules as defined for an audit policy in HP Server Automation. This class can be used when rules are directly attached to an audit policy.


Rule Type Name string Audit Policy rule type name in HP Server Automation.

Audit Rule ID number Audit Policy rule ID in HP Server Automation.

Audit Rule Description string Audit Policy rule description in HP Server Automation.

Generic class > Audit Policy > Audit Policy Rule class




Audit Rule Details string Audit Policy rule details in HP Server Automation.

Rule Disabled number Is the rule disabled for the audit in HP Server Automation.

Generic class > Audit Policy > Audit Policy Rule class, continued

Cross Group ObjectsThe Cross Group Objects class contains objects and classes that are shown in the following graphic:


Audit Policy Name string Audit policy name in HP Server Automation.

Audit Name string Name of an audit in HP Server Automation.

Cross Groups Objects class



Audit Compliance - Cross Grouping


SA Server ID number The ID of the server in HP SA.

Server Name string The name of the server in HP SA.

Management IP string The management IP address of the server in HP SA.

Primary IP string The primary IP address for this server.

Host Name string The host name of the server in HP SA.

Source Name string Data source name as defined in the HP AI Administration console.

Server Key number The server key of the server in HP SA.

Audit Job ID number Job ID in HP SA.

Device Group Name string The name of the device group in HP SA.

Facility Name string The facility name of the server in HP SA.

Cross Groups Objects class > Audit Compliance - Cross Grouping class

Audit Inventory - Cross Grouping Source Server Info


Server Name string The name of the audit source server in HP SA.

Management IP string The management IP address of the audit source server in HP SA.

Host Name string Host name of the server used as "Source" for the audit.

Primary IP string The primary IP address of the audit source server in HP SA.

Server Key number The key of the audit source server in HP SA.

Cross Groups Objects class > Audit Inventory - Cross Grouping > Source Server Info class



Audit Inventory - Cross Grouping Target Server Info


Host Name string Host name of the server used as "Target" for the audit.

Server Name string The name of the target server in HP SA.

Management IP string The management IP address of the audit target server in HP SA.

Primary IP string The primary IP address of the audit target server in HP SA.

Target Server Key number Server Key of the server used as "Target" for the audit.

Cross Groups Objects class > Audit Inventory - Cross Grouping > Target Server Info class

Audit ComplianceThe Audit Compliance class represents audit compliance-related classes and objects. Note that objects in this class must not be used with objects from Audit Inventory.

The following sections describe the classes and objects they contain:



l "Audit Compliance Server"

l "Compliance Server Group"

l " Audit Job"

l "Audit Compliance Summary"

l "Audit Compliance Details"

Audit Compliance ServerThe Audit Compliance Server class contains classes and objects related to audit compliance of servers known to HP Server Automation. This includes managed an unanaged servers.

Note: Do not use objects in this class with objects from Audit Inventory.


SA Server ID number

Created Date date The created date of the server in HP Server Automation.

Platform Family Name string The platform family name of the server in HP Server Automation.

Server Key number The server key of the server in HP Server Automation.

Host Name string The host name of the server in HP Server Automation.

Server Name string The name of the server as displayed in HP Server Automation.

Description string The description of the server in HP Server Automation.

Management IP string The management IP address of the server in HP Server Automation.


Asset Tag string The asset tag of the server in HP Server Automation.

Server Use string The server use of the server in HP Server Automation.

Server Stage string The stage name of the server in HP Server Automation.

Server Lifecycle string The lifecycle name of the server in HP Server Automation.

Audit Compliance Server class




Platform Name string The platform name of the server in HP Server Automation.

Facility Name string The facility name of the server in HP Server Automation.

Audit Compliance Server class, continued

Compliance Server GroupThe Compliance Server Group class represents the device group as defined in HP Server Automation.


Created Date date The created date of the device group in HP Server Automation.

Device Group ID number The ID of the device group in HP Server Automation.

Device Group Name string The name of the device group in HP Server Automation.

Device Group Description

string The description of the device group in HP Server Automation.

Accessibility string The accessibility of the device group in HP Server Automation.

Is Public string If the device group is a public group in the HP Server Automation.

Compliance Server Group class

Audit JobThe Audit Job class represents he audit jobs that are run in HP Sever Automation.


Audit Job Runtime number Time, in minutes, taken to complete audit job.

Audit Job Start Time date Start time of the audit job.

Audit Job Status string Audit job status, for example: FAILURE, SUCCESS.

Audit Job End Time date Job end time.

Audit Job Status Name string Similar to Audit Job Status, but user-friendly, for example: Success, Failure.

Audit Job class



Audit Job Schedule Time

date Job Schedule Time of the audit.

Audit Job ID number Job ID in HP Server Automation.

Audit Job Type string Job type, for example: Audit Servers with audit task "linux1."

Audit Job Ticket ID string Job ticket ID in HP SA when running an Audit Job.

Audit Job Username string Name of the HP SA user who initiated the Job.

Audit Job class, continued

Audit Compliance SummaryThe Audit Compliance Summary class represents Audit Compliance Summary on a daily basis. This class is dependent on Rollup Jobs. The latest run of an audit for a given day on is captured in this class. This class can be used to know the audit compliance status summary for a given audit/server as of a given date or date range.


Server Status Name string Overall Audit Compliance Status of the Server. Ex: Compliant, Non-Compliant.

Server Scan Date date Audit Scan date.

Modified Date date Compliance summary modified date in HP Server Automation.

Created Date date Compliance summary creation time in HP Server Automation.

Failure Type Name string Failure description of the compliance scan on the server.

Compliance Summary ID

number Object ID of the compliance scan run.

Failure Description string Failure description of the compliance scan on the server.

Total Checks measure number Total number of checks performed as part of compliance scan run.

Differences measure number Total number of failed checks in compliance scan run.

Warnings measure number Total number of warning checks in compliance scan run.

Total Rules measure number Total rules in the compliance scan per server.

Total Failed Rules measure

number Total failed rules in the compliance scan per server.

Audit Compliance Summary class



Total Rule Exceptions measure

number Total exception rules in the compliance scan per server.

Audit Compliance Summary class, continued

The Audit Compliance Summary class contains the Audit Results for Summary class.

Audit Results for SummaryThe Audit Results for Summary class represents the audit result for the audit summary.


Audit Result Key number Unique key for audit result.

Created Date date Created Date of audit results in HP Server Automation.

Result Name string Name of the audit results in HP Server Automation.

Ruleset Type string Ruleset Type of the audit results in HP Server Automation, for example: CPUS or MEMORY.

Ruleset Type Name string Similar to Ruleset Type, but gives user friendly names to result set types.

Ruleset Description string Ruleset type description in HP Server Automation.

Audit Results for Summary class

Audit Compliance DetailsThe Audit Compliance Details class represents Audit Compliance details for Audit runs. This class provides rule level information for scan runs for servers.


Audit Rule Type string Type of the Audit Rule. This is meaningful only when paired with an audit and a rule.

Created Date date Created time of audit details in HP Server Automation.

Test Date date Scan time of audit details in HP Server Automation.

Rule Item string Rule item for which the details are created.

Rule Description string Rule description.

Rule Details string Rule details.

Actual Value string Actual value found on the server for this rule.

Audit Compliance Details class



Expected Value string Expected value for this rule as defined in HP Server Automation.

Is Compliant string Is the rule check compliant.

Rule Status string Compliance status of the rule check, for example: Compliant or Non-Compliant.

Operator string Operator applied for the compliance check, for example: COMPARISON or =.

Audit Compliance Details class, continued

The Audit Compliance Details class includes the Audit Exceptions class.

Audit Compliance Audit ExceptionsThe Audit Compliance Audit Exceptions class represents audit exceptions.


Exception Reason string Reason for an audit exception. This is meaningful only when paired with an audit exception.

Audit Exception Created By

string Creator of an audit exception. This shows the SA user who created the exception for the selected audit. This is meaningful only when paired with an audit exception.

Audit Exception Modified By

string Creator of an audit exception. This shows the SA user who modified the exception for the selected audit. This is meaningful only when paired with an audit exception.

Audit Exception Expiration Date

date Expiration date for an audit exception. This is meaningful only when paired with an audit exception.

Audit Exception Ticket ID

string Ticket ID for the audit exception. This is the ticket associated with an audit exception entry. This is meaningful only when paired with an audit exception

Exception ID number ID of the exception associated with the audit.

Audit Compliance Audit Exceptions class

Audit InventoryThe Audit Inventory class represents audit inventory-related classes and objects. Note that objects in this class must not be used with objects from Audit Compliance.

The Audi Inventory class contains classes and objects that are shown in the following graphic.



The Audit Inventory class contains the Audit Server As Target and Audit Device Group As Target classes.

Audit Server As TargetThe Audit Server As Target class represents the target server specified for the audit in HP Server Automation. This should be used in the context of Audit Inventory.


Platform Family Name string The platform family name of the audit target server in HP SA.

Server Key number Server key of the server used as "Target" for the audit.

Host Name string Host name of the server used as "Target" for the audit.

Server Name string The name of the server in HP Server Automation.

Notes string Notes.

Management IP string The management IP address of the audit target server in HP SA.

Audit Inventory class > Audit Server As Target class




Primary IP string The primary IP address of the audit target server in HP SA.

Asset Tag string The asset tag of the audit target server in the HP SA.

Server Use string Server usage of the audit target server in HP SA.

Stage Name string Server state of the audit target server in HP SA.

Lifecycle Name string The lifecycle name of the audit target server in HP SA.

Platform Name string The platform name of the audit target server in HP SA.

Facility Name string The facility name of the audit target server in HP SA.

Audit Inventory class > Audit Server As Target class, continued

Audit Device Group As TargetThe Audit Device Group As Target class represents the audit in HP Server Automation. This should be used in context of Audit Inventory.


Created Date date The created date of the device group in HP SA.

Is Public string If the target device group is a public group in HP SA.

Accessibility string The accessibility of the target device group in HP SA.

Description string The description of the target device group in HP SA.

Device Group Name string The name of the target device group in HP SA.

Audit Inventory class > Audit Device Group As Target class

The Audit Device Group As Target class contains the Server Member class.

Server MemberThe following class represents member servers of the device group class 'Audit Device Group As Target'.


Stage Name string Stage name

Use Name string Use name.

Lifecycle Name string Lifecycle name.

Audit Inventory class > Audit Device Group As Target class > Server Member class




Server Key number Server key.

Host Name string Host name of the server used as "Device Group As Target" for the audit.

Server Name string The name of the audit target device group server in HP SA.

Notes string Notes.

Asset Tag string Asset tag.

Management IP string Management IP.

Primary IP string Primary IP.

Facility Name string Facility name.

Platform Name string Platform name.

Audit Inventory class > Audit Device Group As Target class > Server Member class, con-tinued



SA Patch Compliance Dashboard and ReportsThis section describes standard reports about the patch compliance of your SA servers.

Run a dashboard for an overview, or access individual reports to see patch compliance information in more detail.

Prerequisites for Displaying Meaningful DataFor the dashboard to display meaningful data, you must perform the following tasks:

l Define at least one patch policy that contains rules.

l Attach the policy to a server and run a patch remediation or scan job.

User Prompt InputsEnter no of days: Enter the number of days you want to include in the report. For example, "30" will give you a report for the previous 30 days.



Select Policy Name max(10-15): Select one or more policies, but do not select more than 10-15 policies.

Select the Facility Name and Select the Device Group Name: Optionally, select facility names and device group names to limit the number of results. These optional filters can make the report run more quickly than without the filters. To learn more about how to optimize reports, see the"Planning and Configuring Your HP AI Environment" section in the HP Automation Insight Administrator Guide.

After you run the dashboard, you can filter the results on Device Group and Facility Name.

AI SA Compliance User GuideSA Patch Compliance Dashboard and Reports


Graph

The Patch Compliance Dashboard reports on the following items:

1. A count and percentage of patches, by compliance status.

2. A count and percentage of patches, grouped by policy.

3. A count and percentage of patches successfully rolled out, grouped by severity.

4. Last patch job success summary.

Note: This dashboard report does not filter on Select Policy Name input. The report includes all jobs that were run on the source, irrespective of the selected policy names.

In addition to the dashboard, you can run the following standard reports for more detailed patch compliance information:

l "Patch Rollout Status Summary for (X) days from Patch Release"

l "Patch Rollout Status Details for (X) Days from Patch Release"

l "Patch Policy Success Rate by Severity Over Time"



l "Patch Compliance Job Statuses for Last (X) Days"

l "Patch Policy Compliance Rate by Severity Over Time"

Patch Rollout Status Summary for (X) days from Patch Release

Run this report to see overall patch compliance by policy and date.

Note: The report does not show information for Vendor Recommended Patch Policies.



l Attach the policy to a server and run a patch job.


User Prompt InputsEnter window of exposure (in days): Enter the day you want to report upon, after the date of each patch release date.

For example:

1. You select a policy that contains 2 patches.

2. One patch was released on January 1, and the other patch was released on February 1.

3. You run the report with a 15-day window of exposure.

4. The report shows the policy statuses on January 15 and February 15, respectively.

Note: Window of exposure should not be confused with Last (X) Days.


Select Policy Name: Select policy names.

Select the Facility Name and Select the Device Group Name: Optionally, select facility names and device group names to limit the number of results. These optional filters can make the report run more quickly than without the filters. To learn more about how to optimize reports, see



the"Planning and Configuring Your HP AI Environment" section in the HP Automation Insight Administrator Guide.


GraphA graph shows the status of patches on the source server for 'X days' from the patch release date for the selected patch policy.

TableA vertical table shows the counts of patch status per server aggregated over patch policy.

Note: Click on the patch policy name to open the Patch Rollout Status Details report.



Patch Rollout Status Details for (X) Days from Patch Release

Run this report to see patch compliance details for one patch compliance policy and date.

Note: The report does not show information for Vendor Recommended Patch Policies.





Note: Run patch scan/remediate for updated patch policies (addition/ deletion of patches).

User Prompt InputsEnter window of exposure (in days): Enter the day you want to report upon, from the date of the patch release.

For example:

1. You select a policy that contains 2 patches.

2. One patch was released on January 1, and the other patch was released on February 1.

3. You run the report with a 15-day window of exposure.

4. The report shows the policy statuses on January 15 and February 15, respectively.

Note: Window of exposure should not be confused with Last (X) Days.


Select Policy Name: Select one patch policy.





After you run the report, you can filter the results by Facility, Device Group, and Patch Severity.

GraphA graph shows the status of patches on the source server for 'X days' from the patch release date for the selected patch policy.

TableA details table shows patch information for the selected policy and date range.



Patch Policy Success Rate by Severity Over TimeRun this report to see all the successful patch rollouts, grouped by time intervals. The report shows all the successful patch installs during the last 24 hours, 2-7 days, 7-15 days, and so on.





Note: A policy must be scanned at least one time after the initial mine to produce data that can be included in this report.


Select the Patch Policy Name(s): Select one or more policies.





After you run the report, you can filter the results by Facility, Device Group and Patch Severity.

GraphA bar chart shows the percentage of successful patches over the time interval. The patches are grouped by severity.


TableA table shows details of patches by date range, policy name, and patch name.



Patch Compliance Job Statuses for Last (X) DaysRun this report to see patch compliance job statuses and take appropriate action.




User Prompt InputsEnter no of days: Enter the number of days you want included in the report. For example, "30" will give you a report for the previous 30 days.








TableA table shows patch compliance job statuses, grouped by SA Job ID.

Patch Policy Compliance Rate by Severity Over Time

Run this report to see patch compliance trends by severity rate for 12 months (at most).


l Within the last 12 months, define at least one patch policy that contains rules.






Select the Patch Policy Name(s): Select one or more patch policy names.

Note: HP AI does not contain data prior to your first data load. For example, if your first data load was 6 months ago, this report contains information for only the past 6 months.

Note: This report displays data for at most 12 months. If your first data mine was 14 months ago, the report contains data for only the previous 12 months.


After you run the report, you can filter the results by Facility, Device Group, and Patch Severity.

GraphA line graph shows the percentage of patch and server combinations that were compliant over time. The compliance is shown by patch severity.




TableA details table shows information about the number and percentage of compliant servers, grouped by policy and patch severity.



SA Patch Compliance Custom ReportsYou can design and run custom patch compliance reports in addition to the standard reports. (For standard reports, see "SA Patch Compliance Dashboard and Reports" on page 39.)

For details about the objects used to build both standard and custom reports, see "SA Patch Compliance Universe" on the next page.






4. Run the query.



AI SA Compliance User GuideSA Patch Compliance Custom Reports


SA Patch Compliance UniverseThe HP Server Automation (SA) Patch Compliance Universe defines classes that contain typical SA objects related to patch compliance and policies. When you run either a standard or a custom patch compliance report, you will use these objects. The resulting reports provide information about the patch compliance levels of your data center devices.

The following graphic shows the classes in the SA Patch Compliance universe.


l "Generic Class"

l "Cross Group"

l "SA Patch Inventory"

l "SA Patch Compliance"

Generic ClassThe Generic class represents a general folder. It contains the object and filter shown in the following graphic:


As of Date date Date associated with a query output record. Include this if you want a date stamp on each row in the final report. You must use this dimension when building historical reports spanning a date range, in order to relate each record to its date.

Generic Class

AI SA Compliance User GuideSA Patch Compliance Universe



Dynamic_Date filter Use to input a date. Include this filter without inputting a date to schedule reports to take today's date automatically without user interaction.

Generic Class, continued

Cross GroupThe Cross Group class represents objects that are used to create reports that use more than one universe. For example, by using SA Software Cross Group Universe objects you can create a report with Patch and Audit Compliance Cross Group objects to check which patches are installed on a particular Server.

The Cross Group class contains the classes and objects that are shown in the following graphic:

The Cross Group class contains the Patch Compliance and the Patch Inventory classes.



Patch Compliance


Source Name string Data source name in the HP AI Administration console.




Policy Name string Patch policy name in HP Server Automation.

Patch Name string The patch name in HP Server Automation.




Cross Group class > Patch Compliance class

Patch Inventory






Patch Name string The patch name in HP Server Automation.




Cross Group class > Patch Inventory class



SA Patch InventoryThe SA Patch Inventory class represents a class for SA Patch Inventory reports. It contains the classes and objects that are shown in the following graphic:


l "Data Source Inventory"

l "Facility Inventory"

l "Device Group Inventory"

l "OS Platform Inventory"

l "Device Inventory"

l " Patch Policy Inventory"

l "Patch Policy Patches Inventory"

Data Source InventoryThe Data Source Inventory class represents data sources like Server Automation. This class is specific to the inventory section of the universe.




Source Type string Data source type, for example Server Automation.


Description string Description of the data source in the HP AI Administration console.

Data Source class

Facility InventoryThe Facility Inventory class represents a facility in HP Server Automation. This class is specific to the inventory section of the universe.


Facility ID number The facility ID of the server in HP Server Automation.


Status string The facility status of the server in HP Server Automation.

Is Satellite string The facility satellite of the server in HP Server Automation.

Facility Inventory class

Device Group InventoryThe Device Group Inventory class represents device groups as defined in HP Server Automation.


Device Group ID number The device group ID in HP Server Automation.





Is Public string If the device group is a public group in HP Server Automation.

Device Group Inventory class

OS Platform InventoryThe OS Platform Inventory class represents OS platforms defined in Server Automation.




Platform Name string The platform name of the patch source server as displayed in HP Server Automation.

Platform Group string The platform group of the patch source server as displayed in HP Server Automation.

Platform Version string The platform version of the patch source server as displayed in HP Server Automation.

Is Patchable string Is patchable.

OS Platform Inventory class

Device InventoryThe Device Inventory class represents servers known to HP Server Automation. This includes managed and unmanaged servers.











Device Inventory class

Patch Policy InventoryThe Patch Policy Inventory class represents patch policies defined in HP Server Automation.

Object Type DescriptionPatch Policy Inventory class




Policy Type Name string Policy type of a patch policy in HP Server Automation.

Policy Description string Patch policy description in HP Server Automation.

Created By string Patch policy Created By in HP Server Automation

Modified By string Patch policy Modified By in Server Automation

Modified Date date Modified date of a patch policy in HP Server Automation

Created Date date Created date of a software patch policy in HP Server Automation

Patch Policy Inventory class, continued

Patch Policy Patches InventoryThe Patch Policy Patches Inventory class represents patches defined in HP Server Automation.


Package ID number The patch ID in HP Server Automation.

Package Name string The patch name in HP Server Automation.

Package Type Name string The patch type name in HP Server Automation.

Patch Release Date date The patch release date in HP Server Automation.

Severity string The patch severity in HP Server Automation.

Software Release string Software release.

KB ID string The patch knowledge base ID.

Patch Title string The patch title in HP Server Automation.

Status Name string The patch status name in HP Server Automation.

Status Descr string The patch status description in HP Server Automation.

Created Date date The patch created date in HP Server Automation.

Modified Date date The patch modified date HP Server Automation.

Patch Policy Patches Inventory class

SA Patch ComplianceThe SA Patch Compliance class represents a class for SA Patch Compliance reports. It contains the objects that are shown in the following graphic:



The following sections describe the classes and objects they contain:

l "Data Source"

l "Facility"

l "Device Group"

l "OS Platform"

l "Device"

l "Patch Policy"

l "Patch Policy Patches"

l "Job"



l "Patch Exception"

l " Server Patch Compliance"

Data SourceThe Data Source class represents data sources like Server Automation. This class is specific to the compliance section of the universe.


Source Type string Data source type, for example Server Automation.

Source Name string Data source name in the AI Administration console.

Description string Description of the data source in the AI Administration console.

Data Source class

FacilityThe Facility class represents a facility in HP Server Automation. This class is specific to the compliance section of the universe.


Facility Id number The facility ID of the server in HP Server Automation.




Facility class

Device GroupThe Device Group class represents device groups as defined in Server Automation.




Device Group class








Device Group class, continued

OS PlatformThe OS Platform class represents OS platforms defined in HP Server Automation.


Platform Name string The platform name of the patch source server as displayed in HP Server Automation.

Platform Group string The platform group of the patch source server as displayed in HP Server Automation.

Platform Version string The platform version of the patch source server as displayed in HP Server Automation.

Platform Family Name string The platform family name of the patch source server as displayed in HP Server Automation.

Is Patchable string Is patchable.

OS Platform class

DeviceThe Device class represents servers known to HP Server Automation. This includes managed and unmanaged servers.





Device class










Device class, continued

Patch PolicyThe Patch Policy class represents patch policies defined in HP Server Automation.



Policy Type Name string Policy type of a patch policy in HP Server Automation.

Policy Description string Patch policy description in HP Server Automation.

Created By string Patch policy Created By in HP Server Automation.

Modified By string Patch policy Modified By in Server Automation.

Modified Date date Modified date of a patch policy in HP Server Automation.

Created Date date Created Date of a Software Patch Policy in Server Automation.

Patch Policy class

Patch Policy PatchesThe Patch Policy Patches class represents patches defined in HP Server Automation.


Package ID number The patch ID in HP Server Automation.

Package Name string The patch name in HP Server Automation.

Package Type Name string The patch type name in HP Server Automation.

Patch Policy Patches class




Severity string The patch severity in HP Server Automation.

Software Release string The software release in HP Server Automation.

Status Name string The patch status name in HP Server Automation.

Status Descr string The patch status description in HP Server Automation.

KB ID string The patch knowledge base ID.

Patch Title string The patch title in HP Server Automation.

Patch Release Date date The patch release date in HP Server Automation.

Patch Install Date date The patch install date in HP Server Automation.

Created Date date The patch created date in HP Server Automation.

Modified Date date The patch modified date HP Server Automation.

Patch Policy Patches class, continued

JobThe Job class represents a job created in HP Server Automation. The class contains the objects and class that are shown in the following graphic.


Job_ID number SA job ID in HP Server Automation.

Username string Name of the HP SA user who initiated the job.

Job Status string Similar to Patch Job Status, but user-friendly, for example: Success, Failure.

Job Type string Job type, for example: Remediate Policies.

Start Date date Start date of the patch job.

End Date date End date of the patch job.

Schedule Date date Job schedule date of the patch job.

Job class



The Job class contains the Patch Measure class.

Patch MeasureThe Patch Measure class represents patch measures such as total checks, total failed checks, and more.


Total Checks number Total number of checks performed as part of the Compliance scan run.

Total Failed Checks number Total number of failed checks performed as part of the Compliance scan run.

Total Exceptions number Total number of exceptions performed as part of the Compliance scan run.

Job class > Patch Measure class

Patch ExceptionThe Patch Exception class represents an exception created in HP Server Automation.


Exception Name string Exception name in HP Server Automation.

Reason string Reason for a patch exception.

Patch Exception class

Server Patch ComplianceThe Server Patch Compliance class represents patch compliance status for the servers.


Patch Policy Status Name

number Patch policy status in HP Server Automation.

Patch Status Name string Patch policy status in HP SA, for example: Compliant.

Scan Date date Patch policy scan date in HP Server Automation.

Server Patch Compliance class



SA Software Compliance Dashboard and Reports

This section describes standard reports about software compliance for your HP SA servers.

A dashboard shows three software compliance reports in one place, providing a quick overview of your software compliance statuses. Alternately, you can access reports individually to see information in more detail.

Prerequisites for Displaying Meaningful DataBefore you run the dashboard, you must perform the following tasks on your HP SA server:

l Define at least one software policy that contains rules.

l Attach the policy to a server and run a job (to learn whether the server is compliant or non-compliant.)


User Prompt InputsEnter no of days: Enter the number of days you want to include in the report. For example, "30" will give you a report for the previous 30 days.


Source: In a multi-mesh SA environment, select one core as the data source for the report.

Select Policy Name max (10-15): Select one or more software policies, but do not select more than 10-15 policies.



AI SA Compliance User GuideSA Software Compliance Dashboard and Reports


Graph

The SA Software Compliance dashboard reports on the following items:

1. A pie chart shows a percentage and count of software policies by status (compliant, non-compliant, scan needed).

2. A pie chart shows a percentage and count of jobs by status (whether successful).

Note: This dashboard report does not filter on Select Policy Name input. The report includes all jobs that were run on the source, irrespective of the selected policy names.

3. A stack chart shows a percentage and count of packages by compliance status and platform.

In addition to the dashboard, you can run the following standard reports for more detailed software compliance information:

l "Software Policy Compliance Summary"

l "Software Policy Compliance Details"



l "Software Policy Compliance Rate by Severity Over Time"

l "Software Compliance Job Statuses for Last (X) Days"

l "Top 10 Package or Software Installs by Failures and Success Count"

Software Policy Compliance SummaryRun this report to see overall software compliance for selected policies and dates. The report uses all scan information during the month, to calculate the percentage compliant for the month.

Prerequisites for Displaying Meaningful DataBefore you run this report, you must perform the following tasks on your HP SA server:


l Attach the policy to a server and run a job (to learn whether the server is compliant.)



Select the Report Date: Enter or select a date. The date must be after the initial data mine is completed. The default is today.

Select the S/W Policy Name(s) Max 10-15: Select one or more software policies, but do not select more than 10 to 15 policies.



GraphA pie chart shows a count and percentage of software policy items, grouped by compliance status.



TableA table shows summary information by policy.

Note: Click a policy name to open the Software Policy Compliance Details report.

Software Policy Compliance DetailsThis report shows information about software compliance for software policies that you select, on a date that you select.

Run this report to show detailed information about software compliance status by server.





l Attach the policy to a server and scan the server (to learn whether the server is compliant or non-compliant.)



Select the S/W Policy Name(s) Max 10-15: Select software policies, but do not select more than 10 to 15 policies.

Select the Report Date: Enter or select a date. The date must be after the initial data mine is completed. The default is today.



GraphA graph shows the count and percentages of servers by software compliance for the policy.



TableA table shows detailed information of policy items that were installed on the server. The Differences column shows the count of non-compliant servers.

Software Policy Compliance Rate by Severity Over Time

Run this report to see how your software compliance rates change over (at most) 12 months, so you can determine whether corrective measures were effective.





l Attach the policy to a server and run a job to learn whether the server is compliant or non-compliant.



Select the Report Date: Enter or select the end date for the 12-month report. The default is today's date.

Note: HP AI does not contain data prior to your first data load. For example, if your first data load was 6 months ago, and you run this report and enter today's date, the report will contain data for only the past 6 months at most.

Select the Software Policy Name(s): Select one or more software compliance policy names.



GraphA line graph shows the percentage of software compliance over time. The compliance is shown by software policy.



Software Compliance Job Statuses for Last (X) Days

Runt this report to see software compliance job statuses and take appropriate action.



l Attach the policy to a server and run a job to learn whether the server is compliant or non-compliant. A scan must be run after the initial data mine is complete to include the information in the report.

l Remediate non-compliant servers. A remediation must be run after the initial data mine is complete to include the information in the report.

User Prompt InputsEnter no of days: Enter the number of days you want included in the report. For example, "30" will give you a report for the previous 30 days.



Note: HP AI does not contain data prior to your first data load. For example, if your first data load was 15 days ago, and you enter "30" for Enter no of days, your report contains information for only the past 15 days.




TableA table shows information about jobs by date and job status.



Top 10 Package or Software Installs by Failures and Success Count

Run this report to see summary information about the most successful and the least successful software or package installs (based on total count) for selected policies. The report displays information as of today, and includes only the current existing policies.



l Attach the policy to a server and run a job to learn whether the server is compliant or non-compliant. A scan must be run after the initial data mine is complete, to include the information in the report.

l Remediate non-compliant servers. A remediation must be run after the initial data mine is complete, to include the information in the report.


Select the Software Policy Name(s): Select one or more software policies.

Note: Only current active policies display as prompts.



TablesA table shows the total number of failures, and the associated software objects for the top 10 failed package or software installations.



A separate table shows the total number of successes and the associated software objects for the top 10 successful installations.



SA Software Compliance Custom ReportsYou can design and run custom software compliance reports in addition to the standard reports. For standard reports, see "SA Software Compliance Dashboard and Reports".

For details about the objects used to build both standard and custom reports, see "SA Software Compliance Universe".






4. Run the query.



AI SA Compliance User GuideSA Software Compliance Custom Reports


SA Software Compliance UniverseThe Server Automation (SA) Software Compliance Universe defines classes that contain typical SA objects related to software compliance. Use the objects to report on the software compliance levels of your data center devices

The following graphic shows the Software Compliance class.


l "Generic Class"

l "Cross Group"

l "Software Inventory"

l "Software Compliance"

Generic ClassThe Generic class represents a general folder. It contains the object shown in the following graphic:


As of Date date Date associated with a query output record. Include this object if you want a date stamp on each row in the final report. You must use this dimension when building historical reports spanning a date range, in order to relate each record to its date.

Generic class

AI SA Compliance User GuideSA Software Compliance Universe



Dynamic_Date filter Use to input a date. Include this filter without inputting a date to schedule reports to take today's date automatically without user interaction.

Generic class, continued

Cross GroupThis class represents objects that are used in creating reports that use more than one universe. For example, by using SA Software Cross Group Universe objects you can create a report with Patch and Audit Compliance Cross Group objects to check which patches are installed on a particular server. The Cross Group class contains the classes and objects that are shown in the following graphic:

The Cross Group class contains the Software Compliance - Cross Grouping and the Software Inventory - Cross Grouping classes.



Software Compliance - Cross Grouping





Source Name string Data source name in the AI Administration console.




Software Policy Name string Software policy name in Server Automation.

Software Patch Name string Software patch name in HP Server Automation.

Cross Group class > Software Compliance - Cross Grouping class

Software Inventory - Cross Grouping


Software Patch Name string Software patch name in HP Server Automation.

Software Policy Name string Software policy name in Server Automation.






Device Group Name string The name of the device group in the HP Server Automation.

Cross Group class > Software Inventory - Cross Grouping class



Software InventoryThe Software Inventory class represents a class for SA Software Inventory reports. It contains the classes and objects shown in the following graphic:


l "Data Source Inventory"

l "Device Group Inventory"

l "Device Group Inventory Policy"

l "Facility Inventory"

l " OS Platform Inventory"

l "Device Inventory"

l "Child Software Policy Inventory"

l "Software Policy Inventory"

l "Software Package Inventory"

l "App Config Inventory"



Data Source InventoryThe Data Source Inventory class represents data sources like HP Server Automation. This class is specific to the inventory section of the universe.


Source Type string Data source type, for example: HP Server Automation.



Data Source Inventory class

Device Group InventoryThe Device Group Inventory class represents device groups as defined in HP Server Automation.








Device Group Inventory class

Device Group Inventory PolicyThe Device Group Inventory Policy class represents a policy attached to device groups as defined in HP Server Automation.




string The description of the device group in the HP Server Automation.

Device Group Inventory Policy class






Device Group Inventory Policy class, continued

Facility InventoryThe Facility Inventory class represents facilities in HP Server Automation. This class is specific to the inventory section of the universe.


Facility Id number The facility ID of the server in HP Server Automation.




Facility Inventory class

OS Platform InventoryThe OS Platform Inventory class represents OS platforms as defined in HP Server Automation.


Platform Name string The platform name of the patch source server in HP Server Automation.

Platform Group string The platform group of the patch source server in HP Server Automation.

Platform Version string The platform version of the patch source server in HP Server Automation.

OS Platform Inventory class

Device InventoryThe Device Inventory class represents servers known to HP Server Automation, including managed and unmanaged servers.













Device Inventory class

Child Software Policy InventoryThe Child Software Policy Inventory class represents a child software policy.


Policy Name string Software policy name.

Child Software Policy Inventory class

Software Policy InventoryThe Software Policy Inventory class represents a software policy.


Policy Name string Software policy name in HP Server Automation.

Install Order number Patch policy install order in HP Server Automation.

Created Date date Created date of a software patch policy in HP Server Automation.

Modified Date date Modified date of a software patch policy in HP Server Automation.

Software Policy Inventory class



Software Package InventoryThe Software Package Inventory class represents elements of a software patch in HP Server Automation.


Severity string Software patch severity in HP Server Automation.

Patch Release Date date Software patch release date in HP Server Automation.

Package ID string ID of a patch in HP Server Automation.

Package Name string Software patch name in HP Server Automation.

Software Release string Software release.

Created Date date Software patch created date in HP Server Automation.

Modified Date date Software patch modified date in HP Server Automation.

Software Package Inventory class

App Config InventoryThe App Config Inventory class represents elements of application configurations in HP Server Automation.


Config Name string Application configuration name in HP Server Automation.

Description string Description of the application configuration.

Notes string Notes in the application configuration.

Version string Version of the application configuration.

Is Tested string Is tested attribute for the application configuration.

Configuration Lifecycle Key

string Lifecycle key.

App Config Inventory class

Software ComplianceThe Software Compliance class represents a class for SA Software Compliance reports. It contains the classes and objects shown in the following graphic:




l "Data Source"

l "Facility"

l "Device"

l "Device Group"

l "OS Platform"

l "Software Policy"

l "Software Package"

l "App Config Base"

l "SA Job"

l "SA Software Compliance"



Data SourceThe Data Source class represents data sources like HP Server Automation. This class is specific to the compliance section of the universe.



Source Type string Data source type, for example: HP Server Automation.


Data Source class

FacilityThe Facility class represents facilities in HP Server Automation. This class is specific to the compliance section of the universe.


Facility ID number The facility ID of the server in HP Server Automation.




Facility class

DeviceThe Device class represents servers known to HP Server Automation, including managed and unmanaged servers.





Device class










Device class, continued

Device GroupThe Device Group class represents device groups as defined in HP Server Automation.








Device Group class

OS PlatformThe OS Platform class represents OS platforms defined in Server Automation.


Platform Name string The platform name of the patch source server in HP Server Automation.

Platform Group string The platform group of the patch source server in HP Server Automation.

OS Platform class




Platform Version string The platform version of the patch source server in HP Server Automation.

Platform Family Name string The platform family name of the patch source server as displayed in the HP Server Automation.

OS Platform class, continued

Software PolicyThe Software Policy class represents a software policy.


Policy Name string Software patch policy name in HP Server Automation.

Created By string Software patch policy Created By in HP Server Automation.

Modified By string Software patch policy Modified By in HP Server Automation

Created Date date Created date of a software patch policy in HP Server Automation.

Modified Date date Modified date of a software patch policy in HP Server Automation.

Start Date date Start date of a software patch policy in HP Server Automation.

End Date date End date of a software patch policy in HP Server Automation.

Policy Type Name string Policy type name of a software patch policy in HP Server Automation.

Software Policy class

Software PackageThe Software Package class represents elements of the software patch in HP Server Automation.


Package Name string Software patch name in HP Server Automation.

Severity string Software patch severity in HP Server Automation.

Software Package class




Patch Title string Software patch title in HP Server Automation.

Patch Release Date date Software patch release date in HP Server Automation.

Created Date date Software patch created date in HP Server Automation.

Modified Date date Software patch modified date in HP Server Automation.

Software Package class, continued

App Config BaseThe App Config Base class represents elements of the software patch in HP Server Automation.


Effective Date date Application configuration effective date in HP Server Automation.

Config Name string Application configuration name in HP Server Automation.

Created By string Application configuration Created By in HP Server Automation.

App Config Base class

SA JobThe SA Job class represents a job that was created in HP Server Automation. It contains the objects and class that are shown in the following graphic:


SA Job ID number SA Job ID in HP Server Automation.

Job Status string Similar to Software Patch Job Status, but user-friendly, for example: Success, Failure.

SA Job class




Username string Name of the HP Server Automation user who initiated the job.

Job Type string Job type, for example: Remediate Policies.

Start Date date Start date of the software patch job.

End Date date End date of the software patch job.

SA Job class, continued

The SA Job class contains the Measure class.

Measure


Total Checks number Total number of checks performed as part of the compliance scan run.

Total Failed Checks number Total number of failed checks performed as part of compliance scan run.

SA Job class > Measure class

SA Software ComplianceThe SA Software Compliance class represents software compliance status for the servers.


Software Policy Status string The software policy status name in HP Server Automation.

Package Status string The software package status name in HP Server Automation, for example: Compliant, Non-Compliant.

Scan Date date Software patch policy's scan date for the server.

SA Software Compliance class



We appreciate your feedback!If you have comments about this document, you can contact the documentation team by email. If an email client is configured on this system, click the link above and an email window opens with the following information in the subject line:

Feedback on AI SA Compliance User Guide (Automation Insight 1.0)

Just add your feedback to the email and click send.

If no email client is available, copy the information above to a new message in a web mail client, and send your feedback to [email protected].


mailto:[email protected]?subject=Feedback on AI SA Compliance User Guide (Automation Insight 1.0)

hp automation insight…l look up hp support contacts ... (x) days from patch release 41 ......

Documents