Proxy Migration from 5.0 to 5.2

1. Introduction

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

The upgrade scenarios covered include:

  • Migrating from SUSE Linux Enterprise Micro (SLE Micro) 5.5 to SL Micro 6.2

  • Migrating from SUSE Linux Enterprise Server (SLES) 15 SP6 to SLES 15 SP7

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

Before migrating the proxy, it is required to first migrate the SUSE Manager 5.0 Server to Uyuni 2026.04.

2. SLE Micro 5.5 to SL Micro 6.2

This section provides the tested procedure to upgrade a SLE Micro 5.5 host deployed with Uyuni 5.0 Proxy to SL Micro 6.2 with Uyuni 2026.04 Proxy.

2.1. Prerequisites

  • Uyuni 5.0 Proxy is installed and running on SLE Micro 5.5.

  • Proxy system is registered with the Uyuni Server.

2.2. Distribution upgrade and proxy migration

Procedure: Migrate Uyuni 5.0 Proxy to Uyuni 2026.04 Proxy
  1. Verify System and Uyuni Tools version.

    cat /etc/os-release
    mgrpxy --version

    Confirm:

    • Operating System: SLE Micro 5.5

    • Tools version: mgrpxy version 0.1.29 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

    • SLE Micro 5.5 + SUSE Manager Proxy 5.0 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.

    reboot
    mgrpxy stop
  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 or higher

  9. Enable Root SSH Access (if required). SL Micro 6.2 disables root login via SSH by default. Edit /etc/ssh/sshd_config.d/sshd.conf:

    PermitRootLogin yes

    Restart the service:

    systemctl restart sshd

    For more information, see Remote root login on SL Micro.

  10. Install the new proxy container images as RPM packages.

    transactional-update pkg install suse-multi-linux-manager-5.2-<arch>-proxy*
  11. Reboot the Proxy.

  12. Upgrade proxy containers and restart them.

    mgrpxy upgrade podman
    mgrpxy stop
    mgrpxy start
  13. 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 SP6 to 15 SP7

This section provides the procedure to upgrade a SUSE Linux Enterprise Server SP6 host deployed with Uyuni 5.0 Proxy to SUSE Linux Enterprise Server SP7 with Uyuni 2026.04 Proxy.

3.1. Prerequisites

  • Uyuni Proxy 5.0 is installed and running on SUSE Linux Enterprise Server 15 SP6.

  • Proxy system is registered with the Uyuni Server.

3.2. Distribution upgrade and proxy migration

Procedure: Update Uyuni Proxy components on SUSE Linux Enterprise Server 15 SP6
  1. Verify operating system and Uyuni tools version.

    cat /etc/os-release
    mgrpxy --version

    Confirm:

    • Operating System: SUSE Linux Enterprise Server 15 SP6

    • Tools version: mgrpxy version 0.1.29 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:

    • SUSE Linux Enterprise Server SP7

    • 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 SP6 + SUSE Manager Proxy 5.0 Extension

      to:

    • SUSE Linux Enterprise Server 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 or higher

  9. Install the new proxy container images as RPM packages.

    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 SP7 with updated Uyuni 2026.04 Proxy packages and synchronized product channels.