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.
- 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
- Specifies whether to remove the node from the Lightweight Directory Access Protocol (LDAP) server.
- Yes
- Specifies that the node is removed.Restriction: Do not specify a value of YES. (The value of YES is appropriate only for users of the previous LDAP authentication method, which is described in Managing passwords and logon procedures.)
- No
- Specifies that the node is not removed. This is the default value.
Example: Remove a client node
Remove the client node LARRY.remove node larry
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 IBM Spectrum Protect. |
REGISTER NODE | Defines a client node to the server and sets options for that user. |
RENAME NODE | Changes the name for a client node. |