Sun Java System Calendar Server 6.3 Administration Guide

ProcedureTo Configure HTTP Services (cshttpd) for Calendar Server Version 6.3

  1. 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 one or more of the parameters as shown in the following table:

    Parameter  

    Description and Default Value  

    service.http.admins

    Space separated list of user ID's with administration rights to this Calendar Server. The default is "calmaster".

    service.http.allowadminproxy

    If "yes", allow login via proxy, which is the default.

    service.http.allowanonymouslogin

    If "yes", allow anonymous (no authentication) access. This is a special type of login that is allowed only specified, restricted access (usually read only access to public calendars). The default is "yes".

    service.http.calendarhostname

    HTTP host for retrieving HTML documents. To enable users to use a fully qualified host name to access calendar data, this value must be the fully qualified host name (including the machine name, DNS domain and suffix) of the machine on which Calendar Server is running, such as mycal@sesta.com.

    If not specified, the local HTTP host is used. 

    service.http.commandlog

    This parameter is for debugging only. If set to "yes", the system logs all incoming commands into the http.commands log file.

    Do not use this during production runtime. It will fill up the log file very quickly and could cause performance degradation. 

    service.http.commandlog.all

    This parameter is for debugging only. If set to "yes", the system logs all HTTP requests into the http.access log file.

    Do not use this during production runtime. It will fill up the log file very quickly and could cause performance degradation. 

    service.http.cookies

    Tells the server to whether or to support cookies (yes/no). It must be set to "yes" to enable single sign-on. The default is "yes".

    service.http.dbcachesize

    Maximum cache size of Berkeley database for HTTP sessions. The default is "8388308".

    service.http.domainallowed

    If specified and not blank (" "), filter to allow access based on TCP domains. For example, "ALL: LOCAL.sesta.com" would allow local HTTP access to anyone in the sesta.com domain. Multiple filters are separated by CR-LF (line feed). The default is blank ("").

    service.http.domainnotallowed

    If specified and not blank (" "), filter to not allow access based on TCP domains. For example, "ALL: LOCAL.sesta.com" would deny HTTP access to anyone in the sesta.com domain. Multiple filters must be separated by CR-LF (line-feed). The default is blank (" ").

    service.http.attachdir.path

    Directory location relative to local.queuedir (or an absolute path if specified) where imported files are temporarily stored. The default is the current directory (".").

    service.http.ipsecurity

    If "yes", all requests that reference an existing session are verified as originating from the same IP address. The default is “yes”.

    service.http.enable

    If "yes", start the cshttpd service when starting all services and stop cshttpd when stopping all services. The default is “yes”.


    Caution – Caution –

    Disabling the HTTP service with this parameter will also disable HTTPS.


    service.http.idletimeout

    Number of seconds before timing out an HTTP connection. The default is “120”.

    service.http.listenaddr

    Specifies the TCP address that HTTP services will listen on for client requests. The default is "INADDR_ANY", which indicates any address.

    service.http.logaccess

    If "yes", HTTP connections to server are fully logged. The default is “no”.

    service.http.maxsessions

    Maximum number of HTTP sessions in cshttpd service. The default is “5000”.

    service.http.maxthreads

    Maximum number of threads to service HTTP requests in cshttpd service. The default is “20”.

    service.http.numprocesses

    Maximum number of concurrently running HTTP service (cshttpd) processes that should run on a server. The default is “1”.

    For a server that has multiple CPU's, see 21.8 Using Load Balancing Across Multiple CPU's.

    service.http.port

    Port for HTTP requests from Calendar Server users. The default is “80”.

    service.http.proxydomainallowed

    If specified and not "", filter for allowing proxy login based on TCP domains. Same syntax as service.http.domainallowed. The default is "".

    service.http.resourcetimeout

    Number of seconds before timing out an HTTP session. The default is “900”.

    service.http.sessiondir.path

    Directory for the HTTP session database. The default is “http”.

    service.http.sessiontimeout

    Number of seconds before timing out an HTTP session in cshttpd service. The default is “1800”.

    service.http.sourceurl

    Directory relative to executable where all URL references to files are stored. The default is "" (null).

    service.http.tmpdir

    Temporary directory for HTTP sessions. The default is “/var/opt/SUNWics5/tmp”.

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

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