OpenNebula tools

From MetaCentrum
Jump to navigation Jump to search

Description

OpenNebula tools (also known as onetools, opennebula-tools or OpenNebula CLI) is a set of command-line utilities that can be used to communicate with OpenNebula server from command line.

Use

OpenNebula tools are currently available in the version that is the same as the version of OpenNebula server which runs MetaCentrum Cloud.

Initialize environment using

Upcoming modulesystem change alert!

Due to large number of applications and their versions it is not practical to keep them explicitly listed at our wiki pages. Therefore an upgrade of modulefiles is underway. A feature of this upgrade will be the existence of default module for every application. This default choice does not need version number and it will load some (usually latest) version.

You can test the new version now by adding a line

source /cvmfs/software.metacentrum.cz/modulefiles/5.1.0/loadmodules

to your script before loading a module. Then, you can list all versions of opennebula and load default version of opennebula as

module avail opennebula/ # list available modules
module load opennebula   # load (default) module


If you wish to keep up to the current system, it is still possible. Simply list all modules by

module avail opennebula

and choose explicit version you want to use.

and now you can authenticate to the MetaCentrum Cloud's OpenNebula server using command

oneuser login -v YourLogin --x509 --cert YourCert.pem --key YourKey.pem --force

where YourCert.pem is your public certificate and YourKey.pem is your private key. Both can be extracted from your cert.p12 certificate (which must be registered in Kategorie:Perun) using commands

openssl pkcs12 -in cert.p12 -out YourCert.pem -clcerts -nokeys 
openssl pkcs12 -in cert.p12 -out YourKey.pem -nocerts -nodes

By default, environment variable ONE_HOST and ONE_XMLRPC are set as follows:

export ONE_HOST=https://cloud.metacentrum.cz
export ONE_XMLRPC=https://cloud.metacentrum.cz:6443/RPC2

but you can change them to any other value if you for some reason want to use OpenNebula tools to communicate with a different OpenNebula server.

OpenNebula tools consist of following utilities:

oneacct
oneacl
onecluster
onedatastore
oneflow
oneflow-template
onegroup
onehost
oneimage
onemarket
onesecgroup
oneshowback
onetemplate
oneuser
onevdc
onevm
onevnet
onezone

Documentation

https://docs.opennebula.org/4.14/user/references/cli.html

Homepage

https://opennebula.org/