Cloning an existing data domain

You can add a new data domain that replicates an existing one with the endeca-cmd clone-dd name command, or with the cloneDataDomain operation of the Manage Web Service.

Before you can clone a data domain with this command, these tasks should be completed:

The Endeca Server node profiles are defined.
The Endeca Server nodes are started in the Endeca Server cluster.
The data domain for which you want to create a copy has been created.

Important: This data domain must be enabled for the clone command to succeed.

The name of the new data domain should not be already in use by any other data domain in the Oracle Endeca Server.

To clone a data domain:

Use a command-line window (for example, open a Command Prompt in Windows) and navigate to the endeca-cmd directory. Alternatively, you can access the Manage Web Service at the host and port of your Endeca Server cluster.
Depending on the method you choose, issue the endeca-cmd clone-dd command, or the cloneDataDomain operation with the Manage Web Service.

Specify the name for the new data domain on the command line, the name of the source data domain with --source-name, and (optionally) whether the domain should be enabled. If you don't specify the value for enabling, the new data domain is enabled by default.
The following example illustrates the endeca-cmd command:
```
endeca-cmd clone-dd MyNewDD --source-name MyExistingDD --is-enabled true 
```
This example creates a copy of the MyExistingDD data domain, gives it a name MyNewDD, and enables this new data domain after it has been created.
Alternatively, you can issue a web service request similar to this example, to the Manage Web Service:
```
 <ns1:cloneDataDomain xmlns:ns1="http://www.endeca.com/endeca-server/manage/1/0">
 <ns1:name>MyNewDD</ns1:name>
 <ns1:sourceName>MyExistingDD</ns1:sourceName>
 <ns1:enabled>true</ns1:enabled>
</ns1:cloneDataDomain>
```
If the Endeca Server cluster has sufficient capacity, the new data domain is created as a copy of the existing data domain.
Verify the creation of the cloned data domain by listing all existing data domains in the Endeca Server with endeca-cmd list-dd.