The csresource utility creates and manages LDAP entries and calendars for resources, such as conference rooms or equipment. (The csresource utility is available only for calendars associated with a resource and returns an error if issued against a user’s calendar.) Commands are:
create adds a new resource for a specified calendar ID (calid)
delete removes a resource or all resources
disable disables a resource or all resources
enable enables a resource or all resources
list displays a single resource or a list of all resources
You must run the utility locally on the machine where Calendar Server is installed.
Calendar Server can be running or stopped.
You must be logged in as the user and group under which Calendar Server is running (such as icsuser and icsgroup) that was specified during installation, or as root.
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] |
Then following table describes the commands available for the csresource utility.
Table D–28 csresource Utility Commands
Command |
Description |
---|---|
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. |
If the name contains a space in any of the above commands, it must be enclosed in quotation marks (" ").
The following table describes the csresource utility command options.
Table D–29 csresource Utility Command Options
Option |
Description |
---|---|
-v |
Run in verbose mode: Display all available information about the command being performed. Default is off. |
-q |
Run in quiet mode:
|
-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 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 Creating Calendar Unique Identifiers (calid's). |
-d domain |
Specifies the name of a hosted (virtual) 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.admin.calmaster.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. |
Display a list of all resource calendars and their LDAP attributes:
csresource -v list
Create a resource calendar with the calendar ID (calid) room100 and the viewable name (LDAP cn attribute) MeetingRoom100:
csresource -m room100@sesta.com -c room100 create MeetingRoom100
Display the LDAP attributes of the resource calendar with the viewable name MeetingRoom100:
csresource -v list MeetingRoom100
Disable the resource calendar with the viewable name MeetingRoom100:
csresource disable MeetingRoom100
Enable the resource calendar with the viewable name MeetingRoom100 and allow doublebooking:
csresource -k yes enable MeetingRoom100
Delete the resource calendar with the viewable name MeetingRoom100:
csresource delete MeetingRoom100
Display the LDAP attributes of the resource calendar with the viewable name MeetingRoom100 on the back-end server sesta:
csresource -v -h sesta list MeetingRoom100