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:

Location of the command file

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


(Windows) APP_ROOT\bin\versionInfo.bat

Syntax for the versionInfo command

The command syntax is:
[AIX] [HP-UX] [Linux] [Solaris] [ -format text | html ]
               [ -file file_name ]
               [ -long ]
               [ -maintenancePackages ]
               [ -maintenancePackageDetail ]
               [ -components ]
               [ -componentDetail ]

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


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.


-? or /?

Displays command syntax.


Adds a list of installed components to the report.


Adds details about installed components to the report.

-file file_name

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.


Creates the long version of the report.


Adds a list of applied maintenance packages to the report.


Adds details about an applied maintenance package to the report.


Displays command syntax.

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:


Installation platform information

Displays information from the platform.websphere file:


Product list information

Displays a list of installed WebSphere products:


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:


Installed component information

Display the following component-level information of the installed component from the .component file under the /properties/version directory:

Installed component update information

Display the general maintenance package information:

Installed maintenance package information

Display the general maintenance package information:

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:

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, 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 ID ND Build Level cc0807.88 Build Date 2/23/08 -------------------------------------------------------------------------------- End Installation Status Report --------------------------------------------------------------------------------

Related information

Use command line tools