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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
.\" Hey, EMACS: -*- nroff -*-
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH install_packages 8 "January 2026" "FAI 6.5"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.de }1
.ds ]X \&\\*(]B\\
.nr )E 0
.if !"\\$1"" .nr )I \\$1n
.}f
.ll \\n(LLu
.in \\n()Ru+\\n(INu+\\n()Iu
.ti \\n(INu
.ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
.br\}
.el \\*(]X\h|\\n()Iu+\\n()Ru\c
.}f
..
.\"
.\" File Name macro. This used to be `.PN', for Path Name,
.\" but Sun doesn't seem to like that very much.
.\"
.de FN
\fI\|\\$1\|\fP
..
.SH NAME
install_packages \- install FAI configured packages
.SH SYNOPSIS
.B install_packages
.SH DESCRIPTION
This command is only called internally by FAI and not directly by the user.
install_packages is a Perl script written for FAI to selectively install, hold,
remove, or purge packages or tasks. Its function is to parse the package_config files based on
the class definitions of the client. For example, if the client belonged to
the SMTPSERVER class, install_packages would parse ../package_config/SMTPSERVER
for instructions on what packages to install, hold, remove, or purge.
.SH OPTIONS
.TP
.B \-c
Check the list of packages if they are known, then exit. This only
works for deb packages.
.TP
.B \-d
Only download packages instead of installing them. Variable
$aptoptions must be set.
.TP
.B \-h
Show help, version and summary of options.
.TP
.B \-G
Generic mode. Use when install_packages is called by fai-mirror (using
-IG) to create a generic package mirror for different combinations of
the class list. This option ignores the logical not operator on
PACKAGES lines and ignores package with suffix - (like packagename-)
and only makes sense in download mode.
.TP
.B \-H
Show list of all available commands for the file in package_config.
.TP
.B \-l
Print only the list of all packages that would be installed, then exit.
.TP
.B \-L
Print the list of all packages with version number that would be installed, then exit.
.TP
.B \-m MAX
Install only MAX packages at a time. Same as setting the shell
environment variable MAXPACKAGES.
.TP
.BI "\-n "
Dry run. Do not execute installation commands, just print them.
.TP
.B \-N
Do not check package names whether they are valid and remove unknown
packages from the list. You can also set the variable
FAI_DISABLE_PACKAGE_NAME_CHECK to 1.
.TP
.B \-P
Print the URIs of all packages that needs download. Only usefull when also using -d.
.TP
.BI "\-p " DIRECTORY
Read the configuration files from DIRECTORY instead of $FAI/packages_config.
.TP
.B -s
Download source of binary packages that are installed. Currently supported
only for apt-get/aptitude based installations.
.TP
.B \-v
Be verbose.
.SH NOTES
.PD 0
install_packages expects to find the FAI_ROOT directory, the location of class
definitions, package configurations, and custom install scripts, somewhere in
the filesystem.
.PD
.SH SEE ALSO
.PD 0
\fIapt\fP(1), \fIaptitude\fP(8), \fIapt-get\fP(8), \fIdpkg\fP(8), \fItasksel\fP(1)
This program is part of FAI (Fully Automatic Installation). See the FAI manual
for more information on how to use install_packages. The FAI homepage is
https://fai-project.org.
.PD
.SH FILES
.PD 0
.TP
.FN /srv/fai/config/package_config/
The FAI package configuration directory.
.SH AUTHOR
Thomas Lange <lange@cs.uni-koeln.de>
|
