Proxy Upgrade from 5.1 to 5.2
1. 简介
This document provides the tested and validated procedures for migrating 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.1.
涵盖的升级场景包括:
-
Migrating from SL Micro 6.1 to SL Micro 6.2
-
Updating SLES 15 SP7 with the new SUSE Multi-Linux Manager Proxy Extension 5.2
-
Upgrading the SUSE Multi-Linux Manager Proxy Extension from version 5.1 to version 5.2
|
Before migrating the proxy, it is required to first migrate the SUSE Multi-Linux Manager 5.1 Server to SUSE Multi-Linux Manager 5.2. |
2. SL Micro 6.1 to SL Micro 6.2
This section provides the tested procedure to upgrade a SL Micro 6.1 host deployed with SUSE Multi-Linux Manager 5.1 Proxy to SL Micro 6.2 with SUSE Multi-Linux Manager 5.2 Proxy.
2.1. 先决条件
-
SUSE Multi-Linux Manager 5.1 Proxy is installed and running on SL Micro 6.1.
-
已在 SUSE Multi-Linux Manager 服务器中注册代理系统。
2.2. 发行套件升级和代理迁移
校验系统和 SUSE Multi-Linux Manager 工具版本。
cat /etc/os-release mgrpxy --version确认以下信息:
Operating System:
SL Micro 6.1Tools version:
mgrpxy version 5.1.xor higher检查正在运行的容器。
podman ps确保以下容器正在运行:
proxy-squid
proxy-ssh
proxy-httpd
proxy-tftpd
proxy-salt-broker在 SUSE Multi-Linux Manager 服务器中同步新代理产品。有关详细信息,请参见 软件产品。
使用 Web UI 进行同步:
SL Micro 6.2
SUSE Multi-Linux Manager Proxy Extension 5.2执行代理产品迁移。有关详细信息,请参见 产品迁移。
导航至代理系统,选择 > 。
将
SL Micro 6.1+SUSE Multi-Linux Manager Proxy 5.1 Extension迁移到
SL Micro 6.2+SUSE Multi-Linux Manager Proxy Extension 5.2
出现提示时,请勿选择可选通道,除非您已确认必须使用这些通道。
建议在执行实际迁移前先进行试运行。
监控迁移操作。
您可在 Web UI 的选项卡中查看流程进度。
After the upgrade completes, stop the proxy container and then reboot the system.
mgrpxy stop reboot执行重引导后的检查。
校验升级后的操作系统和 SUSE Multi-Linux Manager 扩展:
cat /etc/os-release SUSEConnect --status-text校验 SUSE Multi-Linux Manager 工具版本。
mgrpxy --version预期输出:
mgrpxy version 5.2.0or higherInstall the new proxy container images as RPM packages if they are not pulled from the registry.
transactional-update pkg install suse-multi-linux-manager-5.2-<arch>-proxy*重引导代理。
升级代理容器并重启。
mgrpxy upgrade podman mgrpxy stop mgrpxy startFor air-gapped installations, first upgrade the container RPM packages, then run the
mgrpxy upgrade podmancommand.或者,可使用以下命令更新 Kubernetes 群集上运行的容器:
mgrpxy upgrade kubernetes清理未使用的容器映像以释放磁盘空间:
podman image prune -a
In some upgrades, multiple
*.rpmnewand*.rpmsavefiles may be generated. The presence or number of these files does not indicate that manual action is required. In SUSE Multi-Linux Manager container environments, required configuration changes are applied automatically during the upgrade process. These files are created as a result of differences between packaged defaults and existing configuration files, and may also include internal or informational changes that are not intended to be merged. If manual action is required for a configuration change, it will be explicitly documented in the release notes or upgrade documentation.Do not treat these files as a post-upgrade checklist or merge them in bulk. Only review a file if you are actively troubleshooting a specific issue and understand the impact of the configuration it contains. If a change is required, it should be applied intentionally based on a known requirement, not by copying differences from these files. If you are unsure, leave the file unchanged.
确认代理容器可正常运行。
podman ps所有预期的代理容器均应正常启动并运行:
proxy-salt-broker
proxy-httpd
proxy-squid
proxy-tftpd
proxy-ssh
|
升级到特定版本
如果未指定标记参数,则默认会升级到最新版本。要升级到特定版本,请为标记参数提供所需的映像标记。 |
|
虽然可以使用特定标记升级特定容器,但此功能仅用于应用 PTF。 在正常情况下,我们强烈建议为所有代理容器使用相同的标记,以确保配置一致性。 |
2.3. 迁移完成
The proxy host system is now running SL Micro 6.2 with updated SUSE Multi-Linux Manager 5.2 Proxy packages and synchronized product channels.
3. SUSE Linux Enterprise Server 15 SP7
This section provides the procedure to update a SUSE Linux Enterprise Server 15 SP7 host deployed with SUSE Multi-Linux Manager 5.1 Proxy to SUSE Multi-Linux Manager 5.2 Proxy.
3.1. 先决条件
-
SUSE Multi-Linux Manager Proxy 5.1 is installed and running on SUSE Linux Enterprise Server 15 SP7.
-
已在 SUSE Multi-Linux Manager 服务器中注册代理系统。
3.2. Proxy component update
校验操作系统和 SUSE Multi-Linux Manager 工具版本。
cat /etc/os-release mgrpxy --version确认以下信息:
Operating System:
SUSE Linux Enterprise Server 15 SP7Tools version:
mgrpxy version 5.1.xor higher列出正在运行的代理容器。
podman ps确保以下容器正在运行:
proxy-salt-broker
proxy-httpd
proxy-squid
proxy-tftpd
proxy-sshSynchronize the new Products in SUSE Multi-Linux Manager Server using the Web UI.
For more information, see 软件产品.
Synchronize:
SUSE Multi-Linux Manager Proxy Extension 5.2Perform proxy product migration.
For more information, see 产品迁移.
导航至代理系统,选择 > 。
Migrate from:
SUSE Linux Enterprise Server 15 SP7+SUSE Multi-Linux Manager Proxy 5.1 Extensionto:
SUSE Linux Enterprise Server 15 SP7+SUSE Multi-Linux Manager Proxy Extension 5.2
出现提示时,请勿选择可选通道,除非您已确认必须使用这些通道。
建议在执行实际迁移前先进行试运行。
监控迁移操作。
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 reboot执行重引导后的检查。
Verify the OS and SUSE Multi-Linux Manager extension version:
cat /etc/os-release SUSEConnect --status-text校验 SUSE Multi-Linux Manager 工具版本。
mgrpxy --version预期输出:
mgrpxy version 5.2.0or higherInstall the new proxy container images as RPM packages if they are not pulled from the registry.
zypper install suse-multi-linux-manager-5.2-<arch>-proxy*重引导代理。
升级代理容器并重启。
mgrpxy upgrade podman mgrpxy stop mgrpxy startFor air-gapped installations, first upgrade the container RPM packages, then run the
mgrpxy upgrade podmancommand.或者,可使用以下命令更新 Kubernetes 群集上运行的容器:
mgrpxy upgrade kubernetes清理未使用的容器映像以释放磁盘空间:
podman image prune -a
In some upgrades, multiple
*.rpmnewand*.rpmsavefiles may be generated. The presence or number of these files does not indicate that manual action is required. In SUSE Multi-Linux Manager container environments, required configuration changes are applied automatically during the upgrade process. These files are created as a result of differences between packaged defaults and existing configuration files, and may also include internal or informational changes that are not intended to be merged. If manual action is required for a configuration change, it will be explicitly documented in the release notes or upgrade documentation.Do not treat these files as a post-upgrade checklist or merge them in bulk. Only review a file if you are actively troubleshooting a specific issue and understand the impact of the configuration it contains. If a change is required, it should be applied intentionally based on a known requirement, not by copying differences from these files. If you are unsure, leave the file unchanged.
确认代理容器可正常运行。
podman ps所有预期的代理容器均应正常启动并运行:
proxy-salt-broker
proxy-httpd
proxy-squid
proxy-tftpd
proxy-ssh
|
升级到特定版本
如果未指定标记参数,则默认会升级到最新版本。要升级到特定版本,请为标记参数提供所需的映像标记。 |
|
虽然可以使用特定标记升级特定容器,但此功能仅用于应用 PTF。 在正常情况下,我们强烈建议为所有代理容器使用相同的标记,以确保配置一致性。 |
3.3. 迁移完成
代理主机系统现已运行 SUSE Linux Enterprise Server 15 SP7,且配备了更新后的 SUSE Multi-Linux Manager 5.2 代理软件包及已同步的产品通道。