historyInfo command

The historyInfo command generates a report from data extracted from XML files in the properties/version folder and the properties/version/history folder. The report includes a list of changed components and a history of installed or uninstalled maintenance packages.

Product history information

The historyInfo tool displays important data about the product and its installed components, such as the build version and build date. History information for installation and removal of maintenance packages also displays in the report. 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 extract data from XML data files in the properties/version folder and the properties/version/history folder:
  • historyInfo script

    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.

Location of the command file

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

[Windows] app_server_root\bin\historyInfo.bat

Syntax for the historyInfo command

The command syntax is:

[AIX] [HP-UX] [Linux] [Solaris]

historyInfo.sh [ -format text | html ]
               [ -file file_name ]
               [ -maintenancePackageID ID_of_maintenance_package ]
               [ -component component_name ]


historyInfo [ -help | /help | -? | /? | -usage ]
[Windows]
historyInfo [ -format text | html ]
            [ -file file_name ]
            [ -maintenancePackageID ID_of_maintenance_package ]
            [ -component component_name ]


historyInfo [ -help | -? | /help | /? | -usage ]

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

Parameters

-? or /?
Displays command syntax.
-component component_name
Specifies the name of a component. When specified, the product history report displays events for only the named component. When not specified, the report displays events for all components.
-file file_name
Specifies the output file name. The report goes to standard output (stdout) by default.
-format text | html
Selects the format of the report. The default is "text".
-help or /help
Displays command syntax.
-maintenancePackageID ID_of_maintenance_package
Specifies the ID of the interim fix, fix pack, or refresh pack. When specified, the product history report displays events for only the named maintenance package. When not specified, the report displays events for all maintenance packages.
-usage
Displays command syntax.

Report description

The historyInfo command reports the following 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 WAS 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 maintenance package log files are in the directory.
  • Backup directory - The file path of the backup directory of the current WAS installation. The backup files generated during the installation of maintenance packages are in this directory.
  • TMP directory - The file path of the temporary directory of the current machine.
  • History directory - The file path of the history directory of the current installation. The history files are in the directory.
  • History File - The file path of the event.history file.

Installation event information

Displays the list of installed maintenance packages (interim fix, fix pack, and refresh pack) and the following related information:
  • Maintenance package ID - The ID of the maintenance package.
  • Action - The action taken with this maintenance package, which is either install or uninstall.
  • Package file name - The file name of the maintenance package that was installed.
  • Log file name - The file path of the log file generated during the installation or removal of the maintenance package.
  • Backup file name - The file path of the backup file generated during the installation of the maintenance package. This field does not apply for an uninstall action.
  • Timestamp - The time when the maintenance action (install or uninstall) occurs. The time is stated in relation to GMT.
  • Result - The result of the installation or removal action. The result is either success, partial success, or failure.

Component installation event information

Displays the following component-level information of the event for the current maintenance package:
  • Maintenance package ID - The ID of the maintenance package to which this particular installation event belongs.
  • Component name - The name of the current component.
  • Action - The action taken on this component due to the action of the current maintenance package, either install or uninstall
  • Update action - The updated action taken on this component. By default, the update action for an installation action is replace.
  • Timestamp - The time at which the action occurs for the maintenance package (GMT offset values).
  • Result - The result of the install or uninstall action. The result is either success, partial success or failure.

Sample historyInfo report

The historyInfo script outputs the information similar to the following:

WVER0210I: Copyright (c) IBM Corporation 2002, 2005, 2008; All rights reserved.
WVER0212I: HistoryInfo Reporter Version 1.7.1.15, Dated 2/27/07

--------------------------------------------------------------------------------
IBM WebSphere Application Server History Report
--------------------------------------------------------------------------------

Report at date and time April 16, 2008 10:27:26 AM EDT

Installation
--------------------------------------------------------------------------------
Product Directory        C:\WAS70_ND
Version Directory        C:\WAS70_ND\properties\version
DTD Directory            C:\WAS70_ND\properties\version\dtd
Log Directory            C:\WAS70_ND\logs
Backup Directory         C:\WAS70_ND\properties\version\nif\backup
TMP Directory            C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp
History Directory        C:\WAS70_ND\properties\version\history
History File             C:\WAS70_ND\properties\version\history\event.history

Warning: No events are available.

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



Related reference
genHistoryReport command
Related information
Using command line tools
Reference topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 1:44:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-dist&topic=rinshistoryinfo
File name: rins_historyInfo.html