Chapter 5. Preparing templates for provisioning

Procedure

1. In the Satellite web UI, navigate to Hosts > Templates > Provisioning Templates and click Create Template.
2. In the Name field, enter a name for the provisioning template.
3. 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.

CLI procedure

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

2. 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

   Copy to Clipboard Toggle word wrap

Procedure

1. In the Satellite web UI, navigate to Hosts > Templates > Provisioning Templates.
2. Find the template that you want to use.
3. Click Clone to duplicate the template.
4. In the Name field, enter a name for the provisioning template.
5. Select the Default checkbox to set the template to associate automatically with new organizations or locations.
6. 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.
7. In the Audit Comment field, enter a summary of changes to the provisioning template for auditing purposes.
8. 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.
9. From the Type list, select the type of the template. For example, Provisioning template.
10. 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.
11. 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.
12. Click the Organizations and Locations tabs to add any additional contexts to the template.
13. Click Submit to save your provisioning template.

Procedure

1. In the Satellite web UI, navigate to Hosts > Templates > Provisioning Templates.
2. Click Create Template.

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

   • Append custom pre to the name of a provisioning template to run code before provisioning a host.
   • Append custom post to the name of a provisioning template to run code after provisioning a host.
4. On the Type tab, select Snippet.
5. Click Submit to create your custom provisioning snippet.

CLI procedure

1. Create a plain text file that contains your custom snippet.

2. 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

   Copy to Clipboard Toggle word wrap

Procedure

1. In the Satellite web UI, navigate to Hosts > Templates > Provisioning Templates.
2. Select a provisioning template.
3. On the Association tab, select all applicable operating systems.
4. Click Submit to save your changes.

CLI procedure

1. Optional: View all templates:

   $ hammer template list

   Copy to Clipboard Toggle word wrap

2. Optional: View all operating systems:

   $ hammer os list

   Copy to Clipboard Toggle word wrap

3. Associate a template with an operating system:

   $ hammer template add-operatingsystem \
   --id My_Template_ID \
   --operatingsystem-id My_Operating_System_ID

   Copy to Clipboard Toggle word wrap

Procedure

1. In the Satellite web UI, navigate to Hosts > Templates > Partition Tables.
2. Click Create Partition Table.
3. In the Name field, enter a name for the partition table.
4. Select the Default checkbox if you want to set the template to automatically associate with new organizations or locations.
5. Select the Snippet checkbox if you want to identify the template as a reusable snippet for other partition tables.
6. From the Operating System Family list, select the distribution or family of the partitioning layout. For example, Red Hat Enterprise Linux, CentOS, and Fedora are in the Red Hat family.

7. In the Template editor field, enter the layout for the disk partition.

   The format of the layout must match that for the intended operating system. For example, Red Hat Enterprise Linux requires a layout that matches a Kickstart file, such as:

   zerombr
   clearpart --all --initlabel
   autopart

   Copy to Clipboard Toggle word wrap

   For more information, see Section 5.10, “Dynamic partition example”.

   You can also use the file browser in the template editor to import the layout from a file.

8. In the Audit Comment field, add a summary of changes to the partition layout.
9. Click the Organizations and Locations tabs to add any other provisioning contexts that you want to associate with the partition table. Satellite adds the partition table to the current provisioning context.
10. Click Submit to save your partition table.

CLI procedure

1. Create a plain text file, such as ~/My_Partition_Table, that contains the partition layout.

   The format of the layout must match that for the intended operating system. For example, Red Hat Enterprise Linux requires a layout that matches a Kickstart file, such as:

   zerombr
   clearpart --all --initlabel
   autopart

   Copy to Clipboard Toggle word wrap

   For more information, see Section 5.10, “Dynamic partition example”.

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

   $ hammer partition-table create \
   --file "~/My_Partition_Table" \
   --locations "My_Location" \
   --name "My_Partition_Table" \
   --organizations "My_Organization" \
   --os-family "Redhat" \
   --snippet false

   Copy to Clipboard Toggle word wrap

Procedure

1. In the Satellite web UI, navigate to Hosts > Provisioning Setup > Operating Systems.
2. Select your Red Hat Enterprise Linux entry.
3. On the Partition Table tab, associate Kickstart default encrypted with your operating system entry.
4. Create a host group that uses the Kickstart default encrypted partition table. For more information, see Working with host groups in Managing hosts.

5. Decrypt the disk of your host during boot time by using one of the following options:

   • LUKS encryption: Add the host parameter disk_enc_passphrase as type string and your cleartext passphrase of the LUKS container as the value.

   • Clevis and Tang: Add the host parameter disk_enc_tang_servers as type array and your list of Tang servers (example: ["1.2.3.4"] or ["server.example.com", "5.6.7.8"]).

     If you set disk_enc_tang_servers, do not set disk_enc_passphrase because the passphrase slot is removed from the LUKS container after provisioning.