Client Tutorial

1. Overview

This APT repository hosts custom OpenNebula packages built by the Innovation Team. Each project (branch) is a separate component in the repo. You pick the project you need, and APT handles the rest.

The repository supports multiple Ubuntu versions. APT automatically selects the correct packages for your Ubuntu version.

2. Client Setup (Install Packages)

On the machine where you want to install packages, run these two commands:

Step 1: Add the repository

Replace <PROJECT> with the project name you need (e.g. cognit, oneai). Check the repository home page for the full list of available projects.

echo "deb [trusted=yes] http://5.2.88.196/repo/ $(lsb_release -cs) <PROJECT>" \
  | sudo tee /etc/apt/sources.list.d/opennebula-innovation.list

Example for the cognit project:

echo "deb [trusted=yes] http://5.2.88.196/repo/ $(lsb_release -cs) cognit" \
  | sudo tee /etc/apt/sources.list.d/opennebula-innovation.list

Step 2: Update and install

sudo apt update
sudo apt install opennebula opennebula-fireedge   # install the packages you need

That's it. The packages from your chosen project are now installed.

3. Switch to a Different Project

To switch from one project to another, overwrite the sources file and update:

# Switch to the "oneai" project
echo "deb [trusted=yes] http://5.2.88.196/repo/ $(lsb_release -cs) oneai" \
  | sudo tee /etc/apt/sources.list.d/opennebula-innovation.list

sudo apt update
sudo apt upgrade   # upgrades to the packages from the new project

4. Available Projects and Distributions

Check the repository home page for the current list of projects and supported distributions.

5. How It Works

The repository is a standard APT repository managed by reprepro and served by Nginx. Each project is stored as a separate component in the repo.

When you add a sources.list entry like:
deb [trusted=yes] http://5.2.88.196/repo/ noble cognit
APT reads the package index from the cognit component of the noble distribution. It then downloads and installs packages from that component only.

All projects contain the same package names (built from different branches), which is why you must only enable one project at a time.