~smoser/ubuntu/trusty/maas/lp-1172566

« back to all changes in this revision

Viewing changes to docs/man/maas-import-pxe-files.8.rst

  • Committer: Package Import Robot
  • Author(s): Andres Rodriguez
  • Date: 2014-04-03 13:45:02 UTC
  • mto: This revision was merged to the branch mainline in revision 58.
  • Revision ID: package-import@ubuntu.com-20140403134502-8a6wvuqwyuekufh0
Tags: upstream-1.5+bzr2227
ImportĀ upstreamĀ versionĀ 1.5+bzr2227

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
The script is usually run regularly by a cron task, though it
15
15
needs to be run manually the first time a MAAS system is installed.
16
16
Images that are already in place are kept unchanged, unless the
17
 
version in the archive has since been updated.
18
 
 
19
 
The script reads a configuration file /etc/maas/import_pxe_files in
 
17
version in the archive has since been updated.  Only new data is
 
18
downloaded, so routine runs will not be costly.
 
19
 
 
20
An easier way to run the script is to trigger it from the MAAS web user
 
21
interface.  To do that, log in to your MAAS as an administrator using a
 
22
web browser, click the cogwheel icon in the top right of the page to go
 
23
to the Clusters page, and click "Import boot images."  This will start
 
24
imports on all cluster controllers simultaneously.  The same thing can
 
25
also be done through the region-controller API, or through the
 
26
command-line interface.
 
27
 
 
28
The script reads a configuration file `/etc/maas/bootresources.yaml` in
20
29
order to determine:
21
30
 
22
 
**ARCHIVE:**
23
 
Location of the Ubuntu download archive
24
 
 
25
 
**RELEASES:**
26
 
Ubuntu releases to download
27
 
 
28
 
**ARCHES:**
29
 
Architectures for which images should be downloaded
30
 
 
31
 
The script uses `wget` to download the kernel and initrd image for
32
 
each architecture in ARCHES and each release in RELEASES.  In addition
33
 
it copies the Intel-architecture pre-boot loader `pxelinux.0` (plus
34
 
some of its modules such as `chain.c32`) from its installed location in
35
 
/usr/lib/syslinux/.
 
31
* the location in the filesystem where downloaded images should be stored,
 
32
  and made available to nodes through TFTP and iSCSI;
 
33
* Simplestream sources from where boot images should be downloaded; and
 
34
* which kinds of images are needed: architecture, operating system
 
35
  release, etc.
36
36
 
37
37
These images are the minimum that's required to start installing a node.
38
38
During installation, a node may download its packages over the network.