Starting the synchronization process

The synchronization process starts automatically when you create a new ClearCase® Synchronized Stream. To enable ongoing synchronization after the synchronization host has been re-started, ensure that all synchronization process start-up scripts are run when a synchronization host re-starts.

About this task

The New ClearCase Synchronized Stream wizard creates a synchronization process start-up script for each ClearCase Synchronized Stream. These scripts are started by the wizard when they are created, and can be re-started from the ClearCase Synchronized Streams view. To ensure that scheduled synchronizations continue to run unattended even though the synchronization host might have been shut down and re-started, you can use host-specific programs to enable the scripts to run automatically whenever the synchronization host starts.

The synchronization process requires read/write access to both Rational® ClearCase and Rational Team Concert™. Access to Rational ClearCase is based on the identity under which the process runs. Synchronization process identity is determined by the credentials (user name and password) with which the user who starts the process logged on to the synchronization host. Access to the Rational Team Concert repository is controlled by the user name and password of the synchronization process account, which you specified in the wizard when the synchronized stream was created.

To start the synchronization process on Linux, use the ccc start syncEngine command.

To start the synchronization process on a non-Linux host, run a synchronization process start-up script manually by completing the following steps:

Procedure

  1. Log on to the synchronization host as a member of the Rational ClearCase users group. This user must have permission to lock the Rational ClearCase stream or branch type that defines the synchronized stream (see Creating a ClearCase Synchronized Stream).
  2. In the ClearCase Synchronized Streams view, right-click the stream and click Restart Synchronization Engine.

Results

When the synchronization process starts, it displays a message of the form:

date time Running build loop...
date time Waiting for request...

where date time is a string of the form 2007-11-13 15:34:55. The synchronization process polls the repository for requests and, when it finds one, it displays a message of this form:

date time  Found a request for build definition "Synchronize stream name

where stream name is the name of the stream to synchronize.

After the synchronization process begins running, Rational Team Concert users can use the ClearCase Synchronized Streams view to synchronize their work with Rational ClearCase.


Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug