Distribution Upgrade and Server Migration from 5.0 to 5.2

  • 升级前必须停止 SUSE Multi-Linux Manager 5.0。

经过安全加固的 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。

迁移过程中，会从源服务器复制服务器 SSL 证书和 CA 链，这意味着您只需准备数据库证书即可

SUSE Multi-Linux Manager 5.0 peripheral servers are always using third-party SSL certificates. If the hub server has generated the certificates for the peripheral server, it needs to generate the certificate for the peripheral database too.

On the hub server, run the following command for each of the peripheral server to migrate.

mgrctl exec -ti -- rhn-ssl-tool --gen-server --dir="/root/ssl-build" --set-country="COUNTRY" \
  --set-state="STATE" --set-city="CITY" --set-org="ORGANIZATION" \
  --set-org-unit="ORGANIZATION UNIT" --set-email="name@example.com" \
  --set-hostname=<hostname>-reportdb --set-cname="example.com" --set-cname=db --set-cname=reportdb

要使用的文件位于服务器容器内，需要复制到新的外围服务器主机上：

  1. /root/ssl-build/RHN-ORG-TRUSTED-SSL-CERT（作为根 CA 证书）

  2. /root/ssl-build/<hostname>-reportdb/server.crt as the db certificate and

  3. /root/ssl-build/<hostname>-reportdb/server.key as the db certificate’s key.

1. SLE Micro 5.5 to SL Micro 6.2

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

1.1. 先决条件

  • SUSE Multi-Linux Manager 5.0 已在 SLE Micro 5.5 上安装并运行。

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

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

过程：从 SUSE Multi-Linux Manager 5.0 迁移到 SUSE Multi-Linux Manager 5.2 Beta 1

  1. 校验当前产品状态。

    SUSEConnect --status-text

    确认以下信息：

    • 基础操作系统：SUSE Linux Enterprise Micro 5.5

    • 扩展：SUSE Manager Server 5.0 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: referencing 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.0 proxy connected to this server, proceed to the Proxy Migration 5.0 > 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 SP6 升级到 15 SP7

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

2.1. 先决条件

  • SUSE Multi-Linux Manager 5.0 is installed and running on SUSE Linux Enterprise Server 15 SP6.

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

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

Procedure: Upgrade and Migrate SUSE Multi-Linux Manager on SUSE Linux Enterprise Server 15 SP6

  1. 校验当前产品状态。

    SUSEConnect --status-text

    确认以下信息：

    • Base OS: SUSE Linux Enterprise Server 15 SP6

    • 扩展：SUSE Manager Server 5.0 Extension

  2. 确保系统已更新。

    zypper patch

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

    mgradm stop
reboot

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

    zypper migration

    Select to migrate to:

    • SUSE Linux Enterprise Server 15 SP7

    • 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: referencing 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.0 proxy connected to this server, proceed to the Proxy Migration 5.0 > 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。当迁移或升级完成且用户已验证新系统可按预期正常运行后，可安全去除该卷。