-i yes | no

Add new Directory Server indexes (yes/no). 

Default: yes 

Your value: 

-R yes | no

Reindex now (yes/no). 

Default: yes 

Your value:  

-c Directory Server Root

Directory Server root path name. 

Default: /var/opt/Sun/dsins

Your value:  

-d Directory Server Instance

Directory Server instance subdirectory. 

Default: none 

Your value:  

-r DC Root Suffix

DC Tree root suffix. 

Default: o=internet

Your value:  

-u User and Group Base Suffix

User/Group root suffix. 

Default: o=usergroup

Your value:  

-s yes | no

Update schema (yes/no). 

Default: yes 

Your value:  

-D Directory Manager DN

Directory Manager Distinguished Name (DN). 

Default: "cn=Directory Manager".

Your value:  

-w Directory Manager DN Password

Directory Manager DN password. 

Default: none. 

Your value:  

-b yes | no

Use this directory to store both configuration and user data (yes) or configuration data only (no). 

Default: yes 

Your value:  

-t 1|1.5|2

Schema version: 

• Option 1 – Schema version 1

• Option 1.5 – Schema version 2 Compatibility Mode

• Option 2 – Schema version 2 Native Mode

  Default: 1

  Your value:

-m yes|no

Do you want to modify the directory server? 

Default: yes 

no- prints out script but does not execute it. 

-S PathtoSchemaFile

Path to the directory where the schema files are located. 

Default: ./schema

Your value:  

LDAP Server Host Name 

Host name of the LDAP directory server you are using for user authentication. 

Default: current host. 

Your value:  

LDAP Server Port 

Port number that the LDAP server listens on. 

Default: 389. 

Your value:  

Base DN 

Entry in the LDAP directory used as the starting point from which searches will occur. 

Default: o=host.com.

Your value:  

Directory Manager DN 

User name that can make changes in the directory server schema. 

Default: cn=Directory Manager.

Your value:  

Directory Manager Password 

Password of the Directory Manager DN. 

Default: None 

Your value:  

Administrator User ID 

User ID of the Calendar Server Administrator. This user must be a user in the above LDAP directory server. 

Default: calmaster.

Your value:  

Administrator Password 

Password of the Calendar Server Administrator. 

Default: None 

Your value:  

Email Alarms 

Specifies whether Calendar Server should send an email alarm message to a Calendar Server administrator in case a server problem occurs. 

Default: Enabled. 

Your value:  

Administrator Email Address 

Email address of the Calendar Server Administrator who will receive the email alarm messages. 

Default: None. 

Your value:  

SMTP Host Name 

Host name of the SMTP server where email alarm messages should be sent. 

Default: Current host. 

Your value:  

Service Port 

Port number that Calendar Server listens on to provide Web (HTTP) access to users. 

Default: 80. 

Your value: 

Maximum Sessions 

Maximum number of Calendar Server sessions. 

Default: 5000. 

Your value: 

Maximum Threads 

Maximum number of Calendar Server threads. 

Default: 20. 

Your value: 

Number of Server Processes 

Maximum number of Calendar Server processes. 

Default: Number of CPU's on the server where you are installing Calendar Server. 

Your value: 

Runtime User ID 

UNIX user name under which Calendar Server will run. 

Default: icsuser.

Your value: 

Runtime Group ID 

UNIX group under which Calendar Server will run. 

Default: icsgroup.

Your value: 

Calendar Server Startup 

Start after successful installation. 

Default: Checked. 

Your value: 

Start on system startup. 

Default: Checked. 

Your value: 

Database Directory 

Directory where Calendar Server should create and store the calendar database files. 

Default: /var/opt/SUNWics5/csdb

Your value:  

Logs Directory 

Directory where Calendar Server writes log files. 

Default: /var/opt/SUNWics5/logs

Your value:  

Temporary Files Directory 

Directory where the Calendar Server writes temporary files. 

Default: /var/opt/SUNWics5/tmp

Your value:  

LDAP Server Host Name 

For example: ldaphost.sesta.com

Your value:  

LDAP Server Port 

Port number that the LDAP server listens on. 

Default: 389. 

Your value:  

Directory Manager DN 

User name that can make changes in the directory server schema. 

Default: cn=Directory Manager.

Your value:  

Directory Manager Password 

Password of the Directory Manager DN. 

Default: None 

Your value: 

Administrator User ID 

User ID of the Calendar Server administrator. This user must be a user in the above LDAP directory server. 

Default: calmaster.

Your value:  

Administrator Password 

Password of the Calendar Server administrator. 

Default: None 

Your value:  

Email Alarms 

Specifies whether Calendar Server should send an email alarm message to a Calendar Server administrator in case a server problem occurs. 

Default: Enabled. 

Your value: 

Administrator Email Address 

Email address of the Calendar Server administrator who will receive the email alarm messages. 

Default: None. 

Your value: 

SMTP Host Name 

Host name of the SMTP server where email alarm messages should be sent. 

Default: Current host. 

Your value: 

Service Port 

Port number that Calendar Server listens on to provide Web (HTTP) access to users. 

Default: 80. 

Your value: 

Maximum Sessions 

Maximum number of Calendar Server sessions. 

Default: 5000. 

Your value: 

Maximum Threads 

Maximum number of Calendar Server threads. 

Default: 20. 

Your value: 

Number of Server Processes 

Maximum number of Calendar Server processes. 

Default: Number of CPU's on the server where you are installing Calendar Server. 

Your value: 

Runtime User ID 

Default value: icsuser

For an HA configuration, add to /etc/passwd on all nodes in the cluster.

Your value:  

Runtime Group ID 

Default value: icsgroup

For an HA configuration, add to /etc/group on all nodes in the cluster.

Your value: 

Calendar Server Startup 

Start after successful installation. 

Default: Checked. 

Your value: For an HA configuration, do not check this option.

Start on system startup. 

Default: Checked. 

Your value: For an HA configuration, do not check this option.

Database Directory 

Default: /var/opt/SUNWics5/csdb

For example: /global/cal/var/opt/SUNWics5/csdb

Your value:  

Logs Directory 

Default: /var/opt/SUNWics5/logs

For example: /global/cal/var/opt/SUNWics5/logs

Your value 

Temporary Files Directory 

Default: /var/opt/SUNWics5/tmp

For example: /global/cal/var/opt/SUNWics5/tmp

Your value: 

D.3 csattribute

Manages the LDAP attributes of a calendar user or resource for Schema version 1. 

D.4 csbackup

Backs up individual calendars, users, and the calendar database. 

D.5 cscal

Manages calendars and their properties. 

D.6 csclean

Removes user and resource calendars for Calendar Server users whose status attribute (inetUserStatus) has been marked as “deleted” by Delegated Administrator. 

D.7 cscomponents

Manages calendar components: events and tasks (todos). 

D.8 csdb

Manages the calendar database. 

D.9 csdomain

Manages Calendar Server attributes in the domain LDAP entry for Schema version 1. 

D.10 csexport

Exports a calendar in iCalendar (.ics) or XML (.xml) format.

D.11 csimport

Imports a calendar in iCalendar (.ics) or XML (.xml) format.

D.13 cspurge

Allows the manual purge of entries in the Delete Log database (ics50deletelog.db).

D.14 csrename

Allows the renaming of user ID's. Causes the whole database to be rewritten. 

D.15 csresource

Manages calendar resources such as conference rooms and equipment. 

D.16 csrestore

Restores individual calendars, users, and the calendar database. 

D.17 csschedule

Manages scheduling entries in the Group Scheduling Engine (GSE) queue. 

D.18 csstats

Displays counters in a Calendar Server. 

D.19 csuser

Manages calendar users for Schema version 1. 

D.20 start-cal

Starts all Calendar Server processes. 

D.21 stop-cal

Stops all Calendar Server processes. 

csattribute [-q|-v] 
             -a attribute=value 
            [-t resource | user]
            [-d domain] 
            add target

csattribute [-q|-v] 
             -a attribute[=value] 
            [-t resource | user]
            [-d domain] 
            delete target

csattribute [-q | -v] 
            [-t resource | user] 
            [-d domain] 
            list target

add target

Adds an LDAP attribute and value to a specified target (user or resource object). 

list target

Lists the attributes of a target object. 

delete target

Deletes an attribute from a target. 

version

Displays the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-a attribute =value

or 

-a attribute [=value ]

An LDAP attribute and value: 

• attribute is required when using the -a option.

• value is required when the -a option is used with the add command, but it is optional when the -a option is used with the delete and list commands.

-t user | resource

Type of target (user or resource object). Default is user. 

[-d domain]

Specifies the name of a domain. Default is taken from the service.defaultdomain parameter in the ics.conf file.

csbackup [-q|-v] 
          -f database target

csbackup [-q|-v] 
          -c calid 
         calendar target

csbackup [-q|-v] 
          -a userid 
         [-b basedn] 
         defcal target

database target

Backs up the calendar database to the specified target database directory. By default, the target database directory is: 

cal-svr-base/SUNWics5/cal/sbin/target-directory

If you specify only the target database directory, do not include the slash (/) before the directory name. For example:

csbackup database backupdir

Note: The csbackup utility fails if the target backup directory already exists and you do not specify the -f option. For example, the following command fails if backupdir exists, even if the directory is empty:

csbackup database backupdir

Therefore, if you specify a target backup directory that already exists, include the -f option when you run csbackup.

You can also specify a nonexistent target backup directory and let csbackup create the directory for you.

calendar calid target

Backs up the specified calendar ID to the specified target output file. The data format of the file is assumed by the file extension, .ics for text/calendar or .xml for text/xml.

defcal userid target

Backs up the default calendar of the specified user ID to the specified target file. The data format of the file is assumed by the file extension, .ics for text/calendar and .xml for text/xml.

version

Displays the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-a userid

The user ID of the calendar user to backup. This option is required for the default option. There is no default. 

-b basedn

The base DN to be used for this user. The default is taken from the setting service.schema2root, defined in the ics.conf file.

The Base DN (distinguished name) is the entry in your LDAP directory used as the starting point from which searches occur. 

For example, if you specify a base DN of ou=people, o=sesta.com, all LDAP search operations executed by Calendar Server examine only the ou=people subtree in the o=sesta.com directory tree.

-c calid

The calendar ID to backup. This option is required with the calendar command. There is no default.

For more information, see 15.2 Creating Calendar Unique Identifiers (calid's).

-f

To force any existing backup files to be deleted. 

In the current release, you must include the -f option if the backup target directory already exists, even if the directory is empty.

-l

To prepare the backup file for use with the Solstice^TM Backup^TM or the Legato Networker^TM backup programs. For more information, see Chapter 17, Backing Up and Restoring Calendar Server Data.

cscal [-q|-v] 
      [-a aces] 
      [-c charset] 
      [-d description] 
      [-g categories]
      [-k yes|no] 
      [-l langcode]
      [-m email]
      [-n name] 
      [-o owner’s uid]
      [-y otherowners]
      create|modify calid

cscal [-q|-v] 
      [-o owner’s uid]
      [-O] 
      delete|reset calid

cscal [-q|-v] 
      [-o owner’s uid]
      [-O] 
      disable|list [calid]

cscal [-q|-v] 
      [-k yes|no]
      [-o owner’s uid]
      [-O] 
      enable [calid]

create calid

Creates the calendar specified by calid. 

Note: If your site is using the LDAP CLD plug-in, all calendars for a specific user must reside on the same back-end server, as indicated by the user’s icsDWPHost LDAP attribute. If you try to create a calendar for the user on a different back-end server, Calendar Server returns an error.

delete calid

Deletes the calendar specified by calid.

If the -o owner option is specified, deletes all calendars whose primary owner is the specified uid.

enable [ calid ]

Enables the calendar specified by calid. If calid is not specified, enables all calendars.

If the -o owner option is specified, enables all calendars whose primary owner is the specified uid.

disable [ calid ]

Disables the calendar specified by calid. If calid is not specified, disables all calendars.

If the -o owner option is specified, disables all calendars whose primary owner is the specified uid.

list [ calid ]

Lists properties of the calendar specified by calid. If calid is not specified, lists properties of all calendars.

If the -o owner's uid option is specified, lists all calendars whose primary owner is the specified owner uid.

When any of the permissions have been modified through the Calendar Express user interface, this command lists those ACE letters capitalized. There is no significance to this. The ACEs are case insensitive.

modify calid

Modifies the properties of the calendar specified by calid.

reset calid

Resets the properties of the calendar specified by calid to the default configuration settings.

version

Displays the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-a [aces]

Access Control Entries (ACE's) for a specified calendar. ACE's determine who can access a calendar for group scheduling and the types of permissions they have, such as create, delete, read, and write privileges. An ACE string or Access Control List (ACL), must be enclosed in quotation marks (" ").

The default is the calstore.calendar.default.acl parameter in the ics.conf file.

For details about the ACE format, see 1.8 Access Control for Calendar Server Version 6.3.

-c charset

Character set. The default is no character set. 

-d description

Description (a viewable comment about the purpose of the calendar). The default is no description. 

-g category

Category. Multiple categories must be enclosed in quotation marks ("") and separated by spaces. The default is no category.

-k yes|no

Specifies whether double booking is allowed for a user calendar. For example, yes means the calendar can have more than one event scheduled for the same time slot.

If the -k option is omitted, the default is taken from the user.allow.doublebook parameter in the ics.conf file. However, the user.allow.doublebook parameter is used only when a calendar is created.

After a calendar is created, Calendar Server checks the calendar properties database, ics50calprops.db, to determine if doublebooking is allowed. If you need to change the calendar properties for a calendar to allow or disallow doublebooking, reissue cscal with the -k option.

-l langcode

Language code. The default is no language code. 

-m email

Email address. The default is no email. 

-n name

Viewable Name. The default is no name. 

-o owner

(Lowercase o) 

Primary owner. The default setting is the unique ID (uid) of the primary owner.

-O

(Uppercase O) 

Specifies all calendars of the primary owner. Default is the named calendar only. 

-y otherowners

Other calendar owners. Multiple owners must be enclosed in quotation marks ("") and separated by spaces. The default is no other owners.

csclean [-q | -v] 
        [-g graceperiod]
        clean domain

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-ggraceperiod

Specifies the number of days to have elapsed since the calendar service was deleted for a user. 

The default is 10 days. 

domain

Specifies the domain in which to remove calendars for all users and resources. 

An asterisk (*) removes all calendars for all users and resources in all domains.

cscomponents [-v|-q] 
             [-e endtime] 
             [-s starttime] 
             [-t event|task]
             delete|list calid

delete calid

Deletes events and tasks in the calendar with the specified calendar ID. 

list calid

Lists events and tasks in the calendar with the specified calendar ID. 

When deleting tasks, you must specify the -soption with an actual DateTime Z String specifying the starting date for removal. If you do not specify a date, or you specify zero (0) as the value for the option, all tasks will be deleted from the calendar.

version

Prints the version of the utility to the screen. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-e endtime

Ending time of the components. An end time of 0 means to the end of time. The default is 0.

-s starttime

Starting time of the components. A start time of 0 means from the beginning of time. The default is 0.

For tasks only, you must specify this option and the starting date specified must be a DateTime Z String. If the option is not specified, or the option is specified but the value is set to zero, all tasks for this calendar will be deleted.

-t event|task

Type of components (events or tasks) on which the action is performed. Default is both. 

csdb [-q|-v] 
     [-t caldb|sessdb|statdb] 
     create|delete [dbdir]

csdb [-q|-v] 
     [-t caldb|sessdb|statdb] 
     list [dbdir]

csdb [-q|-v] 
     [-f] 
     [-t caldb|sessdb|statdb] 
     recover [dbdir]

csdb check [dbdir]

csdb rebuild [-a, -V] 
     [-g] [dbdir [dstdir]]

create [dbdir]

Creates the databases in the specified database directory. If a database directory is not specified, the current directory is used. If a database does not exist when the server is started, Calendar Server creates one automatically. 

delete [dbdir]

Deletes the databases in the specified database directory. If a database directory is not specified, the current directory is used. A database cannot be deleted while it is open (when Calendar Server is running). 

list [dbdir]

Lists information about the databases in the specified database directory. If a database directory is not specified, the current directory is used. 

recover [dbdir]

Attempts to recover damaged calendar databases in the specified database directory. If a database directory is not specified, the current directory is used. Is not implemented for session or statistics databases. 

check [dbdir]

Scans a calendar database in the specified database directory to determine if any corruption has occurred and reports the results in its output. If a database directory is not specified, the current directory is used. 

rebuild [dbdir [dstdir]]

Scans all calendar databases in the specified database directory to determine if any corruption has occurred and generates a rebuilt calendar database (.db files). If a database directory is not specified, the current directory is used. After the databases are rebuilt, db_verify runs.

The dstdir specifies an optional destination directory.

version

Displays the version of the utility. 

-a

For rebuild command only, rebuilds only the alarms database.

-V

Must be passed in with -a for rebuilding the alarms database. Causes verify to be run against all databases, including alarms.

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-f

Force the recovery of the calendar database. 

-g

For the rebuild command, rebuild the group scheduling engine (GSE) database in addition to the other calendar databases.

-t caldb|sessdb|statdb

Specifies the target database group: 

• caldb (calendar)

• sessdb (session)

• statdb (statistics)

  Note: If -t is not specified, csdb operates on all database groups, except for the check, recover and rebuild commands, which operate only on caldb (calendar).

csdomain [-q | -v] 
          -n node 
         create domain

csdomain [-q | -v] 
         {-a attr[=value] | 
          -f filename} 
         add domain

csdomain [-q | -v] 
         [-a attr | 
          -f filename] 
         delete domain

csdomain [-q | -v] 
         list domain

create

Create a new domain in the LDAP directory. 

add

Add a Calendar Server attribute and its associated value in the domain LDAP entry. If you add or update domain attributes using csdomain, restart Calendar Server for the new values to take effect.

delete

Delete a Calendar Server attribute in the LDAP directory for a specific domain or delete all LDAP entries for an entire domain. 

list

Display Calendar Server attributes in the LDAP directory for a specific domain. 

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-aattr[=value]

Specifies the LDAP attribute property name and its optional value. 

For a list of these attributes and property names, see D.9.3 LDAP Attributes and Property Names.

-f filename

Specifies a text file that contains Calendar Server LDAP directory property names and their associated values.  

For example: 

createLowerCase="yes"

filterPrivateEvents="no"

fbIncludeDefCal="no"

subIncludeDefCal="no"

uiProxyUrl="https://proxyserver"

-n node

Applies to the create command as follows: 

• For LDAP Schema version 1 – Specifies the node under which all users and resources are created. For example: o=node2,o=node1,o=sesta

• For LDAP Schema version 2 – Specifies the name of the node created for this domain. For example: o=west.sesta.com

  If node is not specified, the domain name is used.

domain

For the add, delete, and list commands, specifies an existing domain in the LDAP directory. 

For the create command, specifies the unique name of a new domain that will be created in the LDAP directory. 

For example: west.sesta.com

0 

allowCalendarCreation

If set (bit 0=1), do not allow calendars to be created. 

Corresponding ics.conf parameter:

service.wcap.allowcreatecalendars

1 

allowCalendarDeletion

If set (bit 1=1), do not allow calendars to be deleted. 

Corresponding ics.conf parameter:

service.wcap.allowdeletecalendars

2 

allowPublicWritableCalendars

If set (bit 2=1), do not allow public writable calendars. 

Corresponding ics.conf parameter:

service.wcap.allowpublicwriteablecalendars

3 

Not used in the current release. 

4 

allowModifyUserPreferences

If set (bit 4=1), do not allow domain administrators to get or set user preferences using WCAP commands. 

Corresponding ics.conf parameter:

service.admin.calmaster.wcap.allowgetmodifyuserprefs

5 

allowModifyPassword

If set (bit 5=1), do not allow user to change password via this server. 

Corresponding ics.conf parameter:

service.wcap.allowchangepassword

6 

Not used in the current release. 

7 

Not used in the current release. 

8 

allowUserDoubleBook

If set (bit 8=1), do not allow double booking for user’s calendars. 

Corresponding ics.conf parameter:

user.allow.doublebook

9 

allowResourceDoubleBook

If set (bit 9=1), do not allow double booking for resource calendars. 

Corresponding ics.conf parameter:

resource.allow.doublebook

10 

allowSetCn

If set (bit 10=1), do not allow user to set the common name (cn) attribute using the WCAP set_userprefs command.

Corresponding ics.conf parameter:

service.wcap.allowsetprefs.cn

11 

allowSetGivenName

If set (bit 11=1), do not allow user to set the givenName attribute using the WCAP set_userprefs command.

Corresponding ics.conf parameter:

service.wcap.allowsetprefs.givenname

12 

allowSetGivenMail

If set (bit 12=1), do not allow user to set the mail attribute using the WCAP set_userprefs command.

Corresponding ics.conf parameter:

service.wcap.allowsetprefs.mail

13 

allowSetPrefLang

If set (bit 13=1), do not allow user to set the preferredLanguage attribute using the WCAP set_userprefs command.

Corresponding ics.conf parameter:

service.wcap.allowsetprefs.preferredlanguage

14 

allowSetSn

If set (bit 14=1), do not allow user to set the surname (sn) attribute using the WCAP set_userprefs command.

Corresponding ics.conf parameter:

service.wcap.allowsetprefs.sn

15–31 

Not used in the current release. 

allowProxyLogin

Specifies "yes" or "no" whether to allow proxy logins.

Corresponding ics.conf parameter:

service.http.allowadminproxy (default = "yes")

calmasterAccessOverride

Specifies "yes" or "no" whether the Calendar Server administrator can override access control.

Corresponding ics.conf parameter:

service.admin.calmaster.overrides.accesscontrol (default = "no")

calmasterCred

Specifies an ASCII string that is the password of the user ID specified as the Calendar Server domain administrator. 

Corresponding ics.conf parameter:

service.siteadmin.cred (no default)

calmasterUid

Specifies an ASCII string that is the user ID of the person designated as the Calendar Server domain administrator. 

Corresponding ics.conf parameter:

service.siteadmin.userid (no default)

createLowercase

Specifies "yes" or "no" whether Calendar Server should convert a calendar ID (calid) to lowercase when creating a new calendar or when searching for a calendar 

Corresponding ics.conf parameter:

calstore.calendar.create.lowercase (default = "no")

domainAccess

Specifies an access control list (ACL) for the domain. For information about ACLs, see 1.8.3 Access Control Lists (ACLs) in Calendar Server Version 6.3.

This ACL is used for cross domain searches. For more information, see 11.2 Cross Domain Searching in Calendar Server 6.3 Systems.

Only a single instance of domainAccess is allowed. However, the system does not warn you if there is a duplicate. You must ensure there is only one, whenever you change the value.

fbIncludeDefCal

Specifies "yes" or "no" whether a user’s default calendar is included in user’s free/busy calendar list. 

Corresponding ics.conf parameter:

calstore.freebusy.include.defaultcalendar (default = "yes")

filterPrivateEvents

Specifies "yes" or "no" whether Calendar Server filters (recognizes) Private and Time and Date Only (confidential) events and tasks. If "no", Calendar Server treats them the same as Public events and tasks.

Corresponding ics.conf parameter:

calstore.filterprivateevents (default = "yes")

groupMaxSize

Specifies the maximum size of an LDAP group that will be expanded for an invitation. 

Corresponding ics.conf parameter:

calstore.group.attendee.maxsize (default is "0" – expand the group without regard to size)

language

Specifies the language for a domain. 

Corresponding ics.conf parameter:

local.domain.language

resourceDefaultAcl

Specifies an access control list (ACL) that is the default access control permissions used when a resource calendar is created. 

Corresponding ics.conf parameter:

resource.default.acl (default is

"@@o^a^r^g;@@o^c^wdeic^g;
@^a^rsf^g"

setPublicRead

Specifies whether user default calendars are initially set to public read/private write ("yes") or private read/private write ("no"). 

Corresponding ics.conf parameter:

service.wcap.login.calendar.publicread (default = "no")

searchFilter

Specifies a search filter for finding a user. 

Corresponding ics.conf parameter:

local.userSearchFilter

ssoCookieDomain

Specifies that the browser should send a cookie only to servers in the specified domain. The value must begin with a period (.). For example: ".sesta.com" 

Corresponding ics.conf parameter:

sso.cookiedomain (default is the current domain)

ssoUserDomain

Specifies the domain used as part of the user’s SSO authentication. 

Corresponding ics.conf parameter:

sso.userdomain (no default)

subIncludeDefCal

Specifies "yes" or "no" whether a user’s default calendar is included in the user’s subscribed calendar list. 

Corresponding ics.conf parameter:

calstore.subscribed.include.defaultcalendar (default = "yes")

uiAllowAnyone

Specifies "yes" or "no" whether the user interface should show and use the "Everybody" access control list (ACL). 

Corresponding ics.conf parameter:

ui.allow.anyone (default = "yes")

uiAllowDomain

Specifies "yes" or "no" whether the user interface should show and use the access control list (ACL) for this domain. 

Corresponding ics.conf parameter:

ui.allow.domain (default = "no")

uiBaseUrl

Specifies a URL for the base server address. For example: "https://proxyserver".

Corresponding ics.conf parameter: 

ui.base.url (no default)

uiConfigFile

Specifies an optional xml based configuration file that Calendar Server can read at startup that allows parts of the user interface to be hidden.

Corresponding ics.conf parameter:

ui.config.file (no default)

uiProxyURL

Specifies a URL for the proxy server address to prepend in an HTML UI JavaScript file. For example: "https://web_portal.sesta.com/"

Corresponding ics.conf parameter:

ui.proxyaddress.url (no default)

icsAllowedServiceAccess

allowedAccessProtocols

Specifies whether access to Calendar Server is allowed. If set to “http”, access is denied. If set to any other value, access is allowed. 

Calendar Server uses this attribute only if the icsStatus attribute is not set.

icsDefaultAccess

userDefaultAcl

Specifies the ACL for a newly created user calendar. 

Corresponding ics.conf parameter:

calstore.calendar.default.acl

icsDomainNames

searchDomainNames

Specifies the external domains that this domain can search when looking for calendars or users. 

Corresponding ics.conf parameter: none

icsDWPBackEndHosts

(undefined) 

Specifies the default back-end host (DNS name) for a user if a host name is not explicitly provided. This attribute is used when Calendar Server is in LDAP CLD mode. 

icsStatus

statusCalendarDomain

Specifies that status of Calendar Server: 

• active–Calendar Server is accessible.

• inactive–Calendar Server is inaccessible. Calendars remain in the database and Calendar Server LDAP attributes remain unchanged.

• deleted–Calendar Server is inaccessible, because the person is marked as deleted.

• removed–Calendars have been removed from the calendar database.

  If icsStatus is set, its value overrides the icsAllowedServiceAccess attribute.

  If icsStatus is not set, Calendar Server uses the icsAllowedServiceAccess attribute.

icsTimezone

timezone

Specifies the default time-zone ID. For example, America/New_York or Asia/Tokyo. 

For the supported time zones, refer to the timezones.ics file.

csexport [-v|-q]
         -c calid
         calendar outputfile

calendar outputfile

Export the calendar to the specified output file. The data format of the file is determined by the specified filename extension: 

• .ics for iCalendar (text/calendar)

• .xml for XML (text/xml)

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-c calid

The calendar ID of the calendar to export. This option is required with the calendar command. There is no default. 

csimport [-v|-q]
          -c calid
         calendar inputfile

calendar inputfile

Import the calendar from the specified input file. The data format of the file is determined by the filename extension: 

• .ics for iCalendar (text/calendar)

• .xml for XML (text/xml)

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-c calid

The calendar ID of the calendar to import. This option is required with the calendar command. 

If the specified calendar ID already exits, the imported data is merged with the current calendar. There is no default. 

For more information, see 15.2 Creating Calendar Unique Identifiers (calid's).

csplugin [-q|-v] 
         [-r] 
          -t ac|attr|auth|locate|lookup|xlate
         activate|deactivate plugin

csplugin [-q|-v] list

activate -t type name

Load and enable the specified plug-in type and plug-in name. (For descriptions of the supported plug-in types, see the -t option in Table D–23.)

deactivate -t type name

Shut down and disable the specified plug-in type and plug-in name. (For descriptions of the supported plug-in types, see the -t option in Table D–23.)

list

List all the supported plug-in types, names, and activation status. (For descriptions of the supported plug-in types, see the -t option in Table D–23.)

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-r

When used with the activate command, physically copies the plug-in into the Calendar Server plugin directory.

When used with the deactivate command, deletes the plug-in from the plugin directory.

-t type

Specifies one of the following supported types of plug-ins: 

• ac— augments or overrides the default group scheduling access control mechanism.

• attr— augments or overrides the mechanism for storing and retrieving user attributes.

• auth— augments or overrides the login authentication mechanism.

• locate— retrieves a calendar ID for the specified qualified URL.

• lookup— augments or overrides the default calendar lookup mechanism.

• xlate— augments or overrides the format translation of incoming and outgoing data.

cspurge [-q|-v] 
        -e endtime 
        -s starttime

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-e endtime

Specifies the ending time in GMT (also referred to as UTC or Zulu). This value is up to (less than) the specified time. 

The default is 0, which means to the end of time. 

-s starttime

Specifies the starting time in GMT (also referred to as UTC or Zulu). This value includes (greater than or equal to) the specified time. 

The default is 0, which means from the beginning of time. 

csrename [-t DestinationDB] 
         [-c ConfigFile]
         [-e ErrorFile] 
          -m MappingFile 
         rename [DB|LDAP]

-t DestinationDB

Specifies the destination directory where csrename generates the new database with the converted user names. The default is MigratedDB. After csrename is finished, the caldb.berkeleydb.homedir.path parameter in the ics.conf file must point to the destination database. Either reset caldb.berkeleydb.homedir.path to point to the destination database directory, or move the destination database files to the directory indicated by the parameter.

-c ConfigFile

An input parameter that specifies a Calendar Server configuration file. The default is the ics.conf file. The csrename utility uses the caldb.berkeleydb.homedir.path parameter in the configuration file to determine the location of the input calendar database. The default location of the calendar database is /var/opt/SUNWics5/csdb.

-e ErrorFile

The file where csrename writes any errors or database entries that cannot be resolved. The default is MigrateError.

-m MappingFile

Specifies an input mapping file. The default is MigrateMapping. The input mapping file is a text file that maps existing user ID's to new user ID's. You must create the mapping file before you run csrename. Specify one entry per line with a space between the old and new values.

For example: 

tchang tc897675

jsmith js963123

bkamdar bk548769

If upon auditing your results, you find that one or more of your intended name changes was omitted, you can fix the error by creating a new mapping file with only the missed names in it and rerunning csrename.

DB|LDAP

Specifies the database that gets updated: 

DB converts user ID's in the new calendar database only (default).

LDAP converts user ID's in both the new calendar database and the LDAP directory server attributes.

csresource [-q|-v] 
           [-a aces] 
           [-b  basedn] 
           [-d domain] 
           [-t description] 
           [-k yes|no] 
           [-o owner] 
           [-y otherowners] 
            -m email 
            -c calid 
           create common_name

csresource [-q|-v] 
           [-b basedn] 
           [-d domain]
           delete|disable|enable [common_name]

csresource [-q|-v] 
           [-b basedn]
           [-d domain]
           [-h host] 
           list [common_name]

create common_name

Create a new resource for a specified calendar ID. 

delete [common_name]

Delete a resource or, if no resource common_name is specified, delete all resources.

enable [common_name]

Enable a resource or, if no resource common_name is specified, enable all resources.

disable [common_name]

Disable a resource or, if no resource common_name is specified, disable all resources.

list [common_name]

Display a single resource calendar or, if no resource name is specified, display all resource calendars.

If the -h host option is included, display the calendar attributes for the specified name (or all resource calendars) on that back-end server.

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-a [aces]

Access Control Entries (ACE's) for the specified calendar. ACE's determine who can access a calendar for group scheduling and the types of permissions they have, such as create, delete, read, and write privileges. An ACE string or Access Control List (ACL), must be enclosed in quotation marks ("").

The default is the resource.default.acl parameter in the ics.conf file.

For information about the ACE format, see 15.4 Calendar Access Control.

-b [basedn]

LDAP base DN (distinguished name) to be used for the specified resource. The default is taken from the local.ugldapbasedn parameter in the ics.conf file.

-c calid

The icsCalendar attribute. This option is required with the create command. For more information, see 15.2 Creating Calendar Unique Identifiers (calid's).

-d domain

Specifies the name of a domain. Default is taken from the service.defaultdomain parameter in the ics.conf file.

-t [description]

Specifies a viewable comment about the purpose of the calendar. The default is no description. 

-h host

Specifies the name of a back-end server where the resource calendar resides. This option applies only to the list command. 

-k yes|no

Specifies whether double booking is allowed for a calendar associated with a resource such as a conference room. For example, yes means the resource calendar can have more than one event scheduled for the same time slot.

If the -k option is omitted, the default is taken from the resource.allow.doublebook parameter in the ics.conf file. However, the resource.allow.doublebook parameter is used only when a calendar is created.

After a calendar is created, Calendar Server checks the calendar properties database (ics50calprops.db) to determine if double booking is allowed. If you need to change the calendar properties for a calendar to allow or disallow double booking, reissue csresource with the -k option.

-m email

Specifies the LDAP mail attribute (primary email address) for the resource. 

-o owner

Primary owner. 

Default is taken from service.siteadmin.userid in the ics.conf file.

-y otherowners

Other owners. Multiple owners must be enclosed in quotation marks (" ") and separated by spaces. The default is no other owners.

version

Display the version of the utility. 

csrestore [-v|-q] 
          [-f] 
          database inputdir

csrestore [-v|-q] 
           -c calid 
          calendar inputfile

csrestore [-v|-q] 
           -a userid
          [-b basedn] 
          defcal inputfile

database inputdir

Restore the calendar database from the specified input directory or input file that contains a backup calendar database. This operation overwrites all previous contents of the current calendar database. 

calendar inputfile

Restore the specified calendar ID from the specified input file. The data format of the file is determined by the filename extension: 

• .ics for iCalendar (text/calendar).

• .xml for XML (text/xml).

  If the specified calendar ID already exists, the calendar's data is cleared before it is restored.

defcal inputfile

Restore the default calendar of the specified user ID from the input file specified. The data format of the file is determined by the filename extension: 

• .ics for iCalendar (text/calendar).

• .xml for XML (text/xml).

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-a userid

The user ID to restore. This option is required with the default option. There is no default. 

-b basedn

The LDAP base DN (distinguished name) to be used for the specified user ID. The default is taken from the setting local.ugldapbasedn defined in the ics.conf file.

-f

To force any existing database files to be deleted. 

-c calid

The calendar ID to restore. This option is required with the calendar command. There is no default.

For more information, see 15.2 Creating Calendar Unique Identifiers (calid's).

csschedule [-q|-v] 
           [-c count] 
           [-e endtime] 
           [-s starttime]
           [-t scheduletime
             -o offset] 
           [-u uid] 
           list [calid]

csschedule [-q|-v] 
           [-t scheduletime 
             -o offset 
             -u uid 
             -n sequencenumber 
             -r rid] 
           list [calid]

csschedule [-q|-v]  
           [-t scheduletime 
             -o offset 
             -u uid 
             -n sequencenumber 
             -r rid] 
           delete [calid]

csschedule [-q|-v] 
           [-s starttime] 
           [-e endtime] 
           delete [calid]

         

list

Display entries held in the GSE queue requested by a specified calendar ID. 

delete

Delete an entry from the GSE queue requested by a specified calendar ID. 

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-c count

The number of GSE queue entries to list. For example, specify 10 if you want to examine ten entries in the queue. 

-e endtime

The ending time of the entry in the GSE queue where 0 means to the end of time. The default is 0. 

-n sequencenumber

The sequence number of the event or task in the queue. 

-o offset

An offset number for a schedule time. The offset number uniquely identifies an entry in the GSE queue when there is more than one entry scheduled at the same time. 

-r rid

The recurrence ID (RID) of the event or todo. An RID is a semicolon delimited list of strings that identify each occurrence of a recurring event or todo.

-s starttime

The starting time of the entry in the GSE queue where 0 means from the beginning of time. The default is 0. 

-t scheduletime

A schedule time, for example: 20001231T103045Z

-u uid

The unique identifier (UID) of an entry in the GSE queue.

csstats [-q|v] 
        [-r registry] 
        [-i iterations] 
        [-s delay] 
        list [subsystem] 

list [subsystem]

List counter statistics about a specified Calendar Server subsystem or. If subsystem is not specified, display basic information about the available subsystems, which are: 

• alarm — monitoring of services alarm notifications

• auth — login authentication

• db — calendar database

• disk — disk usage monitoring

• gse — Group Scheduling Engine (GSE)

• http — HTTP transport

• response — server response times

• sess — server session status

• wcap — Web Calendar Access Protocol

Version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-i iterations

The number of times to repeat statistical lookups. Default is 1. 

-r registry

The name and location of the file that stores counter statistics. The default is: 

/opt/SUNWics5/cal/lib/counter/counter

-s delay

The amount of time (in seconds) to wait before displaying each statistical lookup. The default is 1 second. 

csuser [-q|-v]
       [-a aces] 
       [-b basedn]
        -m email address 
       [-d domain]
        -f filename
        -g givenname 
       [-k yes|no] 
       [-l langcode] 
        -s surname 
        -y userpassword
       create userid

csuser [-q|-v] 
       [-b basedn] 
       [-d domain] 
       [-h host] 
       list [userid]

csuser [-q|-v] 
       [-b basedn] 
       [-d domain]
       [check|delete|disable|enable|reset] userid

         

check userid

Check if the specified user ID is enabled for calendaring. 

create userid

Create the specified user ID and enable this user to log into Calendar Server. 

delete userid

Delete the specified user ID. 

disable userid

Disables the specified user ID for calendaring by adding icsAllowedServiceAcess="http" to the user's LDAP entry.

enable userid

Enables the specified user ID for calendaring by removing icsAllowedServiceAcess="http" from the user's LDAP entry.

list [userid]

List the calendar attributes for the specified user ID. If user ID is not specified, list attributes for all enabled users. 

If the -h server-name option is included, list the calendar attributes for the specified user ID (or all enabled users) on that back-end server.

reset userid

Reset all calendar attributes for a user ID to their default settings. 

Note: After the calendar attributes for a user ID have been reset, all of the calendar attributes are removed from the user’s LDAP entry, including icsCalendarUser (object class), icsSubscribed, icsCalendarOwned, icsCalendar, and icsDWPHost (if the user is in an LDAP CLD setup). A Calendar Server administrator then cannot create calendars on the user’s behalf.

These attributes are restored in the user’s LDAP entry when the Calendar Server administrator issues a csuser enable command for the user.

version

Display the version of the utility. 

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

• Display no information if the operation is successful (errors, if they occur, are displayed).

• Suppress confirmation prompting for dangerous commands.

  Default is off.

-b basedn

The base DN to be used for all LDAP users. The default value is taken from the setting local.ugldapbasedn defined in the ics.conf file.

-d domain

Specifies the name of a domain. Default is taken from the service.defaultdomain parameter in the ics.conf file.

-a [aces]

Access Control Entries (ACE's) for a specified calendar. ACE's determine who can access a calendar for group scheduling and the types of permissions they have, such as create, delete, read, and write privileges. An ACE string or Access Control List (ACL), must be enclosed in quotation marks ("").

Default is: 

"@@o^a^r^g;@@o^c^wdeic^g;
@^a^sf^g;@^c^^g;@^p^r^g"

For details about the ACE format, see E.2.9 Calendar Server Services Configuration.

-f filename

File name to specify a password for options that require a password (-y parameter). If you are running csuser from a script, for added security, specify the password in filename.

-g givenname

The user's LDAP given name (first name). This option is required. There is no default. 

-h host

Specifies the name of a back-end server where the user’s calendar resides. This option applies only to the list command. 

-p port

The port number that LDAP server is listening to. The default value is taken from the setting local.ugldapport defined in the ics.conf file.

-k yes|no

If double booking is allowed for a user’s calendar. If yes, the user’s calendar can have more than one event scheduled for the same time slot.

Default is taken from the setting user.allow.doublebook defined in the ics.conf file.

-l [langcode]

Language code. Default is the value of local.sitelanguage in ics.conf.

-m email address

Specifies the LDAP mail attribute (primary email address) for the user. 

-s surname

The user's LDAP surname (last name). This option is required. There is no default. 

local.autoprovision

"yes"

Enables ("yes") or disables ("no") autoprovisioning of the user's calendar.

local.domain.language

"en"

Default language for domains in this Calendar Server instance. 

local.hostname

" "

Host name of the machine on which Calendar Server is installed. 

local.installeddir

cal-svr-base/SUNWics5/ cal

Directory path location where Calendar Server is installed. 

local.instancedir

cal-svr-base/SUNWics5/ cal

Directory path location where configuration files and data for this instance of Calendar Server are installed. 

local.instance.lockdir.path

cal-svr-base/SUNWics5/ cal/data/lock

Specifies the location where lock files for this server instance are stored. 

local.instance.counter.path

cal-svr-base/SUNWics5/ cal/lib/counter

Specifies the location where counter files for this server instance are stored. 

local.plugindir.path

" "

Directory path location where CSAPI plug-ins for this instance of Calendar Server are installed. 

local.rfc822header.allow8bit

"no"

Allow (y) or not allow (n) 8-bit headers in email messages sent by this server.

local.servergid

"icsgroup"

Group ID (gid) for Calendar Server files, such as counters and logs.

local.serveruid

"icsuser"

User ID (UID) for Calendar Server files, such as counters and logs.

local.sitelanguage

"en"

Default language for this instance of Calendar Server. 

local.smtp.defaultdomain

" "

Name of the default domain used to lookup an attendee’s calendar ID that corresponds to an email address. For example, jsmith resolves to jsmith@sesta.com if the value for this is setting is "sesta.com".

local.supportedlanguages

"en"

User languages supported by this instance of Calendar Server. 

local.authldapbasedn

" "

Base DN for LDAP authentication. If not specified, local.ugldapbasedn is used.

local.authldaphost

"localhost"

Host for LDAP authentication. If not specified, local.ugldaphost is used.

local.authldapbindcred

" "

Bind credentials (password) for user specified in local.authldapbinddn.

local.authldapbinddn

" "

DN used to bind to LDAP authentication host to search for user's dn. If not specified, or if the value is " ", its an anonymous bind.

local.authldapport

"389"

Port for LDAP authentication. If not specified, local.ugldapport is used.

local.authldappoolsize

"1"

Minimum number of LDAP client connections that are maintained for LDAP authentication. If not specified, local.ugldappoolsize is used.

local.authldapmaxpool

"1024"

Maximum number of LDAP client connections that are maintained for LDAP authentication. If not specified, local.ugldapmaxpool is used.

local.lookupldap.search.minwildcardsize

"3"

Specifies the minimum string size for wildcard searches in an attendee lookup search. Zero (0) means always do a wildcard search. 

local.ugldaphost

"localhost"

Host name of machine that stores the LDAP user preferences. 

local.enduseradmincred

" "

Bind credentials (password) for LDAP user preferences authentication. 

local.enduseradmindn

" "

DN used to bind to LDAP user preferences host. There is no default DN. If the value is " ", or not specified, anonymous bind is assumed.

local.ugldapbasedn

" "

Base DN for LDAP user preferences. Must be specified and cannot be blank. 

local.ugldapicsextendeduserprefs

"ceColorSet,

ceFontFace,

ceFontSizeDelta,

ceDateOrder,

ceDateSeparator,

ceClock,

ceDayHead,

ceDayTail,

ceInterval,

ceToolText,

ceToolImage,

ceDefaultAlarmStart,

ceSingleCalendarTZID,

ceAllCalendarTZIDs,

ceDefaultAlarmEmail,

ceNotifyEmail,

ceNotifyEnable,

ceDefaultView,

ceExcludeSatSun,

ceGroupInviteAll"

Values for the options in the icsExtendedUserPrefs attribute.

local.user.authfilter

"uid=%u"

Filter to use for user lookup. 

calstore.anonymous.calid

"anonymous"

Calendar ID (calid) used for anonymous logins.

user.allow.doublebook

"yes"

Determines if a user calendar can have more than one event scheduled for the same time slot when the calendar is created: 

• "no" prevents double booking.

• "yes" allows double booking.

calstore.calendar.default.acl

"@@o^a^r^g;
@@o^c^wdeic^g;
@^a^fs^g;
@^c^^g;
@^p^r^g"

Specifies the default access control permissions used when a user creates a calendar. The format is specified by a semicolon-separated list of access control entry (ACE) argument strings. 

For details on the ACE format, see 15.4 Calendar Access Control

To specify Access Control Entries for one or more calendars using the command-line utilities, see D.5 cscal.

calstore.calendar.owner.acl

"@@o^a^rsf^g;
@@o^c^wdeic^g"

Specifies the default access control settings for owners of a calendar. 

calstore.calendar.create.

lowercase

"no"

Specifies whether Calendar Server should convert a calendar ID (calid) to lowercase when creating a new calendar or when looking up a calendar using the LDAP CLD plug-in.

Although this parameter regulates the case of the original calid, it does not affect related LDAP attributes that set values for the owner, subscribed, and ACE permissions. Setting this parameter to “yes” may affect the use of Communications Express, since Communications Express relies on values set in the LDAP attributes such as icsCalendarOwned to determine the calid. Therefore, use caution if you intend to set this parameter to “yes.”

calstore.default.timezoneID

"America/
New_York"

Time zone ID to be used when: 

• A time zone ID is not supplied

• A calendar time zone ID is not found

• A user time zone ID is not found

  An invalid value causes the server to use to the GMT (Greenwich Mean Time) time zone.

calstore.filterprivateevents

"yes"

Specifies whether Calendar Server filters (recognizes) Private and Time and Date Only (confidential) events and tasks. If "no", Calendar Server treats them the same as Public events and tasks.

calstore.freebusy.include.

defaultcalendar

"yes"

Specifies whether a user's default calendar is included in user's free/busy calendar list. 

calstore.freebusy.remove.

defaultcalendar

"no"

Specifies whether a user's default calendar can be removed from user's free/busy calendar list. 

calstore.group.attendee.maxsize

"0"

Maximum size of an LDAP group that will be expanded for an invitation. A value of "0" means to expand the group without regard to size. A value of -1 means no expansion of LDAP groups allowed.

calstore.group.freebusy.maxsize

"0"

Maximum number of users present in any legitimate mailing list (group) used for calendar free/busy lookups. The default value allows an unlimited number of users.  

If a group contains an extremely large number of users, there can be performance issues and/or high memory consumption when doing a free/busy lookup. 

calstore.recurrence.bound

"60"

Maximum number of events that can be created by a recurrence expansion. 

calstore.subscribed.include.

defaultcalendar

"yes"

Specifies whether a user's default calendar is included in the user's subscribed calendar list. 

calstore.subscribed.remove.

defaultcalendar

"no"

Specifies whether a user's default calendar can be removed from the user's subscribed calendar list. 

calstore.userlookup.maxsize

"200"

Maximum number of results returned from LDAP lookup from user search. Value of "0" means no limit.

calstore.unqualifiedattendee.

fmt1.type

"uid"

Specifies how Calendar Server treats strings, such as jdoe or jdoe:tv, when performing a directory lookup for attendees of an event. Allowable values are: uid, cn, gid, res, mailto, cap.

calstore.unqualifiedattendee.

fmt2.type

"mailto"

Specifies how Calendar Server treats strings with an at sign (@), such as jdoe@sesta.com, when performing a directory lookup for attendees of an event. Allowable values are: uid, cn, gid, res, mailto, cap.

calstore.unqualifiedattendee.

fmt3.type

"cn"

Specifies how Calendar Server treats strings with a space, such as john doe, when performing a directory lookup for attendees of an event. Allowable values are: uid, cn, gid, res, cap.

store.partition.primary.path

"."

Location of primary disk partition where calendar information is stored. 

logfile.admin.logname.

"admin.log"

Name of log file for logging administrative tools. 

logfile.buffersize

"0"

Size of log buffers (in bytes). 

logfile.dwp.logname

"dwp.log"

Name of log file for logging Database Wire Protocol related administrative tools. 

logfile.expirytime

"604800"

Number of seconds before log files expire. 

logfile.flushinterval

"60"

Number of seconds between flushing buffers to log files. 

logfile.http.access.logname

"httpd.access"

Name of the current HTTP access log file. 

logfile.http.logname

"http.log"

Name of current log file for the cshttpd service.

logfile.http.access.

logname

"httpd.access"

Name of current HTTP access log file. 

logfile.logdir

"logs"

Directory location of log files. 

logfile.loglevel

"NOTICE"

Determines the level of detail the server will log. Each log entry is assigned one of these levels: CRITICAL, ALERT, ERROR, WARNING, NOTICE, INFORMATION, and DEBUG.

logfile.maxlogfiles

"10"

Maximum number of log files in log directory. 

logfile.maxlogfilesize

"2097152"

Maximum size of each log file (in bytes). 

logfile.maxlogsize

"20971520"

Maximum disk space for all log files (in bytes). 

logfile.minfree

diskspace

"5242880"

Minimum free disk space (in bytes) that must be available for logging. 

logfile.notify.logname

"notify.log"

Name of log file for the csnotifyd service.

logfile.rollovertime

"86400"

Number of seconds before log files are rotated. 

logfile.store.logname

"store.log"

Store log file name. 

service.http.commandlog

"no"

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

cred

" "

Password of the user ID specified as the Calendar Server administrator. This value is supplied at installation and is required by the installation program. 

service.siteadmin.

userid

"calmaster"

User ID of the person designated as the Calendar Server administrator. This value is supplied at installation and is required by the installation program. 

service.admin.calmaster.

overrides.accesscontrol

"no"

Indicates whether the Calendar Server administrator can override access control. 

service.admin.calmaster.

wcap.allowgetmodify

userprefs

"no"

Indicates whether the Calendar Server administrator can get and set user preferences using WCAP commands. 

service.admin.ldap.enable

"yes"

If "yes", enables LDAP for user authentication of the user specified in service.siteadmin.userid.

service.admin.alarm

"yes"

Enable ("yes") or disable ("no") alarm notifications for administration tools.

local.store.

checkpoint.enable

"yes"

If "yes", start the csadmind database checkpoint thread.

service.admin.

dbcachesize

"8388608"

Maximum cache size (in bytes) for Berkeley Database for administration sessions. 

local.store.

deadlock.enable

"yes"

If "yes", start the csadmind database deadlock detection thread.

service.admin.

diskusage

"no"

If "yes", start the csadmind low disk space monitor thread.

service.admin.enable

"yes"

If "yes", start the csadmind service when starting all services and stop csadmind when stopping all services.

service.admin.

idletimeout

"120"

Number of seconds before timing out an HTTP connection in csadmind.

service.admin.

maxsessions

"100"

Maximum number of administration sessions allowed. 

service.admin.

maxthreads

"10"

Maximum number of running threads per administration session. 

service.admin.

numprocesses

N/A 

Maximum number of a concurrent administration processes allowed. 

service.admin.port

N/A 

**CAUTION** 

Set by the system. Do not change. 

service.admin.

resourcetimeout

"900"

Number of seconds before timing out an administration connection. 

service.admin.

serverresponse

"no"

If "yes", start the csadmind service response thread.

service.admin.

sessiondir.path

" "

Temporary directory for administration session requests. 

service.admin.

sessiontimeout

"1800"

Number of seconds before timing out an HTTP session in csadmind.

service.admin.

sleeptime

"2"

Number of seconds to wait between checking for started, stopped, or ready calendar service. 

service.admin.

starttime

"300"

Number of seconds to wait for any calendar service to start. 

service.admin.

stoptime

"300"

Number of seconds to wait for any calendar service to stop. 

service.admin.

stoptime.next

"60"

Number of seconds to wait between sending stop commands to any calendar service. 

service.dcroot

"o=internet"

Root suffix of the DC tree in the directory. 

service.

dnsresolveclient

"no"

If "yes", client IP addresses are checked against DNS if allowed HTTP access.

service.plaintext

loginpause

"0"

Number of seconds to delay after successfully authenticating a user using plain text passwords. 

service.http.admins

"calmaster"

Space separated list of user ID's with administration rights to this Calendar Server. 

service.http.

allowadminproxy

"yes"

If "yes", allow login via proxy.

service.http.

allowanonymouslogin

"yes"

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

service.http

.calendarhostname

"" (Null)

HTTP host for retrieving HTML documents. 

service.http.cookies

"yes"

Tells the server to whether or to support cookies. It must be set to "yes" to enable single sign-on.

service.http.

dbcachesize

"8388608"

Maximum cache size of Berkeley DB for HTTP sessions. 

service.http.

domainallowed

"" (Null)

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

EXCEPT Operator 

You can use the EXCEPT operator to create exceptions to matching names or patterns when you have multiple entries in a list. For example, the expression: 

list1 EXCEPT list2

means that anything that matches list2 is matched, unless it also matches list2. 

For example: 

ALL: ALL EXCEPT isserver.siroe.com 

If this were a Deny filter, it would deny access to all services to all clients except those on the host machine, isserver.siroe.com. 

EXCEPT clauses can be nested. The expression: 

list1 EXCEPT list2 EXCEPT list3 

is evaluated as if it were 

list1 EXCEPT (list2 EXCEPT list3) 

service.http.

domainnotallowed

"" (Null)

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

EXCEPT Operator. For details about this operator, see the preceding entry, service.http.domainallowed.

service.http.

attachdir.path

"."

Directory location relative to local.queuedir (or an absolute path if specified) where imported files are temporarily stored.

service.http.

ipsecurity

"yes"

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

service.http.enable

"yes"

If "yes", start the cshttpd service when starting all services and stop cshttpd when stopping all services.

service.http.

idletimeout

"120"

Number of seconds before timing out an HTTP connection. 

service.http.

ldap.enable

"yes"

If "yes", LDAP connections for authentication and user preferences are created and maintained. 

service.http.listenaddr

"INADDR_ANY"

Specifies the TCP address that HTTP services will listen on for client requests. "INADDR_ANY" indicates any address.

service.http.logaccess

"no"

If "yes", HTTP connections to server are fully logged. 

service.http.

maxsessions

"5000"

Maximum number of HTTP sessions in cshttpd service.

service.http.

maxthreads

"20"

Maximum number of threads to service HTTP requests in cshttpd service.

service.http.

numprocesses

"1"

Maximum number of concurrently running HTTP service (cshttpd) processes that should run on a server.

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

service.http.port

"80"

Port for HTTP requests from Calendar Server users. 

service.http.

proxydomainallowed

""

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

service.http.

resourcetimeout

"900"

Number of seconds before timing out an HTTP session. 

service.http.

sessiondir.path

"http"

Temporary directory for HTTP sessions. 

service.http.sessiontimeout

"1800"

Number of seconds before timing out an HTTP session in cshttpd service.

service.http.sourceurl

" "

Directory relative to executable where all URL references to files are stored. 

service.http.tmpdir

Directory relative to executable where all URL references to files are stored. 

The default is: /var/opt/SUNWics5/tmp

service.http.uidir.path

"html"

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

service.ldapmemcache

"no"

If "yes", use cache in LDAP SDK. 

service.ldapmemcachettl

"30"

If service.ldapmemcache is "yes", pass in this value to the LDAP SDK. This is the maximum number of seconds that an item can be cached. If 0, there is no limit to the amount of time that an item can be cached.

service.ldapmemcachesize

"131072"

If service.ldapmemcache is "yes", pass in this value to the LDAP SDK. This is the maximum amount of memory in bytes that the cache will consume. If 0, the cache has no size limit.

service.wcap.anonymous

.allowpubliccalendarwrite

"yes"

If "yes", allow anonymous users to write to publicly writable calendars. 

service.wcap.format

"text/calendar"

Specifies the default output format for commands currently applied only for freebusy. 

service.wcap.

freebusybegin

"30"

Specifies the default offset from the current time in days for get_freebusy for beginning of the range.

service.wcap.

freebusyend

"30"

Specifies the default offset from the current time in days for get_freebusy for end of the range.

service.wcap.freebusy.

redirecturl

““ 

For migration purposes, when migration is only partially done and calendars are split between the originating database and the Calendar Server target database. The URL of the originating database to look in, if a calendar is not found in the Calendar Server database. 

service.wcap.allow

createcalendars

"yes"

If "yes", allow calendars to be created.

service.wcap.allow

deletecalendars

"yes"

If "yes", allow calendars to be deleted.

service.wcap.allow

changepassword

"no"

If "yes", allows user passwords to be changed.

service.wcap.allow

publicwritablecalendars

"yes"

If "yes", allow users to have publicly writable calendars.

service.wcap.allow

setprefs.cn

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference cn (LDAP user's common name).

service.wcap.allow

setprefs.givenname

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference givenname (LDAP user's given name).

service.wcap.allow

setprefs.icsCalendar

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference icsCalendar (a user's default calendar identifier).

service.wcap.allow

setprefs.mail

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference mail (user's email address).

service.wcap.allowsetprefs.

preferredlanguage

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference preferredlanguage (LDAP user's preferred language).

service.wcap.allow

setprefs.sn

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference sn (LDAP user's surname).

service.wcap.allow

setprefs.nswccalid

"no"

If "yes", allow the set_userprefs.wcap attribute to modify the user preference nswccalid, which is the user's default calendar ID.

service.wcap.login.

calendar.publicread

"no"

If "yes", default user calendars are initially set to publicly readable and privately writable. If "no", default user calendars are initially set to privately readable and writable.

service.wcap.userprefs.

ldapproxyauth

"no"

If "yes", enables LDAP proxy authorization for get_userprefs.wcap command. If "no", anonymous LDAP search is performed.

service.wcap.validateowners

"no"

If "yes", the server must validate that each owner of a calendar exists in the directory (through LDAP or a CSAPI compatible user directory mechanism).

service.wcap.version

"3.0"

WCAP version. 

encryption.rsa.

nssslactivation

"on"

Enables the RSA Cypher Encryption Family Services for SSL. 

encryption.rsa.

nsssltoken

"internal"

Specifies the location of the RSA Cypher Encryption Family token. 

encryption.rsa.

nssslpersonalityssl

"SampleSSLServerCert"

Specifies the certificate name for the RSA Cypher Encryption Family. 

service.http.tmpdir

/var/opt/SUNWis5/tmp

doma 

Specifies a temp directory. 

service.http.uidir.

path

"html"

Specifies directory where the UI files are found. 

service.http.ssl.

cachedir

"."

Specifies the physical path location for the SSL cache. 

service.http.ssl.

cachesize

"10000"

Specifies the maximum size of the SSL cache database. 

service.http.ssl.

usessl

"no"

For SSL configuration, change this value to "yes".

Specifies whether the cshttpd process should use the SSL subsystem.

service.http.ssl.

port.enable

"no"

For SSL configuration, change this value to “yes”. 

This does not disable the HTTP process from listening to its port. There is no way to actually disable HTTP, but you can assign it to another port that is non-functional.

Do not set service.http.enable="no". That would disable the HTTPS process also.

service.http.ssl.

port

"443"

Specifies the SSL port number where the cshttpd process listens for HTTPS requests from Calendar Server users.

Do not set this to the same default port used by HTTP ("80").

service.http.ssl.

securesession

"yes"

Specifies whether to encrypt the entire session. 

local.ssldbpath

"/etc/opt/SUNWics5/config"

Specifies the physical path location of the SSL Certificate Database. 

service.http.ssl.certdb.password — This parameter was removed from the ics.conf file. It was replaced by a configuration file.

sslpassword.com

sslpassword.conf is a text file that contains the certificate database password.

This file is used by the certutil utility but not by Calendar Server. Create sslpassword.conf in the following directory:

/etc/opt/SUNWics5/config

service.http.ssl.

sourceurl

"https://localhost:443"

Specifies the SSL host name and port number for the originating source URL. 

service.http.ssl.

ssl2.ciphers

""

Specifies ciphers for SSL2. 

service.http.ssl.

ssl2.sessiontimeout

"0"

Specifies the session timeout for SSL2. 

service.http.ssl.

ssl3.ciphers

"rsa_rc4_40_md5,
rsa_rc2_40_md5,
rsa_des_sha,
rsa_rc4_128_md5,
rsa_3des_sha"

Specifies a list of supported or valid SSL ciphers. 

service.http.ssl.

ssl3.sessiontimeout

"0"

Specifies the timeout value for the SSL session. 

local.domain.language

"en"

Default language for domains in this instance of Calendar Server. 

local.schemaversion

"1"

Specifies the version of the LDAP schema: 

• "1" Sun LDAP Schema version 1. See also service.dcroot

• "2" Sun LDAP Schema version 2. See also service.schema2root

service.dcroot

" "

Specifies the root suffix of the DC tree in the LDAP directory, if local.schemaversion="1". For example: "o=internet"

service.schema2root

" "

Specifies the root suffix underneath which all domains are found, if local.schemaversion="2". For example: "o=sesta.com"

service.defaultdomain

" "

Specifies the default domain for this instance of Calendar Server. Used when a domain name is not supplied during a login. For example: "sesta.com".

service.loginseparator

"@+"

Specifies a string of separators used for the login-separator when Calendar Server parses userid[login-separator]domain. Calendar Server tries each separator in turn.

service.siteadmin.userid

" "

Specifies the user ID of the domain administrator.