To power on an OpenPower managed system:
chsysstate {-m managed-systems | --all} -r sys -o on
To power off a managed system:
chsysstate {-m managed-systems | --all} -r sys -o off
[--immed] [--force]
To power off an OpenPower managed system:
chsysstate {-m managed-systems | --all} -r sys -o off
To restart a managed system (not valid for OpenPower managed systems):
chsysstate {-m managed-systems | --all} -r sys
-o off --immed --restart
To rebuild a managed system (not valid for OpenPower managed systems):
chsysstate {-m managed-systems | --all} -r sys -o rebuild
To recover partition data for a managed system (not valid for OpenPower managed systems):
chsysstate -m managed-system -r sys -o recover
To initiate service processor failover for a managed system (not valid for OpenPower managed systems):
chsysstate -m managed-system -r sys -o spfailover
To set the keylock position for a managed system or a partition (not valid for OpenPower managed systems):
chsysstate -m managed-system -r {sys | lpar}
-o chkey -k keylock-position
[{-n partition-name | --id partition-ID}]
To activate a partition with a profile:
chsysstate -m managed-system -r lpar -o on
{-n partition-name | --id partition-ID}
-f partition-profile-name
[-k keylock-position]
[-b boot-mode] [-i IPL-source]
[--novsi] [--force]
To activate a partition with its current configuration:
chsysstate -m managed-system -r lpar -o on
{-n partition-names | --id partition-IDs | --all}
[-b boot-mode]
To activate and perform a network install of an IBM i partition:
chsysstate -m managed-system -r lpar -o on
{-n partition-name | --id partition-ID}
[-f partition-profile-name] [-k keylock-position]
[-t {nfs | iscsi}]
--ip IP-address [--netmask network-mask]
--gateway gateway-IP-address
[--serverip NFS-server-IP-address]
[--serverdir NFS-server-directory]
[--targetip iSCSI-target-IP-address]
[--targetname iSCSI-target-name]
[--targetport iSCSI-port]
[--initiatorname iSCSI-initiator-name]
[--chapname CHAP-name [--chapsecret CHAP-secret]]
[--speed {auto | 1 | 10 | 100 | 1000}]
[--duplex {auto | half | full}]
[--mtu {1500 | 9000}]
[--vlan VLAN-ID]
To shut down or restart a partition (it is recommended that the chlparstate command be used to shut down a suspended partition):
chsysstate -m managed-system -r lpar
-o {shutdown | osshutdown | dumprestart |
retrydump}
{-n partition-name | --id partition-ID | --all |
--allnonvios}
[--immed] [--restart] [--force]
To perform an operator panel service function on a partition:
chsysstate -m managed-system -r lpar
-o {dston | remotedstoff | remotedston |
consoleservice | iopreset | iopdump}
{-n partition-name | --id partition-ID}
To validate or activate a system profile:
chsysstate -m managed-system -r sysprof
-n system-profile-name
[-o on] [--continue] [--test]
See the chlparstate command for additional partition state change operations.
The Hardware Management Console (HMC) must be the current PowerVM management controller for the managed-system when running the chsysstate -r lpar command.
The chsysstate -r sysprof and chsysstate -r sys -o onsysprof commands are not allowed.
| -m |
The name of the managed system on which to perform the operation. 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.
When powering on managed systems (-o on or -o onstandby), powering off or restarting managed systems (-o off), or rebuilding managed systems (-o rebuild), multiple managed system names can be specified with this option, or the --all option can be specified to perform the operation on all managed systems. Multiple managed system names must be comma separated. This option is required when performing a partition or a system profile operation. When performing a managed system operation, either this option or the --all option is required. The -m and --all options are mutually exclusive for managed system operations. |
| -r | The type of resource on which to perform the operation. Valid values are lpar for partition, sys for managed system, and sysprof for system profile. |
| -o |
The operation to perform. Valid values are:
on - activates a partition or a system profile, or powers on the managed-system. When powering on the managed-system, partitions that are marked as auto start are activated unless the managed system is an OpenPower managed system. onstandby - powers on the managed-system to Standby state. onstartpolicy - powers on the managed-system as defined by the next partition start policy. onsysprof - powers on the managed-system then activates a system profile. Only those partitions in the system profile are activated. onhwdisc - powers on the managed-system and runs the hardware discovery process. When the hardware discovery process completes, the managed-system will be in Operating state, but no partitions will be automatically started. off - powers off the managed-system. If the --immed option is specified, a fast power off (operator panel function 8) is performed, otherwise a normal power off is performed. If both the --immed and the --restart options are specified, a restart (operator panel function 3) of the managed-system is performed. rebuild - rebuilds the managed-system. recover - recovers partition data for the managed-system by restoring the data from the backup file on the HMC. spfailover - initiates service processor failover for the managed-system. chkey - sets the keylock position for a partition or the managed-system. shutdown - shuts down a partition. If the --immed option but not the --restart option is specified, an immediate shutdown (operator panel function 8) is performed. If the --restart option but not the --immed option is specified, a dumprestart operation (operator panel function 22) is performed. If both the --immed and the --restart options are specified, an immediate restart (operator panel function 3) of the partition is performed. If neither the --immed nor the --restart option is specified, a delayed shutdown is performed.
It is recommended that the chlparstate command
|
| -f |
When activating a partition with a profile, use this option to specify the name of the partition profile to use.
If the managed-system is in the manufacturing default configuration and this option is not specified, the partition will be activated with no configuration changes and the managed-system will remain in the manufacturing default configuration. If the managed-system is in the manufacturing default configuration and this option is specified, the partition will be activated with the configuration specified by partition-profile-name and the manufacturing default configuration will be permanently exited. When powering on a managed system with a system profile, use this option to specify the name of the system profile to use. This option is required. |
| -k |
The keylock position to set. Valid values are manual and norm for normal.
This option is required when setting the keylock position for a partition or a managed system. This option is optional when powering on a managed system or activating a partition. |
| --immed |
If this option is specified when powering off a managed system, a fast power off is performed.
This option must be specified when restarting a managed system. If this option is specified when shutting down or restarting a partition, an immediate shutdown or restart is performed. |
| --restart | If this option is specified, the partition or managed system will be restarted. |
| -n |
When performing a system profile operation, use this option to specify the name of the system profile on which to perform the operation.
When performing a partition operation, use this option to specify the name of the partition on which to perform the operation, the --id option to specify the partition’s ID, the --all option to perform the operation on all partitions, or the --allnonvios option to perform the operation on all partitions except Virtual I/O Server (VIOS) partitions. The --all option is only allowed when activating partitions with their current configurations (-o on), or when shutting down or restarting partitions (-o shutdown). The --allnonvios option is only allowed when shutting down or restarting partitions (-o shutdown). When activating partitions with their current configurations, multiple partition names can be specified with this option. The partition names must be comma separated. The -n, --id, --all, and --allnonvios options are mutually exclusive for partition operations. |
| --id |
When performing a partition operation, use this option to specify the ID of the partition on which to perform the operation, the -n option to specify the partition’s name, the --all option to perform the operation on all partitions, or the --allnonvios option to perform the operation on all partitions except VIOS partitions. The --all option is only allowed when activating partitions with their current configurations (-o on), or when shutting down or restarting partitions (-o shutdown). The --allnonvios option is only allowed when shutting down or restarting partitions (-o shutdown).
When activating partitions with their current configurations, multiple partition IDs can be specified with this option. The partition IDs must be comma separated. The --id, -n, --all, and --allnonvios options are mutually exclusive for partition operations. |
| --all |
When performing a managed system operation, specify this option to perform the operation on all of the systems currently managed by this HMC. This option is only allowed for the following managed system operations: power on (-o on or -o onstandby), power off or restart (-o off), or rebuild (-o rebuild).
When performing a partition operation, specify this option to perform the operation on all of the partitions in the managed-system. This option is only allowed for the following partition operations: activate with current configuration (-o on), or shut down or restart (-o shutdown). |
| --allnonvios | When performing a partition shutdown or restart operation (-o shutdown), specify this option to perform the operation on all of the partitions in the managed-system except VIOS partitions. |
| -b | The boot mode to use when activating an AIX, Linux, or Virtual I/O Server partition. Valid values are norm for normal, dd for diagnostic with default boot list, ds for diagnostic with stored boot list, of for Open Firmware OK prompt, or sms for System Management Services. |
| -i | The IPL source to use when activating an IBM i partition. Valid values are a, b, c, or d. |
| -t | The type of network installation server to use to perform a network install for an IBM i partition. Valid values are nfs for an NFS server or iscsi for an iSCSI server. If this option is not specified, it defaults to nfs. |
| --ip | The IP address of the Ethernet adapter or SR-IOV logical port assigned as the alternate restart device of the IBM i partition for which to perform the network install operation. When performing a network install using an NFS server, either an IPv4 or an IPv6 address can be specified. If an IPv6 address is specified, it must be in the following format: IPv6-address/prefix-length. When performing a network install using an iSCSI server, an IPv4 address must be specified. |
| --netmask | If the IP address specified with the --ip option is an IPv4 address, this option is required and is used to specify the network mask. If the IP address specified with the --ip option is an IPv6 address, this option is not valid. |
| --gateway | The IP address of the gateway to use when performing a network install of an IBM i partition. When performing a network install using an NFS server, either an IPv4 or an IPv6 address can be specified. When performing a network install using an iSCSI server, an IPv4 address must be specified. |
| --serverip |
The IP address of the NFS server that contains the network install images for an IBM i partition. Either an IPv4 or an IPv6 address can be specified.
This option is required when performing a network install of an IBM i partition using an NFS server. |
| --serverdir |
The directory on the NFS server that contains the network install images for an IBM i partition.
This option is required when performing a network install of an IBM i partition using an NFS server. |
| --targetip |
The IPv4 address of the iSCSI target that contains the network install images for an IBM i partition.
This option is required when performing a network install of an IBM i partition using an iSCSI server. |
| --targetname |
The name of the iSCSI target that contains the network install images for an IBM i partition.
This option is required when performing a network install of an IBM i partition using an iSCSI server. |
| --targetport |
The port to use for the iSCSI connection. If this option is not specified when performing a network install using an iSCSI server, it defaults to 3260.
This option is only valid when performing a network install of an IBM i partition using an iSCSI server. |
| --initiatorname |
The name of the iSCSI initiator associated with the iSCSI target that contains the network install images for an IBM i partition.
If this option is not specified, it defaults to the value displayed by the lssyscfg -r lpar -m managed-system -F os400_iscsi_initiator_name_default command.
This option is only valid when performing a network install of an IBM i partition using an iSCSI server. |
| --chapname |
The Challenge-Handshake Authentication Protocol (CHAP) name used by the IBM i iSCSI initiator to authenticate with the iSCSI target.
This option is only valid when performing a network install of an IBM i partition using an iSCSI server. |
| --chapsecret |
The CHAP secret used by the IBM i iSCSI initiator to authenticate with the iSCSI target.
This option is required when a CHAP name is specified. If a CHAP name is specified and this option is omitted, you will be prompted to enter the secret. This option is only valid when performing a network install of an IBM i partition using an iSCSI server and a CHAP name. |
| --speed |
The speed setting to use when performing a network install of an IBM i partition. Valid values are:
auto - automatically detect and set speed 1 - 1 Mbps 10 - 10 Mbps 100 - 100 Mbps 1000 - 1000 Mbps If this option is not specified, it defaults to auto. |
| --duplex |
The duplex setting to use when performing a network install of an IBM i partition. Valid values are:
auto - automatically detect and set duplex half - half duplex full - full duplex If this option is not specified, it defaults to auto. |
| --mtu | The maximum transmission unit, in bytes, to use when performing a network install of an IBM i partition. Valid values are 1500 or 9000 bytes. If this option is not specified, it defaults to 1500 bytes. |
| --vlan | The VLAN ID to use when performing a network install of an IBM i partition. Ethernet packets will be tagged with the specified VLAN ID. If this option is not specified, Ethernet packets will be untagged. |
| --novsi | When activating a partition that uses virtual ethernet adapter Virtual Station Interface (VSI) profiles, use this option to allow the partition to be activated without VSI profiles. Note that when this option is specified, the partition will still be activated with VSI profiles if possible. |
| --force |
This option allows you to power off a managed system while a dump from the managed system is being offloaded to the HMC. It is recommended that you wait until the dump offload operaion is complete before powering off. If you choose to not wait the dump may be corrupted or incomplete and unable to be used for problem determination.
This option allows you to shut down a Virtual I/O Server (VIOS) partition which is the only VIOS partition providing access to the paging device or reserved storage device for one or more partitions. This option also allows you to activate a shared memory partition under any of the following conditions: - the partition is configured to use redundant paging VIOS partitions, but only one paging VIOS partition is currently available and that paging VIOS partition has access to an available paging space device in the shared memory pool, - the partition is configured to use redundant paging VIOS partitions, but there is no available paging space device in the shared memory pool that can be accessed by both paging VIOS partitions. However, there is an available paging space device in the shared memory pool that can be accessed by one of the paging VIOS partitions, - the partition is configured to use a single paging VIOS partition which is not currently available or does not have access to an available paging space device in the shared memory pool, but there is another paging VIOS partition in the shared memory pool that is available and that has access to an available paging space device in the shared memory pool. |
| --test | If this option is specified when performing a system profile operation, the system profile is validated. |
| --continue | If this option is specified when activating a system profile, remaining partitions will continue to be activated after a partition activation failure occurs. |
| --help | Display the help text for this command and exit. |
| 0 | Success |
| 100 |
Partial success
This value is returned when performing an operation on multiple managed systems or multiple partitions and at least one operation succeeded, and at least one failed. |
chsysstate -m 9406-520*10110CA -r sys -o on
Power on a managed system with a system profile:
chsysstate -m sys1 -r sys -o onsysprof -f mySysProf
Power off a managed system normally:
chsysstate -m sys1 -r sys -o off
Power off a managed system fast:
chsysstate -m sys1 -r sys -o off --immed
Restart a managed system:
chsysstate -m 9406-570*12345678 -r sys -o off --immed
--restart
Rebuild a managed system:
chsysstate -m 9406-570*12345678 -r sys -o rebuild
Recover partition data for a managed system:
chsysstate -m sys1 -r sys -o recover
Initiate service processor failover for a managed system:
chsysstate -m myServer -r sys -o spfailover
Set the keylock position for a managed system:
chsysstate -m sys1 -r sys -o chkey -k manual
Activate IBM i partition p1 using partition profile p1_prof1 and IPL source b:
chsysstate -m sys1 -r lpar -o on -n p1 -f p1_prof1 -i b
Activate partitions p1, p2, and p3 with their current configurations:
chsysstate -m sys1 -r lpar -o on -n p1,p2,p3
Activate and perform a network install of the IBM i partition iLpar using an NFS server:
chsysstate -m mySys -r lpar -o on -n iLpar -f iProf --ip 9.1.2.33
--netmask 255.255.255.0 --gateway 9.1.0.1 --serverip 9.5.12.34
--serverdir /IBMi/611
Activate and perform a network install of the IBM i partition iLpar using an iSCSI server:
chsysstate -m mySys -r lpar -o on -n iLpar -t iscsi --ip 9.1.2.3
--netmask 255.255.254.0 --gateway 9.1.0.1 --targetip 9.1.2.35
--targetname iqn.2000-03.com.falconstor:vtl.dsitest.Target-40
--initiatorname
iqn.1924-02.com.ibm:ibmi.5749fde66af6445c846d02ebae0006ee-i0
Shut down the partition with ID 1:
chsysstate -m 9406-570*12345678 -r lpar -o shutdown --id 1
Issue the operating system shutdown command to immediately shut down the partition p1:
chsysstate -m 9406-570*12345678 -r lpar -o osshutdown
-n p1 --immed
Issue the operating system shutdown command to shut down then restart the partition p1:
chsysstate -m 9406-570*12345678 -r lpar -o osshutdown
-n p1 --restart
Immediately restart the partition with ID 1:
chsysstate -m 9406-570*12345678 -r lpar -o shutdown --id 1
--immed --restart
Enable a remote service session for the IBM i partition mylpar:
chsysstate -m sys1 -r lpar -o remotedston -n mylpar
Validate system profile sp1:
chsysstate -m sys1 -r sysprof -n sp1 --test
Validate then activate system profile sp1:
chsysstate -m sys1 -r sysprof -n sp1 -o on --test
Activate system profile mySysProf and continue activating remaining partitions if a partition activation failure occurs:
chsysstate -m 9406-570*12345678 -r sysprof -n mySysProf
-o on --continue
| None | |
| None | |
| Linux | CHSYSSTATE (1) | December 2022 |