You can use the chnode command to change the name that is assigned to a node and other options. The name can then be used when running subsequent commands. All the parameters that are associated with this command are optional. However, you must specify one or more parameters with this command.
Syntax
>>- svctask -- -- chnode -- --+------------------------+--------> +- -iscsialias -- alias -+ '- -noiscsialias --------' >--+-------------+-- --+--------------------------+-- ----------> '- -failover -' '- -name -- new_node_name -' >--+- node_name -+--------------------------------------------->< '- node_id ---'
Parameters
- -iscsialias alias
- (Optional) Specifies the iSCSI name of the node. The maximum length is 79 characters.
- -noiscsialias
- (Optional) Clears any previously set iSCSI name for this node. This parameter cannot be specified with the iscsialias parameter.
- -failover
- (Optional) Specifies that the name or iSCSI alias being set is the name or alias of the partner node in the I/O group. When there is no partner node, the values set are applied to the partner node when it is added to the cluster. If this parameter is used when there is a partner node, the name or alias of that node changes.
- -name new_node_name
- (Optional) Specifies the name to assign to
the node.Important: The iSCSI Qualified Name (IQN) for each node is generated using the cluster and node names. If you are using the iSCSI protocol, changing either name also changes the IQN of all of the nodes in the cluster and might require reconfiguration of all iSCSI-attached hosts.
- node_name | node_id
- (Required) Specifies the node to be modified. The variable that
follows the parameter is either:
- The node name that you assigned when you added the node to the cluster.
- The node ID that is assigned to the node (not the worldwide node name).
Description
If the failover parameter is not specified, this command changes the name or iSCSI alias of the node. The name can then be used to identify the node in subsequent commands.
The failover parameter is used to specify values that are normally applied to the partner node in the I/O group. When the partner node is offline, the iSCSI alias and IQN are assigned to the remaining node in the I/O Group. The iSCSI host data access is then preserved. If the partner node is offline when these parameters are set, the node they are set on handles iSCSI I/O requests to the iSCSI alias specified, or the IQN that is created using the node name. If the partner node in the I/O group is online when these parameters are set, the partner node handles iSCSI requests to the iSCSI alias specified, and its node name and IQN change.
An invocation example
svctask chnode -name testnodeone nodeone
The resulting output
No feedback