Code

Updated goto locales
[gosa.git] / gosa-si / client.conf.pod
2 =head1 NAME
4 gosa-si-client.conf - Configuration file for gosa-si-client.
7 =head1 DESCRIPTION
9 The gosa-si-client.conf file defines all parameter GOsa-SI-client needs for running and communication with GOsa-SI-server. It is normally located in the F</etc/gosa-si/> directory and is generated automatically by the gosa-si-client(1) program during installation. 
11 =head1 DIRECTIVES
13 =head2 [General]
15 =over 4
17 =item log-file = /var/log/gosa-si/gosa-si-client.log
19 Defines the location for the log file.
21 =item pid-file = /var/run/gosa-si/gosa-si-client.pid
23 Defines the location for the pid file.
25 =item opts-file = var/run/gosa-si/gosa-si-client.opts
27 Defines the location for the opts file.
29 =back
32 =head2 [Client]
34 =over 4
36 =item port = 20083
38 Defines the port GOsa-SI-client is listening for incoming messages.
40 =item ip = 0.0.0.0
42 If set GOsa-SI-client is forced to use this ip address. If it is not set, an automated determination is tried.
44 =item mac-address = 00:00:00:00:00:00
46 If set GOsa-SI-client is forced to use this mac address. If it is not set, an automated determination is tried.
48 =item server-domain =
50 Forces the search domain used to get possible servers from DNS. If not set, the client will search the domains from $ENV.
52 =item ldap = 1 | 0
54 If set to '1', the client will get the LDAP-Configuration from the registration server (on every registration process). Under some circumstances this is not wanted, so setting to '0' disables this behavior.
56 =item ldap-config = /etc/ldap/ldap.conf
58 Defines the location for ldap.conf file.
60 =item pam-config = /etc/pam_ldap.conf
62 Defines the location for pam-ldap.conf file. 
64 =item nss-config = /etc/libnss-ldap.conf
66 Defines the location for libnss-ldap.conf file.
68 =item fai-logpath = /var/log/fai/fai.log
70 Defines the location for fai.log file.
72 =item force-hostname = false | true
74 If set to true, client will try to get the hostname for registration from $ENV. Used in FAI environments, when hostname gets set from DHCP.
76 =item system-com = disabled | enabled
78 Open a different fifo for system communication
80 =back
83 =head2 [Server]
85 =over 4
87 =item ip = 127.0.0.1
89 If set GOsa-SI-client is forced to register at specified GOsa-SI-Server. If it is not set, GOsa-SI tries to register at GOsa-SI-servers found in DNS. 
91 =item port = 20081
93 Defines the port GOsa-SI-server is listening for incoming messages.
95 =item key = 
97 Defines the password GOsa-SI-server messages should be encrypted. This has to be modified, default value will usually not work!!!
99 =item timeout = 10
101 Defines in seconds the timeout GOsa-SI-client is waiting for the next try if all registraion efforts fails.
103 =item key-lifetime = 600
105 Defines in seconds the lifetime of the key GOsa-SI-server messages should be encrypted with. 
107 =back
110 =head2 [krb5]
112 =over 2
114 =item admin = user
116 Define the admin for your kerberos realm
118 =item password = password
120 Defines the password for your kerberos realm admin
122 =back
125 =head1 BUGS 
127 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>
130 =head1 LICENCE AND COPYRIGHT
132 This code is part of GOsa (L<http://www.gosa-project.org>)
134 Copyright (C) 2003-2010 GONICUS GmbH
136 This program is distributed in the hope that it will be useful,
137 but WITHOUT ANY WARRANTY; without even the implied warranty of
138 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
139 GNU General Public License for more details.
141 =cut