launchpad-reviewers team mailing list archive

[Gavin Panella <gavin.panella@xxxxxxxxxxxxx>]

Gavin Panella has proposed merging lp:~allenap/maas/docs-and-man-bug-975454 into lp:maas with lp:~allenap/maas/docs-and-man-tidy as a prerequisite.

Commit message:
Remove references to maas-import-pxe-files from HACKING.txt.

Requested reviews:
  Launchpad code reviewers (launchpad-reviewers)
Related bugs:
  Bug #975454 in MAAS: "complete documentation and man pages"
  https://bugs.launchpad.net/maas/+bug/975454

For more details, see:
https://code.launchpad.net/~allenap/maas/docs-and-man-bug-975454/+merge/135259
-- 
https://code.launchpad.net/~allenap/maas/docs-and-man-bug-975454/+merge/135259
Your team Launchpad code reviewers is requested to review the proposed merge of lp:~allenap/maas/docs-and-man-bug-975454 into lp:maas.

=== modified file 'HACKING.txt'
--- HACKING.txt	2012-10-02 17:24:06 +0000
+++ HACKING.txt	2012-11-20 21:54:22 +0000
@@ -178,10 +178,6 @@
 
     $ make sampledata
 
-Install the provisioning server::
-
-    $ sudo apt-get install maas-provision
-
 By default, the snippet ``maas_proxy`` includes a definition for an http
 proxy running on port 8000 on the same host as the MAAS server.  This
 means you can *either* install ``squid-deb-proxy``::
@@ -195,16 +191,6 @@
 
     $ sudo tee -a /etc/tgt/targets.conf < contrib/tgt.conf
 
-Now run ``maas-import-pxe-files`` to download current Ubuntu releases for
-installing nodes::
-
-    $ sudo http_proxy=$http_proxy PATH=$PATH:$PWD/bin:$PWD/scripts \
-        MAAS_PROVISIONING_SETTINGS=$PWD/etc/pserv.yaml \
-        ./scripts/maas-import-pxe-files
-
-This may download dozens or hundreds of megabytes, so depending on your
-network connection it may take a while.
-
 The http_proxy variable is only needed if you're downloading through a
 proxy; "sudo" wouldn't pass it on to the script without the assignment.
 Or if you don't have it set but do want to download through a proxy, pass
@@ -220,12 +206,43 @@
 simple user using the test account (username: 'test', password: 'test') or the
 admin account (username: 'admin', password: 'test').
 
+At this point you may also want to `download PXE boot resources`_.
+
+.. _`download PXE boot resources`: `Downloading PXE boot resources`_
+
 To shut down the database cluster and clean up all other generated files in
 your branch::
 
     $ make distclean
 
 
+Downloading PXE boot resources
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To use PXE booting, each cluster controller needs to download several
+files relating to PXE booting. This process is automated, but it does
+not start by default.
+
+First create a superuser and start all MAAS services::
+
+    $ bin/maas createsuperuser
+    $ make run
+
+Get the superuser's API key on the `account preferences`_ page in web
+UI, and use it to log into MAAS at the command-line::
+
+    $ bin/maascli login dev http://localhost:5240
+
+.. _`account preferences`: http://localhost:5240/account/prefs/
+
+Start downloading PXE boot resources::
+
+    $  bin/maascli dev node-groups import-boot-images
+
+This may download dozens or hundreds of megabytes, so depending on your
+network connection it may take a while.
+
+
 Running the built-in TFTP server
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^