Reference Guide › AutoShell › AutoShell Loadable Modules' Command Reference › CA IBM LPAR AutoShell Commands › dpmlpar-cycle Command--Cycle a Logical Partition (Funclet)

dpmlpar-cycle Command--Cycle a Logical Partition (Funclet)

The dpmlpar-cycle command powers on, powers off, resets, or suspends a logical partition.

This command has the following format:

dpmlpar-cycle 
-powerop {activate|restart|shutdown} 
-hmc name 
-managed_system managedsystemname 
-partition_name partitionname 
[-type {delayed|immediate|os_shutdown|immediate_os_shutdown}] 
[-profile_name profilename] 
[-activate_bootmode {normal|open_firmware}] 
[-activate_keylock {normal|manual}]
[-verbose add_commandinfo]
[-sc URL]
[-ws_remote_user username]
[-ws_remote_password password]
[-pre]
[-post]

-powerop {activate|restart|shutdown}

Specifies the power operation to perform on the LPAR. Options include the following:

activate

Turns on the LPAR.

restart

Turns off the LPAR, if necessary, and then turns it on.

shutdown

Turns off the LPAR.

-hmc name

Specifies the Hardware Management Console (HMC) or Integrated Virtualization Manager (IVM) that controls the managed systems where the logical partition resides.

-managed_system managedsystemname

Specifies the managed system on which the logical partition resides. The managed system must exist on the HMC/IVM.

-partition_name partitionname

Specifies the logical partition to which the resources are going to be applied. The partition must exist on the managed system.

-type {immediate|os_shutdown|immediate_os_shutdown}

Specifies to use the imaging operation type resource group (res_group) or individual resources (individual_res). Options include the following:

immediate

Shuts down the partition immediately. This option can cause undesirable results if the data has only been partially updated.

os_shutdown

Shuts down the partition by issuing the command for a typical shutdown. The partition must be imaged for this option to succeed.

immediate_os_shutdown

Shuts down the partition by issuing the operating system command to shut down the system as soon as possible. This command bypasses typical shutdown activities including sending messages to other users. The partition must be imaged for this option to succeed.

-profile_name lparprofile (HMC only)

[-profile_name lparname] (IVM only)

Specifies the partition profile to use when you activate the logical partition. Required for HMC. Optional for IVM, and if specified the name must match the partition name.

-activate_bootmode {normal|open_firmware}

(Optional) Specifies the keylock mode for the activate operation. Options include the following:

normal

Starts the partition in the typical manner.

open_firmware

Starts the partition and opens the open firmware prompt.

-activate_keylock {normal|manual|bypass}

(Optional) Specifies the keylock mode for the activate operation. Options include the following:

normal

Starts the partition in unattended mode and requires no user interaction during activation.

manual

Starts the partition in attended mode and requires user interaction during activation.

bypass

Does not activate the keylock mode.

-verbose add_commandinfo

Provides additional information about how to execute the command.

-sc URL

(Optional) Specifies the URL of the service controller.

-ws_remote_user username

(Optional) Specifies the CA Server Automation remote user name.

-ws_remote_password password

(Optional) Specifies the CA Server Automation remote password.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

Example: Activate a Logical Partition with the Default Profile

This example activates the logical partition, "testlpar," using the default profile.

dpmlpar-cycle -powerop activate -hmc uslihmc -managed_system testComputer 
-partition_name testlpar -profile_name testlparprofile

Example: Activate a Logical Partition with a Specified Profile

This example activates the logical partition, "testlpar," using the profile testlparprofile.

dpmlpar-cycle -powerop activate -hmc uslihmc -managed_system testComputer 
-partition_name testlpar -profile_name testlparprofile

Example: Activate a Logical Partition to Open Firmware Prompt

This example activates the logical partition "testlpar" using the profile testlparprofile and opens to the open firmware prompt.

dpmlpar-cycle -powerop activate -hmc usliivm -managed_system testMS 
-partition_name testlpar -activate_bootmode open_firmware

Example: Delayed Shut Down of a Logical Partition

This example performs a delayed shutdown of the logical partition, "testlpar."

dpmlpar-cycle -hmc testivm -powerop shutdown -managed_system managedsys1 
-partition testlpar -type delayed