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
_______________________________________________ Mailing list: https://launchpad.net/~launchpad-reviewers Post to : [email protected] Unsubscribe : https://launchpad.net/~launchpad-reviewers More help : https://help.launchpad.net/ListHelp
