IBM Tivoli Storage Manager, Version 7.1

REMOVE NODE (Delete a node or an associated machine node)

Use this command to remove a node from the server. If you are using disaster recovery manager and the node to be removed is associated with a machine, the association between the node and the machine is also deleted.

If a node is part of a collocation group and you remove the node from the server, the node is removed from the collocation group. If a node is removed and the node contained file spaces in a file space collocation group, those file spaces are removed from the group member list.

Using SYNCLDAPDELETE = YES with this command removes the node’s entry from the LDAP directory server. Do not specify SYNCLDAPDELETE = YES if the LDAP namespace is shared by multiple IBM® Tivoli® Storage Manager servers. If you want to remove a node from all Tivoli Storage Manager servers and all LDAP directory servers, specify SYNCLDAPDELETE = YES.

When a node is removed, the corresponding administrative ID is removed only if the following issues are true:

The administrator name is identical to the node name.
The administrator has client owner or client access authority only to the node that is being removed.
The administrator is not a managed object.

Important: Before you can remove a node, you must delete all backup and archive file spaces that belong to that node.

Before you can remove a NAS node that has a corresponding data mover defined, you must complete the following tasks in order:

Delete any paths from the data mover
Delete the data mover
Delete all virtual file space definitions for the node
Remove the NAS node

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


                           .-SYNCldapdelete--=--No------.   
>>-REMove Node--node_name--+----------------------------+------><
                           '-SYNCldapdelete--=--+-No--+-'   
                                                '-Yes-'

Parameters

node_name (Required): Specifies the name of the node to be removed.
SYNCldapdelete: If the node ID is stored on the LDAP directory server, you can delete the entry on that server by specifying a value of YES. Do not delete the entry if it is used by another server that shares namespace on the LDAP directory server.

Example: Remove a client node

Remove the client node LARRY.

remove node larry

Example: Remove any corresponding entries for a node ID that authenticates to an LDAP directory server

To remove the client node elroy that has corresponding entries that share namespace on an LDAP directory server, issue the following command:

remove node elroy syncldapdelete=yes

Related commands

Table 1. Commands related to REMOVE NODE
Command	Description
DELETE MACHNODEASSOCIATION	Deletes association between a machine and node.
DELETE DATAMOVER	Deletes a data mover.
DELETE FILESPACE	Deletes data associated with client file spaces. If a file space is part of a collocation group and you remove the file space from a node, the file space is removed from the collocation group.
DELETE PATH	Deletes a path from a source to a destination.
DELETE VIRTUALFSMAPPING	Delete a virtual file space mapping.
LOCK NODE	Prevents a client from accessing the server.
QUERY COLLOCGROUP	Displays information about collocation groups.
QUERY MACHINE	Displays information about machines.
QUERY NODE	Displays partial or complete information about one or more clients.
QUERY SESSION	Displays information about all active administrator and client sessions with Tivoli Storage Manager.
REGISTER NODE	Defines a client node to the server and sets options for that user.
RENAME NODE	Changes the name for a client node.

Feedback