Deploy Uyuni 2024.02 as a container using SLE Micro

In this section, you will gain expertise in setting up and deploying a containerized Uyuni 2024.02 Server. This process encompasses the installation of SLE Micro, and then initiating interaction with the container through the mgradm and mgrctl commands.

1. Container Host general Requirements

For general requirements see, General requirements

A SLE Micro or SUSE Linux Enterprise Server server should be installed from installation media. This procedure is described below.

2. Container Host Requirements

For CPU, RAM and storage requirements see, Hardware requirements

To guarantee that clients can resolve the Uyuni 2024.02 domain name, both the container server and host machines must be linked to a functional DNS server. Additionally, it is essential to ensure correct configuration of reverse lookups.

3. SLE Micro 5.5 Installation

Get a copy of the SLE Micro 5.5 install media. You can begin installation on either a virtual machine or on a physical server.

Procedure: SLE Micro 5.5 installation
  1. Begin installation from media

  2. Adjust Keyboard and language. Click the checkbox to accept the License Agreement.

  3. Click Next to continue.

  4. Select your registration method. For this example we will register the sever with SUSE Customer Center.

  5. Enter your SUSE Customer Center Email address.

  6. Enter your registration code for SLE Micro 5.5.

    Base operating system for Uyuni 2024.02 Server

    For SUSE Manager 5.0, the base operating system of the container is SLE Micro 5.5 You can find these keys from your SUSE Customer Center account.

  7. Click Next to continue.

  8. Select the Uyuni 2024.02 Server extension Checkbox.

  9. Click Next to continue.

  10. Enter your Uyuni 2024.02 Server extension registration code.

    Uyuni as an extension

    Uyuni 2024.02 is installed as an extension. Therefore, in addition to acquiring SUSE Customer Center registration keys for the base Server, you will also need SUSE Customer Center registration codes for the following extensions:

    • Uyuni 2024.02 Server

    • Uyuni 2024.02 Proxy

    • Retail Branch Server

  11. Click Next to continue.

  12. Enter or accept default NTP Server.

  13. Click Next to continue.

  14. Add the root user password twice to confirm.

  15. Click Next to continue.

  16. Adjust Installation Settings as required.

  17. Click Next to continue.

This concludes installation of SLE Micro 5.5.

4. Deploy Uyuni 2024.02 as container on SLE Micro 5.5

4.1. Basic and advanced deployment with mgradm

Procedure: Basic deployment of a Uyuni 2024.02 container with Podman
  1. from the terminal run the following command as the root user.

    sudo mgradm install podman

    You must deploy the container as sudo or root. The following error will be displayed at the terminal if you miss this step.

    INF Setting up uyuni network
    9:58AM INF Enabling system service
    9:58AM FTL Failed to open /etc/systemd/system/uyuni-server.service for writing error="open /etc/systemd/system/uyuni-server.service: permission denied"
  2. Enter your servers FQDN.

  3. Enter a database and certificate password when prompted.

  4. Wait for deployment to complete.

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

In this section you learned the basic method for deploying a Uyuni 2024.02 Server container.

Procedure: Advanced - Deploy Uyuni 2024.02 using a custom configuration file
  1. Prepare an mgradm.yaml file similar to the following example:

    # Database password
    db:
      password: MySuperSecretDBPass
    # Certifcate password
    cert:
      password: MySuperSecretCAPass
    # SSL password
    ssl:
      password: MySuperSecretSllPassword
    
    # If you have these you can provide them to setup your oganization credentials
    scc:
      user: ccUsername
      password: ccPassword
    
    # Adminstrators email
    email: email@example.com

    For security, using command line parameters to specify passwords should be avoided: use a configuration file with proper permissions instead.

  2. from the terminal run the following command a the sudo user. Replace uyuni.example.com with your FQDN.

    sudo mgradm -c mgradm.yaml install podman <FQDN>

    You must deploy the container as sudo or root. The following error will be displayed at the terminal if you miss this step.

    INF Setting up uyuni network
    9:58AM INF Enabling system service
    9:58AM FTL Failed to open /etc/systemd/system/uyuni-server.service for writing error="open /etc/systemd/system/uyuni-server.service: permission denied"
  3. Wait for deployment to complete.

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

In this section you learned how to deploy an Uyuni Server container.

4.2. Persistent volumes

If you are just testing out Uyuni you do not need to specify these volumes. mgradm will setup the correct volumes by default.

Specifiying volume locations will generally be used for larger production deployments.

Many users will want to specify locations for their persistent volumes.

By default Podman stores its volumes in /var/lib/containers/storage/volumes/.

You can provide custom storage for the volumes by mounting disks on this path or the expected volume path inside it such as: /var/lib/containers/storage/volumes/var-spacewalk. This is especially important for the database and package mirrors.

For a list of all persistent volumes in the container see, Persistent container volumes

5. Container managment

To begin managing your containers see, Container management