rgy_check

Check ClearCase registry files for inconsistencies

APPLICABILITY

ClearCase (administrative command)

SYNOPSIS

rgy_check { -views | -vobs } ... [ -region region ] [ -storage ]

DESCRIPTION

The rgy_check command examines the contents of ClearCase VOB and/or view registry files, and reports any errors or inconsistencies.

By default, rgy_check examines registry entries for all ClearCase network regions. Use -region to examine only the VOB and/or view registry for a single region.

Registry Error Reporting

If rgy_check finds any errors or inconsistencies, it displays a line like the following at the end of its output:

Error: 21 total registry errors/inconsistencies detected.

For each problematic registry entry, rgy_check displays the registry entry and a warning or error message.

rgy_check reports the following general errors:

• Duplicate entries in the region registry

• Malformed entries in the region registry

rgy_check reports the following VOB or view registration anomalies:

• Objects with no UUID

• Two objects with same UUID
• Objects with no host name
• Objects with no local (server) pathname
• Two objects pointing to same host/local-path
• Objects with no associated tags in any region (stranded object)

• Tags with no UUIDs

• Tags with UUIDs that do not match any object (stranded tag)
• Tags in regions that are not in the region registry
• Two tags in one region pointing to same object UUID
• Tags with no global pathname
• Tag registry entries with no tag
• Duplicate tags in the same region
• Tags in one region with duplicate global pathnames

If you specify the -storage option, rgy_check also reports these problems:

• View-tags that point to global paths with missing or incorrect .view files:
  • Missing .view file (usually a missing view)
  • .view file with invalid contents
  • .view file that contains a different view UUID (points to wrong view)
• VOB-tags that point to global paths with missing or incorrect replica_uuid files:
  • Missing replica_uuid file (usually a missing VOB)
  • replica_uuid file with invalid contents
  • replica_uuid file with incorrect UUID (points to wrong VOB)

Registry problems have various causes:

• Editing registry database entries directly, as with Notepad.
• Improper administration procedures; for example, removing a VOB with del rather than with rmvob
• Faulty upgrade procedures; for example, migrating a VOB to a new release that introduces a database schema change without reformatting the VOB (using reformatvob)
• Defects in older releases of ClearCase

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING REGISTRY ENTRIES TO DISPLAY.   Default: None. You must specify -vobs or -views (or both). rgy_check examines the VOB/view object and tag file entries for all network regions.

-views

Checks the contents of the ClearCase registry's view_tag and/or view_object files.

-vobs

Checks the contents of the ClearCase registry's vob_tag and/or vob_object files.

-region region

Specifies the network region. If you do not include a -region option, rgy_check reports on all VOBs or views in the ClearCase registry.

-storage

Checks for the existence of registered VOB and/or view storage directories. Given a storage directory's existence, rgy_check looks for basic storage configuration problems as well. Typically, registered storage pathnames for multiple network regions are not accessible from a single host. It is common practice to use -region to confine storage checks to the current host's network region.

EXAMPLES

• Check the VOB registry for errors and anomalies.

rgy_check -vobs
No registry errors/inconsistencies detected.

• Check VOB and view registries in the devel region (which includes the local host). Include storage directory checks. In this example, rgy_check finds a tutorial VOB from which the user has removed the VOB's replica_uuid file.

rgy_check -vobs -views -region devel -storage
rgy_check: Error: The VOB storage at \\io\alh\ccasetut\tut.vbs has no replica_uuid file.
This tag:
-tag = "\alh_IO_hw"
-global_path = "\\io\alh\ccasetut\tut.vbs"
-hostname = "io"
-mount_access = "private"
-mount_options = ""
-region = "devel"
-vob_replica = "7d7031db.6dfb11cf.a398.00:80:c8:81:fa:e0"

rgy_check: Error: 1 total registry errors/inconsistencies detected.

SEE ALSO

registry_ccase