chnodecanisterhw

Use the chnodecanisterhw command to update the hardware configuration for a node canister.

Syntax

chnodecanisterhw [ -legacyversion ] [ -force ] [ { object_id | object_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) Allows the node to change its hardware configuration, even if it might cause the 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 canister if the canister hardware is different than its configured hardware. After rebooting, the node canister uses its hardware, and does not use the previous configuration.

Attention: When you run the chnodecanisterhw command to change the configured hardware for a node canister, these items are removed:
  • Small Computer System Interface-3 (SCSI-3) reservations (through that node canister) are removed.
  • Small Computer System Interface-3 (SCSI-3) registrations (through that node canister) 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.

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

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

chnodecanisterhw 7

The resulting output:

No feedback

An invocation example of how to update the node canister hardware configuration for node7 (even if the reboot of the node canister causes an I/O outage)

chnodecanisterhw -force node7

The resulting output:

No feedback

An invocation example of how to update the node hardware configuration for compatibility with code level 6.3.0.0

chnodecanisterhw -legacy 6.3.0.0 node2

The resulting output:

No feedback