Importing files and folders from Rational ClearCase

Use the Select Files To Synchronize window to select files and folders from Rational® ClearCase® to synchronize.

About this task

Restriction: You cannot import objects from a UCM component using a synchronized stream that was created for synchronization with base ClearCase. Conversely, you also cannot import objects from a base ClearCase VOB using a synchronized stream that was created for synchronization with UCM.

To select files and folders to synchronize:

Procedure

  1. You must be logged on to the synchronization host where the stream was created.
  2. Open the ClearCase Synchronized Streams view and select a stream to which you would like to add files and folders.
  3. Click the Select Files to Synchronize icon Select Files to Synchronize icon.
  4. On the Select Files To Synchronize page, select Select files and folders in ClearCase.
    • To show the list of files and folders that are currently being synchronized, select Show currently synchronized objects in the table.
    • To select files and folders by browsing mounted VOBs, click Browse to display a list of VOBs mounted by the synchronization host. (To speed up browsing, unmount any VOBs that you do not intend to access.) If no VOBs are visible in the window, verify that the VOBs from which you want to import are mounted on the synchronization host. When you have finished selecting files and folders, click OK to close the browser and display the selected paths in the list of Files and folders to synchronize.
    • To select files and folders manually, enter a path name that is visible in the Rational ClearCase stream you specified in Creating a ClearCase Synchronized Stream and then click Add. The path name must be relative to the view root. If you are using a UCM stream, the path name must end at the root of a UCM component. All path names that you specify for import must begin with a VOB tag (without any leading / or \ characters) and include the full path from the VOB root to the project root folder. For example:

      sources\eclipse_projects\my_project

      selects a folder named my_project that is stored in the eclipse_projects folder of the VOB whose VOB tag is \sources.
    If you want, you can use the Remove and Edit buttons to modify selected path names after they have been added.
  5. Click Finish to begin importing the specified files and folders.
    Restriction: Unlike Rational ClearCase, Rational Team Concert source control does not support hard links. If multiple hard links to the same file are encountered during an import, only one link target (the final one encountered during the import) remains in the synchronized stream after the import completes.
    Note: If you are using Rational Team Concert version 2.0.0.2 or later, symbolic links are supported. The ClearCase Synchronizer and Importer create Jazz symbolic links for any ClearCase symbolic links that are imported. Likewise, the Synchronizer creates ClearCase symbolic links for any Jazz symbolic links that are exported. Symbolic links can only be loaded from a repository workspace on a platform that supports symbolic links.
  6. When the import is complete, you can use the Rational Team Concert source control Load Wizard to specify how the files and folders in the synchronized stream should be loaded into a repository workspace. For more information, see Loading or unloading a repository workspace.

Results

You can monitor synchronization status in the ClearCase Synchronized Streams view. For more information, see Synchronizing.


Feedback

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