OSF DCE Administration Guide--Core Components

OSF DCE Administration Guide—Core Components
21.4.2 Copying the Clearinghouse Database Files to the Target Server
System
After you disable the clearinghouse and remove knowledge of the clearinghouse from
the host server, you must copy the clearinghouse database files to a specific location on
the new host server system.
A clearinghouse database consists of the following three files:
• clearinghouse-name.checkpointnnnnnnnn
• clearinghouse-name.tlognnnnnnnn
• clearinghouse-name.version
where nnnnnnnn represents an 8-digit number.
You should verify the existence of these files before you attempt to copy them to the
new host system. (See the and the OSF DCE Porting and Testing Guide for the full
pathnames of all CDS files.)
Note: You may sometimes find two .checkpointnnnnnnnn files in the directory.
This can happen as a result of a system crash or other interruption during
the clearinghouse’s most recent checkpoint operation. If you do find two
files, copy both of them to the target server system. The server software
that is on that system automatically reconciles any problem that may exist
as soon as the clearinghouse is enabled at the target server.
To move the dabase files to the new CDS server, use the ftp utility or a similar network
file transfer utility. Copy the three database files from the existing server host to the
new CDS server host. The directory where the files reside on the old and new CDS
server is dcelocal/var/directory/cds.
21.4.3 Starting the Clearinghouse on the Target Server
After copying the clearinghouse database files to the appropriate location on the target
server system, use the create clearinghouse command to start the clearinghouse at the
new location. Make sure that you specify the same clearinghouse name that was used
at its original (source) location. After you enter the command, the server detects the
clearinghouse files, adds knowledge of them to its memory, then starts the
clearinghouse.
To use the clearinghouse create command for the purpose of relocating a
clearinghouse, you must have write permission to the server on which you intend to
relocate the clearinghouse.
In the preceding example, the database files for clearinghouse /.:/Chicago2_CH were
successfully copied to a server system named orion. The following command, which is
issued on orion, relocates the clearinghouse named /.:/Chicago2_CH on that server:
dcecp> clearinghouse create /.:/Chicago2_CH
21 − 12 Tandem Computers Incorporated 124243