This SUSE product includes materials licensed to SUSE under the GNU General Public License (GPL). The GPL requires that SUSE makes available certain source code that corresponds to the GPL-licensed material. The source code is available for download.

For up to three years after SUSE’s distribution of the SUSE product, SUSE will mail a copy of the source code upon request. Requests should be sent by e-mail or as otherwise instructed here. SUSE may charge a fee to recover reasonable costs of distribution.

Version revision history

  • 31st July, 2025: 5.1 GA

About SUSE Multi-Linux Manager Proxy 5.1

SUSE Multi-Linux Manager Proxy offers mirroring proxy support tailored for large and distributed environments.

The Proxy operates transparently, appearing as a managed client to the SUSE Multi-Linux Manager Server and as a server to the managed clients.

Managed clients communicate exclusively with the Proxy, which then relays requests to the SUSE Multi-Linux Manager Server.

All software packages that pass through the SUSE Multi-Linux Manager Proxy are cached, allowing subsequent client requests for these packages to be resolved directly from the cache.

System requirements

The SUSE Multi-Linux Manager Proxy is available for x86_64 and aarch64 architectures.

It is advisable to have a minimum of 8 GB of RAM and approximately 50 GB of disk space per distribution or channel. Additional disk space should be considered for storing images for retail terminals.

For more details on system requirements, see the Installation Guide on https://documentation.suse.com/multi-linux-manager/5.1/

SUSE Multi-Linux Manager Proxy distribution

SUSE Multi-Linux Manager Server, Proxy, and Retail Branch Server will be packaged in containers, accessible through the SUSE Registry.

The SUSE Multi-Linux Manager Retail Branch Server and SUSE Multi-Linux Manager Proxy extensions are both built on top of SL Micro, equipped with the necessary tools to manage Retail Branch Server and Proxy, respectively.

Installation and setup

To install SUSE Multi-Linux Manager Proxy 5.1 on SL Micro 6.1 or SUSE Linux Enterprise 15 SP7, follow the steps for installing and configuring the proxy as described in the Installation Guide

Important

Only the containerized versions of SUSE Multi-Linux Manager Proxy and Retail Branch server will be available for SUSE Multi-Linux Manager 5.1.

Upgrade from previous version

In-place migration from SUSE Multi-Linux Manager Proxy 5.0 to 5.1 is supported, as long as the host operating system remains unchanged.

However, there is no direct migration path from SUSE Multi-Linux Manager Proxy 4.3 to 5.1. In this case, you will need to deploy a new Proxy and migrate your clients to it.

For detailed guidance on upgrading, please refer to the Upgrade Guide

Note
 A known issue related to this is documented under the Known issues section. Please refer to it for more details.

SUSE Multi-Linux Manager Server versions

SUSE Multi-Linux Manager Proxy 5.1 is compatible only with SUSE Multi-Linux Manager 5.1 Server.

However, SUSE Multi-Linux Manager Proxy 4.3 and 5.0 are forward compatible and can still function with SUSE Multi-Linux Manager 5.1 Server. So, there is no immediate need to migrate all proxies if it is not feasible.

The product is designed for optimal performance when used in a scenario where all components — SUSE Multi-Linux Manager Server, SUSE Multi-Linux Manager Proxy, and Retail Branch Server — are of the same version. It is generally advised to avoid using mixed versions long-term in production environments.

Major Changes Since SUSE Multi-Linux Manager Proxy 5.0

Salt 3006

SUSE Multi-Linux Manager 5.1, continues to use Salt 3006. It is considered by upstream to be a long-term support (LTS) version. Our plan is to upgrade to the next LTS version, which will be 3008 when available. Short-term support (STS) versions of salt are not supported for use with SUSE Multi-Linux Manager.

Throughout this process, all critical bug fixes, including CVEs, L3 fixes, and essential features needed for SUSE Multi-Linux Manager, will be provided.

Host system changed

SUSE Multi-Linux Manager 5.1 proxy will be an extension of SUSE Linux Micro 6.1 and SUSE Linux Enterprise 15 SP7. It will be delivered in containers only.

SL Micro subscription for the Server will now be included in the SUSE Multi-Linux Manager subscription, eliminating the need for customers to purchase the underlying OS subscription separately.

However, for SUSE Linux Enterprise 15 SP7, users will need to have a separate subscription.

Dropped features

None

Deprecated features

None

Known issues

Proxy Migration issue

During proxy migration from SUSE Multi-Linux Manager 5.0 to 5.1, an issue has been identified that will require user intervention. In some cases, the upgrade appears successful, but services fail to start. This is likely due to a mismatch in the /etc/uyuni/proxy/config.yaml file, where the expected server_version is set incorrectly.

The value should be 5.1.0, but it may instead be 5.0.5. User can confirm this by checking the logs via:

journalctl -u uyuni-proxy-httpd.service

or by reviewing the mgrpxy logs uyuni-proxy-httpd logs. Look for an error message such as:

CRITICAL:root:Proxy container image version (5.1.5) doesn't match server major version (5.0.)

To resolve this issue, manually edit the /etc/uyuni/proxy/config.yaml file and set

server_version: 5.1.0

Then proceed with the upgrade by running:

mgrpxy upgrade podman

After a successful upgrade, start the services manually using:

mgrpxy start

A permanent fix is in progress and will be included in an upcoming update.

Note
 Even if the migration is not successful, using SUSE Multi-Linux Manager 5.0 proxies with a SUSE Multi-Linux Manager 5.1 Server remains a supported configuration. These proxies are fully compatible with version 5.1 of the server.

Product Migration from SLE Micro 5.5 to SL Micro 6.1

A potential issue in SLE Micro 5.5 may prevent successful product migration to SL Micro 6.1 when using the Product Migration feature of SUSE Multi-Linux Manager. While the migration may succeed in some cases, failures have been observed due to a known bug. A permanent fix is in progress.

It is strongly recommended to create a full backup of the SLE Micro 5.5 minion disk before attempting the migration in this case. If the process fails, the backup will allow to restore the system and avoid any unwanted state.

Keep Informed

To stay connected regarding information about SUSE Multi-Linux Manager and SUSE products:

Providing feedback

If you encounter a bug in any SUSE product, please report it through your SUSE Customer Service or Sales representatives

Resources

Latest product documentation: https://documentation.suse.com/multi-linux-manager/5.1/

Technical product information for SUSE Multi-Linux Manager: https://www.suse.com/products/multi-linux-manager/

These release notes are available online: https://www.suse.com/releasenotes/

Visit https://www.suse.com for the latest Linux product news from SUSE.

Visit https://www.suse.com/source-code/ for additional information on the source code of SUSE Linux Enterprise products.

Legal Notices

SUSE Software Solutions Germany GmbH
Frankenstraße 146
D-90461 Nürnberg
Tel: +49 (0)911 740 53 - 0
Email: feedback@suse.com

SUSE makes no representations or warranties with regard to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, SUSE reserves the right to revise this publication and to make changes to its content, at any time, without the obligation to notify any person or entity of such revisions or changes.

Further, SUSE makes no representations or warranties with regard to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, SUSE reserves the right to make changes to any and all parts of SUSE software, at any time, without any obligation to notify any person or entity of such changes.

Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classifications to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical/biological weaponry end uses. Please refer to the SUSE Legal information page for more information on exporting SUSE software. SUSE assumes no responsibility for your failure to obtain any necessary export approvals.

Copyright © 2012-2025 SUSE LLC.

This release notes document is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License (CC-BY-ND-4.0). You should have received a copy of the license along with this document. If not, see https://creativecommons.org/licenses/by-nd/4.0/.

SUSE has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at https://www.suse.com/company/legal/ and one or more additional patents or pending patent applications in the U.S. and other countries.

For SUSE trademarks, see SUSE Trademark and Service Mark list (https://www.suse.com/company/legal/). All third-party trademarks are the property of their respective owners.

Colophon

Thank you for using SUSE Multi-Linux Manager Proxy and/or SUSE Multi-Linux Manager Retail Branch Server in your business.

Your SUSE Multi-Linux Manager Team.