Proxy Migration

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 SLE Micro 6.1

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

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

2. SLE Micro 5.5 to SL Micro 6.1

This section provides the tested procedure to upgrade a SLE Micro 5.5 host deployed with Uyuni 5.0 Proxy to SL Micro 6.1 with Uyuni 2025.07 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 2025.07

  1. Verify System and Proxy Version

    cat /etc/os-release
mgrpxy --version

    Confirm:

    • Operating System: SLE Micro 5.5

    • Proxy Component: 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 Proxy Products in Uyuni Server

    Use the Web UI to synchronize:

    • SL-Micro 6.1

    • Uyuni 2025.07 Proxy Extension

  4. Perform Proxy Product Migration

    Use the Web UI to migrate from:

    • SLE Micro 5.5 + Uyuni Proxy 5.0 Extension to

    • SL Micro 6.1 + Uyuni Proxy 2025.07 Extension

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

  5. Monitor the Migration Action

  6. Reboot the System

    reboot

  7. Post-Reboot Validation

    cat /etc/os-release
mgrpxy --version

    Expected:

    • OS: SL Micro 6.1

    • Updated Proxy version

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

    PermitRootLogin yes

    And restart the service:

    systemctl restart sshd

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

  9. Upgrade proxy containers:

    mgrpxy upgrade podman

  10. Validate Proxy Containers

    podman ps

    All expected proxy containers should be up and running.

  • If migration fails due to missing GPG keys (e.g. key ID 09D9EA69), refer to Bug 1243373.

  • Also check for issues like missing libraries (liblua5.3.so.5) as reported in Bug 1243457.

2.3. Migration Complete

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

3. SUSE Linux Enterprise Server 15 SP6 to 15 SP7

This section provides the tested procedure to upgrade a SUSE Linux Enterprise Server SP7 host deployed with Uyuni 5.0 Proxy to SUSE Linux Enterprise Server SP7 with Uyuni 2025.07 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 Proxy Version

    cat /etc/os-release
mgrpxy --version

    Expected Output:

    NAME="SLES"
VERSION="15-SP6"
VERSION_ID="15.6"
PRETTY_NAME="SUSE Linux Enterprise Server 15 SP6"
ID="sles"
ID_LIKE="suse"

    and

    mgrpxy version 0.1.29 (HEAD 053c629)

  2. List Running Proxy Containers

    podman ps

    Verify the following containers are running:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

    • Supporting infrastructure container(s)

  3. Synchronize Products on the Uyuni Server

    Using the Web UI, synchronize the following:

    • SUSE Linux Enterprise Server 15 SP6

    • Uyuni Proxy Extension 5.0

  4. Trigger the Product Migration via Web UI

    Navigate to the proxy system in the Uyuni Web UI and select:

    • Migrate from: SLES 15 SP6 + Manager Proxy Extension 5.0

    • To: SLES 15 SP7 + Manager Proxy Extension (updated channels)

      When prompted, do not select optional channels unless you have confirmed they are required.

  5. Monitor the Migration Job

    Check job status under the system action history in the Web UI.

  6. Reboot the Proxy System

    reboot

  7. Validate Post-Reboot Status

    cat /etc/os-release
mgrpxy --version

    Expected:

    • OS: SUSE Linux Enterprise Server 15 SP7

    • Updated mgrpxy version (e.g., 5.1.9)

  8. Update proxy containers:

    mgrpxy upgrade podman

  9. Confirm Proxy Containers Are Operational

    podman ps

    Ensure all relevant proxy containers are up:

    • 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 2025.07 Proxy packages and synchronized product channels.