Starting the synchronization engine process

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

About this task

The synchronization engine process requires read/write access to both Rational® ClearCase and IBM® Engineering Workflow Management (EWM). Access to Rational ClearCase is based on the identity under which the process runs: the synchronization process Rational ClearCase account. The synchronization process Rational ClearCase account 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 EWM repository is controlled by the user name and password of the synchronization process EWM account, which you specified in the wizard when the synchronized stream was created.

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


To start the synchronization engine process, run a synchronization process start-up script manually by completing the following steps:

  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 and merge workspace).
  2. In the ClearCase-Synchronized Streams view, right-click the stream, and click Start Synchronization Engine.
    Note: You can also start the synchronization process with the ccc start syncEngine command.


When the synchronization engine process starts, it displays the following message:

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 engine 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, EWM users can use the ClearCase-Synchronized Streams view to synchronize their work with Rational ClearCase.