Preparing client platforms

You have to configure the platforms that you will provision. That entails creating a hardware model, CPU architecture, and operating system.

Creating an operating system for Debian 13

Create an operating system in orcharhino to provision hosts running Debian 13. This example creates an operating system entry for Debian 13.

You can use a script to add operating system entries to your orcharhino Server.

On your orcharhino Server, uncomment the operating systems and orcharhino Client for Debian that you want to add in /etc/orcharhino-ansible/or_operating_systems_vars.yaml, replace the default organization and location names, and run /opt/orcharhino/automation/play_operating_systems.sh. For more information, see /usr/share/orcharhino-ansible/README.md on your orcharhino Server.
Procedure

  1. In the orcharhino management UI, navigate to Hosts > Provisioning Setup > Operating Systems.

  2. Click Create Operating System to create an operating system entry for Debian.

  3. Enter Debian 13 as Name for the operating system. Choose a name as reported by Ansible, Puppet, or Salt as fact.

  4. Set the Major Version to 13.

  5. Leave the Minor Version field empty.

  6. Set the Release Name to trixie for Debian 13.

  7. On the Partition Table tab, select the Preseed partition table.

    For more information, see Creating partition tables.

  8. On the Templates tab, select the Preseed Finish template as Finish template, the Preseed template as Provisioning Template, and the Preseed PXELinux template as PXELinux template.

  9. On the Parameters tab, add the or_client_repo_url parameter, select the string type, and enter the value http://orcharhino.example.com/pulp/content/_My_Organization_/Library/custom/debian_Client/debian_Client_debian/.

    If you want to provision hosts through orcharhino Proxy Servers, you have to use the or_client_repo_path parameter containing the Published At path of your content on orcharhino Server. orcharhino Proxy Server will add the FQDN of your orcharhino Proxy Server to generate the URL based on the content source setting of your host.

  10. Click Submit to save the operating system entry for Debian.

Updating the details of multiple operating systems

Use this procedure to update the details of multiple operating systems. This example shows you how to assign each operating system a partition table called Preseed default, a configuration template called Preseed default PXELinux, and a provisioning template called Preseed Default.

Procedure

  1. On orcharhino Server, run the following Bash script:

    PARTID=$(hammer --csv partition-table list | grep "Preseed default," | cut -d, -f1)
PXEID=$(hammer --csv template list --per-page=1000 | grep "Preseed default PXELinux" | cut -d, -f1)
ORCHARHINO_ID=$(hammer --csv template list --per-page=1000 | grep "provision" | grep ",Preseed default" | cut -d, -f1)

for i in $(hammer --no-headers --csv os list | awk -F, {'print $1'})
do
   hammer partition-table add-operatingsystem --id="${PARTID}" --operatingsystem-id="${i}"
   hammer template add-operatingsystem --id="${PXEID}" --operatingsystem-id="${i}"
   hammer os set-default-template --id="${i}" --config-template-id=${PXEID}
   hammer os add-config-template --id="${i}" --config-template-id=${ORCHARHINO_ID}
   hammer os set-default-template --id="${i}" --config-template-id=${ORCHARHINO_ID}
done

  2. Display information about the updated operating system to verify that the operating system is updated correctly:

    $ hammer os info --id 1

Creating architectures

An architecture in orcharhino represents a logical grouping of hosts and operating systems. Architectures are created by orcharhino automatically when hosts check in with Puppet. The x86_64 architecture is already preset in orcharhino.

Use this procedure to create an architecture in orcharhino.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > Provisioning Setup > Architectures.

  2. Click Create Architecture.

  3. In the Name field, enter a name for the architecture.

  4. From the Operating Systems list, select an operating system. If none are available, you can create and assign them under Hosts > Provisioning Setup > Operating Systems.

  5. Click Submit.

CLI procedure

  • Enter the hammer architecture create command to create an architecture. Specify its name and operating systems that include this architecture:

    $ hammer architecture create \
--name "My_Architecture" \
--operatingsystems "My_Operating_System"

Creating hardware models

Use this procedure to create a hardware model in orcharhino so that you can specify which hardware model a host uses.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > Provisioning Setup > Hardware Models.

  2. Click Create Model.

  3. In the Name field, enter a name for the hardware model.

  4. Optionally, in the Hardware Model and Vendor Class fields, you can enter corresponding information for your system.

  5. In the Info field, enter a description of the hardware model.

  6. Click Submit to save your hardware model.

CLI procedure

  • Create a hardware model using the hammer model create command. The only required parameter is --name. Optionally, enter the hardware model with the --hardware-model option, a vendor class with the --vendor-class option, and a description with the --info option:

    $ hammer model create \
--hardware-model "My_Hardware_Model" \
--info "My_Description" \
--name "My_Hardware_Model_Name" \
--vendor-class "My_Vendor_Class"

Creating compute profiles

You can use compute profiles to predefine virtual machine hardware details such as CPUs, memory, and storage.

To use the CLI instead of the orcharhino management UI, see the CLI procedure.

A default installation of orcharhino contains three predefined profiles:

  • 1-Small

  • 2-Medium

  • 3-Large

You can apply compute profiles to all supported compute resources:

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Profiles and click Create Compute Profile.

  2. In the Name field, enter a name for the profile.

  3. Click Submit. A new window opens with the name of the compute profile.

  4. In the new window, click the name of each compute resource and edit the attributes you want to set for this compute profile.

CLI procedure

  1. Create a new compute profile:

    $ hammer compute-profile create --name "My_Compute_Profile"

  2. Set attributes for the compute profile:

    $ hammer compute-profile values create \
--compute-attributes "flavor=m1.small,cpus=2,memory=4GB,cpu_mode=default \
--compute-resource "My_Compute_Resource" \
--compute-profile "My_Compute_Profile" \
--volume size=40GB

  3. Optional: To update the attributes of a compute profile, specify the attributes you want to change. For example, to change the number of CPUs and memory size:

    $ hammer compute-profile values update \
--compute-resource "My_Compute_Resource" \
--compute-profile "My_Compute_Profile" \
--attributes "cpus=2,memory=4GB" \
--interface "type=network,bridge=br1,index=1" \
--volume "size=40GB"

  4. Optional: To change the name of the compute profile, use the --new-name attribute:

    $ hammer compute-profile update \
--name "My_Compute_Profile" \
--new-name "My_New_Compute_Profile"
Additional resources

  • For more information about creating compute profiles by using Hammer, enter hammer compute-profile --help.

Installing katello-host-tools-tracer Manually

The katello-host-tools package is responsible for the connection between managed hosts and content from orcharhino Server and orcharhino Proxies. It uploads currently used repositories and installed packages to orcharhino. The katello-host-tools-tracer package signals orcharhino if services such as nginx have to be restarted or the managed host itself has to be rebooted after updating packages such as the Linux Kernel.

Procedure

  1. In the orcharhino management UI, navigate to Monitor > Jobs.

  2. Click Run Job.

  3. In the Job category drop down menu, select Commands.

  4. In the Job template drop down menu, select Run Command - SSH Default.

  5. In the Search Query field, filter your managed hosts, for example all hosts running Debian:

    os = Debian

    Alternatively, you can also filter for specific hosts using name = my-host.example.com.

  6. In the Command field, enter the command to install the katello-host-tools-tracer package:

    $ apt install -y katello-host-tools-tracer

  7. Click Submit to install the package.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").