Reporting and reviewing bugs
MAAS bug reports live on Launchpad. Before you dive into reporting, let’s make sure your report is top-notch for swift triage and resolution.
Ready Your Info
Preparation is key. Have these details ready:
-
Bug summary: Be concise. Think:
- “MAAS PXE boot fails on IBM LPAR as KVM host”
-
Version and build:
- Snap users:
snap list maas
- Debian package users:
apt list maas
- Snap users:
- Interface used: UI? CLI? API? Specify.
- What happened: Describe the unexpected behaviour. Keep it crisp.
- Steps to reproduce: Step-by-step actions leading to the problem.
- Screenshots: Only if they clarify.
-
Logfiles: Especially
maas.log
,regiond.log
,rackd.log
. Depending on your installation:- Snap:
/var/snap/maas/common/log/
- Debian Package:
/var/log/maas/
- Snap:
Use a text editor. Keep these details at hand.
Submitting the Bug
- Start here: Launchpad bug report page^
- Summary: Input your concise summary.
- Details: Paste the prepared info into “Further information”.
- Attachments: Add screenshots and logfiles. Describe them.
- Submit: Click “Submit Bug Report”.
For clarity, you can view this sample bug.
Happy reporting!
Last updated a month ago.