1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
.TH maas\-import\-pxe-files 8 "16 July 2012" maas "maas"
.SH NAME
\fBmaas\-import\-pxe-files\fP \- import Ubuntu install images into MAAS
.SH DESCRIPTION
\fBmaas\-import\-pxe\-files\fP downloads Ubuntu images and installs them into
MAAS. The MAAS server needs these images to provides nodes with operating
systems. Images that are already in place are kept unchanged, unless the
version in the archive has since been updated.
The script reads a configuration file \fI/etc/maas/import_pxe_files\fP in
order to determine:
- ARCHIVE: Location of the Ubuntu download archive
- RELEASES: Ubuntu releases to download
- ARCHES: Architectures for which images should be downloaded
(To support development setups that run directly from a code branch, it will
also look for \fIetc/maas/import_pxe_files\fP relative to the current
directory).
The script uses \fBwget\fP(1) to download the kernel and initrd image for
each architecture in ARCHES and each release in RELEASES. In addition it
copies the Intel-architecture pre-boot loader \fBpxelinux.0\fP (plus some
of its modules such as \fBchain.c32\fP) from its installed location in
\fI/usr/lib/syslinux/\fP.
These images are the minimum that's required to start installng a node.
During installation, a node may download its packages over the network.
A \fBcron\fP(8) job typically runs this script at a quiet time every Sunday,
but you may need to run it manually once for a new MAAS installation.
.SH FILES
\fI/etc/maas/import_pxe_files\fP, \fI/etc/cron.d/maas\-import\-pxe\-files\fP
.SH "SEE ALSO"
.BR maas\-import\-ephemerals (8),
.BR cron (8),
.BR wget (1)
.TP
\fIhttp://launchpad.net/maas\fP
.PD
.SH AUTHOR
This manual page and the script were written by Jeroen Vermeulen
<jeroen.vermeulen@canonical.com> for Ubuntu systems, but may be used by
others. Permission is granted to copy, distribute and/or modify this
document and the utility under the terms of the GNU General Public
License, Version 3 published by the Free Software Foundation.
The complete text of the GNU General Public License can be found in
\fI/usr/share/common-licenses/GPL\fP on Debian/Ubuntu systems, or on
the web at \fIhttp://www.gnu.org/licenses/gpl.txt\fP.
|