test

Sun Update Connection - Automated Baseline Management Service 1.0 User's Guide

TLP Reporting

This section describes the reports that are automatically generated by the TLP tool whenever a patch set is created. TLP reports help you review information about the patch sets that were created. The main purpose of the report is to provide an overview about system status, thus enabling you to prioritize patching needs. You can use these reports to plan the rollout of patch sets in your data center.

There are two kinds of reports that are automatically generated when patch sets are created:

Note –

This guide does not describe usage of the ASCII text report. Although the text report provides output that is the same as the HTML report, the HTML report is easier to interpret. You can adjust the TLP reports by using report templates. Adjusting report templates is beyond the scope of this guide.

ProcedureHow to Access the HTML Report (Dashboard)

This task describes how access the HTML report that is automatically generated by the TLP tool whenever patch sets are created.

Before You Begin

This procedures assumes that you have installed the TLP server and client software, and that you have successfully run the tlp main command at least once.

Steps

  1. Log in to the system.

  2. Launch a web browser.

  3. In the location field, type: 


    file:///target-directory/index.html

    where target-directory is the directory that stores the TLP results, as is specified in the report section of the tlp.cfg file.

    In this section you can also assign color codes to the phases. The defaults for the GREEN and AMBER phases are already predefined. The results that are displayed should look similar to Figure 2–1.

    Figure 2–1 TLP HTML Report (Dashboard)

    Graphic of HTML report. Shows all systems, number of patches applied, date applied, green and amber phases indicate date of application.

    See Interpreting the TLP HTML Report (Dashboard) for more information on how to interpret the HTML report.

Interpreting the TLP HTML Report (Dashboard)

The TLP HTML report presents an overview of all of the systems in the data center that are controlled by TLP. Each row in the report represents one client system. Columns provide specific status details for each system. You can sort systems by clicking the column headers. See Table 2–1 for a more detailed explanation of the contents of a TLP HTML report.

Table 2–1 Location and Description of the TLP HTML Report Contents

Location of Information Within the HTML Report 

Description of the Contents 

Column node 

Shows the host name of the system. 

Column phase 

Shows the name of hte phase for which the host is compliant. 

Column Operation Risk Index (ORI) 

Shows the ORI, as it is calculated by the Sun Checkup analyzer. If other analyzers are used, N/A is displayed.

Next columns 

Represent the phases, with the latest phase left as the default, GREEN.

Individual rows within the report 

Represent individual client systems, which are displayed in the color of the latest phase for which the system is compliant. 

Individual cells within the report 

Show the number of patches that are required (missing) for the system to be compliant to this phase. 

Other columns within the report 

Show the OS version and the system type 

For example, the host, ar-cluster, is missing 35 patches from the GREEN phase. In this example, a second phase, AMBER, is defined. In addition, a snapshot dated, 2004-06-29, was assigned within the tlp.cfg file. TLP enables you to define and install as many snapshots (baselines) as you like. To do so, modify the tlp.cfg file. Within the file, assign names and colors to each phase.

Each row represents one client system and is displayed in the color of the latest phase for which a system is compliant. For example, a line shows up in green if the patches of the GREEN phase were installed on this system. Host, ar-cluster, has an AMBER status because the AMBER patch set was installed, but the GREEN patch set was not installed.

The dashboard assists you in determining each system's status, in relationship to the baselines. The color status, and the number of missing patches, assist you in prioritizing and planning for patch set creation within the data center.

Note –

You should continue to read SunSMAlert information, even when using the TLP tool to generate patch sets within a data center. Although a system has the latest baseline installed, new critical patches might have been released since the baseline was installed. SunAlert provides timely notifications about critical patches, which can help you determine whether any systems are affected.

To obtain more information about a specific system or its status, click on the number in the patch cell. The report header provides system-specific information. If you click the individual links, you can obtain the following information:

Table 2–2 Sample TLP Report for ZRD-SUN-01

System Architecture: 

sun4u 

OS Version: 

Sun OS 5.8 

System Type 

SUNW,Ultra-Enterprise 

Patch Info 

README 

Special Install Instructions 

System Check 

Patches to be installed in Phase GREEN

108987-15 

SunOS 5,8: patch for patchadd and patchrm 

110934-21 

SunOS 5.8: package utilities patch 

109147-32 

SunOS 5.8: linker patch 

108434-18 

SunOS 5.8: 32-Bit Shared library patch for C++ 

108435-18 

SunOS 5.8: 64-Bit Shared library patch for C++ 

108652-87 

X11 6.4.1: Xsun patch 

108773-19 

SunOS 5.8: IIIM and X Input & Output Method patch 

108921-22 

CDE 1.4: dtlogin patch 

108974-41 

CDE 1.4: dtwm patch 

The bottom of the page provides a list of all the patches that were selected for this patch set. Click the patch ID to get to the patch README file for more information.