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

dpmlpar delete Command--Delete a Logical Partition

The dpmlpar delete command deletes a logical partition that is deactivated.

Important! Verify that you back up any important data before you issue this command. This command deletes the LPAR and the data files for the LPAR. The LPAR must be powered off when you issue this command.

This command has the following format:

dpmlpar delete 
[-sc sc_url] 
-hmc name 
-managed_system managedsystemname 
-partition_name partitionname 
[-pre] [-post]
[-ws_user username]
[-ws_password password]
[-prompt <false|true>]
[-ws_remote_user username]
[-ws_remote_password password]
[-delete_logical_value <false|true>]
[-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

-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 name of a logical partition to delete. This partition must exist on the managed system.

-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: Delete a Logical Partition

This example deletes the logical partition, "lpar01."

dpmlpar delete -hmc hmc02 -managed_system system05 
-partition_name lpar01