Getting Help

The two channels you can use to get help debugging a MAAS issue are:

Gathering debugging information

If your question is related to a problem related to a specific MAAS installation, we encourage you to gather debugging information and make it available while asking for help. This will make it much easier for people to assist.

A big step on the way to doing this is by using sosreport, an automated information-gathering utility. It is available in the Ubuntu archives:

sudo apt install -y sosreport
sudo sosreport -o maas

This will create a tarball containing MAAS log files, MAAS configuration files and a dump of the MAAS database. By default, the tarball will end up in /tmp but you can change the location. See the sosreport man page for details. If there are things you do not wish to share publicly, feel free to edit the tarball.

The last step is to make this file available by any means at your disposal (openly accessible FTP server, Dropbox, etc.) in order for helpers to be able to get their hands on it.