Configuring Provisioning Resources

Click Any Organization and select the organization.

Click Any Location and select the location to use.

In the orcharhino management UI, navigate to Hosts > Operating systems and click New Operating system.

In the Name field, enter a name to represent the operating system entry.

In the Major field, enter the number that corresponds to the major version of the operating system.

In the Minor field, enter the number that corresponds to the minor version of the operating system.

In the Description field, enter a description of the operating system.

From the Family list, select the operating system’s family.

From the Root Password Hash list, select the encoding method for the root password.

From the Architectures list, select the architectures that the operating system uses.

Click the Partition table tab and select the possible partition tables that apply to this operating system.

Click the Installation Media tab and enter the information for the installation media source. For more information, see Adding Installation Media to orcharhino.

Click the Templates tab and select a PXELinux template, a Provisioning template, and a Finish template for your operating system to use. You can select other templates, for example an iPXE template, if you plan to use iPXE for provisioning.

On the Parameters tab, add the or_client_repo_url parameter, select the string type, and enter the value \http://orcharhino.example.com/pulp/repos/My_Organization/Library/custom/My_OS_Client/My_OS_Client_Version/.

Click Submit to save your provisioning template.

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

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

Enter Ubuntu 22.04 as Name for the operating system. Choose a name as reported by Ansible, Puppet, or Salt as fact.

Set the Major Version to 22.04.

Set the Minor Version to 1.

Set the Release Name to Jammy Jellyfish for Ubuntu 22.04.

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

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.

On the Parameters tab, add the or_client_repo_url parameter, select the string type, and enter the value \http://orcharhino.example.com/pulp/repos/My_Organization/Library/custom/Ubuntu_Client/Ubuntu_Client_22.04/.

Click Submit to save the operating system entry for Ubuntu.

On orcharhino Server, run the following Bash script:

PARTID=$(hammer --csv partition-table list | grep "Kickstart default," | cut -d, -f1)
PXEID=$(hammer --csv template list --per-page=1000 | grep "Kickstart default PXELinux" | cut -d, -f1)
SATID=$(hammer --csv template list --per-page=1000 | grep "provision" | grep ",Kickstart 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=${SATID}
   hammer os set-default-template --id="${i}" --config-template-id=${SATID}
done

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

$ hammer os info --id 1

In the orcharhino management UI, navigate to Hosts > Architectures and click Create Architecture.

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

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

Click Submit.

In the orcharhino management UI, navigate to Hosts > Hardware Models and click Create Model.

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

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

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

Click Submit to save your hardware model.

In the orcharhino management UI, navigate to Hosts > Installation Media and click Create Medium.

In the Name field, enter a name to represent the installation media entry.

In the Path enter the URL or NFS share that contains the installation tree. Synchronized content on orcharhino Proxies always uses an HTTP path. orcharhino Proxy managed content does not support NFS paths.

From the Operating system family list, select the distribution or family of the installation medium. Ubuntu belongs to the Debian family.

Click the Organizations and Locations tabs, to change the provisioning context. orcharhino Server adds the installation medium to the set provisioning context.

Click Submit to save your installation medium.

In the orcharhino management UI, navigate to Hosts > Installation Media.

Click Create Medium to create an installation medium entry.

Enter a Name for the installation medium.

Set the Path to the upstream URL http://ftp.ubuntu.com/ubuntu/.

Set the Operating System Family to Debian.

Click Submit to save the installation medium to orcharhino.

Navigate to Hosts > Operating Systems.

Select the Ubuntu 22.04 operating system.

On the Partition Table tab, select your previously created Preseed partition table as Partition Table.

On the Templates tab, select your previously created Preseed Finish template as Finish template, Preseed template as Provisioning Template, and Preseed PXELinux template as PXELinux template.

Click Submit to associate the partition table and provisioning templates with Ubuntu 22.04.

In the orcharhino management UI, navigate to Hosts > Partition Tables and click Create Partition Table.

In the Name field, enter a name for the partition table.

Select the Default checkbox if you want to set the template to automatically associate with new organizations or locations.

Select the Snippet checkbox if you want to identify the template as a reusable snippet for other partition tables.

From the Operating System Family list, select the distribution or family of the partitioning layout. Ubuntu belongs to the Debian family.

In the Template editor field, enter the layout for the disk partition. For example:

zerombr
clearpart --all --initlabel
autopart

In the Audit Comment field, add a summary of changes to the partition layout.

Click the Organizations and Locations tabs to add any other provisioning contexts that you want to associate with the partition table. orcharhino adds the partition table to the current provisioning context.

Click Submit to save your partition table.

Before you create a partition table with the CLI, create a plain text file that contains the partition layout. This example uses the ~/my_partition_table file.

Create the installation medium using the hammer partition-table create command:

$ hammer partition-table create \
--file "path/to/my_partition_table" \
--locations "My_Location" \
--name "My_Partition_Table" \
--organizations "My_Organization" \
--os-family "Debian" \
--snippet false

In the orcharhino management UI, navigate to Hosts > Provisioning Templates and click Create Template.

In the Name field, enter a name for the provisioning template.

Fill in the rest of the fields as required. The Help tab provides information about the template syntax and details the available functions, variables, and methods that can be called on different types of objects within the template.

Before you create a template with the CLI, create a plain text file that contains the template. This example uses the ~/my-template file.

Create the template using the hammer template create command and specify the type with the --type option:

$ hammer template create \
--file ~/my-template \
--locations "My_Location" \
--name "My_Provisioning_Template" \
--organizations "My_Organization" \
--type provision

In the orcharhino management UI, navigate to Hosts > Provisioning Templates and search for the template that you want to use.

Click Clone to duplicate the template.

In the Name field, enter a name for the provisioning template.

Select the Default checkbox to set the template to associate automatically with new organizations or locations.

In the Template editor field, enter the body of the provisioning template. You can also use the Template file browser to upload a template file.

In the Audit Comment field, enter a summary of changes to the provisioning template for auditing purposes.

Click the Type tab and if your template is a snippet, select the Snippet checkbox. A snippet is not a standalone provisioning template, but a part of a provisioning template that can be inserted into other provisioning templates.

From the Type list, select the type of the template. For example, Provisioning template.

Click the Association tab and from the Applicable Operating Systems list, select the names of the operating systems that you want to associate with the provisioning template.

Optionally, click Add combination and select a host group from the Host Group list or an environment from the Environment list to associate provisioning template with the host groups and environments.

Click the Organizations and Locations tabs to add any additional contexts to the template.

Click Submit to save your provisioning template.

In the orcharhino management UI, navigate to Hosts > Provisioning Templates and click Create Template.

In the Name field, enter a name for your custom provisioning snippet. The name has to start with the name of a provisioning template that supports including custom provisioning snippets:

On the Type tab, select Snippet.

Click Submit to create your custom provisioning snippet.

Before you create a template with the CLI, create a plain text file that contains your custom snippet.

Create the template using hammer:

$ hammer template create \
--file "/path/to/My_Snippet" \
--locations "My_Location" \
--name "My_Template_Name_custom_pre" \
--organizations "_My_Organization" \
--type snippet

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

Click Run Job.

In the Job category drop down menu, select Commands.

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

In the Search Query field, filter your managed hosts, for example all hosts running Ubuntu:

os = Ubuntu

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

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

Click Submit to install the package.

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

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

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

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

Generate an encrypted password:

$ python -c 'import crypt,getpass;pw=getpass.getpass(); print(crypt.crypt(pw)) if (pw==getpass.getpass("Confirm: ")) else exit()'

Copy the password for later use.

In the orcharhino management UI, navigate to Administer > Settings.

On the Settings page, select the Provisioning tab.

In the Name column, navigate to Root password, and click Click to edit.

Paste the encrypted password, and click Save.

On the VM host system, configure the firewall to allow VNC service on ports 5900 to 5930:

On your orcharhino Proxy, ensure Smart Proxy HTTP forward is enabled:

$ grep "^:enabled: true$" /etc/foreman-proxy/settings.d/templates.yml

On your orcharhino Proxy, open the corresponding port for the Smart Proxy service:

$ firewall-cmd --permanent --zone=public --add-port=8000/tcp
$ firewall-cmd --reload

On your orcharhino Server, add your orcharhino Proxy to the list of trusted proxies:

$ orcharhino-installer --foreman-trusted-proxies "127.0.0.1" --foreman-trusted-proxies "::1" --foreman-trusted-proxies "Your_orcharhino_Proxy_IP"

Provide the extracted ISO and ISO image itself on each orcharhino Proxy. Perform the procedure to create an installation medium for Ubuntu 22.04 on your orcharhino Proxy.

Navigate to Hosts > Installation Media and create an installation medium. Set the Path to the extracted ISO image on your orcharhino Proxy.

Navigate to Hosts > Operating Systems and assign the installation medium to your operating system entry for Ubuntu 22.04.

Navigate to Configure > Host Groups, select the host group that you use to deploy Ubuntu 22.04 through an orcharhino Proxy, and set the installation medium entry accordingly.