commadmin resource create

The commadmin resource create command creates a directory entry for a resource.

For instructions on creating a resource, see Creating a Resource.

Syntax

commadmin resource create -D <login> -n <domain> -w <password> -u <identifier> -N <name> 
    [-c <calendar identifier>] [-A [+]<attributename>:<value>] [-C <DWPHost>]
    [-d <domainname> ] [-h] [-?] [-i <inputfile>][-p <AM port>] [-s] [-T <time zone>] [-v]
    [-V] [-X <AM host>]

Options

The following options are mandatory:

Option	Description
`-D` login	The user ID of the user with permission to execute this command.
`-n` domain	Domain of the user specified with the `-D` option.
`-w` password	Password of the user specified with the `-D` option.
`-u` identifier	Resources’ unique identifier.This identifier value should be unique within the domain namespace or within all the users and resources the calendar manages in the calendar mode.
`-N` name	Friendly name used to display the resource in the calendar GUI.
`-c` calendar identifier	Identifier for this resource's calendar.The identifier value should be unique throughout all the calendars managed by the Calendar Server

The following options are non-mandatory:

Option	Description
`-A` [+] attributename:value	An attribute to modify. The attributename is defined in the LDAP schema and value replaces any and all current values for this attribute in the directory. Repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.A “+” before the attributename indicates adding the value to the current list of attributes.
`-C` DWPHost	The DNS name of the back end calendar server which hosts this user's calendars.If the DNS name of the backend calendar server is not specified, the value stored in the ics.conf file of the server is used as the default value.
`-d` domain name	Domain of the resource. If `-d` is not specified, the domain specified by `-n` is used.
`-h`, `–?`	Prints command usage syntax.
`-i` inputfile	Reads the command information from a file instead of the command line.An option value specified in the input file overrides any value for the same option set in the command line.
`-p` AM port	Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default AM port is used, or Port 80 is used if no default was configured at install time.
`-s`	Use SSL (Secure Socket Layer) to connect to the Access Manager.
`-T` time zone	The time zone used to display the resource's calendar in the calendar’s user interface. See Calendar Time Zone Strings for a list of the valid time zone strings.
`-v`	Enable debugging output.
`-V`	Prints information about the utility and its version.
`-X` AM host	Specifies the host on which the Access Manager is running. If not specified, the default AM host is used, or the localhost if no default was configured at install time.

Example

To create a resource with Name peter in the calendar cal.siroe.com under the domain varrius.com:

commadmin resource create -D chris -n sesta.com -w bolton \
-d varrius.com -u id -c calid -N peter -C cal.siroe.com

Creating a Resource

A resource consists of two data descriptions: a directory entry and a calendar in the Calendar Server database. The directory entry has an attribute, icsCalendar, whose value is the name of the calendar associated with the resource.

You can create a resource with the two data descriptions, using either of the following methods:

Use commadmin resource create to create a directory entry.
The calendar for the resource is created automatically when the resource is first invited to an event. The ics.conf parameter, resource.invite.autoprovision, determines whether a resource's calendar is created automatically when the resource is invited to an event. By default, the value of this parameter is set to Yes.
To create the resource's calendar before any invitations are sent to the resource, use the cscal utility.
Example
Use commadmin resource create to create a directory entry:
```
commadmin resource create -D amadmin -w ampassword -n blink.sesta.com \
 -X blink -p 5555 -d varrius.com -u resourceOne \
 -N firstResource -c resourceOneCalendar
```
The directory entry is as follows:
```
dn: uid=resourceONE,ou=People,o=varrius,o=domainroot
uid: resrouceONE
objectClass: icsCalendarResource
objectClass: top
cn: firstResource
icsStatus: active
icsCalendar: resourceOne
```
Use the csresource utility by itself. The csresource utility creates a directory entry and a calendar.
However, using csresource to create both the directory entry and the calendar is only recommended if the directory is in a Schema 1 environment and you are not using Access Manager.

You can now log in as any user and invite the resource to an event.

For a detailed description of the csresource and cscal utilities, see Calendar Server Command-Line Utilities in the Sun Java System Calendar Server 6.3 Administration Guide.

commadmin resource create