Reference Guide › Command-Line Scripting › CA IBM LPAR CLI Commands › dpmlpar cycle Command--Cycle a Logical Partition

dpmlpar cycle Command--Cycle a Logical Partition

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

This command has the following format:

dpmlpar cycle 
[-sc sc_url] 
-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}] 
[-pre] [-post]
[-ws_user username]
[-ws_password password]
[-prompt <no|yes>]
[-ws_remote_user username]
[-ws_remote_password password]
[-locale iso639value]

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-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.

-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.

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

-prompt {yes|no}

(Optional) Specifies whether you are prompted for the web service user ID and password.

Default: Yes

-ws_remote_user username

(Optional) Specifies the CA Virtual Assurance remote user name.

-ws_remote_password password

(Optional) Specifies the CA Virtual Assurance remote password.

-locale iso639value

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

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 usliivm 
-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 uslihmc 
-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