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). count must be specified along with the number of desired clones. If count is not specified, one single clone will be created.

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