Code

Don not't reset server settings, if gosa.conf was modified
[gosa.git] / gosa-core / contrib / gosa.conf.5
index f48cddf83c08cebf926d543d5bf625e547fe860a..8fa937a2dd0d88a4a0c726a9b94dac9c7917ad59 100644 (file)
@@ -689,7 +689,7 @@ defined departments. The default is
 This statement defines the location where GOsa looks for new samba workstations.
 .PP
 
-.B ogroupou
+.B ogroupRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new object groups inside of defined
@@ -713,7 +713,7 @@ departments. Default is
 .I ou=terminals.
 .PP
 
-.B workstationou
+.B workstationRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new workstations inside of defined
@@ -721,7 +721,7 @@ departments. Default is
 .I ou=workstations.
 .PP
 
-.B printerou
+.B printerRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new printers inside of defined
@@ -729,7 +729,7 @@ departments. Default is
 .I ou=printers.
 .PP
 
-.B componentou
+.B componentRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new network components inside of defined
@@ -737,7 +737,7 @@ departments. Default is
 .I ou=components.
 .PP
 
-.B phoneou
+.B phoneRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new phones inside of defined
@@ -745,7 +745,7 @@ departments. Default is
 .I ou=phones.
 .PP
 
-.B conferenceou
+.B phoneConferenceRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new phone conferences inside of defined
@@ -753,7 +753,7 @@ departments. Default is
 .I ou=conferences.
 .PP
 
-.B blocklistou
+.B faxBlocklistRDN
 .I string
 .PP
 This statement defines the location where GOsa creates new fax blocklists inside of defined
@@ -761,7 +761,7 @@ departments. Default is
 .I ou=blocklists.
 .PP
 
-.B incomingou
+.B systemIncomingRDN
 .I string
 .PP
 This statement defines the location where GOsa looks for new systems to be joined to the LDAP.
@@ -769,7 +769,7 @@ Default is
 .I ou=incoming.
 .PP
 
-.B systemsou
+.B systemRDN
 .I string
 .PP
 This statement defines the base location for servers, workstations, terminals, phones and
@@ -777,6 +777,72 @@ components. Default is
 .I ou=systems.
 .PP
 
+.B ogroupRDN
+.I string
+.PP
+This statement defines the location where GOsa looks for object groups.
+Default is
+.I ou=groups.
+.PP
+
+.B aclRoleRDN
+.I string
+.PP
+This statement defines the location where GOsa stores ACL role definitions.
+Default is
+.I ou=aclroles.
+.PP
+
+.B phoneMacroRDN
+.I string
+.PP
+This statement defines the location where GOsa stores phone macros for use with the Asterisk
+phone server.
+Default is
+.I ou=macros,ou=asterisk,ou=configs,ou=systems.
+.PP
+
+.B faiBaseRDN
+.I string
+.PP
+This statement defines the location where GOsa looks for FAI settings.
+Default is
+.I ou=fai,ou=configs,ou=systems.
+.PP
+
+.B faiScriptRDN, faiHookRDN, faiTemplateRDN, faiVariableRDN, faiProfileRDN, faiPackageRDN, faiPartitionRDN 
+.I string
+.PP
+These statement define the location where GOsa stores FAI classes. The complete base for the
+corresponding class is an additive of
+.B faiBaseRDN
+an and this value.
+.PP
+
+.B deviceRDN
+.I string
+.PP
+This statement defines the location where GOsa looks for devices.
+Default is
+.I ou=devices.
+.PP
+
+.B mimetypeRDN
+.I string
+.PP
+This statement defines the location where GOsa stores mime type definitions.
+Default is
+.I ou=mimetypes.
+.PP
+
+.B applicationRDN
+.I string
+.PP
+This statement defines the location where GOsa stores application definitions.
+Default is
+.I ou=apps.
+.PP
+
 .B ldapFilterNestingLimit
 .I integer
 .PP
@@ -820,7 +886,7 @@ with your
 .I adduser.conf
 to avoid overlapping uidNumber values between local and LDAP based lookups. The uidNumberBase
 can even be dynamic. Take a look at the
-.I nextIdHook
+.I baseIdHook
 definition below.
 .PP
 
@@ -988,7 +1054,7 @@ This script can be used to do automatted dialing from the addressbook.
 .B Mail options
 .PP
 .B mailMethod
-.I cyrus/kolab/golab/sendmail
+.I Cyrus/SendmailCyrus/Kolab/Kolab22
 .PP
 The
 .I mailMethod
@@ -996,12 +1062,11 @@ statement tells GOsa which mail method the setup should use to communicate
 with a possible mail server. Leave this undefined if your mail method does
 not match the predefined ones.
 
-.I cyrus
+.I Cyrus
 maintains accounts and sieve scripts in cyrus servers.
-.I kolab
+.I Kolab/Kolab22
 is like cyrus, but lets the kolab daemon maintain the accounts.
-.I golab is like cyrus - just with kolab attributes.
-.I sendmail just disables everything which is IMAP dependent.
+.I SendmailCyrus is based on sendmail LDAP attributes.
 .PP
 
 .B cyrusUseSlashes
@@ -1039,6 +1104,51 @@ Valid values are
 and
 .I uid.
 
+.B mailFolderCreation
+Every mail method has its own way to create mail accounts like 
+.I share/development
+or 
+.I shared.development@example.com
+which is used to identify the accounts, set quotas or add acls. 
+
+To override the methods default account creation syntax, you can set the
+.I mailFolderCreation
+option.
+
+.I Examples
+
+.nf
+ mailFolderCreation="%prefix%%cn%"              => "shared.development"
+ mailFolderCreation="my-prefix.%cn%%domain%"    => "my-prefix.development@example.com">
+.fi
+
+.I Placeholders
+
+.nf
+ %prefix%    The methods default prefix. (Depends on cyrusUseSlashes=FALSE/TRUE)
+ %cn%        The groups/users cn.
+ %uid%       The users uid.
+ %mail%      The objects mail attribute.
+ %domain%    The domain part of the objects mail attribute.
+ %mailpart%  The user address part of the mail address.
+ %uattrib%   Depends on mailAttribute="uid/mail".
+.fi
+
+
+.B mailUserCreation
+This attribute allows to override the user account creation syntax, see
+the
+.I mailFolderCreation
+description for more details. 
+
+.I Examples
+
+.nf
+ mailUserCreation="%prefix%%uid%"           => "user.foobar"
+ mailUserCreation=my-prefix.%uid%%domain%"  => "my-prefix.foobar@example.com"
+.fi
+
+
 .B vacationTemplateDirectory
 .I path
 .PP
@@ -1113,6 +1223,10 @@ DEBUG_SESSION = 32
 DEBUG_CONFIG  = 64
 
 DEBUG_ACL     = 128
+
+DEBUG_SI      = 256
+
+DEBUG_MAIL    = 512
 .PP
 
 
@@ -1141,6 +1255,103 @@ is the corresponding password for this DN.
 You can define a set of referrals if you have several server to
 connect to.
 
+.SH Settings for the environment plugin
+
+In order to make full use of the environment plugin, you may want
+to define the location where kiosk profiles will be stored on the
+servers harddisk.
+
+This is done by the
+.I kioskPath
+keyword defined within the
+.I environment
+class definition inside your gosa.conf.
+
+.B Example:
+
+.nf
+  <plugin acl="users/environment"
+          class="environment"
+          kioskPath="/var/spool/kiosk"/>
+.fi
+
+Make sure, that this path is writeable by GOsa.
+
+.SH Settings for the FAI plugin
+
+The FAI plugin can be used in a way that it generates branched or
+freezed releases inside your repository. Specifying the
+.I postcreate
+and
+.I postmodify
+keywords in the
+.I servrepository
+definition, calls the provided script as a hook when adding or
+removing branches. This script should do the rest inside of your
+repository.
+
+.B Example:
+
+.nf
+  <tab class="servrepository" 
+          repositoryBranchHook="/opt/dak/bin/get_extra_repos"
+          postcreate="/opt/dak/bin/handle_repository '%lock_dn' '%lock_name' '%lock_type' />
+.fi
+
+.I %lock_dn
+keeps the base DN of the source branch,
+.I %lock_name
+the name of the new branch and
+.I %lock_type
+is either "freeze" or "branch".
+
+The
+.I repositoryBranchHook
+outputs additional releases, that are not retrieveable with the standard
+GOsa/FAI methods.
+
+If you have only one release, or want to define a default release to be shown
+by GOsa, define the
+.I defaultFaiRelease
+within the 
+.I faiManagement
+class definition
+
+.SH Settings for the addressbook plugin
+
+The addressbook plugin can be configured to store the addressbook data on
+a special location. Use the
+.I addressbookBaseDN
+keyword within the
+.I addressbook
+class definition inside your gosa.conf to configure this location.
+
+Default:
+.I ou=addressbook.
+
+.SH Settings for system plugins
+For the
+.I workstationStartup
+and
+.I terminalStartup
+classes, you can define the
+.I systemKernelsHook
+keyword. It can load additional kernels that are not retrieveable by
+standard GOsa/FAI mechanisms.
+
+In order to make use of SNMP information, you can set the
+.I snmpCommunity
+in the
+.I terminfo
+class definition.
+
+To enable the burn CD image function, you can specify the
+.I systemIsoHook
+in the
+.I workgeneric
+class. You will get a CD symbol in the systems list - which calls
+the hook if pressed.
+
 .SH AUTHOR
 .B gosa.conf(5)
 was written by Cajus Pollmeier for