86e1f390ec40bb5a23cb514314cce70bb35d3e9e
1 .\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.07)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 . de IX
53 . tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 . nr % 0
56 . rr F
57 .\}
58 .el \{\
59 . de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
66 .if n \{\
67 . ds #H 0
68 . ds #V .8m
69 . ds #F .3m
70 . ds #[ \f1
71 . ds #] \fP
72 .\}
73 .if t \{\
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 . ds #V .6m
76 . ds #F 0
77 . ds #[ \&
78 . ds #] \&
79 .\}
80 . \" simple accents for nroff and troff
81 .if n \{\
82 . ds ' \&
83 . ds ` \&
84 . ds ^ \&
85 . ds , \&
86 . ds ~ ~
87 . ds /
88 .\}
89 .if t \{\
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 . ds : e
114 . ds 8 ss
115 . ds o a
116 . ds d- d\h'-1'\(ga
117 . ds D- D\h'-1'\(hy
118 . ds th \o'bp'
119 . ds Th \o'LP'
120 . ds ae ae
121 . ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "SERVER.CONF 1"
127 .TH SERVER.CONF 1 "2010-05-15" "perl v5.10.0" "User Contributed Perl Documentation"
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 gosa\-si\-server.conf \- Configuration file for gosa\-si\-server.
134 .SH "DESCRIPTION"
135 .IX Header "DESCRIPTION"
136 The gosa\-si\-server.conf file defines all parameter GOsa-SI-server needs for running. It is normally located in the /etc/gosa\-si/ directory and is generated automatically by the \fIgosa\-si\-server\fR\|(1) program during installation.
137 .SH "DIRECTIVES"
138 .IX Header "DIRECTIVES"
139 .SS "[General]"
140 .IX Subsection "[General]"
141 .IP "logfile = /var/log/gosa\-si\-server.log" 4
142 .IX Item "logfile = /var/log/gosa-si-server.log"
143 Defines the location for the log file.
144 .IP "pid-file = /var/run/gosa\-si\-server.pid Defines the location for the pid file." 4
145 .IX Item "pid-file = /var/run/gosa-si-server.pid Defines the location for the pid file."
146 .SS "[Server]"
147 .IX Subsection "[Server]"
148 .PD 0
149 .IP "ip = 1.2.3.4" 4
150 .IX Item "ip = 1.2.3.4"
151 .PD
152 Defines the ip address GOsa-SI-server should use. Default: GOsa-SI determines the the ip address based on the destination address.
153 .IP "port = 20081" 4
154 .IX Item "port = 20081"
155 Defines the port GOsa-SI-server is listening for incoming messages.
156 .IP "known-clients = /var/lib/gosa\-si/clients.db" 4
157 .IX Item "known-clients = /var/lib/gosa-si/clients.db"
158 Defines the location for the local \s-1DB\s0 'known_clients'.
159 .IP "known-server = /var/lib/gosa\-si/servers.db" 4
160 .IX Item "known-server = /var/lib/gosa-si/servers.db"
161 Defines the location for the local \s-1DB\s0 'known_server'.
162 .IP "incoming = /var/lib/gosa\-si/incoming.db" 4
163 .IX Item "incoming = /var/lib/gosa-si/incoming.db"
164 Defines the location for the local \s-1DB\s0 'incoming'.
165 .IP "login-users = /var/lib/gosa\-si/users.db" 4
166 .IX Item "login-users = /var/lib/gosa-si/users.db"
167 Defines the location for the local \s-1DB\s0 'login_users'.
168 .IP "fai-server = /var/lib/gosa\-si/fai_server.db" 4
169 .IX Item "fai-server = /var/lib/gosa-si/fai_server.db"
170 Defines the location for the local \s-1DB\s0 'fai_server'.
171 .IP "fai-release = /var/lib/gosa\-si/fai_release.db" 4
172 .IX Item "fai-release = /var/lib/gosa-si/fai_release.db"
173 Defines the location for the local \s-1DB\s0 'fai_release'.
174 .IP "packages-list = /var/lib/gosa\-si/packages.db" 4
175 .IX Item "packages-list = /var/lib/gosa-si/packages.db"
176 Defines the location for the local \s-1DB\s0 'packages_list'.
177 .IP "messaging = /var/lib/gosa\-si/messaging.db" 4
178 .IX Item "messaging = /var/lib/gosa-si/messaging.db"
179 Defines the location for the local \s-1DB\s0 'messaging'.
180 .IP "foreign-clients = /var/lib/gosa\-si/foreign_clients.db" 4
181 .IX Item "foreign-clients = /var/lib/gosa-si/foreign_clients.db"
182 Defines the location for the local \s-1DB\s0 'foreign_clients'.
183 .IP "source-list = /etc/apt/sources.list" 4
184 .IX Item "source-list = /etc/apt/sources.list"
185 Defines the location for the sources file.
186 .IP "repo-path = /srv/www/repository" 4
187 .IX Item "repo-path = /srv/www/repository"
188 Defines the location of the dak Archive or local Debian Mirror and is scanned for Debian Packages.
189 .IP "debian-arch = i386" 4
190 .IX Item "debian-arch = i386"
191 Defines the architecture of the debian repository.
192 .IP "ldap-uri =" 4
193 .IX Item "ldap-uri ="
194 Defines the \s-1LDAP\s0 uniform resource identifier.
195 .IP "ldap-base =" 4
196 .IX Item "ldap-base ="
197 Defines the \s-1LDAP\s0 base.
198 .IP "ldap-admin-dn =" 4
199 .IX Item "ldap-admin-dn ="
200 Defines the distinguished name of the administrator.
201 .IP "ldap-admin-password =" 4
202 .IX Item "ldap-admin-password ="
203 Defines the password of the administrator.
204 .IP "ldap-version = 3" 4
205 .IX Item "ldap-version = 3"
206 Define the ldap protocol version used
207 .IP "ldap-retry-sec = 10" 4
208 .IX Item "ldap-retry-sec = 10"
209 Define the number of second gosa-si-server should wait if ldap is not available
210 .IP "gosa-unit-tag =" 4
211 .IX Item "gosa-unit-tag ="
212 Forces the Unit-Tag in a tagged environment. If not set, GOsa-SI tries to get the tag from the server entry in \s-1LDAP\s0.
213 .IP "max-clients = 10" 4
214 .IX Item "max-clients = 10"
215 Defines the maximum number of GOsa-SI-clients connected to the GOsa-SI-server.
216 .IP "wol-password =" 4
217 .IX Item "wol-password ="
218 Defines the password for wake on \s-1LAN\s0 (\s-1WOL\s0).
219 .SS "[GOsaPackages]"
220 .IX Subsection "[GOsaPackages]"
221 .IP "job-queue = /var/lib/gosa\-si/jobs.db" 4
222 .IX Item "job-queue = /var/lib/gosa-si/jobs.db"
223 Defines the location for the local \s-1DB\s0 'job_queue'.
224 .IP "job-queue-loop-delay = 3" 4
225 .IX Item "job-queue-loop-delay = 3"
226 Defines the seconds the job queue is checked.
227 .IP "messaging-db-loop-delay = 3" 4
228 .IX Item "messaging-db-loop-delay = 3"
229 Defines the seconds the messaging queue is checked.
230 .IP "key = none" 4
231 .IX Item "key = none"
232 Defines the password incoming GOsaPackages messages should be encrypted. This has to be modified, default value will not work!!!
233 .IP "new-systems-ou = ou=workstations,ou=systems" 4
234 .IX Item "new-systems-ou = ou=workstations,ou=systems"
235 Define the branch in your ldap tree where new systems should be put, only change if you know what you are doing !!!
236 .IP "dak-base = /srv/archive" 4
237 .IX Item "dak-base = /srv/archive"
238 Base Directory of the local dak Archive.
239 .IP "dak-keyring = /srv/archive/keyrings" 4
240 .IX Item "dak-keyring = /srv/archive/keyrings"
241 Directory with keyrings that hold the gpg-keys the archive accepts when uploading Debian packages.
242 .IP "dak-queue = /srv/archive/queue" 4
243 .IX Item "dak-queue = /srv/archive/queue"
244 Directory with the different dak queues.
245 .IP "dak-usr = deb-dak" 4
246 .IX Item "dak-usr = deb-dak"
247 User that is used to access dak files. Only needed if you have manually changed the default.
248 .SS "[ClientPackages]"
249 .IX Subsection "[ClientPackages]"
250 .IP "key = none" 4
251 .IX Item "key = none"
252 Defines the password incoming ClientPackages messages should be encrypted. This has to be modified, default value will not work!!!
253 .IP "user-date-of-expiry = 600" 4
254 .IX Item "user-date-of-expiry = 600"
255 Lifetime of logged in user information. If no update information comes after n seconds,
256 the user is marked to be no longer logged in or the host is no longer running.
257 .SS "[ServerPackages]"
258 .IX Subsection "[ServerPackages]"
259 .IP "address =" 4
260 .IX Item "address ="
261 Comma separated list of GOsa-si-servers (1.2.3.4:20081,9.8.7.6:123) in network where this SI-server should register. These given SI-servers extend the list of SI-servers found in \s-1DNS\s0.
262 .IP "dns-lookup = true" 4
263 .IX Item "dns-lookup = true"
264 Perform a \s-1DNS\s0 lookup for server registration
265 .IP "domain =" 4
266 .IX Item "domain ="
267 Forces the search domain used to get possible foreign servers from \s-1DNS\s0. If not set, this server will search the domains found in domain or search statement in /etc/resolv.conf.
268 .IP "key = none" 4
269 .IX Item "key = none"
270 Defines the password incoming ServerPackages messages should be encrypted. This has to be modified, default value will not work!!!
271 .IP "key-lifetime = 120" 4
272 .IX Item "key-lifetime = 120"
273 Defines the lifetime in seconds of a GOsa-SI-server key. After expiring the key will be automatically renewed.
274 .IP "job-synchronization-enabled = true" 4
275 .IX Item "job-synchronization-enabled = true"
276 Defines whether job queue information are be shared with other GOsa-SI-server in network.
277 .IP "synchronization-loog = 5" 4
278 .IX Item "synchronization-loog = 5"
279 Defines in seconds after which time the job queue synchronization is being done.
280 .SS "[ArpHandler]"
281 .IX Subsection "[ArpHandler]"
282 .IP "enabled = false" 4
283 .IX Item "enabled = false"
284 Defines whether the ArpHandler is being activated at GOsa-SI-server start.
285 .IP "interface = all" 4
286 .IX Item "interface = all"
287 Space\- or comma-separated list of interfaces on which to start an ARP-Daemon. Enter 'all' to use all possible interfaces (Default).
288 .SS "[Opsi]"
289 .IX Subsection "[Opsi]"
290 .IP "enabled = false" 4
291 .IX Item "enabled = false"
292 Defines whether Opsi integration is being enabled or not.
293 .IP "server = localhost" 4
294 .IX Item "server = localhost"
295 Define the hostname of the Opsi server
296 .IP "admin = opsi-admin" 4
297 .IX Item "admin = opsi-admin"
298 Define the name of the opsi admin
299 .IP "password =" 4
300 .IX Item "password ="
301 Define the Opsi admin password
302 .SH "BUGS"
303 .IX Header "BUGS"
304 Please report any bugs, or post any suggestions, to the GOsa mailing list <gosa\-devel@oss.gonicus.de> or to <https://oss.gonicus.de/labs/gosa>
305 .SH "LICENCE AND COPYRIGHT"
306 .IX Header "LICENCE AND COPYRIGHT"
307 This code is part of GOsa (<http://www.gosa\-project.org>)
308 .PP
309 Copyright (C) 2003\-2009 \s-1GONICUS\s0 GmbH
310 .PP
311 This program is distributed in the hope that it will be useful,
312 but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
313 \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the
314 \&\s-1GNU\s0 General Public License for more details.