gosa-si/server.conf.pod

   1
   2 =head1 NAME
   3
   4 gosa-si-server.conf - Configuration file for gosa-si-server.
   5
   6
   7 =head1 DESCRIPTION
   8
   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.
  10
  11 =head1 DIRECTIVES
  12
  13
  14 =head2 [general]
  15
  16 =over 4
  17
  18 =item logfile = /var/log/gosa-si-server.log
  19
  20 Defines the location for the log file.
  21
  22 =item pid-file = /var/run/gosa-si-server.pid
  23 Defines the location for the pid file.
  24
  25 =back
  26
  27
  28 =head2 [server]
  29
  30 =over 4
  31
  32 =item ip = 1.2.3.4
  33
  34 Defines the ip address GOsa-SI-server should use. Default: GOsa-SI determines the the ip address based on the destination address.
  35
  36 =item port = 20081
  37
  38 Defines the port GOsa-SI-server is listening for incoming messages.
  39
  40 =item known-clients = /var/lib/gosa-si/clients.db
  41
  42 Defines the location for the local DB 'known_clients'.
  43
  44 =item known-server = /var/lib/gosa-si/servers.db
  45
  46 Defines the location for the local DB 'known_server'.
  47
  48 =item incoming = /var/lib/gosa-si/incoming.db
  49
  50 Defines the location for the local DB 'incoming'.
  51
  52 =item login-users = /var/lib/gosa-si/users.db
  53
  54 Defines the location for the local DB 'login_users'.
  55
  56 =item fai-server = /var/lib/gosa-si/fai_server.db
  57
  58 Defines the location for the local DB 'fai_server'.
  59
  60 =item fai-release = /var/lib/gosa-si/fai_release.db
  61
  62 Defines the location for the local DB 'fai_release'.
  63
  64 =item packages-list = /var/lib/gosa-si/packages.db
  65
  66 Defines the location for the local DB 'packages_list'.
  67
  68 =item messaging = /var/lib/gosa-si/messaging.db
  69
  70 Defines the location for the local DB 'messaging'.
  71
  72 =item foreign-clients = /var/lib/gosa-si/foreign_clients.db
  73
  74 Defines the location for the local DB 'foreign_clients'.
  75
  76 =item source-list = /etc/apt/sources.list
  77
  78 Defines the location for the sources file.
  79
  80 =item repo-path = /srv/www/repository
  81
  82 Defines the location of the dak Archive or local Debian Mirror and is scanned for Debian Packages.
  83
  84 =item debian-arch = i386
  85
  86 Defines the architecture of the debian repository.
  87
  88 =item ldap-uri =
  89
  90 Defines the LDAP uniform resource identifier.
  91
  92 =item ldap-base =
  93
  94 Defines the LDAP base.
  95
  96 =item ldap-admin-dn =
  97
  98 Defines the distinguished name of the administrator.
  99
 100 =item ldap-admin-password =
 101
 102 Defines the password of the administrator.
 103
 104 =item ldap-version = 3
 105
 106 Define the ldap protocol version used
 107
 108 =item ldap-retry-sec = 10
 109
 110 Define the number of second gosa-si-server should wait if ldap is not available
 111
 112 =item gosa-unit-tag =
 113
 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.
 115
 116 =item max-clients = 10
 117
 118 Defines the maximum number of GOsa-SI-clients connected to the GOsa-SI-server.
 119
 120 =item wol-password =
 121
 122 Defines the password for wake on LAN (WOL).
 123
 124 =back
 125
 126 =head2 [GOsaPackages]
 127
 128 =over 4
 129
 130 =item job-queue = /var/lib/gosa-si/jobs.db
 131
 132 Defines the location for the local DB 'job_queue'.
 133
 134 =item job-queue-loop-delay = 3
 135
 136 Defines the seconds the job queue is checked.
 137
 138 =item messaging-db-loop-delay = 3
 139
 140 Defines the seconds the messaging queue is checked.
 141
 142 =item key = none
 143
 144 Defines the password incoming GOsaPackages messages should be encrypted. This has to be modified, default value will not work!!!
 145
 146 =item new-systems-ou = ou=workstations,ou=systems
 147
 148 Define the branch in your ldap tree where new systems should be put, only change if you know what you are doing !!!
 149
 150 =item dak-base = /srv/archive
 151
 152 Base Directory of the local dak Archive.
 153
 154 =item dak-keyring = /srv/archive/keyrings
 155
 156 Directory with keyrings that hold the gpg-keys the archive accepts when uploading Debian packages.
 157
 158 =item dak-queue = /srv/archive/queue
 159
 160 Directory with the different dak queues.
 161
 162 =item dak-usr = deb-dak
 163
 164 User that is used to access dak files. Only needed if you have manually changed the default.
 165
 166 =back
 167
 168
 169 =head2 [ClientPackages]
 170
 171 =over 4
 172
 173 =item key = none
 174
 175 Defines the password incoming ClientPackages messages should be encrypted. This has to be modified, default value will not work!!!
 176
 177 =item user-date-of-expiry = 600
 178
 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.
 181
 182 =back
 183
 184
 185 =head2 [ServerPackages]
 186
 187 =over 4
 188
 189 =item address =
 190
 191 Comma seperated 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.
 192
 193 =item dns-lookup = true
 194
 195 Perform a DNS lookup for server registration
 196
 197 =item domain =
 198
 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.
 200
 201 =item key = none
 202
 203 Defines the password incoming ServerPackages messages should be encrypted. This has to be modified, default value will not work!!!
 204
 205 =item key-lifetime = 120
 206
 207 Defines the lifetime in seconds of a GOsa-SI-server key. After expiring the key will be automatically renewed.
 208
 209 =item job-synchronization-enabled = true
 210
 211 Defines whether job queue informations are be shared with other GOsa-SI-server in network.
 212
 213 =item synchronization-loog = 5
 214
 215 Defines in seconds after which time the job queue synchronization is being done.
 216
 217 =back
 218
 219
 220 =head2 [ArpHandler]
 221
 222 =over
 223
 224 =item enabled = false
 225
 226 Defines whether the ArpHandler is being activated at GOsa-SI-server start.
 227
 228 =item interface = all
 229
 230 Space- or comma-separated list of interfaces on which to start an ARP-Daemon. Enter 'all' to use all possible interfaces (Default).
 231
 232 =back
 233
 234 =head2 [Opsi]
 235
 236 =over 4
 237
 238 =item enabled = false
 239
 240 Defines wheter Opsi integration is being enabled or not.
 241
 242 =item server = localhost
 243
 244 Define the hostname of the Opsi server
 245
 246 =item admin = opsi-admin
 247
 248 Define the name of the opsi admin
 249
 250 =item password =
 251
 252 Define the Opsi admin password
 253
 254 =back
 255
 256 =head1 BUGS
 257
 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>
 259
 260
 261 =head1 LICENCE AND COPYRIGHT
 262
 263 This code is part of GOsa (L<http://www.gosa-project.org>)
 264
 265 Copyright (C) 2003-2009 GONICUS GmbH
 266
 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.
 271
 272
 273
 274 =cut
 275
 276
 277