OpenNebula Repositories

Before we can proceed with installation, we have to configure the packaging tools on your Front-end host to include OpenNebula repositories. OpenNebula software is provided via two distinct distribution channels depending on the build type you are going to install:

Follow the steps below based on your OpenNebula edition and Front-end operating system.

Enterprise Edition

OpenNebula Systems provides an OpenNebula Enterprise Edition to customers with an active support subscription. To distribute the packages of the Enterprise Edition there is a private enterprise repository accessible only to those customers that contains all packages (including major, minor, and maintenance releases). You only need to change your repository configuration on Front-end once per major release and you’ll be able to get every package in that series. Private repositories contain all OpenNebula released packages.

Important

You should have received the customer access token (username and password) to access these repositories. You have to substitute the appearance of <token> with your customer specific token in all instructions below.

CentOS/RHEL

To add the OpenNebula enterprise repository, execute the following as user root:

CentOS/RHEL 7

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Enterprise Edition
baseurl=https://<token>@enterprise.opennebula.io/repo/6.0/CentOS/7/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache fast

CentOS/RHEL 8

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Enterprise Edition
baseurl=https://<token>@enterprise.opennebula.io/repo/6.0/CentOS/8/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache

Debian/Ubuntu

Note

If the commands below fail, ensure you have gnupg, wget and apt-transport-https packages installed and retry. E.g.,

apt-get update
apt-get -y install gnupg wget apt-transport-https

First, add the repository signing GPG key on the Front-end by executing as user root:

wget -q -O- https://downloads.opennebula.io/repo/repo.key | apt-key add -

and then continue with repository configuration:

Debian 9

echo "deb https://<token>@enterprise.opennebula.io/repo/6.0/Debian/9 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Debian 10

echo "deb https://<token>@enterprise.opennebula.io/repo/6.0/Debian/10 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 18.04

echo "deb https://<token>@enterprise.opennebula.io/repo/6.0/Ubuntu/18.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 20.04

echo "deb https://<token>@enterprise.opennebula.io/repo/6.0/Ubuntu/20.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 20.10

echo "deb https://<token>@enterprise.opennebula.io/repo/6.0/Ubuntu/20.10 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Note

You can point to a specific 6.0.x version by changing the occurrence of shorter version 6.0 in any of the above commands to the particular full 3 components version number (X.Y.Z). For instance, to point to version 6.0.1 on Ubuntu 18.04, use the following command instead:

echo "deb https://<token>@enterprise.opennebula.io/repo/5./Ubuntu/18.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Following Debian 10 and Ubuntu 16.04, it’s now possible (and recommended) to store a customer token in a separate file to the repository configuration. If you choose to store the repository credentials separately, you need to avoid using the <token>@ part in the repository definitions above. You should create a new file /etc/apt/auth.conf.d/opennebula.conf with the following structure and replace the <user> and <password> parts with the customer credentials you have received:

machine enterprise.opennebula.io
login <user>
password <password>

Community Edition

The community edition of OpenNebula offers the full functionality of the Cloud Management Platform. You can configure the community repositories as follows:

CentOS/RHEL/Fedora

To add OpenNebula repository, execute the following as user root:

CentOS/RHEL 7

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.0/CentOS/7/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache fast

CentOS/RHEL 8

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.0/CentOS/8/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache

Fedora 32

Important

This is a Secondary Platform not recommended for production environments!

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.0/Fedora/32/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache

Fedora 33

Important

This is a Secondary Platform not recommended for production environments!

cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.0/Fedora/33/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache

Debian/Ubuntu

Note

If the commands below fail, ensure you have gnupg, wget and apt-transport-https packages installed and retry. E.g.,

apt-get update
apt-get -y install gnupg wget apt-transport-https

First, add the repository signing GPG key on the Front-end by executing as user root:

wget -q -O- https://downloads.opennebula.io/repo/repo.key | apt-key add -

Debian 9

echo "deb https://downloads.opennebula.io/repo/6.0/Debian/9 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Debian 10

echo "deb https://downloads.opennebula.io/repo/6.0/Debian/10 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 18.04

echo "deb https://downloads.opennebula.io/repo/6.0/Ubuntu/18.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 20.04

echo "deb https://downloads.opennebula.io/repo/6.0/Ubuntu/20.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update

Ubuntu 20.10

echo "deb https://downloads.opennebula.io/repo/6.0/Ubuntu/20.10 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
apt-get update