gosa-si/gosa-si-server.conf.5

   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-17" "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/gosa\-si\-server.log" 4
 142 .IX Item "logfile = /var/log/gosa-si/gosa-si-server.log"
 143 Defines the location for the log file.
 144 .IP "pid-file = /var/run/gosa\-si/gosa\-si\-server.pid Defines the location for the pid file." 4
 145 .IX Item "pid-file = /var/run/gosa-si/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/" 4
 187 .IX Item "repo-path = /srv/www/"
 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\-2010 \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.