Managing Ubuntu Systems Guide

Ubuntu is a Debian based Linux distribution and a popular choice for servers and cloud computing due to its long term support versions. This guide shows how to attach existing or deploy new hosts running Ubuntu 20.04 ("Focal Fossa") when starting with a basic orcharhino installation.

This guide presumes a basic understanding of orcharhino’s content management capabilities as outlined in the content management guide.

Deploying hosts running Ubuntu 20.04 requires an already attached compute resource. Refer to the compute resources chapter on how to add a compute resource provider to orcharhino.

Attach Hosts Running Ubuntu 20.04

Refer to the attach existing hosts guide on how to attach existing hosts running Ubuntu 20.04 via script.

Most notably, there are five prerequisites:

  • An activation key for the host needs to exist and contain the necessary software content for this host.

  • A host group must be configured accordingly to be able to use a full registration, i.e. orcharhino managing the host completely.

    Make sure to select a host group without any predefined deploy on compute resource. Otherwise, this will start deploying a new host to the compute resource selected in the deploy on drop down menu. Refer to creating a host group for more information.

  • The Ubuntu orcharhino client repository needs to exist and be reachable.

  • --deps-repository-url specifies the repository containing the required dependencies (e.g. --deps-repository-url Navigate to products, click on your orcharhino clients product, choose an individual repository on the repositories tab and select the appropriate client repository. You need to pass the published at URL.

  • --deps-repository-gpg-key with the corresponding GPG public key (i.e.

Download the script using curl, wget, or similar:


The help instructions displays a list of mandatory options:

python --help

Run the following command on your Ubuntu 20.04 host to attach it to orcharhino:

./ \
  -s "" \
  -a "ubuntu_20_04" \
  -o "Example" \
  -L "Munich" \
  -l "admin" \
  -p "changeme" \
  -g "Ubuntu 20.04" \
  --fqdn "" \

This allows you to attach an existing host running Ubuntu 20.04 to your orcharhino.

Deploy Hosts Running Ubuntu 20.04

The following steps allow you configure and prepare your orcharhino to deploy hosts running Ubuntu 20.04:

Preparing Installation Media

Extracting the installation media for Ubuntu 20.04 allows for complete offline installations.

  1. Connect to your orcharhino via SSH:

    # ssh
  2. Download the Ubuntu 20.04 server legacy installation media from using wget:

    # cd /tmp
    # wget
  3. Verify the integrity and authenticity of the downloaded .iso file:

    # gpg --keyserver --recv-key 3B4FE6ACC0B21F32 D94AA3F0EFE21092 871920D1991BC93C
    # wget
    # wget
    # gpg --verify SHA256SUMS.gpg SHA256SUMS
    # echo 'f11bda2f2caed8f420802b59f382c25160b114ccc665dbac9c5046e7fceaced2 *ubuntu-20.04.1-legacy-server-amd64.iso' | sha256sum --check

    You might need to import the official Ubuntu GPG public key first before verifying the authenticity of the SHA256SUMS file. Refer to the content credentials for more information.

  4. Mount the .iso image:

    # mount ubuntu-20.04.1-legacy-server-amd64.iso /mnt
  5. Copy mounted installation media to public directory:

    # mkdir -p /var/www/html/pub/installation_media/ubuntu_20_04
    # cp -pR /tmp/ubuntu_20_04_iso/ /var/www/html/pub/installation_media/ubuntu_20_04/
  6. Create the required directory structure:

    # cd /var/www/html/pub/installation_media/ubuntu_20_04
    # mkdir -p dists/focal/main/installer-amd64/current/legacy-images/
    # cd dists/focal/main/installer-amd64/current/legacy-images/
    # ln -s ../../../../../../install/netboot
  7. Unmount and delete the .iso image:

    # cd
    # umount /mnt
    # rm -rf /tmp/ubuntu-20.04.1-legacy-server-amd64.iso

You can use the installation media on

Adding Operating System Entry

  1. Create an architecture.

    Depending on your hardware or compute resource provider, you probably want to create an architecture called x86_64.

  2. Create an installation medium for Ubuntu 20.04

    Navigate to Hosts > Installation Media and create a new installation media.

    Creating an installation media for Ubuntu 20.04
    • The Name field (1) identifies the installation media for Ubuntu 20.04. We recommend adding local to the name as the path of the extracted .iso file points to the orcharhino. Using a locally available installation medium allows for offline installations.

    • The Path field (2) defines the path to the extracted .iso file. This is the orcharhino FQDN plus the directory of the extracted .iso file as described in the first part, e.g.

    • The Operating System Family drop down menu (3) is set to Debian for all Debian and Ubuntu systems.

    • Remember to also set a proper location and organization context (4) for the installation media.

    • Click the Submit button (5) to save the installation media entry for Ubuntu 20.04.

  3. Create an operating system called Ubuntu 20.04.

    Creating an operating system for Ubuntu 20.04
    • The Name field (1) sets the name of the operating system. Choose a name from one of the operating systems reporting by Ansible, Puppet, or Salt as fact.

    • The Major Version field (2) describes the major version of Ubuntu, e.g. 20.04.

    • The Minor Version field (3) can be omitted for Ubuntu.

    • The Descriptions field (4) allows for an arbitrary description of the operating system.

    • The Family drop down menu (5) assigns Ubuntu to a operating system family.

    • The Release Name field (6) contains the name of the release, e.g focal for Ubuntu 20.04.

    • The Root Password Hash drop down menu (7) must be set to SHA256 for Ubuntu.

    • The Architectures field (8) assigns Ubuntu to an architecture as created in the step above.

    • The other tabs (9) require associations to the newly created operating system. Select a partition table, an installation media, templates, and optionally parameters.

      On a basic orcharhino installation, you are not able to select any partition tables and templates when creating the operating system. Instead, save the Ubuntu 20.04 operating system entry by clicking the Submit button as shown above and navigate to Hosts > Partition Tables and Hosts > Templates to associate the default templates with the operating system. You can now return to the operating system and select those templates via drop down menu.

    • Clicking the Submit button (10) saves your changes to orcharhino.

Synchronizing Content

  1. Create a product called Ubuntu 20.04

  2. Create the necessary repositories

    Create generic deb repositories inside the product created in step 1. This product may contain one or more repositories such as the following:

  3. Synchronize the repositories

    Synchronize all repositories via the Select Action > Sync Now button on the products page.

  4. Create a content view

    Create a single content view called Ubuntu 20.04 comprising the Ubuntu repositories created in the Ubuntu 20.04 product and publish a new version.

  5. Create a composite content view

    Create a new composite content view called Composite Ubuntu 20.04 comprising the previously published Ubuntu 20.04 content view, the Ubuntu 20.04 orcharhino client content view and optionally further content views of your choice (e.g. Puppet). Refer to adding an orcharhino client on how to synchronize the orcharhino client for Ubuntu 20.04. The necessary upstream URL for the orcharhino client repository for Ubuntu 20.04 can be found in the ATIX Service Portal.

    Publish a new version and promote this version to the lifecycle environment of your choice.

  6. Create an activation key

    Create a new activation key called ubuntu-20.04 and configure it as follows:

    • On the Details tab, assign the correct lifecycle environment and assign the correct composite content view.

    • On the Subscriptions tab, assign the necessary subscriptions (e.g. Ubuntu 20.04, and Puppet etc).

  7. (Optional) Create a new host group and assign the previously created activation key to it to deploy hosts running Ubuntu 20.04 more comfortably.

You can now deploy hosts supplied by the Ubuntu 20.04 repositories once the previously created activation key is assigned to them either on an individual level or via host group.