NAME

Rex::Virtualization::VBox - VirtualBox Virtualization Module

DESCRIPTION

With this module you can manage VirtualBox.

SYNOPSIS

use Rex::Commands::Virtualization;
   
set virtualization => "VBox";
   
use Data::Dumper;   
  
print Dumper vm list => "all";
print Dumper vm list => "running";
   
vm destroy => "vm01";
   
vm delete => "vm01"; 
    
vm start => "vm01";
   
vm shutdown => "vm01";
   
vm reboot => "vm01";
   
vm option => "vm01",
         memory     => 512;
             
print Dumper vm info => "vm01";
   
# creating a vm 
vm create => "vm01",
     storage     => [
        {   
           file   => "/mnt/data/vbox/vm01.img",
           size   => "10G",
        },
        {
           file => "/mnt/iso/debian6.iso",
        }
     ],
     memory => 512,
     type => "Linux26", 
     cpus => 1,
     boot => "dvd";
  
vm forward_port => "vm01", add => { http => [8080, 80] };
  
vm forward_port => "vm01", remove => "http";
 
print Dumper vm guestinfo => "vm01";
   
vm share_folder => "vm01", add => { sharename => "/path/to/share" };
   
vm share_folder => "vm01", remove => "sharename";

For VirtualBox memory declaration is always in megabyte.