rmwpar Command

Purpose

Removes a workload partition.

Syntax

/usr/sbin/rmwpar [ -F ] [ -p ] [ -s ] [ -v ] WparName

Description

The rmwpar command deletes the specified workload partition from the system that includes the following tasks:

Removing the workload partition's configuration data from the system's workload partition database
Deleting the workload partition's file systems (if you do not specify the -p flag)
Removing the workload partition's Workload Manager (WLM) profile

Without the -F flag, the rmwpar command stops the first time any part of the operation fails. If you specify the -F flag, the rmwpar command removes as much as possible. If the specified workload partition is active, the rmwpar command fails unless you specify the -s flag or the -F flag.

Flags

Item	Description
`-F`	Specifies that the rmwpar command must override or ignore most failures. It can be used to force the removal of broken workload partitions. This flag implies the `-s` flag.
`-p`	Removes a preservation removal that is assigned for the workload partition. The configured local file systems that are the logical volumes or subdirectories within the pre-existing logical volumes are not emptied or removed. This flag is for system workload partitions only. This flag cannot be used with rootvg workload partitions. File systems that are preserved by using this flag can be used with the following command to create a new workload partition that is attached to the m: `mkwpar -p`
`-s`	Stops the workload partition. This flag is equivalent to calling the stopwpar command before the rmwpar command. Use this flag to shut down and delete a workload partition in 1 step. If the rmwpar command was run with the `-F` flag specified, the stopwpar command can be run with the `-F` flag specified. If the rmwpar command is run on an active workload partition without the `-s` flag or the `-F` flag that is specified, the rmwpar command fails.
`-v`	Verbose mode.

Security

Access Control: Only the root user can run this command.

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To remove the workload partition called "roy", enter:
```
rmwpar roy
```
To stop and remove the workload partition called "roy", preserving data on its file system, enter:
```
rmwpar -p -s roy
```