Sun Java System Calendar Server 6.3 Administration Guide

5.2 Configuring Calendar Servers for CLD and DWP

This sections contains instructions for configuring servers for CLD and DWP.

This section contains the following topics:

ProcedureTo Configure a Front-End Server for CLD

  1. On every front-end server, log in as an administrator with permission to change the configuration.

  2. Change to the /etc/opt/SUNWics5/cal/config directory.

  3. Save your old ics.conf file by copying and renaming it.

  4. Edit the ics.conf parameters as shown in the following list:

    Parameters

    Description

    csapi.plugin.loadall

    For every front-end server, set the value to “y” if you want all plug-ins starting with cs_ to be loaded into the cal-svr-base/SUNWics5/cal/bin/plugins directory.

    Set to “n”, to load only a specific plug-in, the name of which is found in csapi.plugin.calendarlookup.name.

    csapi.plugin.calendarlookup

    Set this parameter to "yes".

    csapi.plugin.calendarlookup.name

    Set this parameter to the name of the plug-in,"calendarlookup". Or, to load all plug-ins, set the parameter to "*".

    caldb.cld.type

    This parameter specifies whether calendars are to be distributed across multiple back-ends (set value to “directory”), or calendars are to be stored on the same server on which Calendar Server is installed (set value to,“local”, which is the default value).

    service.dwp.enable

    Disable DWP service for the front-end, unless it is also serving as a back-end machine. For example: service.dwp.enable="no"

    service.dwp.port

    The default port is “59979”. This port number must be the same for all front-end and back-end servers.

    service.store.enable

    This parameter is enabled by default (value = "yes"). It does not appear in the configuration file (ics.conf).

    It must be added to the configuration file if you wish to disable it (value = "no").

    caldb.dwp.server.backend-server-n.ip

    This is a multi-valued parameter. Create one ics.confparameter for each back-end server in your Calendar Server deployment. The value of this parameter is the back-end server hostname. The server name must be fully qualified and be resolvable by your Domain Name Service (DNS) into a valid IP address. The server name must be identical and fully qualified in both the parameter name and the value.

    For example:

    caldb.dwp.server.calendar1.sesta.com="calendar1.sesta.com"
    caldb.dwp.server.calendar2.sesta.com="calendar2.sesta.com"
    caldb.dwp.server.default

    Set the default DWP server name used by the system if the user or resource LDAP entry does not have an icsDWPHost attribute. The server name must be fully qualified and be resolvable by your DNS.

    For example:

    caldb.dwp.sever.default="calendar1.sesta.com"
    local.authldaphost

    The hostname where the Directory Server is installed. The default is "localhost".

    local.ugldaphost

    The hostname where the LDAP user preferences are stored. If you do not keep the user preferences in a separate LDAP host, then it should be set to the same value as local.authldaphost.

    service.ens.enable

    Disable ENS (enpd) for this front-end server, set this parameter to "no".

    ENS must be enabled only on the back-end servers.

    caldb.serveralarms

    To disable server alarms for the front-end by setting this to "0".

    Server alarms must be enabled ("1") only on the back-end servers.

    caldb.serveralarms.dispatch

    To disable the alarm dispatcher, set this parameter to "no".

    The alarm dispatcher should be enabled ("yes") only on the back-end servers.

    service.notify.enable

    To disable the notify service, set this parameter to "no".

    The notify service should be enabled ("yes") only on back-end servers.

    caldb.berkeleydb.archive.enable

    To disable the automatic archive backup service, set this parameter to "no". There is no need to have archiving configured on a front-end machine.

    caldb.berkeleydb.hotbackup.enable

    The automatic hot backup service should be disabled (value set to "no"). There is no need for hot backups on a front-end machine.

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

    cal-svr-base/SUNWics5/cal/sbin/start-cal

ProcedureTo Configure a Back-end Server for CLD and DWP

  1. On every back-end server, log in as an administrator with permission to change the configuration.

  2. Change to the /etc/opt/SUNWics5/cal/config directory.

  3. Save your old ics.conf file by copying and renaming it.

  4. Edit the ics.conf parameters as shown in the following table:

    Parameters

    Description

    service.http.enable

    Set this parameter to "no".

    There is no need for HTTP on a back-end server.

    service.admin.enable

    Enable the administration service (csadmind) by setting the parameter to "yes", which is the default.

    caldb.cld.type

    If this machine is a back-end only machine, set to "local". If this machine is both a front-end and a back-end, set to "directory".

    csapi.plugin.calendarlookup

    Set this parameter to "no".

    There is no need for a plug-in on a back-end server.

    service.dwp.enable

    Enable DWP by setting this parameter to "yes"

    service.dwp.port

    The default port is “59979”. This port number must be the same for all front-end and back-end servers.

    caldb.dwp.server.backend-server-n.ip

    This is a multi-valued parameter. Create one ics.confparameter for each back-end server in your Calendar Server deployment. The value of this parameter is the back-end server hostname. The server name must be fully qualified and be resolvable by your Domain Name Service (DNS) into a valid IP address. The server name must be identical and fully qualified in both the parameter name and the value.

    For example:

    caldb.dwp.server.calendar1.sesta.com="calendar1.sesta.com"
    caldb.dwp.server.calendar2.sesta.com="calendar2.sesta.com"
    caldb.dwp.server.default

    Set the default DWP server name used by the system if the user or resource LDAP entry does not have an icsDWPHost attribute. The server name must be fully qualified and be resolvable by your DNS.

    For example:

    caldb.dwp.sever.default="calendar1.sesta.com"
    local.authldaphost

    The hostname where the Directory Server is installed. The default is "localhost".

    local.ugldaphost

    The hostname where the LDAP user preferences are stored. If you do not keep the user preferences in a separate LDAP host, then it should be set to the same value as local.authldaphost.

    service.ens.enable

    To enable ENS (enpd) for this back-end server, set this parameter to "yes".

    caldb.serveralarms

    Server alarms must be enabled ("1") on the back-end servers.

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

    cal-svr-base/SUNWics5/cal/sbin/start-cal

ProcedureTo Configure a Server as Both a Front-end and a Back-end

  1. On every server, log in as an administrator with permission to change the configuration.

  2. Change to the /etc/opt/SUNWics5/cal/config directory.

  3. Save your old ics.conf file by copying and renaming it.

  4. Edit the ics.conf parameters as shown in the following table:

    Parameters

    Description

    csapi.plugin.loadall

    For every front-end server, set the value to “y” if you want all plug-ins starting with cs_ to be loaded into the cal-svr-base/SUNWics5/cal/bin/plugins directory.

    Set to “n”, to load only the CLD plug-in, the name of which is found in csapi.plugin.calendarlookup.name.

    csapi.plugin.calendarlookup

    Set this parameter to "yes".

    csapi.plugin.calendarlookup.name

    To load all plug-ins, set the parameter to "*".

    If you want to load only the CLD plug-in, set this parameter to the name of the plug-in,"calendarlookup".

    caldb.cld.type

    This parameter specifies whether calendars are to be distributed across multiple back-ends (set value to “directory”), or calendars are to be stored on the same server on which Calendar Server is installed (set value to,“local”, which is the default value).

    service.dwp.enable

    Enable DWP by setting this parameter to "yes"

    service.dwp.port

    The default port is “59979”. This port number must be the same for all front-end and back-end servers.

    caldb.dwp.server.backend-server-n.ip

    This is a multi-valued parameter. Create one ics.confparameter for each back-end server in your Calendar Server deployment. The value of this parameter is the back-end server hostname. The server name must be fully qualified and be resolvable by your Domain Name Service (DNS) into a valid IP address. The server name must be identical and fully qualified in both the parameter name and the value.

    For example:

    caldb.dwp.server.calendar1.sesta.com="calendar1.sesta.com"
    caldb.dwp.server.calendar2.sesta.com="calendar2.sesta.com"
    caldb.dwp.server.default

    Set the default DWP server name used by the system if the user or resource LDAP entry does not have an icsDWPHost attribute. The server name must be fully qualified and be resolvable by your DNS.

    For example:

    aldb.dwp.sever.default="calendar1.sesta.com"
    local.authldaphost

    The hostname where the Directory Server is installed. The default is “localhost”(on the same server as the front-end).

    local.ugldaphost

    The hostname where the LDAP user preferences are stored. If you do not keep the user preferences in a separate LDAP host, then it should be set to the same value as local.authldaphost.

    service.ens.enable

    Enable ENS by setting this parameter value to "yes".

    caldb.serveralarms

    Server alarms must be enabled ("1") on the back-end servers.

    caldb.serveralarms.dispatch

    The alarm dispatcher should be enabled ("yes") on the back-end servers.

    service.notify.enable

    The notify service should be enabled ("yes") on back-end servers.

    caldb.berkeleydb.archive.enable

    The automatic archive backup service should be enabled (value set to "yes"on the back-end systems.

    caldb.berkeleydb.hotbackup.enable

    The automatic hot backup service should be enabled (value set to "yes"on the back-end systems.

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

    cal-svr-base/SUNWics5/cal/sbin/start-cal