Asked Questions about
Process to migrate ClearCase archives to StarTeam
archives using the Command Line processing
this document to a colleague
This is an outline of a process to migrate ClearCase
archives to a StarTeam archive format. This process requires that the
user know how to use the ClearCase command line function. The user will
also need to know a little about StarTeam GUI and the StarTeam command
line. This document assumes that the ClearCase archive and program is
running in a Unix environment.
StarTeam server installed and running.
Installation of Java SDK 1.1.6 or greater on Unix
Installation of the StarTeam Universal Command Line
client on Unix computer.
Installation of the StarTeam GUI.
Creating StarTeam Project from ClearCase migration:
From the StarTeam GUI you will need to create a StarTeam
project for the ClearCase project. When you create the StarTeam project
you will create a folder tree that matches the ClearCase project tree
(see fig. 1.1 below). StarTeam project tree will create directory and
sub-directory by the folder name in the project tree. StarTeam will
check-in and check-out files using this project tree structure:
Setup of the Universal Command Line Client for StarTeam:
To install the Universal Command Line you are required
to install the Sun Java SDK 1.1.6 or better for the version of Unix.
The Universal command line installation program will require that the
user use an X-terminal window to execute. The installation will create
a batch file name STCMD.
Script to migrate ClearCase to StarTeam:
The instruction below is a guideline to create a script
the will migrate ClearCase projects to StarTeam projects.
Adding first to the StarTeam project section of the
The first line of the script should be a ClearCase
command to check-out the first revision of the project.
The second line in the script should be StarTeam
STCMD command that will add the files to the pre-built StarTeam
project. (i.e: stcmd add ?p ?UserName:Password@computernameIP:endpoint/ProjectName/ProjectView?
/is /u /q /x /d ?Init Check-in? /vl ?Build 1? /rp ?\Unix file path?
/eol on *.)
Note: This will add the file to the StarTeam project. Please reference
Chapter 17 in the StarTeam User Manual or the Online User Manual
install with the StarTeam client for definition of command line
Below is the section of the Unix script that must
loop to complete the check-in of all revisions in the project:
Have the script remove any files from the Unix directory
after the files have been add to StarTeam.
Script the ClearCase command line to check-out the
next revision of the project. (i.e.: ClearCase command line check-out
revision 2 then 3 then 4 then 5.)
Script the StarTeam command line to check-in the
files with a label. (i.e: stcmd co ?p ?UserName:Password@computernameIP:endpoint/ProjectName/ProjectView?
/is /q /x /o /r ?Reason for check-in? /vl ?%variable%? /rp ?\Unix
file path? /eol on *.)
Note: %Variable% is used to change the label from each revision
being added to StarTeam. You may create a file that will pass the
labels to the script. Please reference Chapter 17 in the StarTeam
User Manual or the Online User Manual install with the StarTeam
client for definition of command line switches.
You should script a loop command to repeat steps
1 to 3 until step 2 in the process can not check-out any more file