Installation, Deployment and Upgrade

Publication Date: 2026-09-23

1. Preface

This guide provides comprehensive, step-by-step instructions for deploying, upgrading, and managing SUSE Multi-Linux Manager Server and Proxy.

It is organized into the following sections:

  • Requirements: Outlines the essential hardware, software, and networking prerequisites to ensure a smooth setup.

  • Deployment and Installation: Guides you through deploying SUSE Multi-Linux Manager as a container and completing the initial configuration.

  • Upgrade and Migration: Details the process for upgrading and migrating SUSE Multi-Linux Manager while minimizing downtime.

  • Basic Server Management: Covers fundamental server operations, helping you get started with SUSE Multi-Linux Manager efficiently.

2. Terminology

This guide uses the following terms consistently:

Maintenance update

Moving between maintenance updates of the same version, for example 5.2.0 to 5.2.1. Update the host operating system, then run mgradm upgrade or mgrpxy upgrade.

Upgrade

Moving between minor versions of the same major release, for example 5.1 to 5.2. This also involves a product migration of the host operating system. Before upgrading, you must update the system to the latest available maintenance update of the current version, and ensure it is running.

Migration

Moving between major versions, for example 4.3 to 5.x, or changing the deployment form, such as moving from an RPM-based installation to containers. Before migrating, you must update the source system to the latest available maintenance update, and ensure it is running.

A maintenance update and an upgrade are both performed with mgradm upgrade or mgrpxy upgrade. The difference is what you are moving between, not the command you run.

3. Copyright Notice

Copyright © 2011–2026 SUSE LLC and contributors. All rights reserved. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled GNU Free Documentation License.

4. Trademarks

For SUSE trademarks, see https://www.suse.com/company/legal/ . All third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its affiliates. Asterisks (*) denote third-party trademarks. All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its affiliates, the authors nor the translators shall be held liable for possible errors or the consequences thereof.