Renaming a UCM project from CLI or GUI

Answer

A ClearCase UCM project can be renamed using the command line interface (CLI) or the graphical user interface (GUI) functionality.

Note: If ClearCase MultiSite is in use, then the local site must have mastership to rename the project, and the change must be synchronized to propagate to the other replicas.

CLI:

1. Open a command prompt (click Start > Run and type cmd).
   
   
2. It is not required to set to a view context to execute the following command syntax successfully:
   
   cleartool rename project:<project selector>@\PVOB project:<new project name>@\PVOB
   
   Example:
   
   C:\>cleartool rename project:project1@\pvob1 project:proj1@\pvob1
   Renamed project from "project" to "proj1".
   
   Notes:
• If you specify the wrong project name or do not use the correct case in the name, the following error will occur:
  
  C:\>cleartool rename project:Project1@\pvob1 project:prj1@\pvob1
  cleartool: Error: project not found: "Project1".
  
  
• You will receive the following error if a name with a space is used or if the command syntax is not used explicitly as shown above:
  
  C:\>cleartool rename project:project1@\pvob1 proj1@\pvob1
  cleartool: Error: The name has illegal characters.

For more information on the cleartool rename command, refer to IBM Rational ClearCase Command Reference, or run cleartool man rename.


GUI:

1. Open ClearCase Project Explorer (Exploring ClearCase Projects) from the Rational ClearCase Start menu options, or click Start > Run and type clearprojexp.
   
   
   
   
2. Right-click the UCM project to be renamed > select Properties:
   
   
   
   
3. Rename the project by changing the Name field to the desired name > click OK to apply the changes and exit the Properties dialogue:
   
   
   
   Note: An error will occur if a name with a space is used:
   
   
   
   
4. ClearCase Project Explorer should dynamically update with the change, however, if it does not, then use F5 to refresh the window: