Use the swapnode command to exchange and maintain nodes
without interruption to the virtualized target ports associated with the specified node.
Syntax
swapnode [ { -replace | -failback | -failover | -service } ] [ -force ] -spare { [ node_id ] | [ node_name ] } { [ node_id ] | [ node_name ] }
Parameters
- -replace | -failback | -failover | -service
- (Optional) Specifies whether to replace or service a selected node. The values are:
- -replace replaces a specified offline node with a suitable candidate.
- -failback replaces a spare (that is being used) with the original node that
it is replacing.
- -failover replaces a node with a spare even if it is currently online.
- -service puts a node into service state after the system triggers a
failover because of any N_Port ID Virtualization (NPIV) ports.
- -sparenode_id | node_name
- (Required) Specifies the ID of the spare node to use as a replacement. This parameter must be
specified with -failover.
Note: The value for the ID must be greater than
1 because the spare is never the first node in the clustered system.
- node_id | node_name
- (Required) Specifies the node ID or name that is being swapped or serviced.
- -force
- Specifies that a node be removed, even if disruption to host system I/O might occur as a result.
Important: Specifying -force might result in a loss of access. Use
it only under the direction of your product support information.
Description
This command exchanges and maintains nodes without interruption to the virtualized
target ports associated with the specified node.
Specify -replace for the system to replace the name, I/O group, and site
values associated with adding a node (by using the addnode command). These values
are taken from the node that is being replaced. The existing node is explicitly specified, and a
candidate node with the same WWNN value is chosen.
Remember: Specifying -replace might be used if you do not want to
specify rmnode for an online node (which would delete the node from the clustered
system).
An invocation example
swapnode -replace 2
The detailed resulting output:
No feedback