OpenNebula - Flexible Enterprise Cloud Made Simple documentation:archives:rel3.0

documentation:archives:rel3.0:accounting

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: To use this functionality you need to install the Accounting Toolset Addon The accounting toolset visualizes and reports resource usage data, and allows their integration with chargeback and billing platforms. The toolset generates accounting reports using the information from the accounting OpenNebula Database.

documentation:archives:rel3.0:acctd_conf

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula Watch is an utility that provides statistics and accounting information for cloud resources. These values can be used by: * Users, to track information of their resources. * Cloud administrators, to get a global vision of the Cloud and the resource utilization in order to identify potential problems and react immediately.

documentation:archives:rel3.0:api

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This reference documentation describes the xml-rpc methods exposed by OpenNebula. Each description consists of the method name and the input and output values. All xml-rpc responses share a common structure. Type Data Type Description OUT Boolean

documentation:archives:rel3.0:auth

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: Development version of OpenNebula 3.0. The material on this page needs to be reviewed for completeness and accuracy. Authentication and authorization module (auth module) is designed so it can be easily modified or completely replaced. In this guide we will learn how to modify the auth module so you can add new authorization methods or tune it for your needs.

documentation:archives:rel3.0:auth_overview

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Auth Subsystem is responsible for the authentication and authorization of user's requests. Any interface to OpenNebula (CLI, Sunstone, Ruby or Java OCA) communicates with the core using xml-rpc calls, that contain the user's session string, which is authenticated by the OpenNebula core comparing the username and password with the registered users.

documentation:archives:rel3.0:build_deps

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: Development version of OpenNebula 3.0. The material on this page needs to be reviewed for completeness and accuracy. This page lists the build dependencies for OpenNebula. If you want to install it from your package manager, visit the software menu to find out if OpenNebula is included in your official distribution package repositories.

documentation:archives:rel3.0:catalog

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: Development version of OpenNebula 3.0. The material on this page needs to be reviewed for completeness and accuracy. Overview The OpenNebula Catalog is a new tool that will allow us to import disk images from external storage providers. In addition, this tool will adapt the image so it will benefit from the OpenNebula contextualization. In this first version we have included an Amazon S3 driver, therefore you will be able to import your EC2 amis into OpenNebula.

documentation:archives:rel3.0:cg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide aim is to give pointers to configure all the components available in OpenNebula. It is assumed that the infrastructure is prepared and OpenNebula is correctly installed. Therefore, the following sections cover each specific component of OpenNebula that can be tailored and/or configured to better adjust the OpenNebula installation to the particular needs of your infrastructure and the potential cloud users.

documentation:archives:rel3.0:cli

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula provides a set commands to interact with the system: * oneacl: manages OpenNebula ACLs * onegroup: manages groups of users * onehost: to add, delete and monitor hosts * oneimage: to add, delete and control images * onetemplate: to add, delete and manage Templates

documentation:archives:rel3.0:compatibility

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide is aimed at OpenNebula 2.0 or 2.2 users and administrators who want to upgrade to the latest 3.0 version. The following sections summarize the new features and usage changes that should be taken into account, or prone to cause confusion.

documentation:archives:rel3.0:compile

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page will show you how to compile and install OpenNebula from the sources. If you want to install it from your package manager, visit the software menu to find out if OpenNebula is included in your official distribution package repositories. :!: Do not forget to check the

documentation:archives:rel3.0:cong

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

There are two contextualization mechanisms available in OpenNebula: the automatic IP assignment, and a more generic way to give any file and configuration parameters. You can use any of them individually, or both. Using Virtual Network Leases within a Virtual Machine

documentation:archives:rel3.0:dbschema

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page presents a simplified view of the database schema used by the acct daemon. It includes the tables relevant for third party accounting or statistics software developers. Virtual Machines * TABLE: vms * PRIMARY KEY: id Name SQL Type

documentation:archives:rel3.0:devel-vmm

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The component that deals with the hypervisor to create, manage and get information about virtual machine objects is called Virtual Machine Manager (VMM for short). This component has two parts. The first one resides in the core and holds most of the general functionality common to all the drivers (and some specific), the second is the driver that is the one able to translate basic VMM actions to the hypervisor.

documentation:archives:rel3.0:ebtables

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Network isolation provided through ebtables rules applied on the bridges. This method will only permit isolation with a mask of 255.255.255.0. Requirements This hook requires ebtables to be available in all the OpenNebula Hosts. Considerations & Limitations

documentation:archives:rel3.0:ec2g

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

You should take into account the following technical considerations when using the EC2 cloud with OpenNebula: * There is no direct access to the dom0, so it cannot be monitored (we don't know where the VM is running on the EC2 cloud). * The usual OpenNebula functionality for snapshotting, restoring, or migration is not available with EC2.

documentation:archives:rel3.0:ec2qcg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Overview The OpenNebula EC2 Query is a web service that enables you to launch and manage virtual machines in your OpenNebula installation through the Amazon EC2 Query Interface. In this way, you can use any EC2 Query tool or utility to access your Private Cloud. The EC2 Query web service is implemented upon the

documentation:archives:rel3.0:ec2qcs

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

COMMON_OPTIONS VALUE --help, -h Show help --access-key , -K The name of the user --secret-key , -S The password of the user --url , -U

documentation:archives:rel3.0:ec2qec

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

In order to interact with the EC2 Service that OpenNebula implements you can use the client included in the OpenNebula distribution, but also you can choose one of the well known tools that are supposed to interact with cloud servers through the EC2 Query

documentation:archives:rel3.0:ec2qug

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The EC2 Query API offers the functionality exposed by Amazon EC2: upload images, register them, run, monitor and terminate instances, etc. In short, Query requests are HTTP or HTTPS requests that use the HTTP verb GET or POST and a Query parameter. OpenNebula implements a subset of the EC2 Query interface, enabling the creation of public clouds managed by OpenNebula. In this first release of the

documentation:archives:rel3.0:evmwareg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: To use this functionality you need to install the VMware Driver Addon The VMware Drivers Addon enables the management of an OpenNebula cloud based on VMware ESX and/or VMware Server hypervisors. It uses libvirt to invoke the Virtual Infrastructure SOAP API exposed by the VMware hypervisors, and it entails a much better integration and performance than the java based drivers traditionally found in the OpenNebula distribution.

documentation:archives:rel3.0:external_auth

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula comes by default with an internal user/password authentication and an ACL authorization system, see the Auth Subsystem guide for more information. You can enable the external Authentication and Authorization drivers to strengthen the security of your cloud. Please proceed to the following guides to learn more:

documentation:archives:rel3.0:features

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This section describes the key features and functionality of the last version of OpenNebula (v3.0) for the comprehensive management of virtualized data centers to enable private, public and hybrid (cloudbursting) clouds based on Xen, KVM and VMware. It also includes links to the different parts of the documentation and the web site that provide extended information about each feature.

documentation:archives:rel3.0:firewall

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This hook installs iptables rules in the physical host executing the VM. This hook can be used to filter (and enforce) TCP and UDP ports, and to define a policy for ICMP connections, without any additional modification to the guest VMs. Requirements

documentation:archives:rel3.0:ftguide

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide's objective is to provide information in order to prepare for failures and/or recover from them. This failures are categorized depending on whether they come from the physical infrastructure (Host failures), from the virtualized infrastructure (VM crashes) or from the virtual infrastructure manager (OpenNebula crash).

documentation:archives:rel3.0:ganglia

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

If you already have ganglia deployed in your cluster you can use the ganglia drivers provided by OpenNebula to get information about hosts and virtual machines from it. These drivers should make the monitoring more performant in a big installation as they don't use ssh connections to the nodes to get the information. On the other side they require more work on the system administrator as ganglia should be properly configured and cron jobs must be installed on the nodes to provide virtual machine…

documentation:archives:rel3.0:glossary

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula components: * Front-end: Machine running the OpenNebula services. * Host: Physical machine running a supported hypervisor. See the Host subsystem. * Image Repository: Storage for registered Images. Learn more about the Storage subsystem. * Sunstone: OpenNebula web interface. Learn more about

documentation:archives:rel3.0:hm-vlan

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Network isolation provided through host-managed VLANs. This hook will create a bridge for each OpenNebula Virtual Network and attach an VLAN tagged network interface to the bridge. This mechanism is compliant with IEEE 802.1Q. The VLAN id will be the same for every interface in a given network, calculated by adding a constant to the network id. It may also be forced by specifying an VLAN_ID parameter in the network template.

documentation:archives:rel3.0:hooks

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Hook Manager present in OpenNebula enables the triggering of custom scripts tied to a change in state in a particular resource, being that a Host or a Virtual Machine. This opens a wide area of automation for system administrators to tailor their cloud infrastructures.

documentation:archives:rel3.0:hostsubsystem

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

What is a Host A Host is a server that has the ability to run Virtual Machines and that is connected to OpenNebula's Frontend server. OpenNebula can work with Hosts with a heterogeneous configuration, i.e. you can connect Hosts to the same OpenNebula with different hypervisors or Linux distributions as long as these requirements are fulfilled:

documentation:archives:rel3.0:host_guide

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

In order to use your existing physical nodes, you have to add them to the system as OpenNebula hosts. You need the following information: * Hostname of the host or IP * Information Driver to be used to monitor the host, e.g. im_kvm. These should match the Virtualization Drivers installed and more info about them can be found at the

documentation:archives:rel3.0:ignc

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page will show you how to install OpenNebula from the binary packages. Please read the Planning the Installation guide before you proceed. Package Installation (Front-End) Visit the software menu to download the latest package for your distribution. OpenNebula may be included in your official distribution package repositories, but you should check if it is the latest version and download it from our page instead.

documentation:archives:rel3.0:image_repo

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The image repository is the on in charge to store and manage registered images. You can get more information on its usage from a user perspective in the Managing Virtual Machine Images guide. The way the image repository accomplishes these tasks is through a driver that knows how to perform these actions:

documentation:archives:rel3.0:img

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Information Manager (IM) is in charge of monitoring the hosts. It comes with various sensors, each one responsible of a different aspects of the computer to be monitored (CPU, memory, hostname...). Also, there are sensors prepared to gather information from different hypervisors (currently KVM and XEN).

documentation:archives:rel3.0:img_guide

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Image Repository system allows OpenNebula administrators and users to set up images, which can be operative systems or data, to be used in Virtual Machines easily. These images can be used by several Virtual Machines simultaneously, and also shared with other users.

documentation:archives:rel3.0:img_mad

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Image Manager Driver is quite similar to the Transfer Manager Driver. This Manager Driver is responsible for the file management needed to create new Images. Image Manager Driver Configuration Only one Image Manager Driver can be configured in oned.conf. The default configuration is as follows:

documentation:archives:rel3.0:img_template

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page describes how to define a new image template. An image template follows the same syntax as the VM template. If you want to learn more about the image repository, you can do so here. Template Attributes The following attributes can be defined in the template.

documentation:archives:rel3.0:intro

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula is the open-source industry standard for data center virtualization, offering the most feature-rich, flexible solution for the comprehensive, complete management of virtualized data centers to enable on-premise IaaS clouds in existing infrastructures. OpenNebula interoperability makes cloud an evolution by leveraging existing IT assets, protecting your investments, and avoiding vendor lock-in.

documentation:archives:rel3.0:introapis

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula has been designed to be easily adapted to any infrastructure and easily extended with new components. The result is a modular system that can implement a variety of Cloud architectures and can interface with multiple datacenter services. In this document we will review the main interfaces of OpenNebula (see figure 1 for an overview), their use and give pointers to additional documentation for each one. We have classified the interfaces in two categories: end-user cloud and system in…

documentation:archives:rel3.0:introc

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

What is a Public Cloud? A Public Cloud is an extension of a Private Cloud to expose RESTful Cloud interfaces. Cloud interfaces can be added to your Private or Hybrid Cloud if you want to provide partners or external users with access to your infrastructure, or to sell your overcapacity. Obviously, a local cloud solution is the natural back-end for any public cloud.

documentation:archives:rel3.0:introh

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

What is a Hybrid Cloud? A Hybrid Cloud is an extension of a Private Cloud to combine local resources with resources from remote Cloud providers. The remote provider could be a commercial Cloud service, such as Amazon EC2, or a partner infrastructure running a different OpenNebula instance. Such support for cloudbursting enables highly scalable hosting environments.

documentation:archives:rel3.0:intropr

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The aim of a Private Cloud is not to expose to the world a cloud interface to sell capacity over the Internet, but to provide local cloud users and administrators with a flexible and agile private infrastructure to run virtualized service workloads within the administrative domain

documentation:archives:rel3.0:java

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page contains the OpenNebula Cloud API Specification for Java. It has been designed as a wrapper for the XML-RPC methods, with some basic helpers. This means that you should be familiar with the XML-RPC API and the XML formats returned by the OpenNebula core. As stated in the

documentation:archives:rel3.0:known_issues

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The following bugs or issues have been identified in the current 3.0 version, and will be solved in future releases. x509 Certificates Limitations The x509 authentication fails if the certificates contain certain characters, like the colon (:), or accented letters (e.g. á, ö).

documentation:archives:rel3.0:kvmg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

KVM (Kernel-based Virtual Machine) is a complete virtualization technique for Linux. It offers full virtualization, where each Virtual Machine interacts with its own virtualized hardware. This guide describes the use of the KVM virtualizer with OpenNebula, please refer to KVM specific documentation for further information on the setup of the KVM hypervisor itself.

documentation:archives:rel3.0:ldap

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: To use this functionality you need to install the LDAP Authentication Addon The LDAP Authentication addon permits users to have the same credentials as in LDAP, so effectively centralizing authentication. Enabling it will let any correctly authenticated LDAP user to use OpenNebula.

documentation:archives:rel3.0:log_debug

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula keeps separate log files for each active component, all of them stored in /var/log/one. To help users and administrators find and solve problems, they can also access some of the error messages from the CLI or the Sunstone GUI. Log Files There are different log files corresponding to different OpenNebula components:

documentation:archives:rel3.0:lvm

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The LVM TM driver is an alternative to tm_shared and tm_ssh driver. It features instantaneous image deployment through LVM snapshots. Requirements LVM must be available in the Hosts. The oneadmin user should be able to execute several LVM related commands with sudo passwordlessly.

documentation:archives:rel3.0:manage_acl

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The ACL authorization system enables fine-tuning of the allowed operations for any user, or group of users. Each operation generates an authorization request that is checked against the registered set of ACL rules. The core then can grant permission, or reject the request.

documentation:archives:rel3.0:manage_users

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula supports user accounts and groups. This guide shows how to manage both. After the installation, the administrative user oneadmin and two default groups should be created. You can check it using the oneuser list and onegroup list commands.

documentation:archives:rel3.0:mysql

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The MySQL backend was introduced in OpenNebula 2.0 as an alternative to the Sqlite backend available in previous releases. Either of them can be used seamlessly to the upper layers and ecosystem tools. These high level components do not need to be modified or configured.

documentation:archives:rel3.0:nm

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

How does Networking work in OpenNebula When a new Virtual Machine is launched, OpenNebula will connect its network interfaces (defined in the NIC section of the template) to the bridge specified in the Virtual Network definition. This will allow the VMto have acess to different networks public or private.

documentation:archives:rel3.0:nsfs

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula can work without a shared FS. In this scenario, the front-end has access to the Image Repository and when a VM is deployed OpenNebula copies the Image files to the , residing in the host local filesystem. Requirements The only requirement for this setup should be already in place if you followed the

documentation:archives:rel3.0:occicg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The OpenNebula OCCI (Open Cloud Computing Interface) server is a web service that enables you to launch and manage virtual machines in your OpenNebula installation using an implementation of the OGF OCCI API specification based on the draft 0.8. This implementation also includes some extensions, requested by the community, to support OpenNebula specific functionality. The OpenNebula OCCI service is implemented upon the

documentation:archives:rel3.0:occidd

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Resources The OpenNebula OCCI API is a RESTful service to create, control and monitor cloud resources using an implementation of the OGF OCCI API specification based on the draft 0.8. This implementation also includes some extensions, requested by the community, to support OpenNebula specific functionality. There are two types of resources that resemble the basic entities managed by the OpenNebula system, namely:

documentation:archives:rel3.0:occiug

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The OpenNebula OCCI API is a RESTful service to create, control and monitor cloud resources using an implementation of the OGF OCCI API specification based on the draft 0.8. This implementation also includes some extensions, requested by the community, to support OpenNebula specific functionality. Interactions with the resources are done through HTTP verbs (

documentation:archives:rel3.0:onecast

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: Development version of OpenNebula 3.0. The material on this page needs to be reviewed for completeness and accuracy. :!: To use this functionality you need to install the onecast Addon onecast is a tool that can rewrite parts of a VM description substituting the variables it contains by some values that the user provides. It also gets values from the environment if the values are not explicitly provided by the user and can also have a default value so they will be translated to somethin…

documentation:archives:rel3.0:onedb

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

:!: Development version of OpenNebula 3.0. The material on this page needs to be reviewed for completeness and accuracy. The command onedb allows the OpenNebula administrator to manage the SQLite or MySQL database, mainly to perform backups and upgrade the database when OpenNebula is updated to a new version.

documentation:archives:rel3.0:oned_conf

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The OpenNebula daemon oned manages the cluster nodes, virtual networks, virtual machines, users, groups and image repository. The configuration file for the daemon is called oned.conf and it is placed inside the /etc/one directory. In this reference document we describe all the format and options that can be specified in

documentation:archives:rel3.0:openvswitch

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Network isolation provided through Open vSwitch. Each Virtual Network interface will receive an VLAN tag enabling network isolation. Other traffic attributes that may be configured through Open vSwitch are not modified. The VLAN id will be the same for every interface in a given network, calculated by adding a constant to the network id. It may also be forced by specifying an VLAN_ID parameter in the network template.

documentation:archives:rel3.0:ozones

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The OpenNebula Zones (oZones) component allows for the centralized management of multiple instances of OpenNebula (zones), managing in turn potentially different administrative domains. The module is run by the oZones administrator, with capacity to grant access to the different zones to particular users.

documentation:archives:rel3.0:ozonescfg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide intends to give a walk through the steps needed to correctly configure the oZones Server to start managing Zones and VDCs. Also, it provides steps to configure a reverse proxy based on the Apache web server to hide the VDC details from end users.

documentation:archives:rel3.0:plan

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide provides a high-level overview of an OpenNebula installation, so you can easily architect your deployment and understand the technologies involved in the management of virtualized resources and their relationship. OpenNebula assumes that your physical infrastructure adopts a classical cluster-like architecture with a front-end, and a set of hosts where Virtual Machines (VM) will be executed. There is at least one physical network joining all the hosts with the front-end.

documentation:archives:rel3.0:quota_auth

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide will show you how to enable and use the Quota authorization. When quota module is enabled it checks for user resource consumption before letting a Virtual Machine or Image to be created in the OpenNebula system. Requirements You don't need to install any additional software.

documentation:archives:rel3.0:ruby

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page contains the OpenNebula Cloud API Specification for Ruby. It has been designed as a wrapper for the XML-RPC methods, with some basic helpers. This means that you should be familiar with the XML-RPC API and the XML formats returned by the OpenNebula core. As stated in the

documentation:archives:rel3.0:schg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Scheduler module is in charge of the assignment between pending Virtual Machines and known Hosts. OpenNebula's architecture defines this module as a separate process that can be started independently of oned. The OpenNebula scheduling framework is designed in a generic way, so it is highly modifiable and can be easily replaced by third-party developments.

documentation:archives:rel3.0:sd

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Transfer Manager (TM) architecture is highly modular. There are high level actions that OpenNebula asks the TM to perform, which in turn the TM translates into different tasks depending on the storage model specific configuration. Current release of OpenNebula comes with two different set of action scripts that conforms two different TMs for different storage models (see

documentation:archives:rel3.0:sfs

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The shared storage model requires the front-end and hosts to share the VM directories (in VM_DIR) and the Image Repository. Both locations have to be mounted in the same points in the front-end and hosts. Typically these storage areas are shared using a distributed FS like NFS, GlusterFS, Lustre, etc. In this guide we'll configure NFS, but you can use any other alternatives.

documentation:archives:rel3.0:sm

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The OpenNebula daemon information is stored in the database, but you also need to configure some storage for the Image and Virtual Machine files. All Image and Virtual Machine management files are stored in /var/lib/one. Virtual Machine Files Management

documentation:archives:rel3.0:ssh_auth

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide will show you how to enable and use the SSH authentication for the OpenNebula CLI. Using this authentication method, users login to OpenNebula with a token encrypted with their private ssh keys. Requirements You don't need to install any additional software.

documentation:archives:rel3.0:statistics_api

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page contains the OpenNebula Statistics API implementation for Ruby. It has been designed for retrieving utilization information of the Cloud. This version of the API supports Virtual Machine and Host statistics. Retrieving Resource Information

documentation:archives:rel3.0:sunstone

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

OpenNebula Sunstone is the OpenNebula Cloud Operations Center, a Graphical User Interface (GUI) intended for regular users and administrators that simplifies the typical management operations in private and hybrid cloud infrastructures. OpenNebula Sunstone allows to easily manage all OpenNebula resources and perform typical operations on them.

documentation:archives:rel3.0:sunstone_dummy_plugin

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Sunstone Dummy Plugin is a simple plugin to illustrate the pluging creation process explained in Sunstone Plugin Guide and to test some of the Sunstone features which are not used by the standard plugins. In order to use it just save the following code in the public/js/plugins/

documentation:archives:rel3.0:sunstone_plugin_guide

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Sunstone client-side has a plugin-oriented structure that allows users to select which features are active and to develop their own extensions and easily include them in the web interface. Plugins can use the Sunstone interface to run and modify common OpenNebula actions, show custom information panels and offer extended capabilities for Sunstone.

documentation:archives:rel3.0:sunstone_plugin_reference

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This document is intended to provide a detailed description for sunstone.js configuration objects and methods regarding the creation and use of plugins. For information on how to write a plugin for Sunstone please read the Sunstone Plugin Guide :!: Sunstone plugins are part of the client-side of Sunstone. Therefore, they are written in Javascript and allow customization and extension of the user interface, which is fully on the client-side.

documentation:archives:rel3.0:template

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

A template file consists of a set of attributes that defines a Virtual Machine. Using the command onetemplate create, a template can be registered in OpenNebula to be later instantiated. For compatibility with previous versions, you can also create a new Virtual Machine directly from a template file, using the

documentation:archives:rel3.0:template_simple

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This is the simplified version of the complete definition file reference. In this guide, only the basic attributes and functionality are described. A template file consists of a set of attributes that defines a Virtual Machine. Using the command onetemplate create, a template can be registered in OpenNebula to be later instantiated.

documentation:archives:rel3.0:upgrade

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide describes the installation procedure for systems that are already running a 2.0 or 2.2 OpenNebula. The upgrade will preserve all current users, hosts, resources and configurations; for both Sqlite and MySQL backends. Read the Compatibility Guide and Relase Notes to know what is new in OpenNebula 3.0 .

documentation:archives:rel3.0:vdcmngt

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

Virtual Data Centers (VDCs) are fully-isolated virtual infrastructure environments where a group of users, under the control of the VDC administrator, can create and manage compute, storage and networking capacity. The VDC administrator can create new users inside the VDC. Both VDC admins and users access the zone through a reverse proxy, so they don't need to know the endpoint of the zone, but rather the address of the oZones module and the VDC where they belong to.

documentation:archives:rel3.0:vgg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

A host is connected to one or more networks that are available to the virtual machines through the corresponding bridges. OpenNebula allows the creation of Virtual Networks by mapping them on top of the physical ones Overview In this guide you'll learn how to define and use virtual networks. For the sake of simplicity the following examples assume that the hosts are attached to two

documentation:archives:rel3.0:vmg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The purpose of this section is to demonstrate how to quickly deploy a VM with OpenNebula in a few easy steps. We will assume that you have properly configured OpenNebula and that you have at least one worker node running KVM (this guide does not work with Xen for the moment).

documentation:archives:rel3.0:vmmg

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The Virtualization Subsystem is the component in charge of talking with the hypervisor installed in the hosts and taking the actions needed for each step in the VM lifecycle. Configuration options and specific information for each hypervisor can be found in these guides:

documentation:archives:rel3.0:vm_guide

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

In OpenNebula the Virtual Machines are defined with Template definition files. This guide explains how to describe the wanted-to-be-ran Virtual Machine, and how users typically interact with the system. The Template Repository system allows OpenNebula administrators and users to register Virtual Machine definitions in the system, to be instantiated later as Virtual Machine instances. These Templates can be instantiated several times, and also shared with other users.

documentation:archives:rel3.0:vm_guide_2

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide follows the Creating Virtual Machines guide. Once a Template is instantiated to a Virtual Machine, there are a number of operations that can be performed using the onevm command. Sunstone You can manage your virtual machines using the onevm command or Sunstone. In Sunstone, you can easily instantiate currently defined

documentation:archives:rel3.0:vnet_template

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This page describes how to define a new Virtual Network template. A Virtual Network template follows the same syntax as the VM template. If you want to learn more about the Virtual Network management, you can do so here. Common Attributes There are two types of Virtual Networks, ranged and fixed. Their only difference is how the leases are defined in the template.

documentation:archives:rel3.0:x509_auth

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

This guide will show you how to enable and use the x509 certificates authentication with OpenNebula. The x509 certificates can be used in two different ways in OpenNebula. The first option that is explained in this guide enables us to use certificates with the CLI. In this case the user will generate a login token with his private key, OpenNebula will validate the certificate and decrypt the token to authenticate the user.

documentation:archives:rel3.0:xeng

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

The XEN hypervisor offers a powerful, efficient and secure feature set for virtualization of x86, IA64, PowerPC and other CPU architectures. It delivers both paravirtualization and full virtualization. This guide describes the use of Xen with OpenNebula, please refer to the Xen specific documentation for further information on the setup of the Xen hypervisor itself.

documentation:archives:rel3.0:zonesmngt

Anonymous (anonymous@undisclosed.example.com) — 2014-01-07T11:47:53+00:00

A Zone is essentially a group of interconnected physical hosts with hypervisors controlled by OpenNebula. A Zone can be added to the oZones server, providing valid oneadmin credentials, so it can contribute to the list of aggregated resources presented by the oZones component. A Zone can be further