Proxy Migration from 5.1 to 5.2

1. Introduction

This document provides the tested and validated procedures for migrating the host operating system and the proxy extension in environments managed by Uyuni, specifically targeting systems deployed with Uyuni Proxy 5.1.

The upgrade scenarios covered include:

  • Migrating from SL Micro 6.1 to SL Micro 6.2

  • Updating SLES 15 SP7 with the new Uyuni Proxy Extension 2026.04

  • Upgrading the Uyuni Proxy Extension from version 5.1 to version 2026.04

Before migrating the proxy, it is required to first migrate the Uyuni 5.1 Server to Uyuni 2026.04.

2. SL Micro 6.1 to SL Micro 6.2

This section provides the tested procedure to upgrade a SL Micro 6.1 host deployed with Uyuni 5.1 Proxy to SL Micro 6.2 with Uyuni 2026.04 Proxy.

2.1. Prerequisites

  • Uyuni 5.1 Proxy is installed and running on SL Micro 6.1.

  • Proxy system is registered with the Uyuni Server.

2.2. Distribution upgrade and proxy migration

Procedure: Migrate Uyuni 5.1 Proxy to Uyuni 2026.04 Proxy

  1. Verify System and Uyuni Tools version.

    cat /etc/os-release
mgrpxy --version

    Confirm:

    • Operating System: SL Micro 6.1

    • Tools version: mgrpxy version 5.1.x or higher

  2. Check running containers.

    podman ps

    Ensure the following containers are running:

    • proxy-squid

    • proxy-ssh

    • proxy-httpd

    • proxy-tftpd

    • proxy-salt-broker

  3. Synchronize the new Proxy Products in Uyuni Server. For more information, see Software Products.

    Use the Web UI to synchronize:

    • SL Micro 6.2

    • Uyuni Proxy Extension 2026.04

  4. Perform proxy product migration. For more information, see Product Migration.

    Navigate to the proxy system and select Systems  Overview > Software  Product Migration.

    Migrate from

    • SL Micro 6.1 + SUSE Multi-Linux Manager Proxy 5.1 Extension

      to

    • SL Micro 6.2 + Uyuni Proxy Extension 2026.04

      Do not select optional channels when prompted, unless you have confirmed they are required.

      It is recommended to do a dry-run first before performing the actual migration.

  5. Monitor the migration action.

    You can follow the process under Systems  Details  Events tab in the Web UI.

  6. After the upgrade completes, stop the proxy container and then reboot the system.

    mgrpxy stop
reboot

  7. Perform post-reboot checks.

    Verify upgraded OS and Uyuni extension:

    cat /etc/os-release
SUSEConnect --status-text

  8. Verify Uyuni tools version.

    mgrpxy --version

    Expected output:

    • mgrpxy version 5.2.0 or higher

  9. Install the new proxy container images as RPM packages if they are not pulled from the registry.

    transactional-update pkg install suse-multi-linux-manager-5.2-<arch>-proxy*

  10. Reboot the Proxy.

  11. Upgrade proxy containers and restart them.

    mgrpxy upgrade podman
mgrpxy stop
mgrpxy start

  12. Confirm proxy containers are operational.

    podman ps

    All expected proxy containers should be up and running:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

2.3. Migration complete

The proxy host system is now running SL Micro 6.2 with updated Uyuni 2026.04 Proxy packages and synchronized product channels.

3. SUSE Linux Enterprise Server 15 SP7

This section provides the procedure to update a SUSE Linux Enterprise Server 15 SP7 host deployed with Uyuni 5.1 Proxy to Uyuni 2026.04 Proxy.

3.1. Prerequisites

  • Uyuni Proxy 5.1 is installed and running on SUSE Linux Enterprise Server 15 SP7.

  • Proxy system is registered with the Uyuni Server.

3.2. Proxy component update

Procedure: Update Uyuni Proxy components on SUSE Linux Enterprise Server 15 SP7

  1. Verify operating system and Uyuni tools version.

    cat /etc/os-release
mgrpxy --version

    Confirm:

    • Operating System: SUSE Linux Enterprise Server 15 SP7

    • Tools version: mgrpxy version 5.1.x or higher

  2. List running proxy containers.

    podman ps

    Ensure the following containers are running:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

  3. Synchronize the new Products in Uyuni Server using the Web UI.

    For more information, see Software Products.

    Synchronize:

    • Uyuni Proxy Extension 2026.04

  4. Perform proxy product migration.

    For more information, see Product Migration.

    Navigate to the proxy system and select Systems  Overview > Software  Product Migration.

    Migrate from:

    • SUSE Linux Enterprise Server 15 SP7 + SUSE Multi-Linux Manager Proxy 5.1 Extension

      to:

    • SUSE Linux Enterprise Server 15 SP7 + Uyuni Proxy Extension 2026.04

      Do not select optional channels when prompted, unless you have confirmed they are required.

      It is recommended to do a dry-run first before performing the actual migration.

  5. Monitor the migration action.

    You can follow the process under Systems  Details  Events in the Web UI.

  6. After the upgrade completes, stop the proxy container and then reboot the system.

    mgrpxy stop
reboot

  7. Perform post-reboot checks.

    Verify the OS and Uyuni extension version:

    cat /etc/os-release
SUSEConnect --status-text

  8. Verify Uyuni tools version.

    mgrpxy --version

    Expected output:

    • mgrpxy version 5.2.0 or higher

  9. Install the new proxy container images as RPM packages if they are not pulled from the registry.

    zypper install suse-multi-linux-manager-5.2-<arch>-proxy*

  10. Reboot the Proxy.

  11. Upgrade proxy containers and restart them.

    mgrpxy upgrade podman
mgrpxy stop
mgrpxy start

  12. Confirm proxy containers are operational.

    podman ps

    All expected proxy containers should be up and running:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

3.3. Migration complete

The proxy host system is now running SUSE Linux Enterprise Server 15 SP7 with updated Uyuni 2026.04 Proxy packages and synchronized product channels.