*************************************************************** {COPYRIGHT-TOP}
* Licensed Materials - Property of IBM
* Restricted Materials of IBM
* IBM Tivoli Usage and Accounting Manager
* 5724-O33, 5765-UAV, 5765-UA7, 44E7863
* (c) Copyright IBM Corp. 2010 All Rights Reserved.
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with
* IBM Corp.
**************************************************************** {COPYRIGHT-END}

FixPack2 for TUAM 7.1.2 Fix Pack 1


1. Description

This Fix pack was created to solve the following Authorized Program Analysis
Reports (APARs)/Defects:

IZ68716			VMware collector: VMCPURES metric is not returning for all VMs configured.
IZ67501			AIXAA collector: StopOnStepFailure parameter does not stop as expected for missing input files.
IZ65619			VMware collector: Disk size information not returned as configured for UNIX/Linux systems.
IZ68319 		AIXAA collector: AIX 6.1 has three additional fields not collected by TUAM.
IZ66532			Process Engine: Apostrophes in identifier values in CSR files cause Database load step to fail.
IZ66895			Web Reporting: Reports Detail by rate group and detail by rate group/identifier are not showing same data as spreadsheet invoice by rategroup


2. Prerequisites

You must be running TUAM 7.1.2.1

3. Installation Instructions

How to install the patch

For Windows:
1. Extract the zip file to a temporary directory.
2. Open a command line window.
3. Use the "cd" command to change to the temporary directory.
4. Type "applyFix.bat" into the command line window.
   (If eWAS web server security is enabled, append the username and password for
   eWAS to the script execution command, i.e., type "applyFix.bat username password")

For Linux, Unix:
1. Extract the zip file to a temporary directory.
2. Open a shell.
3. Use the "cd" command to change to the temporary directory.
3. Type "chmod u+x applyFix.sh" in the shell. This will change the rights
   to applyFix.sh.
4. Type "./applyFix.sh" into the shell.
   (If eWAS web server security is enabled, append the username and password for
   eWAS to the script execution command, i.e., type "./applyFix.sh username password")

How to uninstall the patch

For Windows:
1. Open a command line window.
2. Use the "cd" command to change to the directory containing the extracted
   zip file.
3. Type "undoFix.bat" into the command line window.
   (If eWAS web server security is enabled, append the username and password for
   eWAS to the script execution command, i.e., type "undoFix.bat username password")

For Linux, Unix:
1. Open a shell.
2. Use the "cd" command to change to the directory containing the extracted
   zip file.
3. Type "chmod u+x undoFix.sh" into the shell. This will change the rights
   to undoFix.sh.
4. Type ./undoFix.sh into the shell.
   (If eWAS web server security is enabled, append the username and password for
   eWAS to the script execution command, i.e., type "./undoFix.sh username password")


NOTE: The fix will stop the eWAS web server, copy the updated program files,
and then restart the web server. If security is turned on for the web server,
you may be prompted for a user name and password when the update attempts to
stop the web server.

Additional instructions for APAR IZ68319:
(AIXAA collector: AIX 6.1 has three additional fields not collected by TUAM)
This APAR adds support for three new fields collected with the AIX Advanced Accounting collector. There are three new
rate codes that need to be defined in the ISC in order to include these new fields.
The new rate codes are as follows:

	AAID0423	AIX System Amount of physical memory allocated to a partition in page-seconds(in thousands)
	AAID0424	AIX System Amount of entitled memory allocated to a partition, reported in 4K pages
	AAID0425	AIX System Amount of I/O memory entitlement in use by a partition in page-seconds(in thousands)

Please see the TUAM online documentation for instructions on Adding Rates.


Problems (APARS) fixed:

IZ68716			VMware collector: VMCPURES metric is not returning for all VMs configured.
IZ67501			AIXAA collector: StopOnStepFailure parameter does not stop as expected for missing input files.
IZ65619			VMware collector: Disk size information not returned as configured for UNIX/Linux systems.
IZ68319 		AIXAA collector: AIX 6.1 has three additional fields not collected by TUAM.
IZ66532			Process Engine: Apostrophes in identifier values in CSR files cause Database load step to fail.
IZ66895			Web Reporting: Reports Detail by rate group and Detail by rate group/identifier are not showing same data as Spreadsheet invoice by rategroup