versionInfo command
The versionInfo command generates a report from data extracted from XML files in the properties/version folder. The report includes a list of changed components and installed or uninstalled maintenance packages.
Product version information
The versionInfo tool displays important data about WAS 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 version reports
The following report generation scripts extract data from XML data files in the APP_ROOT/properties/version folder:
- versionInfo script
Lets you use parameters to create a version report.
- genVersionReport script
Generates the versionReport.html report file in the current working directory, which is usually the APP_ROOT/bin directory.
Location of the command file
[AIX] [HP-UX] [Linux] [Solaris]
APP_ROOT/bin/versionInfo.sh
(Windows) APP_ROOT\bin\versionInfo.bat
Syntax for the versionInfo command
The command syntax is:
[AIX] [HP-UX] [Linux] [Solaris]
versionInfo.sh [ -format text | html ] [ -file file_name ] [ -long ] [ -maintenancePackages ] [ -maintenancePackageDetail ] [ -components ] [ -componentDetail ] versionInfo [ -help | /help | -? | /? | -usage ]
(Windows)
versionInfo [ -format text | html ] [ -file file_name ] [ -long ] [ -maintenancePackages ] [ -maintenancePackageDetail ] [ -components ] [ -componentDetail ] versionInfo [ -help | /help | -? | /? | -usage ]Issue the command from the bin directory of APP_ROOT.
Parameters
Non-root limitations
We cannot run the versioninfo command with a user which does not have authority to write to the main product files. We can avoid the problem by running the versioninfo command with a user with authority to write to APP_ROOT/properties/version/history or by changing the permissions of the directory to allow other users to write to it.
If using zones with the Solaris operating system, then run the versionInfo command in the global zone.
Report description
The versionInfo command reports the following information:
Installation information
Display 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 defined by the WAS_HOME environment variable.
- Version directory - The file path of the version directory of the current IBM WAS - ND installation.
- DTD directory - The file path of the DTD directory of the current IBM WAS - ND installation.
- Log directory - The file path of the log directory of the current IBM WAS - ND installation. The maintenance package log files are in the directory.
- Backup directory - The file path of the backup directory of the current IBM WAS - ND 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.
Installation platform information
Displays information from the platform.websphere file:
- Name - IBM WAS
- Version - 7.0
Product list information
Displays a list of installed WebSphere products:
- Product ID - WAS ND v7.0 ID of the installed product.
- Status - The status of WAS ND, either installed or uninstalled.
Installed product information
This information and the other information topic descriptions are hierarchal for each installed product, component, component update, installed maintenance package, included APARs, and component updates.
This section of the report displays the following information:
- Name - The name of the installed product.
- Version - The current version of WAS ND. Installing or uninstalling fix packs or refresh packs modifies this version.
- ID - WAS ND v7.0 ID of WAS installed, such as BASE, BASETRIAL, ND, EXPRESS, EXPRESSTRIAL, embeddedEXPRESS, IHS, XD, PLG, or CLIENT.
- Build level - The build level of the installed product.
- Build date - The build date of the installed product.
Installed component information
Display the following component-level information of the installed component from the .component file under the /properties/version directory:
- Component name - The name of the installed component
- Spec version - The spec version of the current component
- Build level - The build level of the current component
- Build date - The build date of the current component
Installed component update information
Display the general maintenance package information:
- Component name - the name of the installed component
- Update type - All interim fixes, fix packs and refresh packs are maintenance packages. The update type field is always set to maintenance package.
- Maintenance package ID - The ID of the maintenance package that is responsible for the current maintenance level of WAS ND.
- Update effect - The updated action taken on a particular component. The default effect is replace.
- Log file name - The file path of the log file that records the maintenance actions for the current maintenance level.
- Backup file name - The file path of the backup file generated during the installation of the maintenance package. Not applicable if the component is restored as a result of an uninstall of a maintenance package.
- Timestamp - The time at which the component is updated. The timestamp is stated in GMT offset values.
Installed maintenance package information
Display the general maintenance package information:
- Maintenance Package ID - the maintenance package ID
- Description - the description of the maintenance package
- Build Date - the build date of this maintenance package
Included APARs information
Display the list of APARs fixed by this maintenance package.
Component updates information
Display the following information about each component that is updated by the installed maintenance package:
- Component name - The name of the installed component.
- Updated effect - The update action taken on the component by the maintenance package. The default action is replace.
- Timestamp - The time at which the component update is installed (GMT offset).
Sample versionInfo report
When the WAS ND product has no interim fixes or fix packs applied, the versionInfo script outputs information similar to the following:
WVER0010I: Copyright (c) IBM Corporation 2002, 2005, 2008; All rights reserved. WVER0012I: VersionInfo reporter version 1.15.1.17, dated 11/23/07 -------------------------------------------------------------------------------- IBM WAS Product Installation Status Report --------------------------------------------------------------------------------Report at date and time April 16, 2008 9:03:51 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
Product List -------------------------------------------------------------------------------- ND installed
Installed Product -------------------------------------------------------------------------------- Name IBM WAS - ND Version 7.0.0.0 ID ND Build Level cc0807.88 Build Date 2/23/08 -------------------------------------------------------------------------------- End Installation Status Report --------------------------------------------------------------------------------
Related information
Use command line tools
genVersionReport