Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Upgrading from 4.x to 5.x

Before starting the upgrade, make sure you have a valid and tested backup. The upgrade process will also upgrade the PostgreSQL database from version 15 to version 18. Once you have backup, first stop and disable appm services:

Stop and disable APPM services

Stop and disable the APPM services before upgrading the operating system.

systemctl disable --now aba-appm appm_collector

This is equivalent to stopping and disabling both services separately.

Upgrade the operating system

After the APPM services have been stopped and disabled, upgrade the Linux distribution to one of the supported platforms:

  • Ubuntu 26.04
  • Debian 13
  • Oracle Linux 10

Upgrade the APPM

After the operating system upgrade is complete, update the APPM repository configuration.

Debian / Ubuntu

Edit /etc/apt/sources.list.d/abakus.list to change URL from:

https://appm.update.abakus.si:448/repo-free/deb12/

to:

https://appm.update.abakus.si:448/repo-free/deb13/

Then update the package metadata and perform the upgrade:

apt update && apt full-upgrade

Oracle Linux

Edit /etc/yum.repos.d/abakus.repo to change baseurl from:

baseurl=https://appm.update.abakus.si:448/repo-free/el9/

to:

baseurl=https://appm.update.abakus.si:448/repo-free/el10/

Then refresh the package metadata and upgrade the installed packages:

dnf --refresh update