Home | Previous Page | Next Page   Appendix A. Command-Line Utility Reference >

cdr delete server

The cdr delete server command deletes a database server from the global catalog.

Syntax

Read syntax diagramSkip visual syntax diagram>>-cdr delete server--+-------------------------+--------------->
                      |                    (1)  |
                      '-| Connect Option |------'
 
>--server_group------------------------------------------------><
 
Notes:
  1. See page Connect Option.
Element Purpose Restrictions Syntax
server_group Name of database server group to remove from the global catalog The database server group must be currently defined in Enterprise Replication. Long Identifiers

Usage

The cdr delete server command deletes the database server in server_group from the global catalog, removes the database server from all participating replicates, and purges all replication data from the send queues for the specified database server. The command shuts down Enterprise Replication on the database server and removes the global catalog from the database server.

When you delete an Enterprise Replication server, you must issue the cdr delete server command twice: once on the server being deleted and once on another server in the enterprise. The first cdr delete server removes the Enterprise Replication server from the local global catalog and removes the Enterprise Replication connection to other hosts. The second cdr delete server removes the Enterprise Replication server from the other replication servers in the system. For more information, see the Examples.

You can issue the cdr delete server command from any replication server. The only limitation is that you cannot delete a server with children. You must delete the children of a server before deleting the parent server.

You cannot delete a server from the enterprise if it is stopped. To delete a server with cdr delete server, you must issue a cdr start command first.

Warning:
Avoid deleting a replication server and immediately re-creating it with the same name. If you re-create the objects immediately (before the operation finishes propagating to the other Enterprise Replication database servers in the network), failures might occur in the Enterprise Replication system at the time of the operation or later. For more information, see Operational Considerations.

Examples

This example removes the server g_italy from the replication environment (assume that you issue the commands from the replication server g_usa):

cdr delete server -c usa g_italy
cdr delete server -c italy g_italy

The first command performs the following actions:

The second command connects to server italy and removes Enterprise Replication from italy. That is, it removes the syscdr database and removes or stops other components of Enterprise Replication.

Figure 19 shows a replication environment with three replication servers, g_usa, g_italy, and g_japan.

Figure 19. Three Replication Servers
begin figure description - This figure is described in the surrounding text. - end figure description

To remove Enterprise Replication from this environment, issue the following commands from the computer where the usa replication server resides.

To remove Enterprise Replication from this environment
  1. Execute:
    cdr delete server g_italy

    This command removes connections between the italy replication server and all other servers in the replication system (usa and japan) and removes any queued data.

  2. Execute:
    cdr delete server -c italy g_italy

    This command removes all replication information (including the syscdr database) from the italy database server.

  3. Execute:
    cdr delete server g_japan
    cdr delete server -c japan g_japan

    These commands remove the japan replication server.

  4. Execute:
    cdr delete server g_usa

    This command removes the replication information from the usa replication server itself.

See Also

Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]