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.

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

The version of PostgreSQL you are using depends on the underlying operating system. openSUSE Leap 15.2 uses PostgreSQL 12, so this is the version used by Uyuni on that operating system. openSUSE Leap 15.3 is expected to have PostgreSQL 13.

Procedure: Migrating the SUSE Manager Server

Before running the server-migrator.sh script, check whether the most recent version of the susemanager package is installed:
```
zypper ref
zypper up susemanager
```
Run the /usr/lib/susemanager/bin/server-migrator.sh script to upgrade the base OS and SUSE Manager Server.
To migrate the database to PostgreSQL 12 run the migrate script:
```
/usr/lib/susemanager/bin/pg-migrate-10-to-12.sh
```
For more information about PostgreSQL database migration, see Database Migration from Version 10 to 12.
To migrate the database to PostgreSQL 13 from PostgreSQL 12 run the migration script:
```
/usr/lib/susemanager/bin/pg-migrate-12-to-13.sh
```
For more information about PostgreSQL database migration, see Database Migration from Version 10 or 12 to 13.
To migrate the database to PostgreSQL 13 from PostgreSQL 10 run the migration script:
```
/usr/lib/susemanager/bin/pg-migrate-10-to-13.sh
```
For more information about PostgreSQL database migration, see Database Migration from Version 10 or 12 to 13.
After the migration is complete, manually reboot the SUSE Manager Server:
```
shutdown -r now
```

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.