Cloning a workspace allows you to make a duplicate copy of a particular local workspace. Use this functionality when you want to create a workspace structure similar to an existing one.
When you duplicate your workspace, don't use the copy and paste function, as each workspace has a unique workspace ID. |
Before cloning a workspace, ensure you met the following requirements:
-
All objects are checked in.
-
The objects are locally unmodified.
If these requirements are not met, you are not able to start the cloning process. To clone a workspace, run the TCWorkspaceCloneUtil.exe file under %COMMANDER_HOME%. The file is called up via the command line. In case of an error while cloning, every clone has to be discarded.
The workspace ID is assigned when you open the clone for the first time. You can therefore use clones as workspace templates in virtual machines. |
Syntax: |
TCWorkspaceCloneUtil.exe -workspace <entire path to any valid workspace file> -out <entire path to an empty output dir> [-count <number of clones to create>] |
Parameter |
Description |
workspace |
Entire path to a valid workspace file. |
out |
Entire path to an empty directory. |
count <number of clones> |
Number of clones (optional). |
In the example below, you clone a workspace. %COMMANDER_HOME%\TCWorkspaceCloneUtil.exe -workspace "C:\Tosca_Projects\Tosca_Workspaces\CloneWorkspace\Clone.tws"" -out "C:\Clones" -count 10 |