10.1 Troubleshooting Tips

Use the following files and commands to help diagnose MultiSite problems:

• Log files. To view log files, use the cleartool getlog command or the ClearCase Administration Console (Windows).

• MultiSite log files

Export/import problems	Files in directory /var/adm/atria/log/sync_logs (UNIX) or ccase-home-dir\var\log (Windows)
Transport problems	shipping
Mastership request problems	msadm
Other errors	Command window Event Viewer (Windows)




• ClearCase log files. If ClearCase problems affect MultiSite operation (for example, a MultiSite operation fails when the ClearCase db_server cannot process the VOB database), useful information appears in these log files.

• Make sure you install the latest ClearCase and MultiSite patches.

• Most MultiSite commands do not require a view context or a mounted VOB replica. If a command such as syncreplica -import fails, you can produce better diagnostics by following the steps below.

On UNIX:

1. Set a dynamic view or change to a directory within a snapshot view.

2. Mount the VOB replica (dynamic view) or load a single file in the VOB (snapshot view).

3. Change into a directory in the replica. If you used a snapshot view, this must be the directory containing the file you loaded.

4. Enter the command again.

On Windows:

1. Change to a directory within a snapshot view or to a view drive.

2. Mount the VOB replica (dynamic view) or load a single file in the VOB (snapshot view).

3. Change into a directory below the root directory. If you used a snapshot view, this must be the directory containing the file you loaded.

4. Enter the command again.

• The commands listed below provide valuable information, especially if you are sending data to Rational Technical Support:

multitool -version
multitool lsreplica
multitool lsepoch
uname -a (UNIX)
cleartool -version

On Windows, look for applicable messages in the Event Viewer's application log and system log, and in the ClearCase MVFS log files (c:\mvfslogs).