NAME

create clearinghouse - Creates a clearinghouse or makes an existing clearinghouse available

SYNOPSIS

cdscp create clearinghouse clearinghouse-name

ARGUMENTS

clearinghouse-nameThe 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 startup command usually creates a new clearinghouse when you configure a new Cell Directory Service (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 for more information about relocating a clearinghouse. 

Clearinghouses should be named only in the root.  When you enter the create clearinghouse 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) permissions 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 /.: prior to issuing this command. 

This command is replaced at DCE Version 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). 

Books: OSF DCE Administration Guide.