Merge lp:~jtv/maas/pkg-bug-1376620 into lp:~maas-maintainers/maas/packaging

[Jeroen T. Vermeulen]

The maas-url config item is used not just to let cluster controllers find the region API, but to let nodes find it as well. At least one user thought they could use 127.0.0.1 in the URL, which will typically work for the cluster controller but not for the nodes.

I also made it say “region controller” rather than “server” as the counterpart to “cluster controller.”

Jeroen

[Graham Binns (gmb)]

I think there's still a risk of folk just not getting that 127.0.0.1 / localhost just isn't a valid host. Why not:

 "The MAAS cluster controller and nodes need to contact the MAAS region controller API. Set the URL at which they can reach the MAAS API here, e.g. http://192.168.1.1/MAAS.
  Note that this URL must be accessible outside of the region controller machine, so localhost or 127.0* are not valid hostnames here."

(That sentence needs some polish, but you get my meaning.)

[Graham Binns (gmb)]

(Oops, forgot the approval…)

review: Approve

=== modified file 'debian/maas-cluster-controller.templates'
--- debian/maas-cluster-controller.templates	2012-10-03 05:53:38 +0000
+++ debian/maas-cluster-controller.templates	2014-10-02 09:58:33 +0000
@@ -2,6 +2,8 @@
 Type: string
 Default:
 _Description: Ubuntu MAAS API address:
- The MAAS Cluster Controller needs to contact the MAAS server to
- register its presence.  Set the URL to the MAAS API here, e.g.
- http://192.168.1.1/MAAS
+ The MAAS cluster controller and nodes need to contact the MAAS region
+ controller API.  Set the URL at which they can reach the MAAS API remotely,
+ e.g.  http://192.168.1.1/MAAS
+ Since nodes must be able to access this URL, localhost or 127.0.0.1 are not
+ useful values here.