pversions (UNIX)

UNIX version of the command: displays the version information for Platform products installed on UNIX hosts.

Synopsis

pversions [-f env_file]
pversions -p [-f env_file] product_name
pversions -b [-f env_file] build_number
pversions -q [-f env_file] file_name
pversions -c package_name
pversions -h

Description

By default, displays the version and patch level of Platform products.

The cluster location is normally determined by your environment setting, so ensure your environment is set before you run this command (for example, you sourced cshrc.lsf or profile.lsf).

For each binary type, displays basic version information (package build date, build number, package installed date) and lists patches installed (package type, build number, date installed, fixes).

Optionally, the command can also be used to do the following:

  • Check the contents of a package before installing it

  • Show information about a specific Platform product installed

  • Show information about installed packages from specific build

  • Find current versions of a specific Platform file and see information for each

Options

-f env_file

This option should only be used if you cannot set your environment (for example, you cannot source cshrc.lsf or profile.lsf).

Specify the full path and file name of a file (such as your LSF install.config file) that properly defines the parameter LSF_TOP.

If you use this option, the command gets the cluster location from this file, not from the settings in your environment.

-b build_number

Specify the build number of an installed patch (you can specify the most recent full installation or patches installed after the most recent full installation).

Displays information and the contents of the build (binary type and install date, notes, fixes, and files in the package).

-c package_name

Specify the full path and file name of an uninstalled package. For this option, you do not need to set your environment because a cluster is not required.

Displays package contents (notes, fixes, and files in the patch).

-p product_name

Specify one Platform product to see information for that product only. Specify 'LSF' to see information about LSF or 'LSF Session Scheduler' to see information about Platform Session Scheduler.

-q file_name

Specify the file name of one installed file.

For each binary type, displays basic version information and file location. If the binary has been updated after the most recent full installation, displays additional information about the most recent patch that updated the file (build number, fixes, notes, date installed)

-h

Outputs command usage and exits.

Output

Information is displayed in your command console.

Product Version Information (Default )

By default, displays product information for entire cluster.

For each Platform product, displays product name and version followed by specific information about each binary type.

For each binary type, displays basic version information (package build date, build number, package installed date) and lists any patches installed (package type, build number or fix number, date installed).

binary type

Binary type, build number of binary, and build date of the binary for the most recent full installation (a full installation is installation of any distribution that contains a complete set of new binaries. A full installation can be a new cluster, a licensed upgrade, or patching with an enhancement pack).

installed

Date the binary was installed for the most recent full installation.

patched

For each patch after the most recent full installation, displays fix number, build number, and date patch was installed. If the patch was a fix pack, multiple fixes are listed.

File Version Information (-q)

With -q, displays information for specified file only.

For each Platform product that contains the specified file, displays product name and version followed by specific information about each binary type.

For each binary type that contains the specified file, displays basic version information and file location. If the binary has been updated after the most recent full installation, displays additional information about the most recent patch that updated the file (build number, fixes, notes, date installed).

binary type

Binary type, build number of binary, and build date of the binary for the most recent full installation (a full installation is any distribution that contains a complete set of new binaries. A full installation can be a new cluster installation, a licensed version upgrade, or patching with an enhancement pack).

installed

Date the binary was installed for the most recent full installation.

file

Full path to the version of the file being used for this binary type.

last patched

For the last patch to update the file after the most recent full installation, displays build number and date patch was installed.

last patch notes

Optional. Some information provided by Platform for the last patch that updated the file.

last patch fixes

Fixes included in the last patch that updated the file.

Build Version Information (-b)

With -b, displays information for patches with the specified build number only.

For each Platform product, if the product is using binaries from the specified build, displays product name and version followed by specific information about each binary type.

For each binary type, displays the following:

binary type

Binary type, build number and build date of the patch.

installed

Date the patch was installed.

notes

Optional. Some information provided by Platform for the build.

fixes

Fixes included in the patch.

files

Files included in the patch (not shown for a full distribution such as enhancement pack). Full path to the file installed by this patch.

Package Version Information (-c)

With -c, displays version information for a specified uninstalled package.

product

Displays Platform product name and version.

binary type

Binary type, build number and build date of the patch.

notes

Optional. Some information provided by Platform for the build.

fixes

Fixes included in the patch.

files

Files included in the patch (not shown for a full distribution such as enhancement pack). Relative path to the file.