2009-07-01 14:27:24 +00:00
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" >
<!--
This file is autogenerated from drvone.html.in
Do not edit this file. Changes will be lost.
-->
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" / >
< link rel = "stylesheet" type = "text/css" href = "main.css" / >
< link rel = "SHORTCUT ICON" href = "32favicon.png" / >
< title > libvirt: OpenNebula Virtual Infrastructure Manager driver< / title >
< meta name = "description" content = "libvirt, virtualization, virtualization API" / >
< / head >
< body >
< div id = "header" >
< div id = "headerLogo" > < / div >
< div id = "headerSearch" >
< form action = "search.php" enctype = "application/x-www-form-urlencoded" method = "get" > < div >
< input id = "query" name = "query" type = "text" size = "12" value = "" / >
< input id = "submit" name = "submit" type = "submit" value = "Search" / >
< / div > < / form >
< / div >
< / div >
< div id = "body" >
< div id = "menu" >
< ul class = "l0" > < li >
< div >
< a title = "Front page of the libvirt website" class = "inactive" href = "index.html" > Home< / a >
< / div >
< / li > < li >
< div >
< a title = "Details of new features and bugs fixed in each release" class = "inactive" href = "news.html" > News< / a >
< / div >
< / li > < li >
< div >
< a title = "Get the latest source releases, binary builds and get access to the source repository" class = "inactive" href = "downloads.html" > Downloads< / a >
< / div >
< / li > < li >
< div >
< a title = "Information for users, administrators and developers" class = "active" href = "docs.html" > Documentation< / a >
< ul class = "l1" > < li >
< div >
< a title = "Information about deploying and using libvirt" class = "inactive" href = "deployment.html" > Deployment< / a >
< / div >
< / li > < li >
< div >
< a title = "Overview of the logical subsystems in the libvirt API" class = "inactive" href = "intro.html" > Architecture< / a >
< / div >
< / li > < li >
< div >
< a title = "Description of the XML formats used in libvirt" class = "inactive" href = "format.html" > XML format< / a >
< / div >
< / li > < li >
< div >
< a title = "Hypervisor specific driver information" class = "active" href = "drivers.html" > Drivers< / a >
< ul class = "l2" > < li >
< div >
< a title = "Driver the Xen hypervisor" class = "inactive" href = "drvxen.html" > Xen< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for QEMU, KQEMU, KVM and Xenner" class = "inactive" href = "drvqemu.html" > QEMU / KVM< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for the Linux native container API" class = "inactive" href = "drvlxc.html" > Linux Container< / a >
< / div >
< / li > < li >
< div >
< a title = "Psuedo-driver simulating APIs in memory for test suites" class = "inactive" href = "drvtest.html" > Test< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver providing secure remote to the libvirt APIs" class = "inactive" href = "drvremote.html" > Remote< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for the OpenVZ container technology" class = "inactive" href = "drvopenvz.html" > OpenVZ< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for the User Mode Linux technology" class = "inactive" href = "drvuml.html" > UML< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for the storage management APIs" class = "inactive" href = "storage.html" > Storage< / a >
< / div >
< / li > < li >
< div >
< a title = "Driver for VirtualBox" class = "inactive" href = "drvvbox.html" > VirtualBox< / a >
< / div >
< / li > < li >
< div >
< span class = "active" > OpenNebula< / span >
< / div >
< / li > < / ul >
< / div >
< / li > < li >
< div >
< a title = "Reference manual for the C public API" class = "inactive" href = "html/index.html" > API reference< / a >
< / div >
< / li > < li >
< div >
< a title = "Bindings of the libvirt API for other languages" class = "inactive" href = "bindings.html" > Language bindings< / a >
< / div >
< / li > < li >
< div >
< a title = "Working on the internals of libvirt API, driver and daemon code" class = "inactive" href = "internals.html" > Internals< / a >
< / div >
< / li > < / ul >
< / div >
< / li > < li >
< div >
< a title = "User contributed content" class = "inactive" href = "http://wiki.libvirt.org" > Wiki< / a >
< / div >
< / li > < li >
< div >
< a title = "Frequently asked questions" class = "inactive" href = "FAQ.html" > FAQ< / a >
< / div >
< / li > < li >
< div >
< a title = "How and where to report bugs and request features" class = "inactive" href = "bugs.html" > Bug reports< / a >
< / div >
< / li > < li >
< div >
< a title = "How to contact the developers via email and IRC" class = "inactive" href = "contact.html" > Contact< / a >
< / div >
< / li > < li >
< div >
< a title = "Miscellaneous links of interest related to libvirt" class = "inactive" href = "relatedlinks.html" > Related Links< / a >
< / div >
< / li > < li >
< div >
< a title = "Overview of all content on the website" class = "inactive" href = "sitemap.html" > Sitemap< / a >
< / div >
< / li > < / ul >
< / div >
< div id = "content" >
< h1 > OpenNebula Virtual Infrastructure Manager driver< / h1 >
< p > < a name = "toc" id = "toc" > < / a > < a href = "http://opennebula.org/" > OpenNebula< / a >
2009-07-01 21:24:47 +00:00
is a Virtual Infrastructure Manager that controls Virtual Machines (VM) in a pool of distributed resources
by orchestrating network, storage and virtualization technologies. The OpenNebula driver lets you manage your private or hybrid (< a href = "http://aws.amazon.com/ec2/" > Amazon EC2< / a > or < a href = "http://www.elastichosts.com/" > Elastic Hosts< / a > based) cloud using a standard libvirt interface, including the API as well as the related
2009-07-01 14:27:24 +00:00
tools and VM description files.< / p >
< h2 >
< a name = "prereq" id = "prereq" > < / a > Deployment pre-requisites< / h2 >
< ul > < li >
< p style = "margin-bottom: 0in" > A working OpenNebula installation,
2009-07-01 21:24:47 +00:00
version 1.2 or higher.
2009-07-01 14:27:24 +00:00
< / p >
2009-07-01 21:24:47 +00:00
< / li > < / ul >
2009-07-01 14:27:24 +00:00
< h2 >
< a name = "uris" id = "uris" > < / a > Connections to OpenNebula driver< / h2 >
< p > The Uri of the driver protocol is "one". Some example
2009-07-01 21:24:47 +00:00
connection Uris for the driver are:
2009-07-01 14:27:24 +00:00
< / p >
< pre > one:/// (local access)
one+unix:/// (local access)
one://example.com/ (remote access)
one+tcp://example.com/ (remote access, SASl/Kerberos)
one+ssh://user@example.com/ (remote access, SSH tunnelled)
< / pre >
< h2 >
< a name = "xmlconfig" id = "xmlconfig" > < / a > Example domain XML config< / h2 >
< p > There are some limitations on the XML attributes that may be
specified when interfacing OpenNebula. The following xml example
details the attributes and options supported by the OpenNebula
2009-07-01 21:24:47 +00:00
driver:< / p >
2009-07-01 14:27:24 +00:00
< h3 > Paravirtualized guest direct kernel boot
< / h3 >
< pre > < domain type='one'>
< name> vm01< /name>
< memory> 32768< /memory>
< vcpu> 1< /vcpu>
< os>
< type> linux< /type>
< kernel> /boot/vmlinuz-2.6.24-17-xen< /kernel>
< initrd> /boot/initrd.img-2.6.24-17-xen< /initrd>
< cmdline> < /cmdline>
< root> sda1< /root>
< /os>
< devices>
< disk type='file' device='disk'>
< source file='/images/sgehosts/01/disk.img'/>
< target dev='sda1'/>
< /disk>
< disk type='file' device='disk'>
< source file='/images/sgehosts/01/swap.img'/>
< target dev='sda2'/>
< /disk>
< disk type='file' device='cdrom'>
< source file='/images/iso/cdrom.iso'/>
< target dev='hdc'/>
< readonly/>
< /disk>
< !--BRIDGE-->
< interface type='bridge'>
< source bridge='eth0'/>
< mac address='00:16:3e:5d:c7:9e'/>
< /interface>
< !--ONE Network-->
< interface type='network'>
< source network='onenetwork'/>
< /interface>
< /devices>
< /domain>
< / pre >
< p >
< b > Note:< / b > The "< interface type='network'> " will
attach the interface to a previously configured network (named
2009-07-01 21:24:47 +00:00
< tt > onenetwork< / tt > ) within the < a href = "http://opennebula.org/" > OpenNebula< / a > system, typically with the
2009-07-01 14:27:24 +00:00
< tt > onevnet< / tt > CLI command.< / p >
2009-07-01 21:24:47 +00:00
< p > < b > Note< / b > : OpenNebula supports the simultaneous use of different hypervisors, so you can specify any os type (linux or hvm) supported by your cluster.
< / p >
< h2 > Links< / h2 >
< ul > < li > < a href = "http://www.opennebula.org/doku.php?id=documentation" > OpenNebula Documentation< / a >
< / li > < li > < a href = "http://www.opennebula.org/doku.php?id=documentation:rel1.2:ug" > OpenNebula User Guide< / a >
< / li > < / ul >
2009-07-01 14:27:24 +00:00
< / div >
< / div >
< div id = "footer" >
< p id = "sponsor" >
Sponsored by:< br / > < a href = "http://et.redhat.com/" > < img src = "et.png" alt = "Project sponsored by Red Hat Emerging Technology" / > < / a > < / p >
< / div >
< / body >
< / html >