This command is used to set or release this Hardware Management Console (HMC) as the PowerVM management controller for the managed system. You must set this HMC as the PowerVM management controller for a managed system when you want to perform an operation from this HMC that requires this HMC to be the PowerVM management controller. In addition, you can choose to set this HMC as the PowerVM management controller for a managed system when you want this HMC to be the only HMC that can perform PowerVM management for the managed system. Other HMCs would be able to perform PowerVM view operations only.
| -m | The name of the managed system for which to change co-management settings. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. |
| -o | The operation to perform. Valid values are setcontroller to set this HMC as the PowerVM management controller for the managed system, and relcontroller to release this HMC as the PowerVM management controller for the managed system. |
| -t |
The type of PowerVM management controller to set. Valid values are norm to set this HMC as a normal controller, and keep to set this HMC as a persistent controller.
If you set this HMC as the PowerVM management controller for a managed system, it is recommended that you release it as controller as soon as controller mode is no longer needed, unless you want this HMC to remain the only HMC that can perform PowerVM management for the managed system. If you choose normal controller mode and you do not release it, it will be gracefully released when another PowerVM manager, such as another HMC, sets itself as the PowerVM management controller for the managed system. If you choose persistent controller mode and you do not release it, no other PowerVM manager will be able to set itself as the PowerVM management controller for the managed system without forcing the operation. It is recommended that you do not choose persistent controller mode unless directed to do so by your hardware service representative. To set this HMC as the persistent controller for a managed system, you must first set this HMC as the normal controller, unless there is no current PowerVM management controller for the managed system. Once this HMC is the current controller, then you can set this HMC as the persistent controller. If there is no current PowerVM management controller for the managed system, you can immediately set this HMC as the persistent controller without setting it as the normal controller first. This option is required when setting the PowerVM management controller. This option is not valid otherwise. |
| --force |
Specify this option to force this HMC to be set as the PowerVM management normal controller for the managed system. Use this option when you are not able to get the current PowerVM management controller to release itself as the controller. Warning: use this option carefully. Forcing the set controller operation can result in any operations in progress on the current PowerVM management controller to fail, which can have unexpected impacts on managed system and partition configuration and states.
If the current PowerVM management controller for the managed system is in normal controller mode, you must first try to set this HMC as the normal controller without using the --force option. After doing so, if this HMC remains in pending controller mode, then you can immediately set this HMC as the normal controller by running this command again using the --force option. If the current PowerVM management controller for the managed system is in persistent controller mode, you can immediately set this HMC as the normal controller by using the --force option. This option is only valid when setting this HMC as the PowerVM management normal controller for a managed system. |
| --help | Display the help text for this command and exit. |
chcomgmt -m sys1 -o setcontroller -t norm
Release this HMC as the PowerVM management controller for managed system sys1:
chcomgmt -m sys1 -o relcontroller
| None | |
| None | |
| Linux | CHCOMGMT (1) | September 2021 |