~lutostag/ubuntu/trusty/maas/1.5.4+keystone

« back to all changes in this revision

Viewing changes to HACKING.txt

  • Committer: Package Import Robot
  • Author(s): Andres Rodriguez
  • Date: 2013-03-04 11:49:44 UTC
  • mto: This revision was merged to the branch mainline in revision 25.
  • Revision ID: package-import@ubuntu.com-20130304114944-azcvu9anlf8mizpa
Tags: upstream-1.3+bzr1452+dfsg
ImportĀ upstreamĀ versionĀ 1.3+bzr1452+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
178
178
 
179
179
    $ make sampledata
180
180
 
181
 
Install the provisioning server::
182
 
 
183
 
    $ sudo apt-get install maas-provision
184
 
 
185
181
By default, the snippet ``maas_proxy`` includes a definition for an http
186
182
proxy running on port 8000 on the same host as the MAAS server.  This
187
183
means you can *either* install ``squid-deb-proxy``::
195
191
 
196
192
    $ sudo tee -a /etc/tgt/targets.conf < contrib/tgt.conf
197
193
 
198
 
Now run ``maas-import-pxe-files`` to download current Ubuntu releases for
199
 
installing nodes::
200
 
 
201
 
    $ sudo http_proxy=$http_proxy PATH=$PATH:$PWD/bin:$PWD/scripts \
202
 
        MAAS_PROVISIONING_SETTINGS=$PWD/etc/pserv.yaml \
203
 
        ./scripts/maas-import-pxe-files
204
 
 
205
 
This may download dozens or hundreds of megabytes, so depending on your
206
 
network connection it may take a while.
207
 
 
208
194
The http_proxy variable is only needed if you're downloading through a
209
195
proxy; "sudo" wouldn't pass it on to the script without the assignment.
210
196
Or if you don't have it set but do want to download through a proxy, pass
220
206
simple user using the test account (username: 'test', password: 'test') or the
221
207
admin account (username: 'admin', password: 'test').
222
208
 
 
209
At this point you may also want to `download PXE boot resources`_.
 
210
 
 
211
.. _`download PXE boot resources`: `Downloading PXE boot resources`_
 
212
 
223
213
To shut down the database cluster and clean up all other generated files in
224
214
your branch::
225
215
 
226
216
    $ make distclean
227
217
 
228
218
 
 
219
Downloading PXE boot resources
 
220
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
221
 
 
222
To use PXE booting, each cluster controller needs to download several
 
223
files relating to PXE booting. This process is automated, but it does
 
224
not start by default.
 
225
 
 
226
First create a superuser and start all MAAS services::
 
227
 
 
228
    $ bin/maas createsuperuser
 
229
    $ make run
 
230
 
 
231
Get the superuser's API key on the `account preferences`_ page in web
 
232
UI, and use it to log into MAAS at the command-line::
 
233
 
 
234
    $ bin/maascli login dev http://localhost:5240
 
235
 
 
236
.. _`account preferences`: http://localhost:5240/account/prefs/
 
237
 
 
238
Start downloading PXE boot resources::
 
239
 
 
240
    $  bin/maascli dev node-groups import-boot-images
 
241
 
 
242
This sends jobs to each cluster controller, asking each to download
 
243
the boot resources they require. This may download dozens or hundreds
 
244
of megabytes, so it may take a while. To save bandwidth, set an HTTP
 
245
proxy beforehand::
 
246
 
 
247
    $ bin/maascli dev maas set-config name=http_proxy value=http://...
 
248
 
 
249
 
229
250
Running the built-in TFTP server
230
251
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
231
252
 
414
435
``src/maasserver/migrations/<auto_number>_description_of_the_change.py``.  Don't
415
436
forget to add that file to the project with::
416
437
 
417
 
    $ bzr add \
418
 
        src/maasserver/migrations/<auto_number>_description_of_the_change.py
 
438
    $ bzr add src/maasserver/migrations/<auto_number>_description_of_the_change.py
419
439
 
420
440
To apply that migration, run::
421
441
 
439
459
methods where data should be actually migrated. Again, don't forget to
440
460
add that file to the project::
441
461
 
442
 
    $ bzr add \
443
 
        src/maasserver/migrations/<auto_number>_description_of_the_change.py
 
462
    $ bzr add src/maasserver/migrations/<auto_number>_description_of_the_change.py
444
463
 
445
464
Once the methods have been written, apply that migration with::
446
465