3. Installing MAAS¶

Installing MAAS on the computer is quite straightforward; you simply use APT. With MAAS installed, you can run the setup-certlab script to configure MAAS for use in an Ubuntu certification environment.

3.1. Install MAAS Snap¶

Follow the procedure below to set up MAAS for certification testing. General guidelines for MAAS installation and setup can be found at https://maas.io/docs.

Install the MAAS snap:
```
$ sudo snap install maas
```
Beginning with Ubuntu 20.04, MAAS is installed via a snap by default, rather than the Debian packages used in earlier versions of Ubuntu. This document assumes MAAS installation via a snap. Use of an older version of Ubuntu is no longer supported.
Verify that MAAS is installed:
```
$ snap info maas | grep installed
```
The output should specify the installed MAAS version, which is 3.7.1 at the time of this writing.

3.2. Install maas-cert-server Package¶

Several scripts and configuration files are available in the maas-cert-server package in the hardware certification PPA. You can install the scripts and configuration files as follows:

$ sudo apt-add-repository ppa:checkbox-dev/stable
$ sudo apt install maas-cert-server

3.3. Configure Network Settings¶

Edit the /etc/maas-cert-server/config file to be sure that the variables it contains are correct. Specifically:
- INTERNAL_NET must point to your internal network device (eth0 in the below examples).
- EXTERNAL_NET must point to your external network device (eth1 in the below examples).
- Do not adjust other values without consulting with the Server Certification Team.
- Note that there must not be spaces surrounding the equal signs (=) in the assignments!
Optionally create a /var/snap/maas/current/iperf.conf file to identify your iperf3 server(s). This file should consist of a single line that contains a comma-delimited list of IP addresses, each identifying a different iperf3 server. If this file is absent, SUTs will configure themselves to use their network gateways (normally the MAAS server) as the iperf3 target. If /etc/maas-cert-server/iperf.conf is present, though, MAAS will tell SUTs to use the specified system(s) instead. You might use this feature if your iperf3 server is not the SUTs’ network gateway or if you have multiple iperf3 servers. The SUTs will attempt to use each iperf3 target in series until the network test passes or until the list is exhausted. This setting can be overridden on SUTs by editing the /etc/xdg/canonical-certification.conf file on the SUT. See Appendix B: Network Testing Options for more on advanced network testing configurations.