chnodehw

Use the chnodehw command to update the hardware configuration for a node.

Syntax

Read syntax diagramSkip visual syntax diagram chnodehw -legacyversion -force object_idobject_name

Parameters

-legacy version
(Optional) Sets the hardware configuration to make it compatible with the 6.3.0.0 code level. The format is four decimal numbers that are separated by periods, and there can be up to 16 characters.
-force
(Optional) Allow the node to restart and change its hardware configuration even if it causes volumes to go offline.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM® support personnel.
object_id | object_name
(Optional) Specifies the object name or ID.

Description

This command automatically reboots the node if the node hardware is different than its configured hardware. After rebooting, the node uses its hardware, and does not use the previous configuration.

Attention: When you run the chnodehw command to change the configured hardware for a node:
  • Small Computer System Interface-3 (SCSI-3) reservations (through that node) are removed.
  • Small Computer System Interface-3 (SCSI-3) registrations (through that node) are removed.
Note:
  • This command fails if you remove the last compression card of a node and try to commit that change while compressed volumes still exist in that I/O group.
  • This command cannot be used for memory upgrades. If any new hardware configuration contains extra memory, this command fails.

Use the -legacy parameter if you want to establish a partnership with another clustered system that is running an earlier level of code than the local system. The value that is supplied for the -legacy parameter must be the code level of the other clustered system.

An invocation example of how to update the node hardware configuration of node ID 7

chnodehw 7

The resulting output:

No feedback