set directory to new epoch(1m) set directory to new epoch(1m)NAME
set directory to new epoch - Reconstructs a directory's replica set,
allowing you to designate a new master replica or to exclude a replica
SYNOPSIS
cdscp set directory directory-name to new epoch master clearinghouse-
name [readonly clearinghouse-name...] [exclude clearinghouse-name...]
ARGUMENTS
The full name of the directory. The full name of the clearinghouse in
which an individual replica is located. The first clearinghouse-name
specifies where the master replica is stored.
DESCRIPTION
The set directory to new epoch command reconstructs a directory's
replica set, allowing you to designate a new master replica or to
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.
The ellipses (...) indicates that you can specify multiple clearing‐
house names, separated by spaces.
When you set a new epoch on a directory, you must disable the clearing‐
house containing the replica that is being excluded. To do this, use
the disable server command (if the server has more than one clearing‐
house, all its clearinghouses will be disabled). Note that all clear‐
inghouses that are not excluded must be enabled and available before
you issue the disable server command.
Privilege Required
You must have administer permission to the directory, and the server
principal needs administer, read, and write permission to the direc‐
tory. When designating a new master replica, you also need write per‐
mission to the clearinghouse that stores the new master replica, and
the server principal needs write permission to each clearinghouse where
the replica type is changed to read-only.
NOTE
This command may be replaced in future releases by the dcecp command,
and may no longer be supported at that time.
EXAMPLE
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 clearing‐
house /.:/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(1m), show directory(1m), show
replica(1m)
set directory to new epoch(1m)