Sun Java System Calendar Server 6.3 Administration Guide

E.1 Editing the ics.conf Configuration File

Calendar Server configuration parameters are stored in the following file:


The ics.conf file is a ASCII text file, with each line defining a parameter and its associated value(s). The parameters are initialized during Calendar Server installation. After installation, you can edit the file using a text editor.

Caution – Caution –

Modify the settings for parameters in the ics.conf file only as described in Sun documentation or as directed by a customer support representative.

For example: Remote administration is not enabled for Calendar Server. Do not change the service.admin.port parameter, because it is already set to its required value by Calendar Server. Otherwise, the csadmind process might not run properly.

ProcedureTo edit the ics.conf file:

  1. Log in as a user who has administrator rights to the system where Calendar Server is running.

  2. Change to the /etc/opt/SUNWics5/config directory where the ics.conf file is located.

  3. Edit parameters in the ics.conf file using a text editor such as vi. Conventions for parameters are:

    • All parameters must be in lower case only.

      • A parameter and its associated value(s) must be separated by an equal sign (=), with spaces or tabs allowed before or after the equal sign. For example:

        service.http.idletimeout = "120"

      • A parameter value must be enclosed in double quotation marks ("). If a parameter allows multiple values, the entire value string must be enclosed in double quotation marks. For example:

      • A comment line begins with an exclamation point (!). Comment lines are for informational purposes only and are ignored by Calendar Server.

        Some parameters are released as comments, beginning with either one or two exclamation points (! or !!). To use this type of parameter, you must remove the exclamation point(s), supply a value (if needed), and then restart Calendar Server for the parameter to take effect.

        For example, to use !!caldb.dwp.server.[hostname].ip, you must remove the exclamation points (!!), supply a value for hostname, and then restart Calendar Server.

      • If a parameter is not in the ics.conf file, add the parameter and its associated value to the file.

      • If a parameter appears more than once, the value of the last parameter listed overrides the previous value.

      • All options must start at the beginning of a line.

  4. After you make changes to parameters in the ics.conf file, stop and then restart Calendar Server for the new configuration values to take effect.

    If you prefer, you can also stop Calendar Server before you edit the ics.conf file. For more information, see 12.1 Starting and Stopping Calendar Server 6.3 Processes.