How-to guides

Errors or typos? Topics missing? Hard to read? Let us know.

Welcome to the comprehensive guide for configuring and managing your MAAS (Metal as a Service) environment. This section provides a step-by-step approach to help you master MAAS, from the basics to advanced customization and maintenance.

Core configuration

Start with the foundational steps needed to set up your MAAS environment. This section covers everything from installing MAAS to deploying and locating machines, ensuring that your setup is robust and functional. Learn how to monitor and troubleshoot issues effectively to keep your infrastructure running smoothly.

• Install or upgrade MAAS
• Customise networks
• Customise DHCP
• Choose OS images
• Configure controllers
• Configure machines
• Commission machines
• Allocate machines
• Deploy machines
• Locate machines
• Monitor MAAS
• Troubleshoot issues

Tuning performance

Optimize your MAAS setup for better performance and reliability. This section guides you through managing IP ranges, mirroring images, and enabling high availability to ensure your environment is efficient and resilient.

• Manage IP ranges
• Mirror MAAS images
• Enable high availability

Adjusting your instance

Customize your MAAS environment to meet specific operational needs. From managing storage and adjusting settings to setting up power drivers and configuring air-gapped instances, this section provides the tools for fine-tuning your setup.

• Customise machines
• Manage storage
• Adjust MAAS settings
• Set up power drivers
• Set up air-gapped MAAS

Using virtual machines

Leverage virtual machine capabilities within MAAS to enhance your infrastructure. Learn how to use LXD, manage virtual machines, and deploy on specialized hardware like IBM Z.

• Use virtual machines
• Set up external LXD
• Use external LXD
• Use LXD projects
• Manage virtual machines
• Deploy VMs on IBM Z

Finding issues in the logs

Effective log management is key to identifying and resolving issues. This section explains how to use various logs, audit MAAS, and interpret testing data to maintain a secure and operational environment.

• Use logging
• Use MAAS systemd logs
• Read event logs
• Read commissioning logs
• Interpret testing logs
• Audit MAAS
• Review audit logs

Grouping machines

Organize your machines for better management using tags, availability zones, and resource pools. This section covers how to categorize and annotate machines to streamline your operations.

• Use availability zones
• Use resource pools
• Annotate machines
• Manage tags
• Use machine tags
• Use network tags
• Use controller tags
• Use storage tags

Scripting MAAS

Automate tasks and interact programmatically with MAAS using scripts and APIs. This section introduces cloud-init, the MAAS API, and Python scripting for more efficient management.

• Use cloud-init with MAAS
• Login to the MAAS API
• Script MAAS with Python

Securing your instance

Protect your MAAS environment with enhanced security measures. Learn to manage user access, implement TLS, and integrate with Vault for secure configuration and data management.

• Enhance MAAS security
• Manage user access
• Implement TLS
• Integrate Vault

Building kernels

Customize your deployment by building specialized kernels and images. This section guides you through deploying real-time or FIPS-compliant kernels and building various OS images for different use cases.

• Deploy a real-time kernel
• Deploy a FIPS kernel
• Use VMWare images
• Customise images
• Build MAAS images
• Build Ubuntu
• Build RHEL 7
• Build RHEL 8
• Build CentOS 7
• Build Oracle Linux 8
• Build Oracle Linux 9
• Build ESXi
• Build Windows

Maintaining MAAS

Ensure the long-term stability of your MAAS environment with regular maintenance tasks. Learn how to back up and upgrade MAAS to keep your system secure and up-to-date.

• Back up MAAS

---

Last updated a month ago.