Install Uyuni Proxy in a Virtual Machine Environment Using Uyuni Proxy VM Image

1. Virtual Machine Manager Settings

This chapter provides the required Kernel Virtual Machine (KVM) settings for Uyuni Proxy. KVM combined with Virtual Machine Manager (virt-manager) will be used as a sandbox for this installation.

You will find the VM images for Uyuni 2024.1 Proxy in various formats. It includes SUSE Linux Enterprise Server 15 SP5 as the underlying operating system and the Uyuni Proxy software current at the time of build. Download the appropriate Uyuni Proxy image for your environment from https://download.suse.com/.

This table specifies the minimum requirements. These are suitable for a quick test installation, such as a server with one client. If you want to use a production environment, review the requirements listed in Hardware Requirements.
Virtual machine settings overview

Installation Method

Import Existing Disk Image

OS:

SUSE Linux Enterprise 15 SP4

Memory:

8 GB

CPU’s:

2

Virtual Disks:

VirtIO Disk 1

SUSE-Manager-Proxy.x86_64-4.3.13-KVM.qcow2

VirtIO Disk 2

100 GB for /var/cache/

VirtIO Disk 3

101 GB for /srv/

Name:

suse-manager-proxy-setup

Network

Bridge br0

For more information on SUSE Linux Enterprise Virtualization, see https://documentation.suse.com/sles/15-SP4/html/SLES-all/book-virtualization.html.

2. Install Uyuni Proxy Virtual Machine

Create virtual machine with additional virtual disks required for the Uyuni Proxy storage partitions.

Procedure: Creating the VM and Additional Partitions with virt-manager

  1. In virt-manager, open File  New Virtual Machine.

  2. In the Create a new virtual machine dialog, select Import existing disk image and confirm with Forward.

  3. Enter the filename of the downloaded Uyuni Proxy KVM image and set SUSE Linux Enterprise 15 SP4 as the operating system. Confirm with Forward.

  4. Configure RAM and number of CPUs (at least 8 GB RAM and 2 CPUs). Confirm with Forward.

  5. Set the name of your VM and select the Customize configuration before install check box.

  6. With the Network selection drop-down menu select the configured bridge device.

  7. Confirm with Finish.

  8. In the overview dashboard, at the bottom of the left navigation bar, click Add Hardware to create additional virtual disks. These disks will be partitioned and mounted later.

    Storage size values are the absolute minimum—only suitable for a small test or demo installation. Also consider to create a separate partition for /srv/tftpboot/ where images on Retail Branchservers are stored.
    VirtIO Storage Disks Name Sizing

    VirtIO Disk 2

    squidcache

    101 GB

    VirtIO Disk 3

    tftpboot

    100 GB

  9. Above the left navigation bar, click Begin Installation to boot the new VM from the Uyuni Proxy image. Wait until the JeOS Firstboot start option is presented.

3. Run JeOS Firstboot Setup

  1. Confirm to start the JeOS Firstboot setup.

  2. Select system locale such as en_US.

  3. Select keyboard layout such as us.

  4. Check end user license agreement.

  5. Select time zone such as UTC.

  6. Enter and confirm root password. Keep note of the root password.

  7. Wait until the login prompt is presented.

4. Preparing virtual machine for Uyuni Proxy

Before starting, obtain a registration code for this image from SUSE Customer Center - https://scc.suse.com.

Procedure: Preparing for Uyuni Proxy run

  1. Log in as root.

  2. Register Uyuni Proxy with SCC:

    SUSEConnect -e <EMAIL_ADDRESS> -r <SUSE_MANAGER_PROXY_CODE>

  3. Prepare Uyuni Proxy storage: suma-storage command automatically prepares and configures previously created external storage for use with the proxy. In the following command, the first parameter is the device for Uyuni Proxy Squid cache that suma-storage can handle:

    suma-storage /dev/vdb

  4. The virtual machine is now ready for Uyuni Proxy to be set up.

Continue with registering the installed Uyuni Proxy as a client: SUSE Manager Proxy Registration.