Deploy Uyuni 2024.08 Server

This guide shows you how to install and configure a Uyuni 2024.08 container on SLE Micro 5.5.

1. Hardware Requirements for Uyuni

This table shows the software and hardware requirements for deploying Uyuni Server on your bare metal machine. For the purposes of this guide your machine should have 16 GB of RAM, and at least 200 GB of disk space. For background information about disk space, see Hardware Requirements.

Table 1. Software and Hardware Requirements
Software and Hardware Recommended

Operating System:

SLE Micro 5.5

Architecture

x86-64, ARM, s390x, ppc64le

Processor: (CPU)

Minimum of four (4) 64-bit CPU cores

RAM:

16 GB

Disk Space:

200 GB

Channel Requirements

50 GB per SUSE or openSUSE product

360 GB per Red Hat product

Swap space:

3 GB

Supported operating system for the Server Container Host

The supported operating system for the container host is SLE Micro 5.5.

Container host

A container host is a server equipped with a container engine like Podman, which lets it manage and deploy containers. These containers hold applications and their essential parts, such as libraries, but not a full operating system, making them lightweight. This setup ensures applications run the same way in different environments. The container host supplies the necessary resources such as CPU, memory, and storage for these containers.

Server deployment mandates the use of a fully qualified domain name (FQDN). In the absence of automatic DNS provision of an FQDN by your router or network, the deployment process will not proceed successfully. An FQDN typically follows the format <host>.<domain>.com.

For instance:

  • suma.example.com

  • suma.container.lab

For more information, see the section on network requirements in Network Requirements.

2. Persistent Volumes

Uyuni 2024.08 defines the required persistent storage volumes by default. These are created during installation by the mgradm tool if they do not already exist.

These volumes are created in /var/lib/containers/storage/volumes/, where Podman stores its volumes by default.

Recommendations

You can leverage the simplicity of storage by mounting an external storage device to this directory. Because it will store the PostgreSQL database, binary packages for repositories, caches, operating system images, autoinstallation distributions, and configuration files, we have three recommendations:

Fast Storage

This mount point should ideally be NVMe or SSD-class devices. Slower storage will adversely affect Uyuni performance.

Large Capacity

Recommended minimum size for this is at least 300 GB, and larger if there will be multiple Linux distributions or architectures to manage.

Recommended Filesystem

XFS (though any supported filesystem for SLE Micro 5.5 could work).

Optional

You can provide custom storage for the volumes by mounting disks on the expected volume path inside it such as /var/lib/containers/storage/volumes/var-spacewalk. This adds to the complexity of a Uyuni deployment, and may affect the resilience the default storage recommendation provides.

For a list of all persistent volumes in the container, see List of persistent storage volumes.

3. SLE Micro 5.5 Installation

Procedure: Download the Installation Media
  1. Locate the SLE Micro 5.5 installation media at https://www.suse.com/download/sle-micro/.

  2. Download SLE-Micro-5.5-DVD-x86_64-GM-Media1.iso.

  3. Prepare a DVD or USB flash drive with the downloaded .iso image for installation.

  4. Insert the DVD or USB flash drive (USB disk or key) containing the installation image for SLE Micro 5.5.

  5. Boot or reboot your system.

    For more information about preparing your machines (virtual or physical), see SLE Micro 5.5 Deployment Guide.

Procedure: SLE Micro 5.5 Installation
  1. Use the arrow keys to select Installation.

  2. Adjust keyboard and language.

  3. Click the checkbox to accept the license agreement.

  4. Click Next to continue.

  5. Select the registration method. For this example, we will register the server with SUSE Customer Center.

    Registering Uyuni as an Extension during Installation

    The Uyuni 2024.08 container is installed as an extension. Therefore, in addition to acquiring SUSE Customer Center registration codes for SLE Micro 5.5, you will also need SUSE Customer Center registration codes for the following extensions:

    • Uyuni 2024.08 Server

    • Uyuni 2024.08 Proxy

    • Retail Branch Server

  6. Enter your SUSE Customer Center email address.

  7. Enter your registration code for SLE Micro 5.5.

  8. Click Next to continue.

  9. Select the Uyuni 2024.08 Server extension Checkbox.

  10. Click Next to continue.

  11. Enter your Uyuni 2024.08 Server extension registration code.

  12. Click Next to continue.

  13. On the NTP Configuration page click Next.

  14. On the Authentication for the System page enter a password for the root user. Click Next.

  15. On the Installation Settings page click Install.

This concludes installation of SLE Micro 5.5 and Uyuni 2024.08 as an extension.

3.1. Registration from the Command Line (Optional)

If you added Uyuni 2024.08 as an extension during SLE Micro 5.5 installation then you can skip this step. However, optionally you may skip registration during SLE Micro 5.5 installation by selecting the Skip Registration button. This section provides steps on registering your products after SLE Micro 5.5 installation.

Procedure: Post Installation Product Registration
  1. Register SLE Micro 5.5 to SUSE Customer Center from the command line run the following commands on the container host:

    transactional-update register -r <reg_code> -e <your_email>
  2. Use the registration code you obtained from your SUSE Customer Center account for SLE Micro 5.5.

    The following steps register a server with the x86-64 architecture and thus require a registration code for the x86-64 architecture. To register ARM or s390x architectures use the correct registration code.

  3. Next add the SUSE Manager Server Extension 5.0 x86_64 Extension. List available extensions with the following command:

    transactional-update --quiet register --list-extensions
  4. Use your SUSE Manager Server Extension 5.0 x86_64 registration code with the following command:

    transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r <reg_code>
  5. Reboot.

3.2. Update the System

  1. Log in as root.

  2. Run transactional-update:

    transactional-update
  3. Reboot.

3.3. Configure Custom Persistent Storage

This step is optional. However, if custom persistent storage is required for your infrastructure, use the mgr-storage-server tool.

  • For more information, see mgr-storage-server --help. This tool simplifies creating the container storage and database volumes.

    Use the command in the following manner:

    mgr-storage-server <storage-disk-device> [<database-disk-device>]

    For example:

    mgr-storage-server /dev/nvme1n1 /dev/nvme2n1

    This command will create the persistent storage volumes at /var/lib/containers/storage/volumes.

    For more information, see List of persistent storage volumes.

4. Deploy with mgradm

Procedure: Deploy Uyuni 2024.08 Using mgradm
  1. Log in as root.

  2. Execute the following command, replacing <suma.example.com> with your fully qualified domain name:

    mgradm install podman <suma.example.com>

    If the above command fails ensure that you have registered Uyuni 2024.08. If you skipped registration during installation and now need to register from the command line, follow the steps below to log in to the registry:

    podman login -u <EMAIL> -p <REGISTRATION-CODE> registry.suse.com

    Use the Uyuni 2024.08 registration key when prompted.

  3. Enter a certificate and administrator account password when prompted.

    The administrator account password must be at least 5 characters and less than 48 characters in length.

  4. Press Enter.

  5. Enter the email address of the administration account. Press Enter.

  6. Wait for deployment to complete.

  7. Open a browser and proceed to your servers FQDN.

  8. Enter your username (default is admin) and the password you set during the deployment process.

SLE Micro is designed to update itself automatically by default and will reboot after applying updates. However, this behavior is not desirable for the Uyuni environment. To prevent automatic updates on your server, Uyuni disables the transactional-update timer during the bootstrap process.

If you prefer the SLE Micro default behavior, enable the timer by running the following command:

systemctl enable --now transactional-update.timer

In this guide you deployed Uyuni 2024.08 Server as a container. Proceed to the next section to add your organization credentials for syncing with SUSE Customer Center.

5. Connect Uyuni 2024.08 to SUSE Customer Center

This section covers synchronizing with SCC from the Web UI and adding your first client channel.

Procedure: Entering Organization Credentials
  1. Open a browser and proceed to your servers FQDN.

  2. Enter your username (default is admin) and the password you set during the deployment process.

  3. In the Uyuni Web UI, select Admin  Setup Wizard.

  4. From the Setup Wizard page select the Organization Credentials tab.

  5. Click Add a new credential.

  6. Point your browser to the SUSE Customer Center.

  7. Select your organization from the left navigation.

  8. Select the users tab from the top of the page then Organization Credentials.

  9. Make a note of your Mirroring credentials.

  10. Back in the Uyuni Web UI enter your Username and Password, and confirm with Save.

When the credentials are confirmed with a green check-mark icon, proceed with Procedure: Synchronizing with SUSE Customer Center.

Procedure: Synchronizing with SUSE Customer Center
  1. In the Web UI, navigate to Admin  Setup Wizard.

  2. From the Setup Wizard page select the SUSE Products tab. If you recently registered with SUSE Customer Center a list of products will begin populating the table. This operation could take up to a few minutes. You can monitor the progress of the operation in section on the right Refresh the product catalog from SUSE Customer Center. The table of products lists architecture, channels, and status information. For more information, see Wizard.

    admin suse products
  3. Use the Filter by product description and Filter by architecture to filter the list of displayed products. The channels listed on the Products page provide repositories for clients.

    • Add channels to Uyuni by selecting the check box to the left of each channel. Click the arrow symbol to the left of the description to unfold a product and list available modules.

    • Click Add Products at the top of the page to start product synchronization.

After adding the channel, Uyuni will schedule the channel to be synchronized. This can take a long time as Uyuni will copy channel software sources from the SUSE repositories located at SUSE Customer Center to the local /var/lib/containers/storage/volumes/var-spacewalk/ directory of your server.

When the channel is fully synchronized, a bootstrap repository for it will be automatically generated. This step is crucial for successfully bootstrapping clients, ensuring that the channel synchronization and distribution are operational on the client side. This completes the installation and configuration of Uyuni, along with preparing the channels necessary for bootstrapping clients.

When the channel synchronization process is complete, you can proceed with registering the Uyuni 2024.08 Proxy or additional clients.

For more instructions, see Client Registration.

6. Entering the container for management

To get to a shell inside the container, run on the container host:

mgrctl term