genHistoryReport command

The genHistoryReport command generates the historyReport.html report file in the current working directory, which is usually the bin directory. The report includes a list of installed or uninstalled fix packs and interim fixes. The genHistoryReport script invokes the historyInfo script specifying the correct parameters to place the information generated into an HTML file in the current directory.

Product history information

The historyInfo tool displays historical data about the product and the installation and removal of fix packs and interim fixes for the product. This tool is particularly useful when working with support personnel to determine the cause of any problem.

Product history reports:

The following report-generation scripts display installed product information:
  • historyInfo command

    Lets you use parameters to create a history report.

  • genHistoryReport script

    Generates the historyReport.html report file in the current working directory, which is usually the bin directory. The report includes a list of fix packs and interim fixes.

Location of the command file

[IBM i]app_server_root/bin/genHistoryReport

[Linux][AIX][HP-UX][Solaris]app_server_root/bin/genHistoryReport.sh

[Windows]app_server_root\bin\genHistoryReport.bat

Syntax for the genHistoryReport command

The command syntax is:

[IBM i]
genHistoryReport
[Linux][AIX][HP-UX][Solaris]
genHistoryReport.sh 
[Windows]
genHistoryReport.bat

Issue the command from the bin directory of the app_server_root directory.

Report description

The historyInfo command generates the report. The genHistoryReport command calls the historyInfo command with a set of report parameters that reports the following information:

Installation information

Installation information displays the following general information about the current installation:
  • Report date and time - The date and time that the report was generated. The timestamp is formatted according to the current locale.
  • Product Directory - The file path to the installation root directory of the product.
  • Version Directory - The file path of the version directory of the current product installation.
  • DTD Directory - The file path of the DTD directory of the current installation.
  • Log Directory - The file path of the log directory of the current installation. The fix pack and interim fix log files are in the directory.

Installation event information

Installation event information displays the list of installed fix packs and interim fixes as well as the following related information:
  • Installation Manager Offering ID or Fix ID - The ID of the offering or product installed using Installation Manager.
  • Action - The action taken.
  • Version - Either the version of the interim fix or the version of the product after the action was performed.
  • Log File Name - The file path of the log file generated during the event.
  • Timestamp - The time when the action occurred. The time is stated in relation to GMT.
  • Result - The result of the action. The result is either success, partial success, or failure.
  • Installed Features - The features installed on the product.
[AIX Solaris HP-UX Linux Windows][z/OS]

Sample historyInfo report

The genHistoryReport script creates the following information in the historyReport.html report file:

--------------------------------------------------------------------------------
IBM WebSphere Product History Report
--------------------------------------------------------------------------------

Report at date and time April 7, 2010 3:07:36 PM EDT

Installation
--------------------------------------------------------------------------------
Product Directory    G:\IBM\WebSphere\AppServer_v85_nd
Version Directory    G:\IBM\WebSphere\AppServer_v85_nd\properties\version
DTD Directory        G:\IBM\WebSphere\AppServer_v85_nd\properties\version\dtd
Log Directory        C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs

Installation Event
--------------------------------------------------------------------------------
Install Manager Offering ID        com.ibm.websphere.ND.v85
Action                             install
Version                            8.5.0.0
Log File Name                      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\20101026_1527.xml
Timestamp                          2010-10-26 17:35:27-0400
Result                             success
Installed Features                 Sample applications

Installation Event
--------------------------------------------------------------------------------
Install Manager Offering ID        com.ibm.websphere.ND.v85
Action                             install
Version                            8.5.0.0
Log File Name                      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\20101027_1347.xml
Timestamp                          2010-10-27 13:48:03-0400
Result                             success
Installed Features                 Sample applications
                                   Non-English language packages for the application server runtime environment

Installation Event
--------------------------------------------------------------------------------
Install Manager Offering ID        com.ibm.websphere.ND.v85
Action                             update
Version                            8.5.0.7
Log File Name                      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\20101027_1347.xml
Timestamp                          2010-10-27 13:53:48-0400
Result                             success
Installed Features                 Non-English language packages for the application server runtime environment
                                   Sample applications

Installation Event
--------------------------------------------------------------------------------
Fix ID                             com.ibm.websphere.ND.v85.FP8507.fix.1
Action                             install
Version                            8.5.0.7
Log File Name                      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\20101027_1347.xml
Timestamp                          2010-10-27 15:09:43-0400
Result                             success

Installation Event
--------------------------------------------------------------------------------
Install Manager Offering ID        com.ibm.websphere.ND.v85
Action                             uninstall
Version                            8.5.0.7
Log File Name                      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\20101027_1347.xml
Timestamp                          2010-10-27 16:01:52-0400
Result                             success
Installed Features                 Non-English language packages for the application server runtime environment

--------------------------------------------------------------------------------
End History Report
--------------------------------------------------------------------------------