F
The Calendar Administrator

The Calendar Administrator is a new, fully customizable Web-based administration tool for calendar server management. The CGI or fastCGI application runs on a Web server, displaying HTML template files that it updates dynamically with information from the calendar server.

Through the Calendar Administrator, you can manage users, resources, holidays and event calendars. You may also customize the look and feel of the application to match your organization's identity.

While the GUI itself is designed to be intuitive and easy-to-use, there are some other issues to consider.

• Web server configuration
• Calendar Administrator customization
• Calendar Administrator configuration

Web server configuration

Ensure that the Calendar Administrator is set up on your Web server with the following configuration:

• uniwebadm.cgi and uniwebadm.ini are in the /caladmin directory within your Web server's cgi-bin directory or fcgi-bin directory (e.g. /usr/local/Apache/cgi-bin/caladmin)
• HTML template files and stylesheet files (uniwebadm.css) are stored in a subdirectory within the directory containing uniwebadm.cgi (e.g. /usr/local/Apache/cgi-bin/caladmin/templates_domain1)
• uniwebadm.js is in the /caladmin directory within your Web server's DocumentRoot (e.g. /usr/local/Apache/htdocs/caladmin)

Calendar Administrator customization

Three levels of customization exist for the Calendar Administrator. On the first level, parameters in the uniwebadm.ini file can be configured to control the level of administration possible through the interface. Secondly, most aspects of the look and feel of the application can be easily controlled through a cascading stylesheet (uniwebadm.css) that is applied to all HTML template files. Thirdly, the template files themselves can be changed to make more radical alterations to the Calendar Administrator look and feel.

By parameters

Customize the administrative operations available through the Calendar Administrator interface using the [PROVISIONINGSETTINGS] manageusers, manageresources, manageholidays, manageeventcalendars, and modifyadminpassword parameters in uniwebadm.ini. See "Calendar Administrator configuration" below for more details on these parameters.

By stylesheet

All HTML template files used by the Calendar Administrator link to a cascading stylesheet file, uniwebadm.css. For more information on cascading stylesheet use and syntax, consult the .css specifications available from the World Wide Web Consortium at http://www.w3c.org. Be advised that different browsers implement cascading stylesheets in very different ways.

By templates

You may choose to alter the HTML template files used by the Calendar Administrator. If you do so, ensure that you do not delete any tags bearing the "CADM" reference. These tags are used by uniwebadm.cgi to update the pages dynamically; removing them will cause errors. Use the /users/unison/misc/domain/domain.ini [YOURDOMAINID] adm.templatesdir parameter to configure different template directories for each of your domains.

Calendar Administrator configuration

The Calendar Administrator configuration file (uniwebadm.ini) contains a number of configurable parameters that control the behaviour of the application. Keep this file in the same directory as uniwebadm.cgi. Most of these parameters are set during installation.

This table lists all uniwebadm.ini parameters in alphabetical order by section.

Table F-1 uniwebadm.ini configuration parameters

Section	Parameter	Description
[ADMINSETTINGS]	adminoldpassword	Old SYSOP password -- disregarded
	imagesdir	Directory for images
	caldomainserverlist	List of Calendar Domain Service hosts -- disregarded
	cgimode	CGI or FCGI operation
	serverpassword	SYSOP password -- disregarded
	sessionsdir	Directory for temporary sessions files
[PROVISIONINGSETTINGS]	domainlogo	Domain logo
	manageeventcalendars	Event calendar management
	manageholidays	Holiday management
	manageresources	Resource management
	manageusers	User management
	sitelogo	Site logo
	sitename	Site name
	supportemail	Support e-mail
	templatesdir	Directory for HTML template files

Directory for HTML template files

Section

[PROVISIONINGSETTINGS]

Parameter

templatesdir

Description

Specifies a directory for HTML template files.

Accepted values

A path relative to the location of the Calendar Administrator CGI or fastCGI

An absolute path

Default value

templates

Directory for temporary sessions files

Section

[ADMINSETTINGS]

Parameter

sessionsdir

Description

Specifies a directory for temporary files identifying sessions of the Calendar Administrator.

Accepted values

A path relative to the location of the Calendar Administrator CGI or fastCGI

An absolute path

Default value

sessions

Directory for images

Section

[ADMINSETTINGS]

Parameter

imagesdir

Description

Specifies a directory for any images to be displayed in the Calendar Administrator interface.

Accepted values

A path relative to the location of your Web server's DocumentRoot

An absolute path

Default value

images

List of Calendar Domain Service hosts -- disregarded

Section

[ADMINSETTINGS]

Parameter

caldomainserverlist

Description

Not for use in Oracle Calendar server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.

CGI or FCGI operation

Section

[ADMINSETTINGS]

Parameter

cgimode

Description

Specifies whether the Calendar Administrator should run as a CGI or FCGI application. This parameter should only be used if it becomes necessary to force a particular behaviour. By default, the Calendar Administrator will run as a CGI or FCGI application depending on the choice made at installation time and the file extension of the application.

Accepted values

cgi

fcgi

auto

Default value

auto

SYSOP password -- disregarded

Section

[ADMINSETTINGS]

Parameter

serverpassword

Description

Not for use in Oracle Calendar server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.

Old SYSOP password -- disregarded

Section

[ADMINSETTINGS]

Parameter

adminoldpassword

Description

Not for use in Oracle Calendar server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.

Site name

Section

[PROVISIONINGSETTINGS]

Parameter

sitename

Description

Specifies the display name of the Calendar Administrator provider within the Web interface.

Accepted values

Any string

Default value

None

Site logo

Section

[PROVISIONINGSETTINGS]

Parameter

sitelogo

Description

Specifies the logo of the Calendar Administrator provider within the Web interface.

Accepted values

A filename in the directory specified by the [ADMINSETTINGS] imagesdir parameter

A URL relative to the Web server base URL

A fully-qualified URL

Default value

None

Domain logo

Section

[PROVISIONINGSETTINGS]

Parameter

domainlogo

Description

Specifies a second logo, if desired.

Accepted values

A filename in the directory specified by the [ADMINSETTINGS] imagesdir parameter

A URL relative to the Web server base URL

A fully-qualified URL

Default value

None

Support e-mail

Section

[PROVISIONINGSETTINGS]

Parameter

supportemail

Description

Specifies an e-mail address for Calendar Administrator users to contact in case of errors or difficulties.

Accepted values

A valid e-mail address

Default value

None

User management

Section

[PROVISIONINGSETTINGS]

Parameter

manageusers

Description

Determines whether user management options will be available through the Calendar Administrator interface.

Accepted values

TRUE (User management is available)

FALSE (User management is disabled)

Default value

TRUE

Resource management

Section

[PROVISIONINGSETTINGS]

Parameter

manageresources

Description

Determines whether resource management options will be available through the Calendar Administrator interface.

Accepted values

TRUE (Resource management is available)

FALSE (Resource management is disabled)

Default value

TRUE

Holiday management

Section

[PROVISIONINGSETTINGS]

Parameter

manageholidays

Description

Determines whether holiday management options will be available through the Calendar Administrator interface.

Accepted values

TRUE (Holiday management is available)

FALSE (Holiday management is disabled)

Default value

TRUE

Event calendar management

Section

[PROVISIONINGSETTINGS]

Parameter

manageeventcalendars

Description

Provides a default value for the event calendar management option in the Calendar Administrator's Domain Creation page.

Determines whether event calendar management options will be available through the Calendar Administrator interface.

Accepted values

TRUE (Event calendar management is available)

FALSE (Event calendar management is disabled)

Default value

TRUE

Admin password management

Section

[PROVISIONINGSETTINGS]

Parameter

modifyadminpassword

Description

Provides a default value for the Domain Administrator password management option in the Calendar Administrator's Domain Creation page..

Accepted values

TRUE (Password modification is available)

FALSE (Password modification is disabled)

Default value

TRUE