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