Ubuntu: Installing MAAS

Configuring the cluster controller

Once the packages are installed, the cluster controller needs to know where to look for the region controller. This is achieved using dpkg to configure the software:

$ dpkg-reconfigure maas-cluster-controller

The configuration script should then bring up a screen where you can enter the IP address of the region controller. Additionally, you will need to run the maas-import-pxe-files script to install the distro image files locally for commissioning:

$ maas maas node-groups import-boot-images

...and optionally set up the DHCP and DNS for the cluster by either:

Using the web UI

Follow the instructions at Cluster Configuration to use the web UI to set up your cluster controller.

Using the command line client

First logging in to the API and then following this procedure

Client-side DNS configuration

When using a third party tool such as juju it will need to be able to resolve the hostnames that the MAAS API returns to it. In order for this to happen, client-side DNS must be configured to point to MAAS’s DNS server. Generally speaking, this is a simple case of adding the following line to the /etc/resolv.conf file on your client host:

nameserver <IP OF MAAS DNS HOST>

replacing the <IP OF MAAS DNS HOST> with the actual IP address of the host running the MAAS DNS server.

However, for hosts using the resolvconf package, please read its documentation for more information.