Proxy Migration from 5.0 to 5.1

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 SUSE Multi-Linux Manager, specifically targeting systems deployed with SUSE Multi-Linux Manager 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 SUSE Multi-Linux Manager Proxy Extension from version 5.0 to version 5.1

Before migrating the proxy, it is required to first migrate the SUSE Manager 5.0 Server to SUSE Multi-Linux Manager 5.1.

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 SUSE Multi-Linux Manager 5.0 Proxy to SL Micro 6.1 with SUSE Multi-Linux Manager 5.1 Proxy.

2.1. Prerequisites

  • SUSE Multi-Linux Manager 5.0 Proxy is installed and running on SLE Micro 5.5.

  • Proxy system is registered with the SUSE Multi-Linux Manager Server.

2.2. Distribution upgrade and proxy migration

Procedure: Migrate SUSE Multi-Linux Manager 5.0 Proxy to SUSE Multi-Linux Manager 5.1 Proxy
  1. Verify System and SUSE Multi-Linux Manager 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. Refresh the product catalog

    • In the SUSE Multi-Linux Manager Web UI, navigate to Admin  Setup Wizard  Products.

    • Click the Refresh button on the right-hand side to update the product catalog from SUSE Customer Center.

  4. Synchronize the new Proxy Products in SUSE Multi-Linux Manager Server. For more information, see Software Products.

    Use the Web UI to synchronize:

    • SUSE Linux Micro 6.1

    • SUSE Multi-Linux Manager Proxy Extension 5.1

  5. 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.1 + SUSE Multi-Linux Manager Proxy Extension 5.1

      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.

  6. Monitor the migration action.

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

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

    mgrpxy stop
    reboot
  8. Perform post-reboot checks.

    Verify upgraded OS and SUSE Multi-Linux Manager extension:

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

    You should see:

    • PRETTY_NAME="SUSE Linux Micro 6.1"

    • SUSE Multi-Linux Manager Proxy 5.1 Extension

  9. Verify SUSE Multi-Linux Manager tools version.

    mgrpxy --version

    Expected output:

    • mgrpxy version 5.1.11 or higher

  10. 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

    Restart the service:

    systemctl restart sshd

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

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

    transactional-update pkg install suse-multi-linux-manager-5.1-x86_64-proxy*
  12. Reboot the P-roxy.

  13. Upgrade proxy containers and restart them.

    mgrpxy upgrade podman
    mgrpxy stop
    mgrpxy start
  14. 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.1 with updated SUSE Multi-Linux Manager 5.1 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 SUSE Multi-Linux Manager 5.0 Proxy to SUSE Linux Enterprise Server SP7 with SUSE Multi-Linux Manager 5.1 Proxy.

3.1. Prerequisites

  • SUSE Multi-Linux Manager Proxy 5.0 is installed and running on SUSE Linux Enterprise Server 15 SP6.

  • Proxy system is registered with the SUSE Multi-Linux Manager Server.

3.2. Distribution upgrade and proxy migration

Procedure: Update SUSE Multi-Linux Manager Proxy components on SUSE Linux Enterprise Server 15 SP6
  1. Verify operating system and SUSE Multi-Linux Manager 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

    Verify the following containers are running:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

    • Supporting infrastructure container(s)

  3. Synchronize the new proxy products in SUSE Multi-Linux Manager Server. For more information see Software Products.

    Using the Web UI, synchronize the following:

    • SUSE Linux Enterprise Server 15 SP7

      • SUSE Multi-Linux Manager Proxy Extension for SLE 5.1

      Proxy extensions are listed under Basesystem Module 15 SP7` > `Containers Module 15 SP7.

  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 Extension 5.0

      to

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

      When prompted, do not select optional channels 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 SUSE Multi-Linux Manager extension.

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

    You should see:

    • PRETTY_NAME="SUSE Linux Enterprise Server 15 SP7"

    • SUSE Multi-Linux Manager Proxy 5.1 Extension for SLE

  8. Verify SUSE Multi-Linux Manager tools version.

    mgrpxy --version

    Expected output:

    • mgrpxy version 5.1.11 or higher

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

    zypper install suse-multi-linux-manager-5.1-x86_64-proxy*
  10. Upgrade proxy containers and restart them.

    mgrpxy upgrade podman
    mgrpxy stop
    mgrpxy start
  11. 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 SUSE Multi-Linux Manager 5.1 Proxy packages and synchronized product channels.