Distribution Upgrade and Server Migration from 5.1 to 5.2

  • SUSE Multi-Linux Manager 5.1 must be stopped before the upgrade.

经过安全加固的 SUSE Multi-Linux Manager 服务器主机可能会限制从 /tmp 文件夹执行文件。在这种情况下，可通过以下临时解决方案规避：在运行 mgradm前，将 TMPDIR 环境变量导出至其他现有路径。

例如：

export TMPDIR=/path/to/other/tmp

在 SUSE Multi-Linux Manager 的后续更新中，相关工具将进行优化，届时无需再使用此临时解决方案。

后续流程需要 SSL 证书。如果不使用自我签名的 CA 和证书，请在开始前准备好以下内容：

  • 证书颁发机构 (CA) SSL 公共证书。如果您使用 CA 链，则所有中间 CA 也必须可用。

  • SSL 数据库私用密钥。

  • SSL 数据库证书。

所有文件必须采用 PEM 格式。

SSL 服务器证书的主机名必须与部署证书的计算机的完全限定主机名匹配。您可以在证书的 X509v3 Subject Alternative Name 部分中设置主机名，也可以根据环境的需要列出多个主机名。支持的密钥类型为 RSA 和 EC（椭圆曲线）。

数据库 SSL 证书的 Subject Alternative Name 必须是 reportdb、db 及用于访问报告数据库的 FQDN。

During a migration the server SSL certificate and CA chain are copied from the source server, meaning that only the database certificates are required.

1. SL Micro 6.1 to SL Micro 6.2

This document provides the tested procedure to upgrade a SL Micro 6.1 host deployed with SUSE Multi-Linux Manager 5.1 Server to SL Micro 6.2 and migrate to SUSE Multi-Linux Manager 5.2 Beta 1.

1.1. 先决条件

  • SUSE Multi-Linux Manager 5.1 is installed and running on SL Micro 6.1.

  • 系统已注册到 SCC 且拥有有效的订阅。

1.2. 发行套件升级和服务器迁移

Procedure: Migration from SUSE Multi-Linux Manager 5.1 to SUSE Multi-Linux Manager 5.2 Beta 1

  1. 校验当前产品状态。

    SUSEConnect --status-text

    确认以下信息：

    • Base OS: SL Micro 6.1

    • Extension: SUSE Multi-Linux Manager Server 5.1 Extension

  2. 确保系统已更新。

    transactional-update patch

    • 如果已应用补丁，请在继续迁移前停止服务器，然后重引导系统：

      mgradm stop
reboot

    • 如果未发现更新，可直接进入迁移步骤。

  3. 启动迁移流程。

    transactional-update migration --auto-agree-with-licenses --gpg-auto-import-keys

    Follow the prompts and select the available migration to SUSE Linux Micro 6.2 and SUSE Multi-Linux Manager Server Extension 5.2 Beta 1.

  4. 停止服务器后重引导，使更改生效。

    mgradm stop
reboot

  5. 执行重引导后的检查。

    Verify SUSE Multi-Linux Manager extension and SUSE Multi-Linux Manager version:

    SUSEConnect --status-text
mgradm --version

    预期输出：

    • Extension: SUSE Multi-Linux Manager Server 5.2 Beta 1 Extension

    • Version: mgradm version 5.2.0 or higher

  6. Verify PostgreSQL database version.

    podman ps

    预期输出：

    • server:5.2.0 or higher

    • server-postgresql:5.2.0 or higher

  7. Verify running containers:

    podman ps

    You should see all the expected server containers are up and running.

1.3. 迁移完成

The server host system is now running SL Micro 6.2 with updated SUSE Multi-Linux Manager 5.2 Beta 1 Server packages.

If you have a SUSE Multi-Linux Manager 5.1 proxy connected to this server, proceed to the Proxy Migration 5.1 > 5.2 guide to upgrade the proxy host.

Validate your setup before resuming production operations.

1.4. 数据库备份卷

通过 mgradm migration 或 mgradm upgrade 执行服务器迁移或升级时，会创建一个包含数据库备份的卷。

当 PostgreSQL 数据库有更新的版本时，必须在执行升级流程前将旧数据库存储到单独的位置。为此，mgradm 会动态创建卷 var-pgsql-backup。当迁移或升级完成且用户已验证新系统可按预期正常运行后，可安全去除该卷。

2. SUSE Linux Enterprise Server 15 SP7

This document provides the procedure to upgrade a SUSE Linux Enterprise Server 15 SP7 host deployed with SUSE Multi-Linux Manager 5.1 Server to SUSE Multi-Linux Manager 5.2 Beta 1.

2.1. 先决条件

  • SUSE Multi-Linux Manager 5.1 is installed and running on SUSE Linux Enterprise Server 15 SP7.

  • 系统已注册到 SCC 且拥有有效的订阅。

2.2. Server package update and migration

Procedure: Update SUSE Multi-Linux Manager components on SUSE Linux Enterprise Server 15 SP7

  1. 校验当前产品状态。

    SUSEConnect --status-text

    确认以下信息：

    • Base OS: SUSE Linux Enterprise Server 15 SP7

    • Extension: SUSE Multi-Linux Manager Server 5.1 Extension

  2. 确保系统已更新。

    zypper patch

    If patches were applied, stop the server and then reboot before proceeding:

    mgradm stop
reboot

  3. Perform the migration to SUSE Multi-Linux Manager 5.2 Beta 1.

    zypper migration

    Select to migrate to:

    • SUSE Multi-Linux Manager Server Extension 5.2 Beta 1

  4. Stop the server and reboot.

    mgradm stop
reboot

  5. 执行重引导后的检查。

    Verify SUSE Multi-Linux Manager extension:

    SUSEConnect --status-text

    预期输出：

    • Extension: SUSE Multi-Linux Manager Server 5.2 Beta 1 Extension

  6. Verify SUSE Multi-Linux Manager version.

    mgradm --version

    预期输出：

    • Version: mgradm version 5.2.0 or higher

  7. Verify containers:

    podman ps

    预期输出：

    • server:5.2.0 or higher

    • server-postgresql:5.2.0 or higher

2.3. 迁移完成

The server host system is now running SUSE Linux Enterprise Server 15 SP7 with updated SUSE Multi-Linux Manager 5.2 Beta 1 Server packages.

If you have a SUSE Multi-Linux Manager 5.1 proxy connected to this server, proceed to the Proxy Migration 5.1 > 5.2 guide to upgrade the proxy host.

Validate your setup before resuming production operations.

2.4. 数据库备份卷

通过 mgradm migration 或 mgradm upgrade 执行服务器迁移或升级时，会创建一个包含数据库备份的卷。

当 PostgreSQL 数据库有更新的版本时，必须在执行升级流程前将旧数据库存储到单独的位置。为此，mgradm 会动态创建卷 var-pgsql-backup。当迁移或升级完成且用户已验证新系统可按预期正常运行后，可安全去除该卷。