Use the chnodecanisterhw command to
update the hardware configuration for a node canister.
Syntax
chnodecanisterhw [ -legacy version ] [ -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 your product support
information.
- 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 clustered system (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