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

Get to know your machines

As an exercise, let’s create some virtual machines with MAAS and find out how to examine them. Be sure you’ve completed this tutorial first, so that everything is set up and running.

Step 1: Create a virtual machine

Create your first virtual machine with the following procedure:

  1. Open your web browser and access the MAAS web interface.

  2. In the MAAS navigation menu, click on “KVM” and then select “LXD”.

  3. Choose the LXD KVM host you previously created in the previous tutorial, or any other available LXD KVM host.

  4. Select “Add VM”.

  5. Optionally, provide a name for the new VM.

  6. Scroll down to the “Compose machine” section and select it. You should see a success message shortly after.

  7. Navigate to the “Hardware” tab and click on “Machines”.

  8. Look for the newly created-machine by checking for the “Commissioning” message.

  9. Underneath the “Commissioning” status, you will see MAAS progressing through the various stages of commissioning for the machine. This process may take a few minutes.

  10. Watch for the machine to change to the “Ready” status, and switch off.

Congratulations! You just created your first MAAS machine.

Step 2: Get to know your new machine

Select the machine name; MAAS will zoom in on the machine, displaying several tabs across the top. Let’s briefly run through each tab in turn, using typical values for a standard LXD VM (yours may vary some).

Status tab

The “Virtual Machine Status” section provides an overview of the current status and configuration of the virtual machine. Let’s break down the different panels:

Let’s run some tests to assess the virtual machine’s CPU performance. Follow these steps:

  1. Select Test CPU….

  2. In the displayed panel, select Start tests for machine. Notice that the Test… button in the CPU panel will transform into a hyperlinked number, accompanied by the phrase View results.

  3. Select the hyperlinked number to navigate to the Tests tab. Most likely, several tests will be listed as Pending.

  4. Switch to the Summary tab and click on View results; this action will also redirect you to the Tests tab.

  5. Keep an eye on the Tests tab as the tests are being executed.

  6. Periodically, access the Logs section to view more detailed status updates about the ongoing testing process.

  7. If you wish to stop the tests, do this: Go to the navigation menu, select Hardware > Machines, mark the checkbox corresponding to the machine undergoing tests, and choose Actions > Abort (confirm the action when prompted).

Feel free to explore other Test… options independently. By following these steps, you can evaluate the the fitness and performance of the virtual machine and monitor the progress of the tests.

Network tab

The network tab in MAAS provides a comprehensive overview of the network configuration for your machines. It displays essential information such as interfaces, bonds, bridges, VLANs, subnets, and DHCP snippets. Each entry in the table represents a distinct network element and includes details like MAC address, link speed, associated fabric, subnet information, and more. Additionally, you can perform various actions related to network management, such as adding interfaces, creating bonds and bridges, and validating the network configuration.

For the moment, let’s ignore most of the buttons on this page and explore the central table that describes the interfaces. Reviewing the table, we find the following columns: