Server - Major Upgrade

When SUSE Manager core components are upgraded to new major versions, you need to perform a major upgrade on the SUSE Manager Server. This is the case if a version upgrade of PostgreSQL, Salt, or openSUSE Leap is needed. openSUSE Leap is the underlying base operating system (OS).

Some additional manual steps might be required, and this information is only available in the release notes. For important extra information about your upgrade, see the release notes at:

https://www.uyuni-project.org/pages/stable-version.html.

You will not be able to fix issues that arise during the migration. Ensure you have created a backup before you start the migration. If you are running SUSE Manager Server on a virtual machine, we recommend that you create a snapshot before you start.

Before the upgrade, ensure that storage requirements are met. For more information, see Requirements. The migration procedure can fill the root partition if there is not enough space available due to the service pack migration and the download of new software packages. It is the same for the /var/lib/pgsql when upgrading PostgreSQL. It takes a copy of the old database, thus be sure to have at least enough space available to cope with a copy of the database.

The server-migrator.sh script migrates SUSE Manager Server to the latest version. It also upgrades the underlying operating system to version 15.5. The script is part of the susemanager package.

Procedure: Migrating the SUSE Manager Server

  1. Before running the server-migrator.sh script, check whether the most recent version of the susemanager package is installed:

    zypper ref
zypper up susemanager

  2. Run the /usr/lib/susemanager/bin/server-migrator.sh script to upgrade the base OS and SUSE Manager Server.

  3. To migrate the database to the latest database version run the migrate script:

    /usr/lib/susemanager/bin/pg-migrate-x-to-y.sh

    For more information about PostgreSQL database migration, see Database Migration to Latest Version.

After the migration is complete, manually reboot the SUSE Manager Server: