Adding a new data domain

You add a data domain with the endeca-cmd create-dd name command, where name is the name of your data domain. Running this command is equivalent to using the createDataDomain operation in the Manage Web Service request.

Before you can create a data domain cluster on multiple Endeca Server nodes, the following conditions must be met:

The Endeca Server software must be installed and deployed as an Endeca Server cluster on multiple WebLogic Server machines. Additionally, the Cluster Coordinator services of the Endeca Server should be running on an odd number of Endeca Server nodes.

Note: In a development environment, you can install and deploy an Endeca Server cluster and its Cluster Coordinator service on a single machine. Such a cluster will not be highly available, but it will still allow you to create a data domain that could be used for initial testing purposes. To run a data domain in production, the data domain would need to be recreated in the Endeca Server cluster that is deployed on multiple WebLogic Server machines. For information on installation and deployment in a cluster, see the Oracle Endeca Server Installation Guide.
An administrator responsible for the Endeca Sever cluster deployment has configured a node profile for the Endeca Server nodes, informing you, as the data domain cluster administrator, of the available capacity on the Endeca Server nodes, and the host and port of the Endeca Server cluster.
An administrator of the Endeca Server cluster has created data domain profiles you can use. This data domain profile must be specified when you create a data domain. Optionally, you can use the default data domain profile, which always exists in the system. For information on data domain profiles, including the default profile, see Managing Data Domain Profiles.

To create a data domain:

Use a command-line window (for example, open a Command Prompt in Windows) and navigate to the endeca-cmd directory.
Use endeca-cmd list-dd-profiles --verbose or the equivalent operation in the Manage Web Service (listDataDomainProfiles), to obtain a list of all defined data domain profiles.

The Endeca Server returns a list of all defined data domain profiles, including their characteristics, such as name, description, the number of data domain nodes, the number of processing threads for the Dgraph processes, the cache size, whether the data domain requires a dedicated leader node, and others. This list also includes the default data domain profile.
Select the data domain profile from this list. You will use its name to create a data domain.
Create a data domain using the command similar to the following example:
```
endeca-cmd create-dd MyDD 
--dd-profile-name test
--is-enabled true
```
where:
- MyDD is the name of the data domain you are creating.
- test is the name of the data domain profile that will be used.
- --is-enabled true indicates that this data domain should be enabled once created.
Note: The name of the data domain can include spaces (for example, if it consists of two words). In this case, the name should be enclosed in double quotes, as in this example: endeca-cmd create-dd "My data". Thereafter, the name should also be enclosed in double quotes when used in other Endeca Server commands.
If the data domain profile exists, and the Endeca Server cluster has sufficient resources to host the new data domain, it is created.
Alternatively, you can issue the request similar to the following example, with the Manage Web Service:
```
<ns1:createDataDomain xmlns:ns1="http://www.endeca.com/endeca-server/manage/1/0">
        <ns1:name>MyDD</ns1:name>
        <ns1:ddProfileName>default</ns1:ddProfileName>
        <ns1:enabled>true</ns1:enabled>
</ns1:createDataDomain>
```
This example uses the default data domain profile that always exists in the Endeca Server cluster.
To verify the data domain has been created successfully, issue one of these commands: endeca-cmd list-dd or endeca-cmd get-dd name

Alternatively, you can issue listDataDomains or getDataDomain requests, using the Manage Web Service.

The following example illustrates the result of the getDataDomain operation. It lists the details of the successfully created data domain MyDD. This data domain uses the data domain profile for which additional arguments have been specified (as compared with the default data domain profile):

<ns3:getDataDomainResponse xmlns:ns2="http://www.endeca.com/endeca-server/types/1/0" xmlns:ns3="http://www.endeca.com/endeca-server/manage/1/0">
 <ns3:dataDomainDetail>
  <ns2:name>MyDD</ns2:name>
  <ns2:allowOversubscribe>true</ns2:allowOversubscribe>
  <ns2:allowQueriesOnLeader>true</ns2:allowQueriesOnLeader>
  <ns2:numFollowers>0</ns2:numFollowers>
  <ns2:readOnly>false</ns2:readOnly>
  <ns2:enabled>true</ns2:enabled>
  <ns2:numComputeThreads>2</ns2:numComputeThreads>
  <ns2:computeCacheSizeMB>0</ns2:computeCacheSizeMB>
  <ns2:startupTimeoutSeconds>600</ns2:startupTimeoutSeconds>
  <ns2:shutdownTimeoutSeconds>30</ns2:shutdownTimeoutSeconds>
  <ns2:sessionIdType>header</ns2:sessionIdType>
  <ns2:sessionIdKey>X-Endeca-Session-ID</ns2:sessionIdKey>
 </ns3:dataDomainDetail>
</ns3:getDataDomainResponse>