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.
If you remove a node that stored data in a deduplicated storage pool, the node name DELETED is displayed in the QUERY OCCUPANCY command output until all data deduplication dependencies are removed.
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.
- 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.
- 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 the 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
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. |