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
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21122278