Offline docs (switch to live docs)                          UI-only  CLI-only

What is new with MAAS 2.9

MAAS 2.9.2 release notes

We have released MAAS 2.9.2, which contains two new features, and some notable bug fixes. The two new features are:

You can also find a digest of the 2.9.2 bug fixes below.

MAAS 2.9.1 release notes

Building upon MAAS 2.9, we have released 2.9.1, which contains some notable bug fixes. You can find a digest of these fixes below.

MAAS 2.9 release notes

Following on from MAAS 2.8, we are happy to announce that MAAS 2.9 is now available.

What are the new features & fixes for MAAS 2.9 and MAAS 2.9.1?

Six other questions you may have:

Focal Fossa (Ubuntu 20.04 LTS) as default release

Ubuntu 20.04 LTS (Focal Fossa) is now the default commissioning and deployment release for new MAAS installations. Machines deployed with Focal may now be registered as KVM hosts.

Support for OpenVswitch bridge type

MAAS 2.9 allows you to create an OpenVswitch bridge type when creating a bridge.

Support for NUMA, SR-IOV, and hugepages

MAAS 2.9 adds extensive optimisation tools for using NUMA with virtual machines. You can now see how many VMs are allocated to each NUMA node, along with the allocations of cores, storage, and memory. You can quickly spot a VM running in multiple NUMA nodes, and optimise accordingly, with instant updates on pinning and allocations. You can also tell which VMs are currently running. Using the CLI, you can also pin nodes to specific cores, and configure hugepages for use by VMs.

Specifically, there are five new features available to support NUMA, SR-IOV, and hugepages:

This functionality comes with an enhanced panel in the "KVM" details section:

See the VM hosting page for more details, and be sure to use the menu at the top of that page to select your desired build method and interface, so that you'll see the most relevant instructions.

Improved performance for large MAAS installations

MAAS 2.9 includes changes to the machine batch size that the UI loads. Previously the UI loaded machines in batches of 25; it now pulls in 25 for the first call, then 100 at a time in subsequent batches.

You can see the results of the investigation in this video podcast.

New release notifications

MAAS now includes new release notifications for users and administrators. These appear when a new release is available:

Both regular and administrative users can snooze these notifications for two weeks at a time. Administrative users can opt out of new release notifications completely, preventing notifications for any user of that MAAS.

IPMI configuration screens

MAAS now includes UI panels corresponding to the IPMI power driver upgrades mentioned earlier:

This screen can be reached from Settings | Configuration | Commissioning.

Descriptions when marking machines broken

When marking a machine broken, a description can now be included:

This description appears in that machine's row on the machine list.

Curtin 20.2 now included

A number of MAAS issues have actually been issues with an older version of Curtin. MAAS now includes Curtin 20.2, which fixes many of these issues, including MAAS is changing my boot order!.

HTTP boot disabled

MAAS 2.9 disables HTTP boot. There are known issues with HTTP boot in MAAS, as well as known issues for HTTP boot with grub (e.g. ) This shouldn’t affect machine boot, as machines will normally try PXE as a fallback boot method if HTTP boot fails. Be aware, though, that machine boot will fail if the BIOS is configured to boot only over HTTP; those machines need to be reconfigured to use PXE.

30-maas-01-bmc-config parameter additions

Four new parameters have been added for IPMI BMC configuration. These parameters will pull from the global defaults, eliminating the need to set the corresponding parameter in each instance.

Note that MAAS will not capture the BMC MAC address when detecting IPMI BMCs.

New global IPMI configuration options

Two new global IPMI configuration options have been added:

Addition of IPMI config options to UI

You may now set the global configuration options maas_auto_ipmi_user, maas_auto_ipmi_k_g_bmc_key, and maas_auto_ipmi_user_privilege_level on the "Settings" page in the UI under "Commissioning."

New maas.power CLI command

Available in all MAAS 2.9 releases is the new maas.power CLI command. This command interfaces directly with the supported MAAS power drivers. This command can be used to control the power on a machine before it has been added to MAAS, for all maas supported power drivers. You can get power status, turn machines on or off, and cycle power. The maas.power --help shows usage details, including syntax for naming each power type (consistent with other MAAS CLI commands).

IPMI BMC detection improvements (RAD)

This release adds two improvements to IPMI BMC detection capability:

Reader Adaptive Documentation (RAD)

This release features Reader Adaptive Documentation, which allows you to adapt individual pages to your install method (Snap vs. Deb), version (2.7/2.8/2.9), and preferred interface (CLI/UI).

Offline documentation

This release will include offline documentation for those users whose MAAS installations reside behind firewalls, unable to access the online documentation.

BMC improvements

Three substantial improvements to BMC usage have been released:

IPMI power driver upgrades

Three new configuration options have been added to the IPMI power driver:

See the 2.9 UI or 2.9 CLI power management pages for details.

Improvements in enlistment scripting

Script flow and capabilities have been improved in three ways:

  1. `maas-run-remote-scripts` can now enlist machines.
  2. Enlistment `user_data` scripts have been removed.
  3. The metadata endpoints `http://:5240//` and `http://:5240//meta-data/` are now available anonymously for use during enlistment.

Major improvements to commissioning script capabilities

Seven major improvements were made to commissioning script flow and capabilities:

  1. Commissioning scripts can now send BMC configuration data
  2. Commissioning scripts can now be used to configure BMC data.
  3. The environment variable BMC_CONFIG_PATH is passed to serially run commissioning scripts.
  4. These scripts may write BMC power credentials to BMC_CONFIG_PATH in a YAML format where each key is the power parameter.
  5. If the commissioning script returns 0, it will be sent to MAAS.
  6. The first script to write BMC_CONFIG_PATH is the only script that may configure the BMC, allowing you to override MAAS's builtin BMC detection.
  7. All builtin commissioning scripts have been migrated into the database.

Commissioning script reordering

Commissioning scripts have been reordered and some are now set to run in parallel. You can now easily set a script to run before the builtin MAAS commissioning scripts. There are nine significant changes:

  1. 00-maas-03-install-lldpd -> 20-maas-01-install-lldpd
  2. 00-maas-05-dhcp-unconfigured-ifaces -> 20-maas-02-dhcp-unconfigured-ifaces
  3. 99-maas-05-kernel-cmdline -> maas -kernel-cmdline
  4. 00-maas-00-support-info -> maas-support-info(now runs in parallel)
  5. 00-maas-01-lshw -> maas-lshw(now runs in parallel)
  6. 00-maas-04-list-modaliases -> maas-list-modaliases(now runs in parallel)
  7. 00-maas-06-get-fruid-api-data -> maas-get-fruid-api-data(now runs in parallel)
  8. 00-maas-08-serial-ports -> maas-serial-ports(now runs in parallel)
  9. 99-maas-01-capture-lldp -> maas-capture-lldp(now runs in parallel)

See the commissioning logs page for more details on these changes.

Improvements in commissioning speed and logging

Four improvements have been made to speed up the commissioning process, mostly by running scripts in parallel (see above):

  1. Commissioning should now take 60s.
  2. Logging has been added to 20-maas-01-install-lldpd (commissioning log output).
  3. Logging added to 20-maas-02-dhcp-unconfigured-ifaces (commissioning log output).
  4. `user_data` can now be input directly into the UI.

Bug fixes

Bugs fixed in 2.9.2 release

Bugs fixed in 2.9.1 release

Bugs fixed in 2.9 release

Known issues

RAD LHS menu

There is a known issue with the Reader Adaptive Documentation left-hand-side menu (navigation), in that the menu links cannot currently be adapted to the RAD parameters. This means that selecting a different page in the LHS menu will take you the the RAD for the current recommended version. Every page that is different in RAD, though, should present you with a top menu, so that you can choose the RAD parameters matching your own preferences.

Erroneous message about "missing migration"

When upgrading to any release above 2.8, using packages, you may receive a warning about missing migration(s) -- specifically something that looks like this:

Setting up maas-common (2.8.3~rc1-8583-g.9ddc8051f-0ubuntu1~18.04.1) ...
Setting up maas-region-api (2.8.3~rc1-8583-g.9ddc8051f-0ubuntu1~18.04.1) ...
Setting up maas-region-controller (2.8.3~rc1-8583-g.9ddc8051f-0ubuntu1~18.04.1) ...
Operations to perform:
  Apply all migrations: auth, contenttypes, maasserver, metadataserver, piston3, sessions, sites
Running migrations:
  No migrations to apply.
  Your models have changes that are not yet reflected in a migration, and so won't be applied.
  Run ' makemigrations' to make new migrations, and then re-run ' migrate' to apply them.

This warning message has no effect on the installation or operation of MAAS, so it can be safely ignored.