summaryrefslogtreecommitdiff
path: root/src/getting-started-maas.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/getting-started-maas.txt')
-rw-r--r--src/getting-started-maas.txt29
1 files changed, 21 insertions, 8 deletions
diff --git a/src/getting-started-maas.txt b/src/getting-started-maas.txt
index adc446b..74622a5 100644
--- a/src/getting-started-maas.txt
+++ b/src/getting-started-maas.txt
@@ -1,8 +1,12 @@
-MAAS, which stands for *Metal As A Service* allows you to run physical servers as if they were virtual machine instance. This means you can configure, deploy and manage bare metal servers just like you would virtual machines in a cloud environment like Amazon AWS or Microsoft Azure. MAAS gives you the management tools that have made the cloud popular, but with the additional benefits of owning your own hardware.
+Canonical's Metal As A Service (MAAS) allows you to deploy and manage physical hardware in the same way you can deploy and manage virtual machines. This means you can configure, deploy and manage bare metal servers just like you would VMs running on Amazon AWS or Microsoft Azure. MAAS gives you the management tools that have made the cloud popular, but with the additional benefits of physical hardware.
-To run MAAS you'll need a server to run the management software and at least one server which can be managed with a BMC. Canonical recommends letting the MAAS server provide DHCP and DNS for the network the managed machines are connected to. If your setup requires a different approach to DHCP, see the MAAS documentation for more details on how DHCP works in MAAS and how you can adapt it to your current setup.
+To use MAAS you'll need a server to run the management software and at least one server which can be managed with a BMC (once MAAS in installed you can select different BMC power types according to your hardware setup).
-To install MAAS first download Ubuntu Server 18.04 LTS and follow the step-by-step installation instructions to set up Ubuntu on your MAAS server. Once you have Ubuntu 18.04 up and running, you can install MAAS. To get the latest development release of MAAS, use the PPA `maas/next`. First add the PPA, then update and install.
+Canonical recommends letting the MAAS server handle DHCP for the network the managed machines are connected to, but if your current infrastructure requires a different approach to DHCP there are other options. The MAAS documentation has more details on [how DHCP works in MAAS](https://docs.maas.io/2.6/en/installconfig-network-dhcp) and how you can adapt it to your current setup.
+
+To install MAAS first download Ubuntu Server 18.04 LTS and follow the step-by-step installation instructions to set up Ubuntu on your server. Once you have Ubuntu 18.04 up and running, you can install MAAS.
+
+To get the latest development release of MAAS, use the [maas/next PPA](https://launchpad.net/~maas/+archive/ubuntu/next). First add the PPA, then update and install.
~~~~console
sudo add-apt-repository ppa:maas/next
@@ -20,16 +24,25 @@ The init command will ask you ask you to create a username and password for the
Once the installation is done you can login to the web-based MAAS GUI by pointing your browser to http://<your.maas.ip>:5240/MAAS/.
-maas-01.png
+<img src="maas-01.png" alt="MAAS web UI login screen" />
-Once you login to the MAAS web UI you'll be presented with the MAAS configuration panel where you can set the region name, configure a DNS forwarder for domains not managed by MAAS, as well as configure the images and architectures you want available for MAAS.
+Once you login to the MAAS web UI you'll be presented with the MAAS configuration panel where you can set the region name, configure a DNS forwarder for domains not managed by MAAS, as well as configure the images and architectures you want available for MAAS-managed machines.
-maas-01.png
+<img src="maas-02.png" alt="MAAS web UI initial setup screen" />
-Here you can accept the defaults and click continue. If you did not add your SSH keys in the init step, you'll need to upload them now. Then click "Go to Dashboard" to continue.
+For now you can accept the defaults and click continue. If you did not add your SSH keys in the initialization step, you'll need to upload them now. Then click "Go to Dashboard" to continue.
+
+<img src="maas-04.png" alt="MAAS web UI SSH keys screen" />
The last step is to configure DHCP. When the MAAS Dashboard loads it will alert you that "DHCP is not enabled on any VLAN." To setup DHCP click the "Subnets" menu item and then click the VLAN where you want to enable DHCP.
+<img src="maas-07.png" alt="MAAS web UI Subnet screen" />
+
This will bring up a new page where you can configure your DHCP subnet, start and end IP addresses, and Gateway IP. You can also decide how MAAS handles DHCP, whether directly from the rack controller or relayed to another VLAN. If you don't want MAAS to manage DHCP you can disable it here.
-To set up your first MAAS instances with MAAS handling DHCP, click the Configure MAAS-managed DHCP button.
+<img src="maas-08.png" alt="MAAS web UI Subnet screen" />
+
+To set up your first MAAS instances with MAAS handling DHCP, click the "Configure MAAS-managed DHCP" button.
+
+<img src="maas-09.png" alt="MAAS web UI Subnet screen" />
+