PreviousNext

clearinghouse create

Creates a new clearinghouse on the local machine. The syntax is:

clearinghouse create clearinghouse_name_list

Description
The clearinghouse create operation creates a new clearinghouse on the local machine. The clearinghouse_name argument is a list of one or more names of the clearinghouse you want to create. Clearinghouses should only be named in the root directory (that is, /.:. This operation also stores a read-only replica of the root directory in the new clearinghouse. The process that creates the new clearinghouse initiates a skulk of the root directory so all replicas of the root should be reachable when you enter the clearinghouse create command. To ensure this, perform an immediate skulk of /.: prior to invoking the command, using the directory synchronize /.: command. The operation returns an empty string on success.

Privileges Required
You need w (write) permission to the server on which you intend to create the clearinghouse, and A (Admin) permission to the cell root directory. The server principal (/.:/hosts/hostname/cds-server)needs r (read), w (write), and A (Admin) permission to the cell root directory.

Examples
The following command creates a clearinghouse named /.:/Boston_CH on the local server system:

dcecp>clearinghouse create /.:/Boston_CH
dcecp>