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.

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.
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, you must complete the following tasks in order:
  1. Delete any paths from the data mover
  2. Delete the data mover
  3. Delete all virtual file space definitions for the node
  4. Remove the NAS node
For users of Lightweight Directory Access Protocol (LDAP) servers: The information in this documentation applies to the LDAP authentication method that is preferred for IBM Spectrum Protect™ V7.1.7 or later servers. For instructions about using the previous LDAP authentication method, see Managing passwords and logon procedures.

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

Read syntax diagramSkip visual syntax diagram
                           .-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

Table 1. Commands related to REMOVE NODE
Command Description
AIX operating systemsWindows operating systemsDELETE MACHNODEASSOCIATION AIX operating systemsWindows operating systemsDeletes 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.
AIX operating systemsWindows operating systemsQUERY MACHINE AIX operating systemsWindows operating systemsDisplays 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.