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.
Refer to the attach existing hosts guide on how to attach existing hosts running Ubuntu 20.04 via
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.
The Ubuntu orcharhino client repository needs to exist and be reachable.
--deps-repository-urlspecifies the repository containing the required dependencies (e.g.
--deps-repository-url https://orcharhino.example.com/pulp/deb/Example/Library/custom/Ubuntu_Client/Ubuntu_20_04_Client/). 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-keywith the corresponding GPG public key (i.e.
bootstrap.py script using
wget, or similar:
The help instructions displays a list of mandatory options:
python bootstrap.py --help
Run the following command on your Ubuntu 20.04 host to attach it to orcharhino:
./bootstrap.py \ -s "orcharhino.example.com" \ -a "ubuntu_20_04" \ -o "Example" \ -L "Munich" \ -l "admin" \ -p "changeme" \ -g "Ubuntu 20.04" \ --fqdn "my-host.example.com" \
This allows you to attach an existing host running Ubuntu 20.04 to your orcharhino.
The following steps allow you configure and prepare your orcharhino to deploy hosts running Ubuntu 20.04:
Extracting the installation media for Ubuntu 20.04 allows for complete offline installations.
Connect to your orcharhino via SSH:
# ssh firstname.lastname@example.org
Ubuntu 20.04 server legacyinstallation media from ubuntu.com using
# cd /tmp # wget http://cdimage.ubuntu.com/ubuntu-legacy-server/releases/20.04/release/ubuntu-20.04.1-legacy-server-amd64.iso
Verify the integrity and authenticity of the downloaded
# gpg --keyserver keys.gnupg.net --recv-key 3B4FE6ACC0B21F32 D94AA3F0EFE21092 871920D1991BC93C # wget http://cdimage.ubuntu.com/ubuntu-legacy-server/releases/20.04/release/SHA256SUMS # wget http://cdimage.ubuntu.com/ubuntu-legacy-server/releases/20.04/release/SHA256SUMS.gpg # 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
SHA256SUMSfile. Refer to the content credentials for more information.
# mount ubuntu-20.04.1-legacy-server-amd64.iso /mnt
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/
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
Unmount and delete the
# cd # umount /mnt # rm -rf /tmp/ubuntu-20.04.1-legacy-server-amd64.iso
You can use the installation media on
Create an architecture.
Depending on your hardware or compute resource provider, you probably want to create an architecture called
Create an installation medium for Ubuntu 20.04
Navigate to Hosts > Installation Media and create a new installation media.
The Name field (1) identifies the installation media for Ubuntu 20.04. We recommend adding
localto the name as the path of the extracted
.isofile points to the orcharhino. Using a locally available installation medium allows for offline installations.
The Path field (2) defines the path to the extracted
.isofile. This is the orcharhino FQDN plus the directory of the extracted
.isofile as described in the first part, e.g.
The Operating System Family drop down menu (3) is set to
Debianfor 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.
Create an operating system called
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.
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
focalfor Ubuntu 20.04.
The Root Password Hash drop down menu (7) must be set to
The Architectures field (8) assigns Ubuntu to an architecture as created in the step above.
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.04operating 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.
Create a product called
Create the necessary repositories
debrepositories inside the product created in step 1. This product may contain one or more repositories such as the following:
Synchronize the repositories
Synchronize all repositories via the Select Action > Sync Now button on the products page.
Create a content view
Create a single content view called
Ubuntu 20.04comprising the Ubuntu repositories created in the
Ubuntu 20.04product and publish a new version.
Create a composite content view
Create a new composite content view called
Composite Ubuntu 20.04comprising the previously published
Ubuntu 20.04content view, the
Ubuntu 20.04 orcharhino clientcontent 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.
Create an activation key
Create a new activation key called
ubuntu-20.04and 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
(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.