Technical Bulletin

BMC PATROL Knowledge Modulefor UNIX® and Linux®

Version 9.10.00August 10, 2011Patch 9.10.00.02 corrects various problems

BMC Software is alerting users to problems in version 9.10.00 of the BMC PATROL Knowledge Module (KM) for UNIX® and Linux®. This technical bulletin describes a patch that prevents the problems from occurring. If you have any questions about the problems or the patch, contact BMC Customer Support at 800 537 1813 (United States or Canada) or call your local support center.

Problems corrected by the 9.10.00.02 patchThe BMC PATROL KM for UNIX and Linux patch version 9.10.00.02 corrects problems that were reported in earlier releases of BMC PATROL. The following table describes the problems and lists the tracking IDs assigned to them.

Tracking ID Description

QM001704547 Incorrect information was polled for the FSCapacity parameter.

QM001709723 The binary file was not getting renamed on RHEL 6 platforms, because of not using the root user for installation.

QM001712972 Due to an incorrect calculation of the CPUUtilPerVCpu parameter, it was depicted as offline in version 9.10.00 of the BMC PATROL KM for UNIX and Linux.

NOTE QM001709723 corrects an issue specific to installations done RHEL 6 platforms without using the root user. After installation, use the root user to execute the puk_config script that renames the binary file.

./puk_config.sh -L <full path to xpc>

*211566**211566*

*211566*

Problems corrected by the 9.10.00.01 patch

Problems corrected by the 9.10.00.01 patchThe BMC PATROL KM for UNIX and Linux patch version 9.10.00.01 corrects problems that were reported in earlier releases of BMC PATROL. The following table describes the problems and lists the tracking IDs assigned to them.

Downloading and installing the 9.10.00.02 patch

This section provides the information that you need to successfully download and install the BMC PATROL KM for UNIX and Linux patch version 9.10.00.02.

Preparing for installation

NOTE QM001712972 corrects an issue specific to AIX 7 operating system. While installing the patch, select the Perform Agent and Collector Patch (July 27 2011) for AIX component, in addition to the patch component, PATROL Knowledge Module for UNIX and Linux - Patch 9.10.00.02.

Tracking ID Description

QM001707277 The online Help package failed to install the puk.chm file on the PATROL Central console for version 9.10.00 of PATROL KM for UNIX and Linux.

QM001707876 When two application classes with similar names were loaded on the PATROL console, the collectors failed to collect data. For example, when NETWORK.km and MS_HW_NETWORK.km were loaded together, the collectors within these application classes failed to collect data. A similar problem might occur for NFS and ZPOOL application classes.

QM001708296 The MG_SYS application class instances were displayed in an incorrect hierarchy on the BMC ProactiveNet Performance Management (BPPM) console.

NOTE Before you install the patch files, you must have previously installed BMC PATROL 9.10.00. The patch does not contain all of the files that are required for a complete product release.

2 Technical Bulletin August 10, 2011

Downloading the installation utility and the patch

You must install the patch on the following computers:

■ hosts that are running the PATROL Agent■ hosts that are running the PATROL Console for Microsoft Windows■ hosts that are running the PATROL Console for UNIX

Before you extract and install the patch, complete the following steps:

1 Stop the PATROL Agent.

2 Back up the PATROL_CACHE directory.

3 Delete all BMC PATROL files from the PATROL_CACHE directory.

4 Back up the PATROL_HOME/lib/knowledge and PATROL_HOME/lib/psl directories.

Downloading the installation utility and the patch

This section provides the information that you need to download the installation utility and the patch from the BMC Electronic Product Distribution (EPD) website.

If you have previously downloaded other BMC products, you might have an older version of the installation utility on your hard drive. To ensure that you are using the correct version of the installation utility for this patch, use the following instructions to download the installation utility.

To download the installation utility and patch from the EPD site

1 Create a temporary directory in which to place the downloaded files.

2 Go to https://webapps.bmc.com/signon/content/logon.jsp.

3 Enter your user ID and password, and click Submit.

4 Click Download Product.

5 On the Export Compliance and Access Terms page, provide the required information, agree to the terms of the agreements, and click Continue.

NOTE On Windows computers, ensure that the directory is only one level into the directory structure. The EPD package creates a directory in the temporary directory when you extract the files, and the directory that contains the installation image should not be in a directory deeper than two levels into the directory structure.

BMC PATROL Knowledge Module version 9.10.00 for UNIX® and Linux® 3

Downloading the installation utility and the patch

6 If you are accessing this site for the first time, create an EPD profile; otherwise, skip to step 7:

A Under Localized Languages, select the language for the patch release.

B Under Install Platforms, select the platforms to download for the patch.

C Click Save Profile.

7 Verify that the correct profile is displayed for your download purpose, and ensure that the Licensed Products tab is displayed.

8 Locate the installation utility:

A Locate the product name (BMC Performance Manager for Servers) and expand its entries to show the available version numbers.

B Expand the version number (BMC Performance Manager for Servers 3.1.00) for the required platform to show the available files.

C Select the check box next to BPM Infrastructure (Agent) - Common Install Version 7.5.62.

9 To download the installation utility, click Download (FTP) or Download Manager:

■ Download (FTP) places the selected items in an FTP directory, and the credentials and FTP instructions are sent to you in an e-mail message.

■ Download Manager enables you to download multiple files consecutively, and to resume an interrupted download if the connection drops.

This method requires a one-time installation of the Akamai Net session Client program on the target computer and is usually the faster and more reliable way to transfer files. A checksum is used to verify file integrity automatically.

10 In the EPD site, select the Product Patches tab.

11 Locate the product patch:

A Locate the product name (BMC Performance Manager for Servers) and expand its entries to show the available version numbers.

B Expand the version number (BMC Performance Manager for Servers 3.1.00) to show the available patches.

C Select the check boxes next to the patches (PATROL Knowledge Module for Unix Version 9.10.00.02) and documents to download.

4 Technical Bulletin August 10, 2011

Installing the patch

12 To download the selected items, click Download (FTP) or Download Manager.

Download the patch files into the same temporary directory as the installation utility.

13 Extract the patch files from PATROL_KM_for_UNIX_9100002.zip for your operating system as appropriate:

■ For Windows, double-click puk_ALL_9100002.zip.■ For UNIX, enter tar -xvf puk_ALL_9100002.tar.

The contents of the files are extracted into the bmc_products subdirectory.

14 Complete the installation procedure described in “Installing the patch” on page 5.

Installing the patch

After you have downloaded the installation utility and patch files and extracted them to the bmc_products subdirectory, follow these steps to install the patch:

1 From the bmc_products subdirectory, run the installation utility as appropriate for your operating system:

■ For Windows, double-click setup.exe.■ For UNIX, run setup.sh.

2 Follow the on-screen instructions until the Select Type of Installation page is displayed.

3 On the Select Type of Installation page, select Custom.

4 On the Select System Roles page, select the following system role:

■ Computers hosting a PATROL Agent — Managed System■ Computers hosting any PATROL Console — Console Systems■ Computers hosting a Console Server — Common Services

5 On the Select Products and Components to Install page, select PATROL Knowledge Module for UNIX and Linux - Patch 9.10.00.02.

NOTE To install this patch on UNIX, you must provide the installer access to the root account.

BMC PATROL Knowledge Module version 9.10.00 for UNIX® and Linux® 5

Where to view the latest product information

6 Follow the on-screen instructions to complete the installation.

After you complete the installation steps, you can delete the temporary directory and its contents.

Where to view the latest product informationThe latest product information is available on the Customer Support website at http://www.bmc.com/support.

From the Customer Support site, you can perform several tasks, including

■ viewing the latest product documentation (manuals, release notes, flashes, technical bulletins, online Help, and parameter information)

■ subscribing to proactive alerts to receive e-mail messages that inform you of new release notes, flashes, and technical bulletins for your products

■ searching for existing product resolutions and frequently asked questions (FAQs)

NOTE QM001712972 corrects an issue specific to AIX 7 platforms. While installing the patch, select the Perform Agent and Collector Patch (July 27 2011) for AIX component, in addition to the patch component, PATROL Knowledge Module for UNIX and Linux - Patch 9.10.00.02.

NOTE QM001709723 corrects an issue specific to installations done RHEL 6 platforms without using the root user. After installation, use the root user to execute the puk_config script that renames the binary file.

./puk_config.sh -L <full path to xpc>

TIP If you do not already have a user name and password that allow you to fully access the Customer Support site, you can register for a user name and password on the site.

6 Technical Bulletin August 10, 2011

How to obtain printed documents

How to obtain printed documentsIn addition to printing documents from the media that you received or downloaded when you obtained the product, you can obtain printed documents in the following ways:

■ Download and print the document from the Customer Support website at http://www.bmc.com/support.

■ Order the document from the Customer Support website at http://www.bmc.com/support.

■ Contact your sales representative.

© Copyright 2011 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners.

UNIX is a registered trademark of The Open Group.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

The information included in this documentation is the proprietary and confidential information of BMC Software, Inc., its affiliates, or licensors. Your use of this information is subject to the terms and conditions of the applicable End User License agreement for the product and to the proprietary and restricted rights notices included in the product documentation.

BMC SOFTWARE INC2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA• 713 918 8800Customer Support: 800 537 1813 (United States and Canada) or contact your local support center

BMC PATROL Knowledge Module version 9.10.00 for UNIX® and Linux® 7