PreviousNext

create clearinghouse(8cds)

Creates a clearinghouse on the local server system or makes an existing clearinghouse available

Synopsis

cdscp create clearinghouse clearinghouse-name

Arguments

clearinghouse-name
The full name of the clearinghouse.

Description
The create clearinghouse command creates a clearinghouse on the local server system or makes an existing clearinghouse available. The server start-up command usually creates a new clearinghouse when you configure a new CDS server. Occasionally, you may need to create a second clearinghouse on a particular server; for example, if you are temporarily relocating a clearinghouse on a different server. See the OSF DCE Administration Guide - Core Components for more information about relocating a clearinghouse.

Clearinghouses should be named only in the root. When you enter the command, CDS creates a read-only replica of the root directory and stores it in the new clearinghouse as the initial replica. Because the process that creates the new clearinghouse initiates a skulk of the root directory, all replicas of the root should be reachable when you enter the command.

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 needs r (read), w (write), and A (Admin) permission to the cell root directory.

Notes
This command is usually executed only by the network configuration procedure. To ensure that all replicas of the root are reachable, perform an immediate skulk of /.: before issuing this command.

This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

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

cdscp> create clearinghouse /.:/Boston_CH

Related Information
Commands:

clear clearinghouse(8cds)
delete clearinghouse(8cds)
list clearinghouse(8cds)
set cdscp preferred clearinghouse(8cds)
show cached clearinghouse(8cds)
show cdscp preferred clearinghouse(8cds)
show clearinghouse(8cds)

Book: OSF DCE Administration Guide - Core Components