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 is to override or ignore most failures. It can be used to force the removal of broken workload partitions. This flag implies the -s flag.
-p Performs a preservation removal of this workload partition. Configured local file systems (logical volumes or subdirectories within pre-existing logical volumes) are not emptied or removed. This flag is for system workload partitions only. File systems that is preserved by using this flag can be used with the following command to create a new workload partition attached to them: 
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 that are associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

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