One-to-One hybrid Driver

Considerations & Limitations

  • You need to setup an user account in the remote OpenNebula cloud. All operations will be mapped to this account in the remote OpenNebula cloud, you may need to consider this when setting up quotas or access rules for this remote account.
  • The following operations are not supported for VMs in the remote cloud: disk operations (attach/detach, snapshots or save), nic operations (attach/detach), migrations or reconfigurations.
  • You need to refer the remote VM Templates by their ID, see below for hints to do so.
  • Context attribute can be added to the local VM Template, these values will be copied to the remote machine.


The attribute FILES is not supported.

  • All states of local virtual machines mirror those of the remote virtual machines except for running, that it may also include pending or any other active states.


An user account needs to be setup in remote OpenNebula. This user should have access to the VM Templates that you are going to expose for hybrid access.


You can check if the user has access to the remote template with the command onetemplate list --endpoint <REMOTE_ENDPOINT> --user <REMOTE_USER> --password <REMOTE_PASS>.

OpenNebula Configuration

Uncomment the OpenNebula IM and VMM drivers from /etc/one/oned.conf file in order to use the driver.

IM_MAD = [
    NAME          = "one",
    SUNSTONE_NAME = "OpenNebula",
    EXECUTABLE    = "one_im_sh",
    ARGUMENTS     = "-c -t 1 -r 0 one" ]

VM_MAD = [
    NAME           = "one",
    SUNSTONE_NAME  = "OpenNebula",
    EXECUTABLE     = "one_vmm_sh",
    ARGUMENTS      = "-t 15 -r 0 one",
    TYPE           = "xml",

Driver flags are the same as other drivers:

-t Number of threads
-r Number of retries

Defining a Hybrid OpenNebula Cloud

First create a new Host with im and vm drivers set to one.

$ onehost create <name> -i one -v one

And, now add the user attributes to connect to the hybrid OpenNebula within host template:

$ onehost update <hostid>

ONE_USER = <remote_username>

ONE_PASSWORD = <remote_password>
ONE_ENDPOINT = <remote_endpoint>
    CPU    = 0,
    MEMORY = 0

The following table describes each supported attribute to configure the hybrid OpenNebula cloud.


The attribute ONE_CAPACITY includes two attributes, CPU and MEMORY, these attributes limit the usage of the remote resources.

ONE_USER Remote username
ONE_PASSWORD Remote password for the username
ONE_ENDPOINT Remote endpoint url to access
ONE_CAPACITY 0 indicate that the quotas are taken from the user and group quotas of the remote OpenNebula user. Alternatively, you can set a hard limit here

OpenNebula to OpenNebula Specific Template Attributes

The following section describes how to create a new local template and map it to the remote template.

Local VM Template

Firstly, find out the remote templates you have access to:

onetemplate list --endpoint http://<hybrid_OpenNebula_cloud>:2633/RPC2 --user <username> --password <pass>

Now, create a new local template for each remote template you want to use. It is recommended to set the same CPU and MEMORY as the remote Template. For example:

cat template.txt
NAME = "hybrid-template"

CPU    = 0.1
MEMORY = 128

    TEMPLATE_ID = "0",
    TYPE        = "opennebula"

onetemplate create template.txt
ID: 0


Your hybrid VM Template must set TEMPLATE_ID to the target VM Template ID in the remote OpenNebula.