Documentation survey

프록시 마이그레이션

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

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 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 SUSE Multi-Linux Manager Server

    Use the Web UI to synchronize:

    • SL-Micro 6.1

    • SUSE Multi-Linux Manager 5.1 Proxy Extension

  4. Perform Proxy Product Migration

    Use the Web UI to migrate from:

    • SLE Micro 5.5 + SUSE Multi-Linux Manager Proxy 5.0 Extension to

    • SL Micro 6.1 + SUSE Multi-Linux Manager Proxy 5.1 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

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.

  1. Upgrade proxy containers:

    mgrpxy upgrade podman
  2. 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 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 SP7 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 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 SUSE Multi-Linux Manager Server

    Using the Web UI, synchronize the following:

    • SUSE Linux Enterprise Server 15 SP6

    • SUSE Multi-Linux Manager Proxy Extension 5.0

  4. Trigger the Product Migration via Web UI

    Navigate to the proxy system in the SUSE Multi-Linux Manager 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 SUSE Multi-Linux Manager 5.1 Proxy packages and synchronized product channels.