Managing Debian Systems Guide

Debian is a free and open source Linux distribution and a popular choice for servers and cloud computing due to its community and stability. This usage guide shows how to attach existing or provision new hosts running Debian 10 "Buster" when starting with a basic orcharhino installation.

Attaching Hosts Running Debian 10

You can attach existing hosts running Debian 10 to your orcharhino. Refer to the attach existing hosts guide for more information on how to attach existing hosts running Debian 10 using the bootstrap.py script.

Prerequisites
  • If you use a self-signed certificate on your orcharhino, ensure hosts trust the SSL certificate before running the bootstrap.py script.

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

  • A host group must be configured accordingly to have orcharhino manage the host completely.

    Ensure to select a host group without any predefined deploy on compute resource. Otherwise, attaching an existing host starts 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.

  • Synchronize the required orcharhino client repository and create a content view.

  • (Debian, SLES, and Ubuntu only) Use --deps-repository-url to specify the repository containing the required dependencies. Navigate to Content > Products, click on your orcharhino clients product, choose the orcharhino client repository on the Repositories tab, and select the appropriate client repository. Pass the Published At URL using --deps-repository-url, for example --deps-repository-url https://orcharhino.example.com/pulp/deb/Example/Library/custom/Debian_Client/Debian_10_Client/.

Procedure
  1. Download the bootstrap.py script using wget:

    # wget https://orcharhino.example.com/pub/bootstrap.py
  2. Use the --help option to display a list of mandatory options:

    # python bootstrap.py --help
  3. Attach your host running Debian 10 to your orcharhino:

    # ./bootstrap.py \
        -s "orcharhino.example.com" \
        -a "debian_10" \
        -o "Example" \
        -L "Munich" \
        -l "admin" \
        -p "password" \
        -g "Debian 10" \
        --fqdn "my-host.example.com" \
        --deps-repository-url "https://orcharhino.example.com/pulp/deb/Example/Library/custom/Debian_Client/Debian_10_Client/" \
        --deps-repository-gpg-key "https://orcharhino.example.com/pub/pulp_deb_signing.key"

Creating the Operating System Entry for Debian 11

To create the operating system entry for Debian 11, see Creating an Operating System for Debian in the Provisioning guide.

Creating the Installation Medium for Debian 11

To create the installation medium for Debian 11, see Creating an Installation Medium for Debian in the Provisioning guide.

Synchronizing Content for Debian 11

To synchronize content for Debian 11, see Adding DEB Repository Example for Debian 11 in the Content Management guide.

Provisioning Hosts

After creating the operating system entry and synchronising required content, create a host group to simplify deploying hosts. Refer to the provisioning guide for more information.

Creating a Host Group

Host groups bundle provisioning and configuration settings.

Procedure
  1. Navigate to Configure > Host Groups.

  2. Click Create Host Group.

  3. On the Host Group tab, enter a Name, for example Debian 10, and assign the previously created Lifecycle Environment, Content View, Content Source, Deploy on, and Compute Profile.

  4. On the Network tab, assign the Domain and Subnet.

  5. On the Operating System tab, assign the Architecture, Operating System, Media, Partition Table, PXE-Loader, and enter a default root password.

  6. On the Locations tab, assign a location.

  7. On the Organizations tab, assign an organization.

  8. On the Activation Keys tab, assign the previously created activation key.

  9. Click Submit to save your host group.

You can now comfortably deploy hosts running Debian 10 using the Debian 10 host group.

Deploying Hosts

Use the previously created host group to deploy hosts.

Procedure
  1. Navigate to Hosts > Create Host.

  2. Select the previously created Host Group.

  3. Click Submit to deploy a host.