PreviousNext

Before You Create a Replica

Before you try to create a replica, verify that the clearinghouse containing the master replica of the directory you intend to replicate is running and reachable. To verify that this condition is satisfied, follow these steps:

1. For the directory that you intend to replicate, use the directory show command to display the directories attribute values and look at the CDS_Replicas attribute. The value of this attribute shows the names of the clearinghouses that currently store a replica of the directory. For example:

dcecp> directory show /.:/sales

{RPC_ClassVersion {01 00}}

{CDS_CTS 1994-08-12-09:52:30.396-04:00I0.000/00-00-c0-f7-de-56}

{CDS_UTS 1994-08-12-09:52:31.506-04:00I0.000/00-00-c0-f7-de-56}

{CDS_ObjectUUID a37d84d0-b5dc-11cd-8ffe-0000c0f7de56}

{CDS_Replicas

{{CH_UUID ce7ed810-b5db-11cd-8ffe-0000c0f7de56}

{CH_Name /.../Chicago1/Chicago1_CH}

{Replica_Type Master}

{Tower {ncacn_ip_tcp 130.105.5.16}}

{Tower {ncadg_ip_udp 130.105.5.16}}}}

{CDS_AllUpTo 1994-08-12-09:52:31.566-04:00I0.000/00-00-c0-f7-de-56}

{CDS_Convergence medium}

{CDS_ParentPointer

{{Parent_UUID d034bc25-b5db-11cd-8ffe-0000c0f7de56}

{Timeout

{expiration 1994-08-12-09:52:30.396}

{extension +1-00:00:00.000I0.000}}

{myname /.../Chicago1/sales}}}

{CDS_DirectoryVersion 3.0}

{CDS_ReplicaState on}

{CDS_ReplicaType Master}

{CDS_LastSkulk 1994-08-12-09:52:31.566-04:00I0.000/00-00-c0-f7-de-56}

{CDS_LastUpdate 1994-08-12-09:52:31.506-04:00I0.000/00-00-c0-f7-de-56}

{CDS_RingPointer ce7ed810-b5db-11cd-8ffe-0000c0f7de56}

{CDS_Epoch a3df2a50-b5dc-11cd-8ffe-0000c0f7de56}

{CDS_ReplicaVersion 3.0}

dcecp>

2. With this information, use the directory show command with the -clearinghouse and -replica options to verify that you can get a response from the clearinghouse that stores the master replica. Example:

dcecp> directory show /.:/sales -replica -clearinghouse /.:/Chicago1_CH

{RPC_ClassVersion {01 00}}

{CDS_CTS 1994-08-12-09:52:30.396-04:00I0.000/00-00-c0-f7-de-56}

{CDS_UTS 1994-08-12-09:52:31.506-04:00I0.000/00-00-c0-f7-de-56}

{CDS_ObjectUUID a37d84d0-b5dc-11cd-8ffe-0000c0f7de56}

{CDS_Replicas

{{CH_UUID ce7ed810-b5db-11cd-8ffe-0000c0f7de56}

{CH_Name /.../Chicago1/Chicago1_CH}

{Replica_Type Master}

{Tower {ncacn_ip_tcp 130.105.5.16}}

{Tower {ncadg_ip_udp 130.105.5.16}}}}

{CDS_AllUpTo 1994-08-12-09:52:31.566-04:00I0.000/00-00-c0-f7-de-56}

{CDS_Convergence medium}

{CDS_ParentPointer

{{Parent_UUID d034bc25-b5db-11cd-8ffe-0000c0f7de56}

{Timeout

{expiration 1994-08-12-09:52:30.396}

{extension +1-00:00:00.000I0.000}}

{myname /.../Chicago1/sales}}}

{CDS_DirectoryVersion 3.0}

{CDS_ReplicaState on}

{CDS_ReplicaType Master}

{CDS_LastSkulk 1994-08-12-09:52:31.566-04:00I0.000/00-00-c0-f7-de-56}

{CDS_LastUpdate 1994-08-12-09:52:31.506-04:00I0.000/00-00-c0-f7-de-56}

{CDS_RingPointer ce7ed810-b5db-11cd-8ffe-0000c0f7de56}

{CDS_Epoch a3df2a50-b5dc-11cd-8ffe-0000c0f7de56}

{CDS_ReplicaVersion 3.0}

dcecp>

The directory show command with the -clearinghouse and -replica options displays all the attribute values for the directory and its replica role.

Note: If any read-only replicas in the directory's existing replica set are unavailable, the replication cannot complete. The normal skulking process completes the replication as soon as all replicas in the directory's replica set become available.