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. ディストリビューションのアップグレードとプロキシの移行

Procedure: Migrate SUSE Multi-Linux Manager 5.1 Proxy to SUSE Multi-Linux Manager 5.2 Proxy
  1. システムとSUSE Multi-Linux Managerツールのバージョンを確認します。

    cat /etc/os-release
    mgrpxy --version

    確認:

    • Operating System: SL Micro 6.1

    • Tools version: mgrpxy version 5.1.x or higher

  2. 実行中のコンテナを確認します。

    podman ps

    以下のコンテナが実行されていることを確認します。

    • proxy-squid

    • proxy-ssh

    • proxy-httpd

    • proxy-tftpd

    • proxy-salt-broker

  3. SUSE Multi-Linux Managerサーバの新しいプロキシ製品を同期します。 詳細については、ソフトウェア製品を参照してください。

    Web UIを使用して同期します。

    • SL Micro 6.2

    • SUSE Multi-Linux Manager Proxy Extension 5.2

  4. プロキシ製品の移行を実行します。 詳細については、製品移行を参照してください。

    プロキシシステムに移動し、システム  概要 > ソフトウェア  製品移行を選択します。

    移行元

    • SL Micro 6.1 + SUSE Multi-Linux Manager Proxy 5.1 Extension

      移行先

    • SL Micro 6.2 + SUSE Multi-Linux Manager Proxy Extension 5.2

      必要であることが確認されていない限り、プロンプトが表示されたときにオプションのチャンネルを選択しないでください

      実際の移行を実行する前に、まず予行演習を実行することをお勧めします。

  5. 移行アクションを監視します。

    Web UIのシステム  詳細  イベントタブでプロセスを追跡できます。

  6. After the upgrade completes, stop the proxy container and then reboot the system.

    mgrpxy stop
    reboot
  7. 再起動後のチェックを実行します。

    アップグレードされたOSとSUSE Multi-Linux Manager拡張機能を確認します。

    cat /etc/os-release
    SUSEConnect --status-text
  8. SUSE Multi-Linux Managerツールのバージョンを確認します。

    mgrpxy --version

    予想される出力:

    • mgrpxy version 5.2.0 or higher

  9. Install 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*
  10. プロキシを再起動します。

  11. プロキシコンテナをアップグレードして再起動します。

    mgrpxy upgrade podman
    mgrpxy stop
    mgrpxy start

    For air-gapped installations, first upgrade the container RPM packages, then run the mgrpxy upgrade podman command.

    または、Kubernetesクラスタ上で実行されるプロキシコンテナは、次のコマンドを使用して更新できます。

    mgrpxy upgrade kubernetes
  12. 未使用のコンテナイメージをクリーンアップし、ディスク容量を解放します。

    podman image prune -a

    In some upgrades, multiple *.rpmnew and *.rpmsave files 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.

  13. プロキシコンテナが動作していることを確認します。

    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

Procedure: Update SUSE Multi-Linux Manager Proxy components on SUSE Linux Enterprise Server 15 SP7
  1. オペレーティングシステムとSUSE Multi-Linux Managerツールのバージョンを確認します。

    cat /etc/os-release
    mgrpxy --version

    確認:

    • Operating System: SUSE Linux Enterprise Server 15 SP7

    • Tools version: mgrpxy version 5.1.x or higher

  2. 実行中のプロキシコンテナを一覧表示します。

    podman ps

    以下のコンテナが実行されていることを確認します。

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

  3. Synchronize 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.2

  4. Perform proxy product migration.

    For more information, see 製品移行.

    プロキシシステムに移動し、システム  概要 > ソフトウェア  製品移行を選択します。

    Migrate from:

    • SUSE Linux Enterprise Server 15 SP7 + SUSE Multi-Linux Manager Proxy 5.1 Extension

      to:

    • SUSE Linux Enterprise Server 15 SP7 + SUSE Multi-Linux Manager Proxy Extension 5.2

      必要であることが確認されていない限り、プロンプトが表示されたときにオプションのチャンネルを選択しないでください

      実際の移行を実行する前に、まず予行演習を実行することをお勧めします。

  5. 移行アクションを監視します。

    You can follow the process under Systems  Details  Events in the Web UI.

  6. After the upgrade completes, stop the proxy container and then reboot the system.

    mgrpxy stop
    reboot
  7. 再起動後のチェックを実行します。

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

    cat /etc/os-release
    SUSEConnect --status-text
  8. SUSE Multi-Linux Managerツールのバージョンを確認します。

    mgrpxy --version

    予想される出力:

    • mgrpxy version 5.2.0 or higher

  9. Install 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*
  10. プロキシを再起動します。

  11. プロキシコンテナをアップグレードして再起動します。

    mgrpxy upgrade podman
    mgrpxy stop
    mgrpxy start

    For air-gapped installations, first upgrade the container RPM packages, then run the mgrpxy upgrade podman command.

    または、Kubernetesクラスタ上で実行されるプロキシコンテナは、次のコマンドを使用して更新できます。

    mgrpxy upgrade kubernetes
  12. 未使用のコンテナイメージをクリーンアップし、ディスク容量を解放します。

    podman image prune -a

    In some upgrades, multiple *.rpmnew and *.rpmsave files 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.

  13. プロキシコンテナが動作していることを確認します。

    podman ps

    すべての予期されるプロキシコンテナが稼働中である必要があります。

    • proxy-salt-broker

    • proxy-httpd

    • proxy-squid

    • proxy-tftpd

    • proxy-ssh

特定のバージョンへのアップグレード

タグパラメータを指定しない場合、デフォルトで最新バージョンにアップグレードされます。特定のバージョンにアップグレードするには、タグパラメータと目的のイメージタグを指定します。

特定のタグを使用して特定のコンテナをアップグレードするオプションはありますが、この機能はPTFの適用のみを意図しています。

通常の状況下では、すべてのプロキシコンテナに同じタグを使用して一貫性を確保することを強くお勧めします。

3.3. 移行の完了

プロキシホストシステムは現在、更新された SUSE Multi-Linux Manager 5.2プロキシパッケージと、同期された製品チャンネルを備えたSUSE Linux Enterprise Server 15 SP7を実行しています。