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:
Enterprise Edition - enterprise users facing hardened builds,
Community Edition - free public builds.
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.
AlmaLinux/RHEL¶
In rhel9 and AlmaLinux9 Some dependencies cannot be found in the default repositories. Some extra repositories need to be enabled. To do this, execute the following as the root user:
repo=$(yum repolist --disabled | grep -i -e powertools -e crb | awk '{print $1}' | head -1)
yum config-manager --set-enabled $repo && yum makecache
To add the OpenNebula enterprise repository, execute the following as user root:
RHEL 8, 9
cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Enterprise Edition
baseurl=https://<token>@enterprise.opennebula.io/repo/6.10/RedHat/$releasever/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo2.key
gpgcheck=1
repo_gpgcheck=1
EOT
yum makecache
AlmaLinux 8, 9
cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Enterprise Edition
baseurl=https://<token>@enterprise.opennebula.io/repo/6.10/AlmaLinux/$releasever/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo2.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:
Note
It might be needed to create /etc/apt/keyrings directory in Debian 11 because it does not exist by default:
mkdir -p /etc/apt/keyrings
wget -q -O- https://downloads.opennebula.io/repo/repo2.key | gpg --dearmor --yes --output /etc/apt/keyrings/opennebula.gpg
and then continue with repository configuration:
Debian 11
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://<token>@enterprise.opennebula.io/repo/6.10/Debian/11 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Debian 12
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://<token>@enterprise.opennebula.io/repo/6.10/Debian/12 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Ubuntu 22.04
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://<token>@enterprise.opennebula.io/repo/6.10/Ubuntu/22.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Ubuntu 24.04
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://<token>@enterprise.opennebula.io/repo/6.10/Ubuntu/24.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Note
You can point to a specific 6.6.x version by changing the occurrence of shorter version 6.6 in any of the above commands to the particular full 3 components version number (X.Y.Z). For instance, to point to version 6.6.1 on Ubuntu 22.04, use the following command instead:
echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://<token>@enterprise.opennebula.io/repo/6.6.1/Ubuntu/22.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list apt-get update
In Debian and Ubuntu it’s 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:
AlmaLinux/RHEL¶
In rhel9 and AlmaLinux9 Some dependencies cannot be found in the default repositories. Some extra repositories need to be enabled. To do this, execute the following as the root user:
repo=$(yum repolist --disabled | grep -i -e powertools -e crb | awk '{print $1}' | head -1)
yum config-manager --set-enabled $repo && yum makecache
To add OpenNebula repository, execute the following as user root:
RHEL 8, 9
# cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.10/RedHat/$releasever/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo2.key
gpgcheck=1
repo_gpgcheck=1
EOT
# yum makecache
AlmaLinux 8, 9
# cat << "EOT" > /etc/yum.repos.d/opennebula.repo
[opennebula]
name=OpenNebula Community Edition
baseurl=https://downloads.opennebula.io/repo/6.10/AlmaLinux/$releasever/$basearch
enabled=1
gpgkey=https://downloads.opennebula.io/repo/repo2.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/repo2.key | gpg --dearmor --yes --output /etc/apt/keyrings/opennebula.gpg
Debian 11
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://downloads.opennebula.io/repo/6.10/Debian/11 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Debian 12
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://downloads.opennebula.io/repo/6.10/Debian/12 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Ubuntu 22.04
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://downloads.opennebula.io/repo/6.10/Ubuntu/22.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update
Ubuntu 24.04
# echo "deb [signed-by=/etc/apt/keyrings/opennebula.gpg] https://downloads.opennebula.io/repo/6.10/Ubuntu/24.04 stable opennebula" > /etc/apt/sources.list.d/opennebula.list
# apt-get update