PreviousNext

registry delete

Deletes a registry replica from the cell. The syntax is:

registry delete registry_replica_name [-force]

Option

-force
Used when the target replica is not available, the -force option removes the replica name from the master replica's replica list and propagates the deletion to other replicas that remain on the list.

Description
The registry delete operation, when called with no options, performs an orderly deletion of a security replica specified as the registry_replica_name argument. To do so, the operation binds to the master replica. The master replica then performs the following tasks:

1. Marks the specified replica as deleted

2. Propagates this deletion to the other replicas on its replica list

3. Delivers the delete request to the specified replica

4. Removes the replica from its replica list.

Note that the dcecp command returns before the deletion is complete because it simply tells the master to perform the delete procedure.

The -force option causes a more drastic action. It causes the master to first delete the specified replica from the replica list and then propagates that deletion to the other replicas that remain on its list. Since this operation never communicates with the deleted replica, you should use -force only when the replica has died and cannot be restarted. If you use -force while the specified replica is still running, you should then use the registry destroy command to eliminate the deleted replica.

This operation returns an empty string on success and sets the _b(sec) variable to the master.

Privileges Required
You must have d (delete) permission to the replist object.

Examples

dcecp> registry delete /.:/subsys/dce/sec/oddball
dcecp>