launchpad-reviewers team mailing list archive

[Nick Veitch <nick.veitch@xxxxxxxxxxxxx>]

Nick Veitch has proposed merging lp:~evilnick/maas/cluster-docs into lp:maas.

Commit message:
Add docs explaining additional cluster controller setup

Requested reviews:
  Launchpad code reviewers (launchpad-reviewers)

For more details, see:
https://code.launchpad.net/~evilnick/maas/cluster-docs/+merge/140213

Doc changes: Adds the section and additional images for addign cluster controllers to a MAAS setup. (replacement)
-- 
https://code.launchpad.net/~evilnick/maas/cluster-docs/+merge/140213
Your team Launchpad code reviewers is requested to review the proposed merge of lp:~evilnick/maas/cluster-docs into lp:maas.

=== modified file 'docs/configure.rst'
--- docs/configure.rst	2012-11-27 21:44:25 +0000
+++ docs/configure.rst	2012-12-17 14:48:25 +0000
@@ -179,3 +179,49 @@
   Future versions of MAAS are likely to replace this type of automatic 
   installation with a different installer.
 
+
+Installing additional clusters
+------------------------------
+
+In an environment comprising large numbers of nodes, it is likely that you will
+want to organise the nodes on a more distributed basis. The standard install of
+the MAAS region controller includes a cluster controller, but it is 
+possible to add additional cluster controllers to the configuration, as 
+shown in the diagram below:
+
+.. image:: media/orientation_architecture-diagram.*
+
+Each cluster controller will need to run on a separate Ubuntu server. 
+Installing and configuring the software is straightforward though:: 
+
+  $ sudo apt-get install maas-cluster-controller
+
+This meta-package will install all the basic requirements of the system. 
+However, you may also wish or need to run DHCP and/or DNS services, in
+which case you should also specify these::
+
+  $ sudo apt-get install maas-cluster-controller maas-dhcp maas-dns
+
+Configuring the cluster controller
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Once the packages are installed, the cluster controller needs to know
+where to look for the region controller. This is achieved using `dpkg` to 
+configure the software::
+
+  $ dpkg-reconfigure maas-cluster-controller
+
+.. image:: media/cluster-config.*
+
+The configuration script should then bring up a screen where you can 
+enter the IP address of the region controller. Additionally, you will need
+to run the `maas-import-pxe-files` script to install the distro image files
+locally for commissioning::
+
+  $ maas-cli maas node-groups import-boot-images
+
+...and optionally set up the DHCP and DNS for 
+the cluster by first :ref:`logging in to the API <api-key>` and then
+:ref:`following this procedure <cli-dhcp>` 
+
+

=== added file 'docs/media/cluster-config.png'
Binary files docs/media/cluster-config.png	1970-01-01 00:00:00 +0000 and docs/media/cluster-config.png	2012-12-17 14:48:25 +0000 differ