/ 
Net-OpenNebula-0.1
River stage zero No dependents
/ Net::OpenNebula

NAME

Net::OpenNebula - Access OpenNebula RPC via Perl.

DESCRIPTION

With this module you can access the OpenNebula XML-RPC service.

To inspect the return values of the methods we suggest to use Data::Dumper.

SYNOPSIS

use Net::OpenNebula;
use Data::Dumper; # for the Dumper() function.
   
my $one = Net::OpenNebula->new(
   url      => "http://server:2633/RPC2",
   user     => "oneadmin",
   password => "onepass",
);
   
my @vms = $one->get_vms();
    
print Dumper(@vms);

METHODS

new(%option)

This is the constructor.

my $one = Net::OpenNebula->new(
   url      => "http://server:2633/RPC2",
   user     => "oneadmin",
   password => "onepass",
);
get_clusters()

This function calls one.clusterpool.info. This will return information of all clusters in the pool.

my @clusters = $one->get_clusters;
get_hosts()

This function calls one.hostpool.info. This will return information of all hosts in the pool.

my @hosts = $one->get_hosts;
get_host($id)

This function calls one.host.info. This will return information the given host. You need to refer to the host by its OpenNebula id.

my $host = $one->get_host(5);
get_vms()

This function calls one.vmpool.info. This will return information of all known virtual machines.

my @vms = $one->get_vms;
get_vm()

This function calls one.vm.info. This will return information of the given virtual machine.

my $vm = $one->get_vm(8);

You can also use the virtual machine's name.

my $vm = $one->get_vm('myvm');
get_templates()

This function calls one.templatepool.info. This will return information of all the templates available in OpenNebula.

my @templates = $one->get_templates;
create_vm(%option)

This function will call one.vm.allocate and create a new virtual machine.

my $vm = $one->create_vm(
   template => 7,
   name     => 'vmname',
);

You can also use the template name.

my $vm = $one->create_vm(
   template => 'centos',
   name     => 'vmname',
);
create_host(%option)

This function will call one.host.allocate and register a new host into OpenNebula.

my $host = $one->create_host(
   name    => 'my-computenode',
   im_mad  => 'im_mad_name',  # optional
   vmm_mad => 'vmm_mad_name', # optional
   vnm_mad => 'vnm_mad_name', # optional
   cluster => 'my-computenode',
);

The cluster option is optional. All other options are mandatory.