Upgrade MAAS¶

This guide outlines the steps to upgrade MAAS to the latest version

General steps¶

Backup your system and database.
Verify Ubuntu release (lsb_release -a) and upgrade to the newer one if required.
Verify PostgreSQL version compatibility and upgrade it if required.
Upgrade rack nodes first, then region nodes.

Upgrade commands¶

sudo snap refresh maas --channel=<version>/stable

Version-specific notes¶

MAAS 3.6: PostgreSQL 14+ supported; PostgreSQL 16 recommended.
MAAS 3.5: Requires PostgreSQL 14.
MAAS 3.3: PostgreSQL 12 deprecated. Upgrade to 14 before proceeding.
MAAS 2.8 or earlier: Full backup required. Fresh install recommended if upgrade fails.

Verification¶

After upgrade:

sudo maas status # Verify services running

Troubleshooting¶

BMC migration (3.3+): Ensure unique BMC IP/username/password combinations.