OSF DCE Administration Guide--Core Components

Restructuring a Namespace

(See the for information on how to conﬁgure CDS servers and CDS

clerks.)

Occasionally, you may need to relocate a clearinghouse from the server system where it

currently resides to another server system. For example, you may want to move a

clearinghouse when

• You need to temporarily disconnect the host server system from the network for

repair or for other reasons.

• You no longer want the current host system to function as a CDS server.

• You want to move the clearinghouse to a server system that is physically closer on

the network to the user groups and applications that use the information contained

in the clearinghouse.

To relocate a clearinghouse, follow these steps:

1. Disassociate the clearinghouse from the server where it is currently running.

2. Copy the clearinghouse database ﬁles from their current location (source server

system) to their new location (target server system).

3. Create a new clearinghouse on the target server system by using the same name

that was used on the source server system from which you copied the database

ﬁles.

21.4.1 Dissociating a Clearinghouse from Its Host Server System

Whenever a CDS server starts, one of the tasks the server software performs is to start

its clearinghouse (or clearinghouses). The server performs this task automatically by

examining a list of the clearinghouses that are resident on the system. Before you

relocate a clearinghouse, use the dcecp clearinghouse disable command to update the

clearinghouse ﬁles and ensure that the ﬁles are consistent before you copy them to the

target server.

The clearinghouse disable command also removes, from the source server’s internal

memory, knowledge of the clearinghouse that you specify. This ensures that the

relocated clearinghouse is not automatically started at the source server during server

restarts.

To use the clearinghouse disable command, you must have write permission to the

server on which the clearinghouse resides.

The following example command removes knowledge of clearinghouse

/.:/Chicago2_CH from the memory of its host server:

dcecp> clearinghouse disable /.:/Chicago2_CH

124243 Tandem Computers Incorporated 21− 11