Documentation survey

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
  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. Synchronize the new Proxy Products in SUSE Multi-Linux Manager Server. For more information, see ソフトウェア製品.

    Use the Web UI to synchronize:

    • SUSE Linux Micro 6.1

    • SUSE Multi-Linux Manager Proxy Extension 5.1

  4. Perform Proxy Product Migration. For more information, see 製品移行.

    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.

  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. Post-Reboot: Verify upgrade status

    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

  8. Verify SUSE Multi-Linux Manager Tools version

    mgrpxy --version

    Expected output:

    • mgrpxy version 5.1.11 or higher

      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. Install the new proxy container images as RPM packages with:

    transactional-update pkg install suse-multi-linux-manager-5.1-x86_64-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.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 tested 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 ソフトウェア製品.

    Using the Web UI, synchronize the following:

    • SUSE Linux Enterprise Server 15 SP7

    • SUSE Multi-Linux Manager Proxy Extension for SLE 5.1

      The Proxy Extensions are listed under Basesystem Module 15 SP7 > Containers Module 15 SP7

  4. Perform Proxy Product Migration. For more information, see 製品移行.

    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. Post-Reboot: Verify upgrade status

    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 with:

    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.