IBM Support

Incorrect version of ClearCase database utilities will produce error output on UNIX and Linux

Troubleshooting


Problem

This technote explains what happens when incorrect versions of IBM® Rational® ClearCase® database utilities such as dbcheck, countdb or vob_sidwalk are run on a VOB on UNIX® or Linux®.

Cause


When running dbcheck, countdb or vob_sidwalk, if the schema version of the utility does not match the schema version of the database being checked, many errors will be reported.

Normally the correct version of the utilities will be available to you. However, when a VOB is moved from one server to another without first ensuring that the schema version of the server will match the VOB, you may end up running the wrong version.

Also, if you have a UNIX or Linux VOB server that was installed as a linked install and have schema 54 VOBs, all the Schema specific applications and tools will link to schema 53 tools.

Resolving The Problem



If you believe you are running into this situation, first make sure you know the schema version of the VOB in question by describing the VOB:

cleartool describe vob:\<vob-name>


In the output, look for a line like:
database schema version: 54


Note: Unless you are in the middle of a migration, this should show the same schema version as the server:

Run the following command on the server to determine its schema version:

cleartool -version


In the output, look for a line like:

VOB database schema version: 54

By default, a ClearCase release area will contain the dbcheck for both schema 53 and 54. Once you know the schema version of the VOB, you can execute dbcheck directly from the release area. Files under an "ldb" directory indicate schema 54. For example, the following paths are sample paths to a schema 54 dbcheck utility:

2003.06:  /ccase_rls/2003.06.00/sun5/clearcase/sun5/ldb/etc/utils
2002.05:  /ccase_rls/v5.0/sun5/sun5/ldb/etc/utils
   4.1:  /ccase_rls/v4.1/sun5/sun5/ldb/etc/utils/dbcheck



Here are some sample paths to the schema 53 version of dbcheck:

2003.06:  /ccase_rls/2003.06.00/sun5/clearcase/etc/utils
2002.05:  /ccase_rls/v5.0/sun5/etc/utils

    4.1:  /ccase_rls/v4.1/sun5/etc/utils/dbcheck

Note: The etc directory at this level in the release area may also be a symlink to sun5/etc, so the path may look like this:

/ccase_rls/v4.1/sun5/sun5/etc/utils/dbcheck


You can also execute the UNIX/Linux find command from the top of your release area to locate these files.

Example:

find . -name "dbcheck" -print

Related Information

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"2002.05.00;2003.06.00;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Database","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21122278