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 ldap-uri =
  85
  86 Defines the LDAP uniform resource identifier.
  87
  88 =item ldap-base =
  89
  90 Defines the LDAP base.
  91
  92 =item ldap-admin-dn =
  93
  94 Defines the distinguished name of the administrator.
  95
  96 =item ldap-admin-password =
  97
  98 Defines the password of the administrator.
  99
 100 =item ldap-version = 3
 101
 102 Define the ldap protocol version used
 103
 104 =item gosa-unit-tag =
 105
 106 Forces the Unit-Tag in a tagged environment. If not set, GOsa-SI tries to get the tag from the server entry in LDAP.
 107
 108 =item max-clients = 10
 109
 110 Defines the maximum number of GOsa-SI-clients connected to the GOsa-SI-server.
 111
 112 =item wol-password =
 113
 114 Defines the password for wake on LAN (WOL).
 115
 116 =back
 117
 118 =head2 [GOsaPackages]
 119
 120 =over 4
 121
 122 =item job-queue = /var/lib/gosa-si/jobs.db
 123
 124 Defines the location for the local DB 'job_queue'.
 125
 126 =item job-queue-loop-delay = 3
 127
 128 Defines the seconds the job queue is checked.
 129
 130 =item messaging-db-loop-delay = 3
 131
 132 Defines the seconds the messaging queue is checked.
 133
 134 =item key = none
 135
 136 Defines the password incoming GOsaPackages messages should be encrypted. This has to be modified, default value will not work!!!
 137
 138 =item new-systems-ou = ou=workstations,ou=systems
 139
 140 Define the branch in your ldap tree where new systems should be put, only change if you know what you are doing !!!
 141
 142 =item dak-base = /srv/archive
 143
 144 Base Directory of the local dak Archive.
 145
 146 =item dak-keyring = /srv/archive/keyrings
 147
 148 Directory with keyrings that hold the gpg-keys the archive accepts when uploading Debian packages.
 149
 150 =item dak-queue = /srv/archive/queue
 151
 152 Directory with the different dak queues.
 153
 154 =item dak-usr = deb-dak
 155
 156 User that is used to access dak files. Only needed if you have manually changed the default.
 157
 158 =back
 159
 160
 161 =head2 [ClientPackages]
 162
 163 =over 4
 164
 165 =item key = none
 166
 167 Defines the password incoming ClientPackages messages should be encrypted. This has to be modified, default value will not work!!!
 168
 169 =item user-date-of-expiry = 600
 170
 171 Lifetime of logged in user information. If no update information comes after n seconds,
 172 the user is marked to be no longer logged in or the host is no longer running.
 173
 174 =back
 175
 176
 177 =head2 [ServerPackages]
 178
 179 =over 4
 180
 181 =item address =
 182
 183 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.
 184
 185 =item dns-lookup = true | false
 186
 187 Perform a DNS lookup for server registration
 188
 189 =item domain =
 190
 191 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.
 192
 193 =item key = none
 194
 195 Defines the password incoming ServerPackages messages should be encrypted. This has to be modified, default value will not work!!!
 196
 197 =item key-lifetime = 120
 198
 199 Defines the lifetime in seconds of a GOsa-SI-server key. After expiring the key will be automatically renewed.
 200
 201 =item job-synchronization-enabled = true | false
 202
 203 Defines whether job queue informations are be shared with other GOsa-SI-server in network.
 204
 205 =item synchronization-loog = 5
 206
 207 Defines in seconds after which time the job queue synchronization is being done.
 208
 209 =back
 210
 211
 212 =head2 [ArpHandler]
 213
 214 =over
 215
 216 =item enabled = true | false
 217
 218 Defines whether the ArpHandler is being activated at GOsa-SI-server start.
 219
 220 =item interface = all
 221
 222 Space- or comma-separated list of interfaces on which to start an ARP-Daemon. Enter 'all' to use all possible interfaces (Default).
 223
 224 =back
 225
 226 =head2 [Opsi]
 227
 228 =over 4
 229
 230 =item enabled = true | false
 231
 232 Defines wheter Opsi integration is being enabled or not.
 233
 234 =item server = localhost
 235
 236 Define the hostname of the Opsi server
 237
 238 =item admin = opsi-admin
 239
 240 Define the name of the opsi admin
 241
 242 =item password =
 243
 244 Define the Opsi admin password
 245
 246 =back
 247
 248 =head1 BUGS
 249
 250 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>
 251
 252
 253 =head1 LICENCE AND COPYRIGHT
 254
 255 This code is part of GOsa (L<http://www.gosa-project.org>)
 256
 257 Copyright (C) 2003-2009 GONICUS GmbH
 258
 259 This program is distributed in the hope that it will be useful,
 260 but WITHOUT ANY WARRANTY; without even the implied warranty of
 261 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 262 GNU General Public License for more details.
 263
 264
 265
 266 =cut
 267
 268
 269