8
The two channels you can use to get help debugging a MAAS issue are:
10
- The `Ask Ubuntu`_ website.
11
- The `Freenode #maas`_ IRC channel.
14
http://askubuntu.com/questions/ask?tags=maas
17
http://webchat.freenode.net/?channels=maas
20
Gathering debugging information
21
-------------------------------
23
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 before you head over to Ask Ubuntu or the IRC channel. This way, you'll have all the required information handy for people who can help you.
25
Gathering debugging information is a fully automated process that is performed with the help of `sosreport`_.
27
If your MAAS server is running Ubuntu version 14.04 (Trusty Tahr) or later, you can get sosreport from the official archives::
30
sudo apt-get install -y sosreport
32
sudo sosreport -o maas
34
Alternatively, if your MAAS server is running a previous Ubuntu release, you'll need to install sosreport manually::
37
sudo apt-get install -y git
38
# Get the latest version of sosreport.
39
git clone https://github.com/sosreport/sosreport.git /tmp/sosreport
41
sudo /tmp/sosreport/sosreport -o maas
44
https://github.com/sosreport/sosreport
46
This will create a tarball containing MAAS' log files, MAAS' configuration files and a dump of MAAS' database. By default, the tarball will end up in /tmp but you can change the location, see sosreport's manpage for details. If there are things you do not wish to share publicly, feel free to edit the tarball.
48
Now, the last step is to make this file available by any means at your disposal (openly accessible FTP server, Dropbox, etc.) in order for the people who will help you to be able to get their hands on it.
added
removed
docs/getting-help.rst
