IBM Tivoli Storage Manager, Version 7.1

REMOVE REPLNODE (Remove a client node from replication)

Use this command to remove a node from replication if you no longer want to replicate the data that belongs to the node.

You cannot delete client node data by issuing the REMOVE REPLNODE command. You can issue the command on a source or on a target replication server. You can only issue this command from an administrative command-line client. You cannot issue this command from the server console.

If you issue the REMOVE REPLNODE command for a client node whose replication mode is set to SEND or RECEIVE, the mode is set to NONE. The replication state is also set to NONE. After you remove a client node from replication, the target replication server can accept backup, archive, and space-managed data directly from the node.

If a client node is removed from replication, information in the database about replication for the node is deleted. If the client node is enabled for replication later, the replication process replicates all the data that is specified by replication rules and settings.

When you issue the REMOVE REPLNODE command, the data that belongs to a client node is not deleted. To delete file space data that belongs to the client node, issue the DELETE FILESPACE command for each of the file spaces that belong to the node. If you do not want to keep the client node definition, issue the REMOVE NODE command. To delete file space data and the client node definition, issue DELETE FILESPACE and REMOVE NODE on the target replication server.

Restriction: If a node replication process is running for a client node that is specified by this command, the command fails and the replication information for the node is not removed.

Privilege class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the client node is assigned.

Syntax


                    .-,-----------------------.   
                    V                         |   
>>-REMove REPLNode------+-node_name-------+---+----------------><
                        '-node_group_name-'

Parameters

node_name or node_group_name (Required): Specifies the name of the client node or defined group of client nodes that you want to remove from replication. To specify multiple client node names and client-node group names, separate the names with commas and no intervening spaces. You can use wildcard characters to specify client node names, but not to specify client-node group names. You cannot combine node or node group names with the domain name.

Example: Remove three client nodes and a client node group from replication

The names of the client nodes are NODE1, NODE2, and NODE3. The name of the client node group is PAYROLL. Issue the following command on the source and target replication servers:

remove replnode node*,payroll

Related commands

Table 1. Commands related to REMOVE REPLNODE
Command	Description
QUERY NODE	Displays partial or complete information about one or more clients.
QUERY REPLICATION	Displays information about node replication processes.

Feedback