installver command

The installver command starts the bill of materials installation verification program. The installver tool verifies that the installation of the product and the creation of a profile was successful. Each profile has its own installver command file.

This tool checks a bill of material (BOM) inventory list of data against the installed files on the file system to ensure that all installed files are correct. The BOM is provided and updated by IBM to support this installation verification system.

The installver program does not start the application server or deployment manager automatically like the IVT program. The installver computes a checksum based on the bill of materials that is shipped with the product to verify proper installation.

Start the installver program from the command line on all distributed platforms.

Location of the command file

The location of the installver script for any profile is:

• install_root/profiles/profile_name/bin/installver.sh

• install_root\profiles\profile_name\bin\installver.bat

• profile_root/bin/installver

Product

The installver script is available in WebSphere Application Server, WebSphere Application Server - Express, and WebSphere Application Server Network Deployment.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Syntax

Use the following syntax for the command to automatically check the bill of materials against the installed file system:

• install_root/profiles/profile_name/bin/installver.sh

• install_root\profiles\profile_name\bin\installver.bat

• installver

Parameters

The following parameters are associated with this command.

createprofiletemplate

Creates a profile template for user file exclusions. Manually edit the template properties file to exclude particular files from verification.

-verbose

Provides verbose output of what the tool checks and what the tool discovers.

-help

Displays usage information.

Properties file for exclusions

A single user configurable properties file is available to specify a list of files to exclude from the bill of materials verification. Each profile can have an exclude list of files. The properties file is stored in the profile_root/properties directory.

The properties file has the following format:

<template>
 <componentfiles componentname="name of component>
  <file>
   <relativepath action="exclude">filename</relativepath>
  </file>
 </componentfiles>
</template>

Create a profile for managing user exclusions from the bill of materials:

• ./installver.sh -createprofiletemplate

• installver.bat -createprofiletemplate

• installver -createprofiletemplate

Display verbose results:

• installver.sh -verbose

• installver.bat -verbose

• installver -verbose

Display usage information:

• installver.sh help

• installver.bat help

• installver help

Using a properties file to exclude files from checking against the bill of materials:

• installver.sh properties properties_filename

• installver.bat properties properties_filename

• installver properties properties_filename

Logging

The installver command logs results to the profile_root/logs/ivtClient.log file. Indicators are:

• VERIFICATION SUCCESS

• VERIFICATION UNSUCCESSFUL

When the verification is unsuccessful, the installver tool creates a report of potential conflicts.

Example

The following examples test the installed product against the shipped bill of materials for the product.

 installver.sh 

 installver.bat

 installver