Sun Java System Calendar Server 6 2005Q4 Administration Guide

ProcedureTo Configure HTTP Services (cshttpd)

  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. The default is “no”.

    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.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 DB for HTTP sessions. The default is “8388308”.

    service.http.domainallowed

    If specified and not " ", 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 "".

    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 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”.

    service.http.uidir.path

    Directory that contains the default calendar client. If allowing only WCAP access, set to "html".

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

    cal_svr_base/SUNWics5/cal/sbin/start-cal