Code

Tagged 2.7.3
[gosa.git] / gosa-si / server.conf.pod
2 =head1 NAME
4 gosa-si-server.conf - Configuration file for gosa-si-server.
7 =head1 DESCRIPTION
9 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 gosa-si-server(1) program during installation. 
11 =head1 DIRECTIVES
14 =head2 [General]
16 =over 4
18 =item logfile = /var/log/gosa-si/gosa-si-server.log
20 Defines the location for the log file.
22 =item pid-file = /var/run/gosa-si/gosa-si-server.pid
23 Defines the location for the pid file.
25 =back
28 =head2 [Server]
30 =over 4
32 =item ip = 1.2.3.4
34 Defines the ip address GOsa-SI-server should use. Default: GOsa-SI determines the the ip address based on the destination address.
36 =item port = 20081
38 Defines the port GOsa-SI-server is listening for incoming messages.
40 =item known-clients = /var/lib/gosa-si/clients.db
42 Defines the location for the local DB 'known_clients'.
44 =item known-server = /var/lib/gosa-si/servers.db
46 Defines the location for the local DB 'known_server'.
48 =item incoming = /var/lib/gosa-si/incoming.db
50 Defines the location for the local DB 'incoming'.
52 =item login-users = /var/lib/gosa-si/users.db
54 Defines the location for the local DB 'login_users'.
56 =item fai-server = /var/lib/gosa-si/fai_server.db
58 Defines the location for the local DB 'fai_server'.
60 =item fai-release = /var/lib/gosa-si/fai_release.db
62 Defines the location for the local DB 'fai_release'.
64 =item packages-list = /var/lib/gosa-si/packages.db
66 Defines the location for the local DB 'packages_list'.
68 =item messaging = /var/lib/gosa-si/messaging.db
70 Defines the location for the local DB 'messaging'.
72 =item foreign-clients = /var/lib/gosa-si/foreign_clients.db
74 Defines the location for the local DB 'foreign_clients'.
76 =item source-list = /etc/apt/sources.list
78 Defines the location for the sources file. 
80 =item repo-path = /srv/www/
82 Defines the location of the dak Archive or local Debian Mirror and is scanned for Debian Packages.
84 =item debian-arch = i386
86 Defines the architecture of the debian repository.
88 =item ldap-uri = 
90 Defines the LDAP uniform resource identifier.
92 =item ldap-base = 
94 Defines the LDAP base. 
96 =item ldap-admin-dn = 
98 Defines the distinguished name of the administrator.
100 =item ldap-admin-password = 
102 Defines the password of the administrator.
104 =item ldap-version = 3
106 Define the ldap protocol version used
108 =item ldap-retry-sec = 10
110 Define the number of second gosa-si-server should wait if ldap is not available
112 =item gosa-unit-tag = 
114 Forces the Unit-Tag in a tagged environment. If not set, GOsa-SI tries to get the tag from the server entry in LDAP.
116 =item max-clients = 10
118 Defines the maximum number of GOsa-SI-clients connected to the GOsa-SI-server.
120 =item wol-password =
122 Defines the password for wake on LAN (WOL).
124 =back
126 =head2 [GOsaPackages]
128 =over 4
130 =item job-queue = /var/lib/gosa-si/jobs.db
132 Defines the location for the local DB 'job_queue'.
134 =item job-queue-loop-delay = 3
136 Defines the seconds the job queue is checked. 
138 =item messaging-db-loop-delay = 3
140 Defines the seconds the messaging queue is checked.
142 =item key = none
144 Defines the password incoming GOsaPackages messages should be encrypted. This has to be modified, default value will not work!!!
146 =item new-systems-ou = ou=workstations,ou=systems
148 Define the branch in your ldap tree where new systems should be put, only change if you know what you are doing !!!
150 =item dak-base = /srv/archive
152 Base Directory of the local dak Archive.
154 =item dak-keyring = /srv/archive/keyrings
156 Directory with keyrings that hold the gpg-keys the archive accepts when uploading Debian packages.
158 =item dak-queue = /srv/archive/queue
160 Directory with the different dak queues.
162 =item dak-usr = deb-dak
164 User that is used to access dak files. Only needed if you have manually changed the default.
166 =back
169 =head2 [ClientPackages]
171 =over 4
173 =item key = none
175 Defines the password incoming ClientPackages messages should be encrypted. This has to be modified, default value will not work!!!
177 =item user-date-of-expiry = 600
179 Lifetime of logged in user information. If no update information comes after n seconds,
180 the user is marked to be no longer logged in or the host is no longer running.
182 =back
185 =head2 [ServerPackages]
187 =over 4
189 =item address = 
191 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 DNS. 
193 =item dns-lookup = true
195 Perform a DNS lookup for server registration
197 =item domain =
199 Forces the search domain used to get possible foreign servers from DNS. If not set, this server will search the domains found in domain or search statement in /etc/resolv.conf.
201 =item key = none
203 Defines the password incoming ServerPackages messages should be encrypted. This has to be modified, default value will not work!!!
205 =item key-lifetime = 120
207 Defines the lifetime in seconds of a GOsa-SI-server key. After expiring the key will be automatically renewed. 
209 =item job-synchronization-enabled = true
211 Defines whether job queue information are be shared with other GOsa-SI-server in network.
213 =item synchronization-loog = 5
215 Defines in seconds after which time the job queue synchronization is being done. 
217 =back
220 =head2 [ArpHandler]
222 =over
224 =item enabled = false
226 Defines whether the ArpHandler is being activated at GOsa-SI-server start.
228 =item interface = all
230 Space- or comma-separated list of interfaces on which to start an ARP-Daemon. Enter 'all' to use all possible interfaces (Default).
232 =back
234 =head2 [Opsi]
236 =over 4
238 =item enabled = false
240 Defines whether Opsi integration is being enabled or not.
242 =item server = localhost
244 Define the hostname of the Opsi server
246 =item admin = opsi-admin
248 Define the name of the opsi admin
250 =item password =  
252 Define the Opsi admin password
254 =back
256 =head1 BUGS 
258 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>
261 =head1 LICENCE AND COPYRIGHT
263 This code is part of GOsa (L<http://www.gosa-project.org>)
265 Copyright (C) 2003-2010 GONICUS GmbH
267 This program is distributed in the hope that it will be useful,
268 but WITHOUT ANY WARRANTY; without even the implied warranty of
269 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
270 GNU General Public License for more details.
274 =cut