Use the ClearCase® Importer to
import Rational® ClearCase data
with full or partial baseline history from a UCM stream to Rational Team Concert™ source
control.
Once imported, you can modify the files in Rational Team Concert source
control,
but you cannot export to ClearCase.
Before you begin
Before you can import ClearCase data with baseline history,
you must configure a synchronization host, then create and add a synchronization
process account. If you are going to import a subset of baseline history,
rather than all baseline history, from a UCM stream,
you must also prepare the ClearCase data.
- Prerequisites
- Preparing to import ClearCase data with history
About this task
Once you have completed or verified all of the prerequisite
requirements, complete the following tasks to import a UCM stream
and then select files and folders to import with history from the
UCM stream.
Importing a ClearCase UCM stream
Create a synchronization stream for importing UCM baseline
history by completing the following steps.
Procedure
- Click .
- In the Import window,
expand Jazz Source Control, select ClearCase
Stream or Branch, and click Next.
- In the ClearCase Stream Information page,
select Import with history from ClearCase. Because the ClearCase Importer does not export changes
in Rational Team Concert source
control to
ClearCase, branch information is not used, so the branch type field
is disabled. Click OK to close the Import
with History information window.
- Specify a configuration for the Rational ClearCase dynamic
view that the wizard creates to support the import process:
- To configure the view from a UCM stream, select Import
from an existing UCM stream.
- Enter the name of an existing stream in the form stream-name@PVOB-tag. For example, to specify a stream named my_stream in
a PVOB with the tag \projects, enter my_stream@\projects.
Use the cleartool lsstream command or the Rational ClearCase Project
Explorer to search for stream names.
Note: You cannot import ClearCase history from a
read-only stream. You can import the history from its parent stream
if the parent stream is not read-only, or you can create a new, writable
child stream identical to the read-only child stream, and then import
history from the new stream.
The wizard validates
the syntax (but not the existence) of the stream name, then enables
the Next button.
- Click Next.
- In the ClearCase
Storage Information page, specify the network path to a
directory where the wizard can create view storage for a Rational ClearCase dynamic
view to enable importing from Rational ClearCase to Jazz™. The Importer seeds this entry with a network path consisting
of the local host name and the string \VIEWSTORAGE.
If this directory exists on the local host and is a valid location
for view storage (it must be shared on Windows® or
exported on the UNIX® system or Linux®),
you can use it. Otherwise, specify the network path to another local
or remote directory where the view storage can be created. The
wizard creates a dynamic view with storage in this directory and a
distinctive view tag (the prefix DO_NOT_USE and
a UUID suffix). This view should be considered off limits by Rational ClearCase users.
If
applicable, check Enter additional option set information
for creating ClearCase views and enter the appropriate
values for Host, Host Path, and Global Path: the hostname, host-local
path, and global storage path, respectively, of the ClearCase server
storage location.
- Click Next.
The wizard validates the view storage path and, if provided, the global
storage path.
- On the Select
Project or Team Area page, expand the repository entry
and select the project or team area to which you added the synchronization
process account (see Adding the synchronization process account to your team area). If there are no entries under the repository, verify that you
are connected to the project area, then try again. Click Next.
- The Jazz Source
Control Information page displays the name of a merge workspace
that the wizard will create. You can choose another name if you want. If the repository contains a workspace with the name you chose,
the wizard extends it with a string that makes it unique. (A merge
workspace is a repository workspace where you resolve conflicts that
occur when a file or folder has been modified in parallel in Rational ClearCase and Rational Team Concert source
control).
- A default Synchronization
user ID is displayed in this field. (The default ID is ccsync.)
If you are using a synchronization user ID other than the default,
replace the ID with the correct value. Enter the password for the Synchronization
user ID. For more information, see Creating a synchronization process account.
- Type the path name where the ClearCase Connector is
installed on this host in the Connector install location field,
or click Browse to browse for it. The ClearCase Connector is
typically installed in the Rational Team Concert installation
directory.
- Select Start a Jazz Synchronization Engine process
after the wizard finishes, and select Start
the Select Files wizard after this wizard finishes.
- Click Finish. The
ClearCase Importer creates a synchronized stream in Rational Team
Concert, starts the synchronization engine process in the background,
then opens the Select Files wizard.