registry designate

registry designate registry_replica_name [-slave | -master [-force]]

Options

-slave
Makes the specified replica a slave. registry_replica_name must identify the master replica.

-master
Makes the specified replica the master. registry_replica_name must identify a slave replica.

-force
Forces registry_replica_name to become the master, even if other slave replicas are more up to date. Used only with the -master option.

The preferred method of creating a new master is to use this command with no options in the form:

registry designate registry_replica_name

Description
This command changes the slave replica named in registry_replica_name to the master by performing an orderly transition. To do so, the command binds to the current master and instructs the master to:

1. Apply all updates to the replica named in registry_replica_name

2. Become a slave

3. Tell the replica named in registry_replica_name to become the master

The -slave or -master options can also be used to change the master to a slave and a slave to a master. However, using these options is not recommended because updates can be lost. You should use them only if you must because the master replica is irrevocably damaged and is unable to perform the steps in the orderly transition. To use this option, enter the command in the forms:

· To make the master a slave:

registry designate registry_replica_name -slave

registry_replica_name is the name of the replica to make a slave

· To make a slave a master:

registry designate registry_replica_name -master

The registry_replica_name is the name of a slave to make a master. If a master exists, the command fails. Also, if there are more up-to-date slaves than the one specified by registry_replica_name, the command fails, unless you specify -force to override this default action.

The operation returns the empty string on success and sets the _b(sec) variable as follows:

· If called with the -force or -master option, the command sets _b(sec) to the replica to which it binds.

· If called with no options, the command sets _b(sec) to the master.

Privileges Required
You must have a (auth_info) permission to the replist object.

Examples

dcecp> registry designate /…/my_cell/subsys/dce/sec/oddball
dcecp>