WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Verifying against the bill of materials

After installation of the product, verify actual checksums of installed files against a bill of materials that ships with the product. If the checksums match, the installed product is installed correctly. If the checksums differ, review the differences to determine whether a problem exists.

Before you begin

Complete the product installation before attempting to compare checksums of the installed files to the shipped bill of materials.

About this task

Use the installver_wbi command to compare a set of bill-of-material files against a checksum of the installed files to verify that all installed files are correct. The product includes a bill-of-materials file for each component to provide this system of verifying installation files.

The installver_wbi tool dynamically generates a list of total components found in the installation.

The installver_wbi command file is located in the bin directory of the installation root directory:
  • For i5/OS operating system On i5/OS® platforms: install_root/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system On Linux® and UNIX® platforms: install_root/bin/installver_wbi.sh
  • For Windows operating system On Windows® platforms: install_root\bin\installver_wbi.bat

Change directories to the bin directory to start the installver_wbi tool from the command line.

To check the bill of materials against the installed file system, perform the following steps.

Procedure

Results

When you issue one of the checksum commands from the install_root/bin directory, the status of the command is displayed on the terminal console.

Logging results: The installver_wbi utility creates messages for each component. It also reports overall success based on the verification of all components in the bill of materials. The following messages indicate completion:
  • I CWNVU0400I: [ivu] Total issues found : 625
  • I CWNVU0340I: [ivu] Done.

The messages report the total number of issues found. If the issue count is zero, all of the components exist and no problems exist. The installver_wbi utility logs the results of the command to the install_root/logs/installver.log file if you use the -log parameter without specifying a file name for the log.

You can redirect the output using the -log parameter and an argument. The directory that you specify must already exist. For example: ./installver_wbi.sh -log /tmp/waslogs/my_installver.log

Example

The following command produces this example, which shows the results of comparing the installed product against the product bill of materials.
  • For i5/OS operating system On i5/OS platforms: ./installver_wbi
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: ./installver_wbi.sh
  • For Windows operating system On Windows platforms: installver_wbi.bat

Example output from components with errors

This example shows errors that the comparison finds.
I CWNVU0160I: [ivu] Verifying. 
I CWNVU0170I: [ivu] The installation root directory is E:\WPS61\ 
I CWNVU0300I: [ivu] The total number of user excluded files found is 38. 
I CWNVU0300I: [ivu] The total number of IBM excluded files found is 82.
I CWNVU0185I: [ivu] Searching component directory for file listing: files.list
I CWNVU0460I: [ivu] The utility is running. 
I CWNVU0260I: [ivu] The total number of components found is: 441 
I CWNVU0270I: [ivu] Gathering installation root data. 
W CWNVU0280W: [ivu] Component mismatch: expected mismatchcomponentname 
  but found mismatchingname
I CWNVU0360I: [ivu] The following bill of materials issue is found for component 
  nullvaluesample: Hash must not be null or an empty string.
I CWNVU0360I: [ivu] The following bill of materials issue is found for component 
  nullvaluesample: Name must not be null or an empty string.
I CWNVU0360I: [ivu] The following bill of materials issue is found for component 
  nullvaluesample: Hash must not be null or an empty string.
I CWNVU0360I: [ivu] The following bill of materials issue is found for component 
  nullvaluesample: Permission must not be null or an empty string.
I CWNVU0360I: [ivu] The following bill of materials issue is found for component 
  symlinksample: Hash must not be null or an empty string.
I CWNVU0290I: [ivu] Starting the verification for 6 components.

I CWNVU0470I: [ivu] Starting to analyze: _binarycomponentsample
I CWNVU0480I: [ivu] Done analyzing: _binarycomponentsample

I CWNVU0470I: [ivu] Starting to analyze: nullvaluesample
I CWNVU0430I: [ivu] The following file is missing: testpath
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: nullvaluesample

I CWNVU0470I: [ivu] Starting to analyze: overlapbinarycomponentsample
W CWNVU0422W: [ivu] The following file is overlapped: lib/binaryTest.jar
W CWNVU0425W: [ivu] The overlap is caused by: _binarycomponentsample
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: overlapbinarycomponentsample

I CWNVU0470I: [ivu] Starting to analyze: regularcomponentsample
I CWNVU0440I: [ivu] The following file is different: lib/different.jar
I CWNVU0410I: [ivu] fc19318dd13128ce14344d066510a982269c241b is the 
checksum in the bill of materials.
I CWNVU0420I: [ivu] 517d5a7240861ec297fa07542a7bf7470bb604fe is the 
checksum on the file system.
I CWNVU0440I: [ivu] The following file is different: lib/ibmtemplateexclude.jar
I CWNVU0410I: [ivu] d3ac7a4ef1a8ffb4134f2f6e7f3c0d249d74b674 is the 
checksum in the bill of materials.
I CWNVU0420I: [ivu] d3ac7a4ef1a838b4134f2f6e7f3c0d249d74b674 is the 
checksum on the file system.
I CWNVU0430I: [ivu] The following file is missing: lib/missing.jar
I CWNVU0440I: [ivu] The following file is different: lib/usertemplateexclude.jar
I CWNVU0410I: [ivu] 12dea96fec20593566ab75ff2c9949596833adc9 is the 
checksum in the bill of materials.
I CWNVU0420I: [ivu] 12dea96fec20593566ab75692c9949596833adc9 is the 
checksum on the file system.
I CWNVU0430I: [ivu] The following file is missing: missingfilebutwithbaddirectory/
missingBadDirectory.jar
I CWNVU0390I: [ivu] Component issues found : 5
I CWNVU0480I: [ivu] Done analyzing: regularcomponentsample

I CWNVU0470I: [ivu] Starting to analyze: symlinksample
I CWNVU0480I: [ivu] Done analyzing: symlinksample

I CWNVU0400I: [ivu] Total issues found : 7
I CWNVU0340I: [ivu] Done.

Example output from a typical successful installation

This example shows typical results from checking a successful installation.

Carefully examine an issue before assuming that the issue is a problem.

I CWNVU0160I: [ivu] Verifying.
I CWNVU0170I: [ivu] The installation root directory is E:\WPS61\
I CWNVU0300I: [ivu] The total number of user excluded files found is 38.
I CWNVU0300I: [ivu] The total number of IBM excluded files found is 82.
I CWNVU0185I: [ivu] Searching component directory for file listing: files.list
I CWNVU0460I: [ivu] The utility is running.
I CWNVU0260I: [ivu] The total number of components found is: 441
I CWNVU0270I: [ivu] Gathering installation root data.
I CWNVU0290I: [ivu] Starting the verification for 439 components.

I CWNVU0470I: [ivu] Starting to analyze: ArtifactLoaderImpl
I CWNVU0480I: [ivu] Done analyzing: ArtifactLoaderImpl

I CWNVU0470I: [ivu] Starting to analyze: activity.impl
I CWNVU0480I: [ivu] Done analyzing: activity.impl

I CWNVU0470I: [ivu] Starting to analyze: activity.session.impl
I CWNVU0480I: [ivu] Done analyzing: activity.session.impl

I CWNVU0470I: [ivu] Starting to analyze: acwa
I CWNVU0480I: [ivu] Done analyzing: acwa

I CWNVU0470I: [ivu] Starting to analyze: adapter
I CWNVU0480I: [ivu] Done analyzing: adapter
...


I CWNVU0470I: [ivu] Starting to analyze: workspace
I CWNVU0480I: [ivu] Done analyzing: workspace

I CWNVU0470I: [ivu] Starting to analyze: workspace.query
I CWNVU0480I: [ivu] Done analyzing: workspace.query

I CWNVU0470I: [ivu] Starting to analyze: wps.rt.bundle
I CWNVU0480I: [ivu] Done analyzing: wps.rt.bundle

I CWNVU0470I: [ivu] Starting to analyze: wps.wccm.bundle
I CWNVU0480I: [ivu] Done analyzing: wps.wccm.bundle

I CWNVU0470I: [ivu] Starting to analyze: wpsnd
I CWNVU0480I: [ivu] Done analyzing: wpsnd

I CWNVU0470I: [ivu] Starting to analyze: wsadie.bundle
I CWNVU0480I: [ivu] Done analyzing: wsadie.bundle

I CWNVU0470I: [ivu] Starting to analyze: wsba.impl
I CWNVU0480I: [ivu] Done analyzing: wsba.impl

I CWNVU0400I: [ivu] Total issues found : 0
I CWNVU0340I: [ivu] Done.

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_installver_wbi_chk.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).