launchpad-reviewers team mailing list archive

[Julian Edwards <julian.edwards@xxxxxxxxxxxxx>]

Julian Edwards has proposed merging lp:~julian-edwards/maas/hacking-deps into lp:maas.

Requested reviews:
  Launchpad code reviewers (launchpad-reviewers)

For more details, see:
https://code.launchpad.net/~julian-edwards/maas/hacking-deps/+merge/118034
-- 
https://code.launchpad.net/~julian-edwards/maas/hacking-deps/+merge/118034
Your team Launchpad code reviewers is requested to review the proposed merge of lp:~julian-edwards/maas/hacking-deps into lp:maas.

=== modified file 'HACKING.txt'
--- HACKING.txt	2012-08-02 07:45:07 +0000
+++ HACKING.txt	2012-08-03 04:17:18 +0000
@@ -248,6 +248,40 @@
     $ make distclean
 
 
+Running the built-in TFTP server
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You will need to run the built-in TFTP server on the real TFTP port (69) if
+you want to boot some real hardware.  By default, it's set to start up on
+port 5244 for testing purposes.  Make these changes::
+
+    * Edit ``etc/pserv.yaml`` to change the tftp/port setting to 69
+    * Install the ``authbind``package:
+
+      $ sudo apt-get install authbind
+
+    * Create a file ``/etc/authbind/byport/69`` that is *executable* by the
+      user running MAAS.
+
+      $ sudo touch /etc/authbind/byport/69
+      $ sudo chmod a+x /etc/authbind/byport/69
+
+Now when starting up the MAAS development webserver, do it like this::
+
+    $ authbind --deep make run
+
+
+Running the Bind daemon for real
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There's a Bind daemon that is started up as part of the development service
+but it runs on port 5246 by default.  If you want to make it run as a real
+DNS server on the box then edit ``services/dns/run`` and change the port
+declaration there so it says::
+
+    port=53
+
+
 Development services
 ====================