NAME

set directory to new epoch - Reconstructs a directory’s replica set

SYNOPSIS

cdscp set directory directory-name to new epoch master clearinghouse-name ... 
[readonly clearinghouse-name ...] [exclude clearinghouse-name ...]

ARGUMENTS

directory-name
The full name of the directory.

master clearinghouse-name ...
The full name of the clearinghouse in which an individual replica is located.  The first clearinghouse-name specifies where the master replica is stored. 

readonly clearinghouse-name ...
Designates the replicas in the specified clearinghouses as read-only.

exclude clearinghouse-name ...
Excludes the replicas in the specified clearinghouses.

DESCRIPTION

The set directory to new epoch command reconstructs a directory’s replica set, allowing you to designate a new master replica, designate a replica as read-only, or exclude a replica.  You must list each existing replica and indicate whether an existing replica needs to be included in or excluded from the new replica set.  You can include or exclude more than one replica.  You can specify multiple clearinghouse names, separated by spaces. 

When you set a new epoch on a directory, you must disable the clearinghouse containing the replica that is being excluded.  To do this, use the disable server command (if the server has more than one clearinghouse, all its clearinghouses will be disabled).  Note that all clearinghouses that are not excluded must be enabled and available before you issue the disable server command. 

Privileges Required

You must have A (Admin) permission to the directory, and the server principal needs r (read), w (write), and A (Admin) permissions to the directory.  When designating a new master replica, you also need w (write) permission to the clearinghouse that stores the new master replica, and the server principal needs w (write) permission to each clearinghouse where the replica type is changed to read-only. 

NOTES

This command may be replaced in future DCE releases by the dcecp command, and may no longer be supported at that time. 

EXAMPLES

The following command sets a new epoch for the directory /.:/mfg.  The master replica is in the clearinghouse /.:/Paris1_CH, and read-only replicas are in the clearinghouses /.:/Chicago1_CH, /.:/Seattle_CH, and /.:/NY1_CH.  The new replica set excludes the replica in the clearinghouse /.:/NY1_CH. 

cdscp> set directory /.:/mfg to new epoch master /.:/Paris1_CH \
       readonly /.:/Chicago1_CH /.:/Seattle_CH exclude /.:/NY1_CH

RELATED INFORMATION

Commands:

set_directory_to_skulk(8cds), show_directory(8cds), show_replica(8cds).