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 5.1

SUSE Multi-Linux Manager 5.1, the latest release from SUSE Multi-Linux Manager based on the Uyuni Project, delivers a best-in-class open source infrastructure management and automation solution that is designed to seamlessly manage and automate your infrastructure. It helps lower costs, reduce complexity, and enhance availability across Edge, Cloud, and Datacenter environments.

As an integral part of modern software-defined infrastructure, SUSE Multi-Linux Manager 5.1 brings forth the following new or improved capabilities to your Edge, Cloud, and Datacenter environments.

Containerization

SUSE Multi-Linux Manager 5.1 server is built upon the containerized foundation introduced in version 5.0, further enhancing modularity, flexibility, and scalability. This release refines deployment and management processes, improving performance, resilience, and ease of use.

With optimizations in containerized infrastructure and additional refinements, SUSE Multi-Linux Manager 5.1 continues the journey toward a more adaptable and efficient management solution for modern enterprise environments.

Role-Based Access Control (RBAC) Implementation

SUSE Multi-Linux Manager now supports Role-Based Access Control (RBAC) to provide users with fine-grained access control and configuration options. This enhancement centralizes access control rules, making them easier to manage and adapt. The implementation is designed to be flexible, allowing new use cases and rules to be defined through configuration rather than code changes. The SUSE Multi-Linux Manager Server will include sensible default policies while also enabling users to create custom access policies (user access groups) to suit their specific requirements.

Online Synchronization for Hub and Peripheral Servers

SUSE Multi-Linux Manager 5.1 introduces a new online synchronization mechanism between the Hub and peripheral servers, providing a more user-friendly and automated approach to content synchronization. This enhancement leverages existing stable mechanisms to deliver a robust and efficient solution. With the Hub architecture, centralized content management is now seamlessly extended to peripheral servers.

Additionally, the scope of ISSv2 has been refined to focus exclusively on offline synchronization, ensuring a clearer and more streamlined functionality.

Ansible Integration Enhancements

SUSE Multi-Linux Manager 5.1 has enhanced its integration with Ansible to provide users with greater flexibility and control over their workflows. These improvements streamline the scheduling, management, and monitoring of Ansible playbooks within the platform. These updates are designed to make Ansible management more efficient, user-friendly, and seamless within SUSE Multi-Linux Manager.

Expanded operating system support

With the release of SUSE Multi-Linux Manager 5.1, the platform now extends support to SUSE Linux Micro 6.1, SUSE Linux Enterprise 15 SP7 family, Amazon Linux 2023, Raspberry Pi OS (Tech Preview), and OpenEuler (Tech Preview). This expansion enables centralized management of multiple Enterprise Linux distributions, regardless of their location.

SUSE Multi-Linux Manager now offers comprehensive management capabilities for a wide range of distributions, including SUSE Linux Enterprise Server, SUSE Linux Enterprise Server for SAP Applications, SUSE Linux Enterprise Server Micro, Red Hat Enterprise Linux, openSUSE, SUSE Liberty Linux, Oracle Linux, AlmaLinux, Rocky Linux, Ubuntu, Debian, and Amazon Linux.

Health Check Tool

SUSE Multi-Linux Manager 5.1 comes with a standalone Health Check tool. This tool provides a detailed dashboard, metrics, and logs from the server, showcasing its current health status based on the support-config. Users can efficiently evaluate the health of their running instance and identify any potential errors for effective troubleshooting.

Installation and Upgrade

Requirements

SUSE Multi-Linux Manager 5.1 will not be a base product, similar to version 5.0. Instead, it will be an extension for SUSE Linux Micro 6.1 and SUSE Linux Enterprise 15 SP7, available through the SUSE Customer Center. This extension will include all the necessary tools to install and manage SUSE Multi-Linux Manager.

SUSE Multi-Linux Manager 5.1 Server will be supported on x86_64, s390x, IBM POWER (ppc64le), and ARM64 (AArch64) architectures.

SUSE Multi-Linux Manager Server, Proxy, and Retail Branch Server will be delivered as containers, accessible via the SUSE Registry.

SUSE Linux Enterprise as Host OS requires an additional subscriptions, while SUSE Linux Micro is included.

Additionally, VM images based on SUSE Linux Micro are provided for simplified setup, featuring preloaded configurations for easy customization.

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

Important

SUSE Linux Micro 6.1 and and SUSE Linux Enterprise 15 SP7 have been chosen as the supported host OS for SUSE Multi-Linux Manager 5.1 and will remain so throughout SUSE Multi-Linux Manager 5.1 lifecycle. Please do not upgrade the host OS where SUSE Multi-Linux Manager 5.1 is running to a newer version unless explicitly instructed otherwise.

Important

In SUSE Multi-Linux Manager 5.1, Netavark is the only supported network management tool for containerized environments. If it does not meet your requirements and you prefer an alternative, please contact our support team for evaluation.

Important

A full database volume can cause significant issues with system operation. As disk usage notifications have not yet been adapted for containerized environments, users are encouraged to monitor the disk space used by Podman volumes themselves, either through tools such as Grafana, Prometheus, or any other preferred method. Pay particular attention to the var-pgsql volume, located under /var/lib/containers/storage/volumes/.

Note

An external database is currently unsupported, despite the option appearing under the mgradm tool’s help section.

Upgrade from previous version of SUSE Multi-Linux Manager Server

In-place upgrade from SUSE Multi-Linux Manager Server 5.0 is supported, if the host operating system remains the same.

However, an in-place upgrade from SUSE Multi-Linux Manager Server 4.3 is not supported.

SUSE Multi-Linux Manager Server 5.1 includes tools designed to simplify the migration process.

Important

After successfully running the mgradm migrate command for migration from 4.3 to 5.1, the Salt setup on all minions will still point to the old server. To redirect them to the new server (destination server), it is required to rename the new server at the infrastructure level (DHCP and DNS) to use the same Fully Qualified Domain Name and IP address as old server (source server).

Adjusting the IP address can be avoided if the latest version of the minion is installed on the clients, as the newer version can automatically re-connect with the server using only the FQDN.

Once the migration is complete, all connected clients will seamlessly continue to run without any changes.

For detailed instructions on upgrading, please refer to the Upgrade Guide available at https://documentation.suse.com/multi-linux-manager/5.1/

Note

When migrating from SUSE Manager 4.3, you will be prompted for the Password for the CA key to generate. It is essential to enter the same CA password that was used in your SUSE Manager 4.3 installation.

Entering the wrong password will result in a failure to generate the database certificate and will cause the migration to abort with the following error:

Error: cannot configure db container: Cannot generate database certificate: CA validation failed!

Make sure the correct CA password is available before starting the migration process.

Upgrading with SUSE Multi-Linux Manager Proxy

Although SUSE Multi-Linux Manager Server 5.1 works with SUSE Multi-Linux Manager Proxy 4.3/5.0 and SUSE Multi-Linux Manager Retail Branch Server 4.3/5.0, we highly recommend upgrading your Proxy and Retail Branch Server when 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’s generally advised to avoid using mixed versions long-term in production environments.

When upgrading, upgrade the SUSE Multi-Linux Manager Server first, followed by the SUSE Multi-Linux Manager Proxy and Retail Branch Servers.

For instructions on upgrading when SUSE Multi-Linux Manager Proxy or SUSE Multi-Linux Manager Retail Branch Servers are in use, see the Upgrade Guide on https://documentation.suse.com/multi-linux-manager/5.1/.

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.

Major changes since SUSE Multi-Linux Manager Server 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.

As part of this commitment, the following CVE fixes have been included:

Important

These CVEs affect both the Salt master and the minions. Some of these vulnerabilities are very critical and could pose significant security risks if not addressed. User must upgrade both the Salt master and the minions to ensure their environment is protected.

As always, the Salt master must be upgraded before upgrading the minions. This is especially important in this case to prevent exceptions or errors on the minions if the master has not been updated first.

Base system changed

SUSE Multi-Linux Manager 5.1 is delivered as a containers, built on the bci-init image, which is based on SLES 15 SP7.

With version 5.1, SUSE Multi-Linux Manager moves to SUSE Linux Micro 6.1 and SUSE Linux Enterprise 15 SP7 as its supported container host systems. The SL Micro subscription for the host server is included with the SUSE Multi-Linux Manager subscription. However, for SUSE Linux Enterprise 15 SP7, users will need to have a separate subscription.

New Operating System Support

SUSE Multi-Linux Manager 5.1 extends the list of operating systems that can be managed by introducing support for the following:

  • SUSE Linux Enterprise 15 SP7 family

  • Amazon Linux 2023

  • openEuler 24.03 (Tech Preview)

  • Raspberry Pi OS (Tech Preview)

This broadens the range of systems that can be managed, offering more flexibility for diverse environments.

New Client Tools

SUSE Multi-Linux Manager 5.1 introduces a rebranded set of client tools for all supported operating systems. This transition is seamless, and users performing a new product synchronization should only notice the updated channel names.

Channels named SUSE Manager Client Tools for XYZ, used by clients previously registered with SUSE Manager 4.3 or 5.0, are no longer available in version 5.1 and will no longer receive updates in 5.1.

Although the legacy channels remain assigned to existing clients after migration, the corresponding repositories have been removed.

To ensure continued updates, users must:

  • Mirror the new SUSE Multi-Linux Manager Client Tools for XYZ channels for the relevant products and assign them to the appropriate clients.

  • Unassign the outdated SUSE Manager Client Tools for XYZ channels.

This also means that any CLM projects based on the old client tools must be adjusted accordingly.

Hub Online synchronisation

SUSE Multi-Linux Manager 5.1 introduces a new online synchronization mechanism between the Hub and peripheral servers, providing a more user-friendly and automated approach to content synchronization. This enhancement leverages existing stable mechanisms to deliver a robust and efficient solution and significantly improves both performance and the overall user experience. With the Hub architecture, centralized content management is now seamlessly extended to peripheral servers.

The new Hub online synchronisation feature builds on the existing repository synchronization mechanism. It allows peripheral servers to sync their software channels directly from repositories hosted on the Hub server. Once the connection is established, the Hub becomes the primary content source for its connected peripheral servers.

Currently, this functionality is limited to software channels, but future releases will expand support to include other artifacts such as images and configuration channels.

As part of this improvement, the already deprecated ISSv1 will be removed. ISSv2 will remain available for offline synchronization scenarios.

Migration will be available from both ISSv1 and ISSv2 to the new method of synchronizing content between the Hub server and peripheral servers.

Role-Based Access Control Enhancements

SUSE Multi-Linux Manager 5.1 introduces significantly improved Role-Based Access Control (RBAC) to provide users with fine-grained access control and configuration options. This enhancement centralizes access control rules, making them easier to manage and adapt. The implementation is designed to be flexible, allowing new use cases and rules to be defined through configuration rather than code changes.

The SUSE Multi-Linux Manager Server will include sensible default policies while also enabling users to create custom access policies (user access groups) to suit their specific requirements.

Administrators can now better manage user permissions, delegating access to specific functions or sections of the system as needed. This is the first phase of a broader effort, and additional enhancements to RBAC are planned in future releases.

Note

To evaluate this feature, ensure you are not logged in as a "SUSE Multi-Linux Manager Administrator" user, as that role has unrestricted access and will not reflect the effects of RBAC limitations.

Ansible Integration Enhancements

SUSE Multi-Linux Manager 5.1 includes a range of enhancements to its Ansible integration, making it easier to manage automation workflows directly from within the product. These improvements aim to streamline day-to-day operations and increase visibility and control over Ansible-driven configurations.

Key improvements include:

  • Display of raw Ansible playbook output in the event history of the control node, along with a list of all targeted systems

  • Support for recurrent (scheduled) execution of Ansible playbooks

  • Ability to configure default playbook and inventory paths when adding a new control node

  • New filter option in the system list to easily identify Ansible-managed systems onboarded

These enhancements mark a major step forward in improving Ansible usability and integration in Multi-Linux Manager.

Backup and Restore Support

SUSE Multi-Linux Manager 5.1 introduces a built-in backup and restore solution via the mgradm backup command-line tool. It provides a reliable and consistent way to safeguard your Multi-Linux Manager installation, simplifying disaster recovery and system migration.

The mgradm backup create command performs a full backup of all critical data, while mgradm backup restore enables system recovery. Additional subcommands and options are available and can be viewed using the tool’s help output.

Regular use of this tool is recommended to prevent data loss and ensure quick recovery in case of failure.

Note

This approach may require substantial disk space and time to complete, depending on the size of your environment.

Note

Before restoring, ensure that all SUSE Multi-Linux Manager services are stopped.

For more details about the tool, refer to the Backup and Restore section of the documentation.

Separate Database Container

SUSE Multi-Linux Manager 5.1 now includes the PostgreSQL database in a separate container. As this new database container no longer shares the SSL certificate with the web server, the password of the SSL CA key is required when upgrading from any older version. When using third party certificates, a certificate and key for the database will need to be provided instead.

To help with backing up and restoring the data a new tool mgradm backup command is available, more information about it can be found in the Backup and Restore section of the documentation.

Product Migration Enhancement

The product migration feature has been enhanced, allowing users to seamlessly migrate their SLES systems to SLES for SAP when needed. This improvement significantly enhances the user experience, eliminating the need for specific scripts previously required, as it is now integrated into SUSE Multi-Linux Manager’s capabilities.

Saline (Technology Preview)

Saline is a tool that brings powerful monitoring and profiling capabilities to SUSE Multi-Linux Server, helping users maintain a well-tuned and responsive Salt infrastructure.

It is designed to work as a Prometheus exporter, collecting and exposing metrics from the Salt event bus. This provides better visibility into Salt events, helping identify performance bottlenecks and profile Salt internals.

For more details about the tool, deployment options, and related information, refer to the Monitoring Salt Events.

Removed features

Virtualization

The virtualization feature, deprecated in SUSE Multi-Linux Manager 5.0, has been fully removed in version 5.1. If you still rely on VM management functionalities, we highly recommend considering alternatives like https://harvesterhci.io/.

ISSv1

Starting with the SUSE Multi-Linux Manager 5.1 release, ISSv1 has been fully removed, following its deprecation in the previous release. For offline inter-server synchronization, ISSv2 is now available. For online synchronization, the required functionality is fully integrated into the Hub server. If you encounter any gaps or issues during this transition, please don’t hesitate to contact us for assistance.

Deprecated features

smdba tool

Starting with the SUSE Multi-Linux Manager 5.1, the smdba tool has been deprecated. Alternative solutions for backup, restore, and database tuning will be provided.

'spacewalk-manage-channel-lifecycle' tool

With SUSE Manager 4.3, the spacewalk-clone-by-date tool was deprecated in favor of Content Lifecycle Management (CLM), a more powerful and flexible solution.

We are now also deprecating spacewalk-manage-channel-lifecycle, as CLM fully covers the functionality of both tools.

CLM’s comprehensive API provides all key capabilities previously offered, and we strongly recommend migrating existing workflows and scripts to CLM.

Unsupported products

  • SUSE Linux Enterprise Server Expanded Support 6

  • SUSE Linux Enterprise Server 11

  • Red Hat Enterprise Linux 6

  • Oracle Linux 6

  • CentOS 6

  • CentOS 7

  • CentOS 8

  • CentOS Stream

  • Ubuntu 16.04

  • Ubuntu 18.04

  • Ubuntu 20.04

  • Debian 9

  • Debian 10

  • Debian 11

We encourage you to migrate your workload to a newer version of each distribution, or to an alternative distribution that is still supported, so you can continue managing your infrastructure with SUSE Multi-Linux Manager.

Please note that we will not break things on purpose for these unsupported products, and there is a possibility that they could still continue to work. But if things break, there will not be any support provided, not even on a best-effort basis.

Deprecated products

The support policy of SUSE Multi-Linux Manager clients can be summarized as: "If the operating system is under general support by its vendor, then SUSE Multi-Linux Manager supports it as a client".

After the EOL of a product, for a grace period of 3 months, a product will be considered as deprecated before moving to unsupported.

For deprecated products, support will only be provided on a best-effort basis.

Support

Supportconfig confidentiality disclaimer

When handling Service Requests, supporters and engineers may ask for the output of the supportconfig tool from SUSE Multi-Linux Manager Server or clients.

This disclaimer applies:

Detailed system information and logs are collected and organized in a
manner that helps reduce service request resolution times.
Private system information can be disclosed when using this tool.

If this is a concern, please prune private data from the log files.

Several startup options are available to exclude more sensitive
information. Supportconfig data is used only for diagnostic purposes
and is considered confidential information.

When you run supportconfig or mgradm support, the output will contain information about your clients as well as about the Server. In particular, debug data for the subscription matching feature contains a list of registered clients, their installed products, and some minimal hardware information (such as the CPU socket count). It also contains a copy of the subscription data available from the SUSE Customer Center.

If this is a concern, please prune data in the subscription-matcher directory in the spacewalk-debug tarball before sending it to SUSE.

Supportability of embedded software components

All software components embedded into SUSE Multi-Linux Manager, like Cobbler for PXE booting, are only supported in the context of SUSE Multi-Linux Manager. Stand-alone usage (e. g. Cobbler command-line) is not supported.

Support for older products

The SUSE Multi-Linux Manager engineering team provides best effort support for products past their end-of-life date. For more information about product support, see Product Support Lifecycle.

Support for products that are considered past their end-of-life is limited to assisting you to bring production systems to a supported state. This could be either by migrating to a supported service pack or by upgrading to a supported product version.

Support for SUSE Liberty Linux

SUSE Multi-Linux Manager supports SUSE Liberty Linux 7, 8 and 9. SUSE Liberty Linux clients are sometimes also called SUSE Linux Enterprise Server with Expanded Support (SLESES) or simply RES.

SUSE has offered LTSS support for SUSE Liberty Linux 7, and SUSE Multi-Linux Manager will continue to support it throughout the LTSS phase.

For a detailed list of supported features, check the Client Configuration Guide.

Support for RHEL, CentOS and Oracle Linux Clients

SUSE Multi-Linux Manager supports RHEL/Oracle Linux 8 and 9.

SUSE Multi-Linux Manager has the ability to mirror all entitled content for the supported operating systems. Although SUSE Multi-Linux Manager doesn’t assign content for specific systems using subscription-manager, it does rely on it initially to retrieve the list of repositories that are available. By utilizing the same EUS channels that Red Hat provides, customers can limit content to individual dot releases.

CentOS Stream is explicitly not supported by SUSE.

Note: Direct sync’ing ULN repos with SUSE Multi-Linux Manager are not currently supported. An Oracle Local Distribution for ULN must be used. To set up a local ULN mirror, please consult the Oracle documentation provided at the following link

Support for Rocky Linux & AlmaLinux

SUSE Multi-Linux Manager supports Rocky Linux 8/9 and AlmaLinux 8/9.

For a detailed list of supported features for AlmaLinux, check the Client Configuration Guide. For a detailed list of supported features for Rocky Linux, check the Client Configuration Guide.

Support for Ubuntu Clients

SUSE Multi-Linux Manager supports Ubuntu 22.04 LTS and 24.04 LTS clients using Salt.

Support for Ubuntu is limited to a growing list of specific features. For a detailed list of supported features, check the Client Configuration Guide.

Support for Debian Clients

SUSE Multi-Linux Manager supports Debian 12 "bookworm" clients using Salt.

Support for Debian is limited to a growing list of specific features. For a detailed list of supported features, check the Client Configuration Guide.

Support Policy for Non-SUSE Client Operating Systems

The Multi-Linux Manager supports multiple major versions of non-SUSE client operating systems, such as RHEL, Rocky Linux, Debian and others. However, only the latest minor release of each supported major version is fully supported.

For example:

  • For Rocky Linux 8, only the most recent minor release is supported. Older minor releases are not supported.

Older minor releases might still work but will only be supported on a limited and reasonable-effort basis. If issues arise on an outdated minor release, users will be asked to upgrade to the latest available minor version before further support is provided.

L1 support for RHEL ppc64le clients

For RHEL clients on the ppc64le architecture, SUSE Multi-Linux Manager offers the same functionality that is supported for the x86_64 architecture. Client tools are not available yet from SCC but the RHEL 9 client tools from Uyuni can be enabled using spacewalk-common-channels.

RHEL ppc64le are only supported at L1 level support. L1 support is limited to problem determination, which means technical support designed to provide compatibility information, usage support, on-going maintenance, information gathering, and basic troubleshooting using available documentation. At the time of writing, any problems or bugs specific to RHEL on ppc64le will only be fixed on a best-effort basis.

Please contact your Sales Engineer or SUSE Consulting if you need additional support or features for these operating systems.

SCAP Security Guide support

SUSE provides scap-security-guide package for different OpenSCAP profiles. In the current version of scap-security-guide, SUSE supports the following profiles:

  • DISA STIG profile for SUSE Linux Enterprise Server 12 and 15

  • PCI-DSS profile for SUSE Linux Enterprise Server 12 and 15

  • HIPAA profile for SUSE Linux Enterprise Server 12 and 15

Other profiles, are community supplied and not officially supported by SUSE.

For Non-SUSE OSs, please note that the included profiles are community supplied and not officially supported by SUSE.

Podman Secret Driver support

Only the file Podman secret driver has been tested and is officially supported for SUSE Multi-Linux Manager container deployments at this time. Other drivers, such as pass or any custom or external secret providers, have not been tested and are not supported.

Browser support

To effectively manage your SUSE Multi-Linux Manager environment via the Web UI, it’s essential to use an up-to-date web browser. SUSE Multi-Linux Manager is compatible with:

  • The latest Firefox browser provided with SUSE Linux Enterprise Server

  • The latest Chrome browser across all operating systems

  • The latest Edge browser provided with Windows

Please note that Windows Internet Explorer is not supported. The SUSE Multi-Linux Manager Web UI may not render correctly when accessed through Windows Internet Explorer.

Please refer to the General Requirements for a list of supported browsers.

SUSE Multi-Linux Manager installation

The only supported methods for installing SUSE Multi-Linux Manager is by utilizing images provided by SUSE, or the tools provided in the SUSE Multi-Linux Manager 5.1 Extension, on top of SUSE Linux Micro 6.1 and SUSE Linux Enterprise 15 SP7.

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.

Bootstrapping SL Micro 6.1 Clients

When bootstrapping an SL Micro 6.1 client, users may encounter the following error:

          ID: file_///usr/lib/rpm/gnupg/keys/gpg-pubkey-09d9ea69-67c857f3.asc
    Function: mgrcompat.module_run
        Name: pkg.add_repo_key
      Result: false
     Comment: Module function pkg.add_repo_key threw an exception. Exception: [Errno 2] No such file or directory: '/usr/lib/rpm/gnupg/keys/gpg-pubkey-09d9ea69-67c857f3.asc'
     Started: 16:14:17.064366
    Duration: 5.956
         SLS: channels.gpg-keys
     Changed: {}

This error occurs due to an outdated version of the suse-build-key package. To resolve the issue, upgrade the suse-build-key package and retry the bootstrapping process.

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.

Backup/Restore: Bootstrap Repositories

After performing a backup and restore of the system, you may encounter a permissions error when generating bootstrap repositories:

PermissionError: [Errno 13] Permission denied: '/srv/www/htdocs/pub/repositories/sle/15/6/bootstrap.tmp/x86_64/venv-salt-minion-3006.0-150000.2.4.x86_64.rpm'

This occurs due to incorrect SELinux labels on restored volumes, which can prevent access to the required files.

To resolve the issue, restore the correct SELinux context by running the following command:

restorecon -rvF /var/lib/containers/storage/volumes/

This command will recursively reset the SELinux context on the affected directory, allowing bootstrap repository generation to proceed successfully.

Note

If the system was backed up with SELinux enabled but is restored on a system where SELinux is not available, the following warning may appear during the restore process:

WRN Unable to restore selinux context for /var/lib/containers/storage/volumes/etc-rhn/_data,
manual action is required error="exec: \"restorecon\": executable file not found in $PATH"

This warning can be safely ignored. The system can proceed with the usual startup sequence by running:

mgradm start

The restore process will function correctly even without SELinux, and the system should operate normally.

Preserve Backup directory Name

When using the backup/restore feature in SUSE Multi-Linux Manager 5.1, do not rename the backup directory or any of its internal paths.

Renaming the backup folder (for example, changing backup-2025-07-25 to backup-new-name) will result in a checksum mismatch error during the restore process, such as:

WRN Encountered problems: error="Checksum does not match for volume backup-newname/volumes/ca-cert.tar: Checksum of backup-newname/volumes/ca-cert.tar does not match"
Error: Restore aborted with partially restored files. Resolve the error and try again

To avoid such issues:

  • Always keep the original directory structure and names created by the backup tool.

  • Ensure that the backup folder is passed to the restore process exactly as it was created.

  • If you need to move the backup to another machine (e.g. for migration from SLE Micro 5.5 with MLM 5.0 to SLE Micro 6.1 with MLM 5.1), preserve the directory name as-is.

Issues with the Database Container

Some issues remain unresolved in context of database container

  • Hostname renaming is not yet supported

  • SSL certificate and CA rotation functionality is incomplete

  • Disk space checks are currently non-functional

Important

A full database volume can cause significant issues with system operation. As disk usage notifications have not yet been adapted for containerized environments, users are encouraged to monitor the disk space used by Podman volumes themselves, either through tools such as Grafana, Prometheus, or any other preferred method. Pay particular attention to the var-pgsql volume, located under /var/lib/containers/storage/volumes/.

Ansible package removal from the client tools

Ansible is no longer included in the new client tools. Users are expected to obtain Ansible from their operating system vendor’s repositories.

On SLE 15 SP6 and SP7, Ansible is provided through the Systems Management Module.

For older service packs such as SP4 and SP5, users who wish to install a newer version of Ansible must enable the Python 3 Module to ensure a successful installation.

Keep Informed

To stay up-to-date 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

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.

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 Server in your business.

Your SUSE Multi-Linux Manager Team.