NAME

Rex::Commands::Partition - Partition module

DESCRIPTION

With this Module you can partition your harddrive.

Version <= 1.0: All these functions will not be reported.

All these functions are not idempotent.

SYNOPSIS

 use Rex::Commands::Partition;

EXPORTED FUNCTIONS

clearpart($drive)

Clear partitions on drive `sda`:

 clearpart "sda";

Create a new GPT disk label (partition table) on drive `sda`:

 clearpart "sda",
  initialize => "gpt";

If GPT initialization is requested, the `bios_boot` option (default: TRUE) can also be set to TRUE or FALSE to control creation of a BIOS boot partition:

 clearpart "sda",
  initialize => "gpt",
  bios_boot => FALSE;

partition($mountpoint, %option)

Create a partition with the specified parameters:

ondisk: The disk to be partitioned. Mandatory.
size: Desired size of the partition in MB. It is mandatory to pass either a "size" or a "grow" parameter (but not both).
grow: If "TRUE", then the partition will take up all the available space on the disk. It is mandatory to pass either a "grow" or a "size" parameter (but not both).
type: Partition type to be passed to "parted"'s "mkpart" command. Optional, defaults to "primary".
boot: Sets boot flag on the partition if "TRUE". Optional, no boot flag is set by default.
fstype: Create a filesystem after creating the partition. Optional, no filesystem is created by default.
label: Label to be used with the filesystem. Optional, defaults to no label.
mount: If "TRUE", try to mount the partition after creating it. Optional, no mount is attempted by default.
mount_persistent: If "TRUE", try to mount the partition after creating it, and also register it in "/etc/fstab". Optional, no mount or "/etc/fstab" manipulation is attempted by default.
vg: Creates an LVM PV, then creates the specified LVM VG (or extends it, if the VG already exists). Needs "ondisk".

Examples:

 partition "/",
   fstype => "ext3",
   size   => 15000,
   ondisk => "sda",
   type   => "primary";
    
 partition "none",
   type   => "extended",
   ondisk => "sda",
   grow   => 1,
   mount  => TRUE,
       
 partition "swap",
   fstype => "swap",
   type   => "logical",
   ondisk => "sda",
   size   => 8000;
    
 partition "/",
   fstype => "ext3",
   size   => 10000,
   ondisk => "sda",
   vg     => "vg0";