This section contains the following topics:
To create a new calendar, use the cscal utility create command. The user or resource entry must already exist in the LDAP directory. Refer to Chapter 14, Administering Users and Resourcesfor information on adding users and resources to your LDAP directory.
If your site is using the LDAP Calendar Lookup Database (CLD) plug-in, you must create all of the calendars for a particular user or resource on the same back-end server, as indicated by the icsDWPHost LDAP attribute in the user or resource entry. If you try to create a calendar on a different back-end server, the cscal utility returns an error. For information about the LDAP CLD plug-in, see Chapter 6, Configuring Calendar Database Distribution Across Multiple Machines.
For example, to create a new calendar with the calendar ID (calid) jsmith:
cscal -o jsmith -n JohnSmithCalendar create jsmith
-o jsmith specifies the primary owner of the new calendar.
-n JohnSmithCalendar specifies the viewable name for the new calendar.
The default access control settings are defined by calstore.calendar.default.acl in the ics.conf file.
To create a calendar with the viewable name Hobbies that is owned by John Smith and uses the default access control settings for group scheduling:
cscal -n Hobbies -o jsmith create Personal
-n Hobbies specifies the viewable name of the calendar.
-o jsmith specifies the user ID of the primary owner.
Personal is used as the second part of the calendar ID (calid). For example: jsmith:Personal
The following example creates a new calendar similar to the previous example, but it also associates the calendar with the category named sports, enables double booking, and specifies Ron Jones as another owner:
cscal -n Hobbies -o jsmith -g sports -k yes -y rjones create Personal
-g sports associates the calendar with a category named sports.
-y rjones specifies another owner of the calendar.
-k yes enables double booking. (-k no would disable double booking.)
cscal -n Hobbies -o jsmith -a "@@o^a^sfr^g" create Personal
where -a "@@o^a^sfr^g" grants other owners schedule, free/busy, and read access privileges to both the components and calendar properties of this calendar for group scheduling.
A resource calendar is associated with things that can be scheduled, such as meeting rooms, notebook computers, overhead projectors and other equipment. Resource calendars require access control lists.
As shown in table Table 15–3, two configuration parameters in the ics.conf file apply to resource calendars:
resource.default.acl– A default access control list.
resource.allow.doublebook– A parameter that allows or disallows doublebooking.
While doublebooking a user’s calendar might be desirable, doublebooking of resources is probably not desirable, therefore, the default value is "no". However, you are allowed to change it to "yes", if desired.
To change the default values for these parameters (shown in table Table 15–3), edit the ics.conf file. Changes to the default values will apply only to new resource calendars; it will not change the values for existing resources.
For Schema 1, use the Calendar Server Utility cscal to change values for an existing resource calendar. The csresource utility does not have a modify command.
For Schema 2, use the Delegated Administrator Utility command commadmin resource modify. The Delegated Administrator Console does not allow you to change these values for calendar resources.
The Calendar Server notification software is not programmed to send notifications to resources, only to users.
Description and Default Value
This parameter determines the default access control permissions used when a resource calendar is created. The default permissions are specified by the following Access Control List (ACL):
This ACL grants all calendar users read, schedule, and free/busy access to the calendar, including both components and properties.
To change the permissions for a resource, use the-a option when you create the calendar using the csresource utility create command.
This parameter determines if a resource calendar allows doublebooking. Doublebooking allows a resource calendar to have more than one event scheduled for the same time.
The default is "no"— Do not allow doublebooking.
To allow doublebooking for a resource calendar, use the -k option when you create the calendar using the csresource utility create command.
Calendar Server does not have autoprovisioning of resource calendars. For every resource required at your site, you must use of the following methods:
For Schema 1, use the Calendar Server Utility command csresource create.
This utility creates both the LDAP entry and the default calendar for the resource.
For example, to create a resource LDAP entry and calendar with the calendar ID aud100, viewable name Auditorium (LDAP cn attribute), with the default settings, use the following command:
csresource -m firstname.lastname@example.org -c aud100 create Auditorium
For Schema 2, use a combination of the Delegated Administrator Utility command commadmin resource create to create the LDAP entry. Then use the Calendar Server Utility command csresource create to create the default calendar.
For Schema 2, create the resource LDAP entry using the Delegated Administration Console. Then use the Calendar Server Utility command csresource create to create the default calendar.
To create the LDAP resource with the Console, select the organization where this resource will reside from the Organizations List. From the Calendar Resources page for this organization, click New to bring up the Create New Calendar Resource Wizard.
If there is an existing LDAP entry for the resource, csresource creates only the calendar. It will not create a duplicate LDAP entry.
For more information about the Delegated Administrator Utility, see Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide.
For more information about the Delegated Administrator Console, see the online help.
For more information about csresource, see Appendix D, Calendar Server Command-Line Utilities Reference.
By default, Calendar Server does not allow double booking for a resource calendar (resource.allow.doublebook parameter). This default prevents scheduling conflicts for resources such as rooms and equipment. However, if you want to allow double booking for a resource calendar, set the csresource -k option to “yes” when you create the calendar.
The following command creates a resource LDAP entry and calendar, but the -k option allows double booking on the calendar, the -o option specifies bkamdar as the owner of the calendar, and the -y option specifies jsmith as another owner:
csresource -m email@example.com -c aud100 -k yes -o bkamdar -y jsmith create Auditorium
To control who can schedule a specific resource, consider limiting the users who have write access to the resource calendar. For example, you might want to allow only certain users to schedule meeting rooms or reserve equipment.
If you do not specify an owner for a resource calendar, the value is taken from the service.admin.calmaster.userid parameter in the ics.conf file.