Offline docs (switch to live docs)                         UI-only         CLI-only

How to install MAAS

MAAS is relatively easy to install and configure. Let’s give it a try.

NOTE: MAAS will run on just about any modern hardware configuration, even a development laptop. If you’re not sure whether your target server will handle MAAS, you can always double-check.

NOTE: IMPORTANT: If you’re having trouble accessing your MAAS, double-check your URL. It should be of the form http://nn.nn.nn.nn:5240/MAAS, where nn.nn... is the IP address. Note that this is http and not https. ALSO check whether the IP of your MAAS host may have changed, e.g., due to the MAAS host using a DHCP lease. If the MAAS host’s IP changes for any reason, you will need to re-initialise MAAS to pick up the new IP address.

How to check the status of MAAS services

You can check the status of running services with:

sudo maas status

Typically, the output looks something like this:

bind9                            RUNNING   pid 7999, uptime 0:09:17
dhcpd                            STOPPED   Not started
dhcpd6                           STOPPED   Not started
ntp                              RUNNING   pid 8598, uptime 0:05:42
postgresql                       RUNNING   pid 8001, uptime 0:09:17
proxy                            STOPPED   Not started
rackd                            RUNNING   pid 8000, uptime 0:09:17
regiond:regiond-0                RUNNING   pid 8003, uptime 0:09:17
regiond:regiond-1                RUNNING   pid 8008, uptime 0:09:17
regiond:regiond-2                RUNNING   pid 8005, uptime 0:09:17
regiond:regiond-3                RUNNING   pid 8015, uptime 0:09:17
tgt                              RUNNING   pid 8040, uptime 0:09:15

How to re-initialise MAAS

It is also possible to re-initialise MAAS to switch modes. For example, to switch from rack to region:

sudo maas init region

How to list additional MAAS initialisation options

The init command can takes optional arguments. To list them, as well as read a brief description of each, you can enter:

sudo maas init --help

How to configure MAAS