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
Verify System and Uyuni Tools version.
cat /etc/os-release mgrpxy --versionConfirm:
Operating System:
SLE Micro 5.5Tools version:
mgrpxy version 0.1.29or higherCheck running containers.
podman psEnsure the following containers are running:
proxy-squid
proxy-ssh
proxy-httpd
proxy-tftpd
proxy-salt-brokerSynchronize 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.04Perform proxy product migration. For more information, see Product Migration.
Navigate to the proxy system and select > .
Migrate from
SLE Micro 5.5+SUSE Manager Proxy 5.0 Extensionto
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.
Monitor the migration action.
You can follow the process under tab in the Web UI.
After the upgrade completes, stop the proxy container and then reboot the system.
reboot mgrpxy stopPerform post-reboot checks.
Verify upgraded OS and Uyuni extension:
cat /etc/os-release SUSEConnect --status-textVerify Uyuni tools version.
mgrpxy --versionExpected output:
mgrpxy version 5.2or higherEnable 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 yesRestart the service:
systemctl restart sshdFor more information, see Remote root login on SL Micro.
Install the new proxy container images as RPM packages.
transactional-update pkg install suse-multi-linux-manager-5.2-<arch>-proxy*Reboot the Proxy.
Upgrade proxy containers and restart them.
mgrpxy upgrade podman mgrpxy stop mgrpxy startConfirm proxy containers are operational.
podman psAll 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
Verify operating system and Uyuni tools version.
cat /etc/os-release mgrpxy --versionConfirm:
Operating System:
SUSE Linux Enterprise Server 15 SP6Tools version:
mgrpxy version 0.1.29or higherList running proxy containers.
podman psEnsure the following containers are running:
proxy-salt-broker
proxy-httpd
proxy-squid
proxy-tftpd
proxy-sshSynchronize 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.04Perform proxy product migration.
For more information, see Product Migration.
Navigate to the proxy system and select > .
Migrate from:
SUSE Linux Enterprise Server 15 SP6+SUSE Manager Proxy 5.0 Extensionto:
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.
Monitor the migration action.
You can follow the process under in the Web UI.
After the upgrade completes, stop the proxy container and then reboot the system.
mgrpxy stop rebootPerform post-reboot checks.
Verify the OS and Uyuni extension version:
cat /etc/os-release SUSEConnect --status-textVerify Uyuni tools version.
mgrpxy --versionExpected output:
mgrpxy version 5.2or higherInstall the new proxy container images as RPM packages.
zypper install suse-multi-linux-manager-5.2-<arch>-proxy*Reboot the Proxy.
Upgrade proxy containers and restart them.
mgrpxy upgrade podman mgrpxy stop mgrpxy startConfirm proxy containers are operational.
podman psAll 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.