PowerOn_LogicalPartition Job

The PowerOn_LogicalPartition job is used to power on a logical partition.

Resource

/rest/api/uom/LogicalPartition/LogicalPartitionUid/do/PowerOn

Request

You must power on a logical partition to start managing it.

Table 1. Request parameters
Request param	Description
bootmode	The boot mode to use when activating an AIX®, Linux, or Virtual I/O Server partition. Valid values are for `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.
iIPLsource	The inital program load (IPL) source to use when activating an IBM® i partition. Valid values are a, b, c, or d.
iIPV4address	The IPv4 address of the Ethernet adapter or HEA logical port that is assigned as the alternate restart device of the IBM i partition on which tthe network installation operation will be performed.
IPAddress	The IPv4 or IPv6 address of the Ethernet adapter or HEA logical port that is assigned as the alternate restart device of the IBM i partition on which the network installation operation will be performed.
SubnetMask	The network mask associated with the IPv4 address specified with the --ip option.
iNetmask	The network mask associated with the IP address specified with the --ip option.
iGateway	The IPv4 address of the gateway to use when performing a network installation of an IBM i partition.
Gateway	The IPv4 or IPv6 address of the gateway to use when performing a network installation of an IBM i partition.
iServerIPV4address	The IPv4 address of the server that contains the network installation images for an IBM i partition.
ServerIPAddress	The IPv4 or IPv6 address of the server that contains the network installation images for an IBM i partition.
iServerdir	The directory on the server that contains the network installation images for an IBM i partition.
iSpeed	The speed setting to use when performing a network installation 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.
ConnectionSpeed	The speed setting to use when performing a network installation 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.
iDuplex	The duplex setting to use when performing a network installation 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.
DuplexMode	The duplex setting to use when performing a network installation 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.
SlotPhysicalLocationCode	The physical location code to be used for a Netboot operation (-l option in CLI).
BootImageFileName	Network boot image file name, mandatory parameter only for IPv6 Netboot (-B option in CLI).
IBMiImageServerDirectory	The server directory containing IBM i image.
iMtu	The maximum transmission unit, in bytes, to use when performing a network installation of an IBM i partition. Valid values are 1500 bytes or 9000 bytes. If this option is not specified, it defaults to 1500 bytes.
MaximumTransmissionUnit	The maximum transmission unit, in bytes, to use when performing a network installation of an IBM i partition. Valid values are 1500 bytes or 9000 bytes. The default value is 1500 bytes.
Timeout	If this value is not specified, by default the value is set to 3600000 milli seconds (60 minutes).
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 continues to be activated with VSI profiles, if possible.
VLAN	The VLAN ID to be used when performing a network installation of an IBM i partition. The valid values are 1 (lowest) - 4094 (highest). This attribute is optional.
force	This option allows you to shut down a Virtual IO 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 during 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 no paging space is available device in the shared memory pool that can be accessed by both paging VIOS partitions. However, a paging space device is available 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 that is not currently available or does not have access to an available paging space device in the shared memory pool, but another paging VIOS partition is available in the shared memory pool that has access to an available paging space device in the shared memory pool.
keylock	The keylock position to set. Valid values are `manual` and `norm` for normal. This option is required while 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.
LogicalPartitionProfile	The name of the profile against which the partition will be powered on.

Response

This job returns the job ID to be used to poll the iob status.

Sample Job Request(s)

	
<JobRequest:JobRequest
 xmlns:JobRequest="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"
 xmlns="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"
 xmlns:ns2="http://www.w3.org/XML/1998/namespace/k2" schemaVersion="V1_1">
    <Metadata>
        <Atom/>
    </Metadata>
    <RequestedOperation kb="CUR" kxe="false" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <OperationName kb="ROR" kxe="false">PowerOn</OperationName>
        <GroupName kb="ROR" kxe="false">LogicalPartition</GroupName>
    </RequestedOperation>
    <JobParameters kb="CUR" kxe="false" schemaVersion="V1_0">
        <Metadata>
            <Atom/>
        </Metadata>
	  <JobParameter schemaVersion="V1_0">
           <Metadata>
               <Atom/>
           </Metadata>
           <ParameterName kxe="false" kb="ROR">force</ParameterName>
           <ParameterValue kxe="false" kb="CUR">false</ParameterValue>
      </JobParameter>
      <JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">LogicalPartitionProfile</ParameterName>
            <ParameterValue kxe="false" kb="CUR">lpar_prof</ParameterValue>
        </JobParameter>
		<JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">novsi</ParameterName>
            <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
        </JobParameter>
		<JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">bootmode</ParameterName>
            <ParameterValue kxe="false" kb="CUR">norm</ParameterValue>
        </JobParameter>
		<JobParameter schemaVersion="V1_0">
            <Metadata>
                <Atom/>
            </Metadata>
            <ParameterName kxe="false" kb="ROR">keylock</ParameterName>
            <ParameterValue kxe="false" kb="CUR">manual</ParameterValue>
        </JobParameter>
   </JobParameters>
</JobRequest:JobRequest>

Last updated: Fri, June 23, 2017