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 separated
by periods, and there can be up to sixteen characters.
- -force
- (Optional) Allows the node to change
its hardware configuration, even if doing so 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 begins to use 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 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
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 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