How to manage networks (snap/3.0/UI)
You can easily manage the basic networking elements of MAAS, including subnets, fabrics, VLANs, spaces, and IP ranges. This section shows how to access and edit these elements. See Concepts and terms for the definitions of these networking components.
This section will show you:
- How to enable network discovery
- How to toggle subnet management
- How to access the main networking view
- How to display the subnet window
- How to view the subnet summary
- How to view utilisation
- How to manage static routes between subnets
- How to view reserved ranges
- How to view used IP addresses
- How to set up a bridge with MAAS
- How to set up a bridge with netplan
Network discovery can be disabled or re-enabled using the switch on the Network discovery dashboard.
To disable (or re-enable) subnet management, use the following procedure:
Navigate to the ‘Subnets’ page and select the subnet.
Press the ‘Edit’ button to allow changes; the ‘Managed allocation’ field will become a slide switch.
Click the label (or the switch icon itself) to toggle between enabled (dark blue) and disabled (grey).
Click ‘Save summary’.
The following screenshot illustrates this process.
To access the main networking view visit the ‘Subnets’ page:
This main view can also be filtered either by fabrics or by spaces through the use of the ‘Group by’ drop-down.
Clicking a subnet (here
192.168.100.0/24) will display its detail screen, which contains several sections, described below.
The Subnet summary section is the largest and most complex of the subnet configuration screens:
This screen presents the following configurable options:
Name: Subnet names can be any valid text string. By default, they are named with the CIDR of the subnet itself.
CIDR: This is the address parameter for the subnet. In keeping with standard CIDR notation, the number of bits of the prefix are indicated after the slash.
Gateway IP: This is the address of the default gateway for your subnet, which is the IP address that transfers packets to other subnets or networks. Typically, this is simply the first IP address in a block of addresses (the
DNS: This is the address of a DNS (domain name server, or simply “nameserver”) for your subnet. It’s optional, but can be configured if desired.
Description: This field represents freeform text that you can enter to describe your subnet, as needed to keep important notes attached to the definition of the subnet.
Managed allocation refers to the ability of MAAS to completely manage a subnet.
Active mapping instructs MAAS to scan the subnet every 3 hours to discover hosts that have not been discovered passively.
Proxy access instructs MAAS to allow clients from this subnet to access the MAAS proxy.
Allow DNS resolution allows subnet clients to use MAAS for DNS resolution.
Fabric: This field allows you to set the subnet’s fabric.
VLAN: This field allows you to set the subnet’s VLAN.
Space is presented for clarity, though spaces are managed at the VLAN level.
This section of the subnet page presents metrics regarding address usage by this subnet.
‘Subnet addresses’ shows the total number of addresses associated with the subnet, here 254. ‘Availability’ shows how many of those addresses are unused, and therefore “available”, here 189, which corresponds to a percentage of roughly 74% of the total. Finally, ‘Used’ shows the percentage that is used, here roughly 26%.
To create a static route:
Click the ‘Add static route’ button to reveal the edit pane.
Enter a Gateway IP address.
Select a destination subnet from the ‘Destination’ drop-down list.
Edit the routing metric value if needed.
Click ‘Add’ to activate the route.
Routes can be edited and removed using the icons to the right of each entry.
The reserved ranges section of the subnet screen looks like this:
More details and instructions regarding these ranges can be found in IP ranges.
This section displays hosts (including controllers) associated with the used addresses along with related bits of host information.
At various times in your MAAS network, you may need to set up a bridge to connect between your machines and MAAS, as shown in this section.
It’s essential to enforce usage of IP addresses to avoid domain name conflicts, should different controllers resolve the same domain name with different IP addresses. You should also avoid using 127.0.0.1 when running multiple controllers, as it would confuse MAAS.
To configure a bridge with the MAAS UI:
Select the machine you want to bridge.
Switch to the “Network” tab.
Select the network where you want to create the bridge and click “Create bridge:”
- Configure the bridge on a subnet MAAS controls (you may use any IP mode for the bridge):
When you’re done, it should look something like this:
Then you can deploy machines using this bridge.
NOTE that you can create an “Open vSwitch” bridge if desired, and MAAS will create the netplan model for you.
You can also use netplan to configure a bridge:
Open your netplan configuration file. This should be in
/etc/netplan. It could be called
netplan.yaml, or something else.
Modify the file to add a bridge, using the following example as a guide:
network: bridges: br0: addresses: - 10.0.0.101/24 gateway4: 10.0.0.1 interfaces: - enp1s0 macaddress: 52:54:00:39:9d:f9 mtu: 1500 nameservers: addresses: - 10.0.0.2 search: - maas parameters: forward-delay: 15 stp: false ethernets: enp1s0: match: macaddress: 52:54:00:39:9d:f9 mtu: 1500 set-name: enp1s0 enp2s0: match: macaddress: 52:54:00:df:87:ac mtu: 1500 set-name: enp2s0 enp3s0: match: macaddress: 52:54:00:a7:ac:46 mtu: 1500 set-name: enp3s0 version: 2
- Apply the new configuration with