Comparing specific file and component checksums

Comparing specific file and component checksums

Specify individual files or components to include in the bill of materials verification.
Install the product before comparing checksums of individual files and components.

Overview

This topic describes how to use inclusion properties to specify individual files and components. By default, IBM includes all files in the checksum comparison except for the 78 IBM excluded files.
 I CWNVU0160I: [ivu] Verifying.
 I CWNVU0170I: [ivu] The installation root directory is C:\IBM\WebSphere\AppServerV602\
 I CWNVU0300I: [ivu] The total number of user excluded files found are 0.
 I CWNVU0300I: [ivu] The total number of IBM excluded files found are 78.
 I CWNVU0180I: [ivu] Searching directory properties\version\install\6.0.0.0\
                     backup for file listing: files.list
 I CWNVU0260I: [ivu] The total number of components found is: 285
 I CWNVU0270I: [ivu] Gathering installation root data.
 I CWNVU0460I: [ivu] The utility is running.
 I CWNVU0290I: [ivu] Starting the verification for 285 components.

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

...
Several different methods are provided to include only certain files in the comparison.

Procedure
Compare checksums and include specified components only in the comparison:

./installver.sh -includecomponent comp1;comp2;comp3;...

installver.bat -includecomponent comp1;comp2;comp3;...

For example, you might include the activity component:

./installver.sh -log -includecomponent activity

installver.bat -log -includecomponent activity

The resulting messages show the inclusion:
I CWNVU0160I: [ivu] Verifying.
I CWNVU0170I: [ivu] The installation root directory is C:\IBM\WebSphere\AppServerV602\
I CWNVU0300I: [ivu] The total number of user excluded files found are 0.
I CWNVU0300I: [ivu] The total number of IBM excluded files found are 78.
I CWNVU0180I: [ivu] Searching directory properties\version\install\6.0.0.0\
                    backup for file listing: files.list
I CWNVU0260I: [ivu] The total number of components found is: 285
I CWNVU0270I: [ivu] Gathering installation root data.
I CWNVU0460I: [ivu] The utility is running.
I CWNVU0460I: [ivu] The utility is running.
I CWNVU0290I: [ivu] Starting the verification for 1 components.

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

I CWNVU0400I: [ivu] Total issues found : 0
I CWNVU0340I: [ivu] Done.
Include only certain files in the comparison:

app_server_root/bin/installver.sh -include fn1;fn2;fn3

app_server_root\bin\installver.bat -include fn1;fn2;fn3

For example, you might include only the properties/version/proxy.server.component file, which was changed to generate the checksum difference in this example.
installver.bat -log 
 -include properties/version/proxy.server.component
The result shows that the included file was in the comparison, which scanned 285 components looking for all components that refer to the file:
I CWNVU0160I: [ivu] Verifying.
I CWNVU0170I: [ivu] The installation root directory is C:\IBM\WebSphere\AppServerV602\
I CWNVU0300I: [ivu] The total number of user excluded files found are 0.
I CWNVU0300I: [ivu] The total number of IBM excluded files found are 78.
I CWNVU0180I: [ivu] Searching directory properties\version\install\6.0.0.0\  
                    backup for file listing: files.list
I CWNVU0260I: [ivu] The total number of components found is: 285
I CWNVU0270I: [ivu] Gathering installation root data.
I CWNVU0460I: [ivu] The utility is running.
I CWNVU0290I: [ivu] Starting the verification for 285 components.

I CWNVU0470I: [ivu] Starting to analyze: activity
I CWNVU0480I: [ivu] Done analyzing: activity
...
I CWNVU0470I: [ivu] Starting to analyze: proxy.server
I CWNVU0440I: [ivu] The following file is different: properties/version/
                    proxy.server.component
I CWNVU0410I: [ivu] f385fc95977092e0482d52f9d1d5bebbc39fbb10 is the checksum 
                    in the bill of materials.
I CWNVU0420I: [ivu] b43bda7f1e7202d1f9495fc74ac14b8d85830aab is the checksum 
                    on the file system.
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: proxy.server
...
I CWNVU0400I: [ivu] Total issues found : 1
I CWNVU0340I: [ivu] Done.
If you know that a file is in only one component, you can speed up the comparison by restricting the comparison of the file to the relevant component:
installver.bat -log -includecomponent proxy.server -include properties/version/
   proxy.server.component 
The result shows the comparison was restricted to one component:
I CWNVU0160I: [ivu] Verifying.
I CWNVU0170I: [ivu] The installation root directory is C:\IBM\WebSphere\AppServerV602\
I CWNVU0300I: [ivu] The total number of user excluded files found are 0.
I CWNVU0300I: [ivu] The total number of IBM excluded files found are 78.
I CWNVU0180I: [ivu] Searching directory properties\version\install\6.0.0.0\
                    backup for file listing: files.list
I CWNVU0260I: [ivu] The total number of components found is: 285
I CWNVU0270I: [ivu] Gathering installation root data.
I CWNVU0460I: [ivu] The utility is running.
I CWNVU0290I: [ivu] Starting the verification for 1 components.

I CWNVU0470I: [ivu] Starting to analyze: proxy.server
I CWNVU0440I: [ivu] The following file is different: properties/version/
                    proxy.server.component
I CWNVU0410I: [ivu] f385fc95977092e0482d52f9d1d5bebbc39fbb10 is the checksum 
                    in the bill of materials.
I CWNVU0420I: [ivu] b43bda7f1e7202d1f9495fc74ac14b8d85830aab is the checksum 
                    on the file system.
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: proxy.server

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

When you issue one of the checksum commands from the app_server_root/bin directory, the status of the command is displayed on the terminal console or in a log file.

What to do next

Go to Change the default message digest algorithm to learn more about the installver command.

Related tasks

Excluding files from a checksum comparison
Change the default message digest algorithm
Verifying checksums of installed files