How to install or upgrade MAAS

Errors or typos? Topics missing? Hard to read? Let us know.

Install MAAS (Snap or packages)

1. Install from Snap:

   sudo snap install --channel=<version> maas
   

   Replace <version> with the desired MAAS version.

2. Install from packages:

   sudo apt-add-repository ppa:maas/<version>
   sudo apt update
   sudo apt-get -y install maas
   

Post-install setup (POC)

There is a proof-of-concept configuration defined for the MAAS Snap version only. To initialise the MAAS Snap in this POC configuration, simply use the --help flag with maas init and follow the instructions. This POC uses the MAAS test DB Snap.

Post-install setup (production)

1. Disable conflicting NTP:

   sudo systemctl disable --now systemd-timesyncd
   

2. Configure PostgreSQL for production:

   sudo apt install -y postgresql
   sudo -i -u postgres psql -c "CREATE USER \"$DBUSER\" WITH ENCRYPTED PASSWORD '$DBPASS'"
   sudo -i -u postgres createdb -O "$DBUSER" "$DBNAME"
   

3. Edit /etc/postgresql/14/main/pg_hba.conf; add a line for the newly created database:

    host    $MAAS_DBNAME    $MAAS_DBUSER    0/0     md5
   
   

4. Initialize MAAS with the database:

   sudo maas init region+rack --database-uri "postgres://$DBUSER:$DBPASS@$HOSTNAME/$DBNAME"
   

5. Create an admin user:

   sudo maas create admin --username=$PROFILE --email=$EMAIL_ADDRESS
   

Upgrading MAAS

1. Upgrade MAAS (Snap):

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

2. Upgrade MAAS (packages):

   sudo apt-add-repository ppa:maas/<version>
   sudo do-release-upgrade --allow-third-party
   

Notes

• For PostgreSQL 12 users, upgrade to PostgreSQL 14 before installing or upgrading to MAAS 3.5+.
• Review the new PostgreSQL requirements in the installation requirements document before installing MAAS.
• For Ubuntu 20.04 LTS users, upgrade to Ubuntu 22.04 before moving to MAAS 3.5+.
• Always back up your MAAS server before upgrading.

Special Upgrade Situations

For multi-node setups, upgrade rack nodes before region nodes. For BMC setups with duplicate IP/username combos, ensure unique combinations to avoid migration failures.

Configuring and starting MAAS

Checking MAAS Status

To check the status of MAAS services, use:

sudo maas status

Output example:

bind9        RUNNING   pid 7999, uptime 0:09:17
dhcpd        STOPPED   Not started
postgresql   RUNNING   pid 8001, uptime 0:09:17
...

MAAS UI setup

1. Access UI:
   http://$API_HOST:5240/MAAS
   Login with credentials created during installation.
2. DNS forwarder: Set to a suitable value (e.g., 8.8.8.8).
3. Image import: Select at least one Ubuntu LTS image.
4. SSH kley import: Choose between Launchpad, GitHub, or upload a key from .ssh/id_rsa.pub.

MAAS CLI setup

1. Login:

   maas login $PROFILE $MAAS_URL $(cat api-key-file)
   

2. Configure DNS:

   maas $PROFILE maas set-config name=upstream_dns value="8.8.8.8"
   

3. Add SSH key:

   maas $PROFILE sshkeys create "key=$SSH_KEY"
   

Enabling DHCP

UI

1. Navigate to Subnets > VLAN > Configure DHCP.
2. Select the appropriate DHCP options (Managed or Relay).
3. Save and apply changes.

CLI

1. Enable DHCP:

   maas $PROFILE vlan update $FABRIC_ID untagged dhcp_on=True \
       primary_rack=$PRIMARY_RACK_CONTROLLER
   

2. Set default gateway:

   maas $PROFILE subnet update $SUBNET_CIDR gateway_ip=$MY_GATEWAY
   

---

Last updated 8 hours ago.