|
|
|
|
|
CorporateTime Server |
Administrator's Guide |
| View in pdf format |
| Go to Reference Manual |
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
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.
Directory for HTML template files
Section
Parameter
Description
Specifies a directory for HTML template files.
Accepted values
A path relative to the location of the Calendar Administrator CGI or fastCGI
Default value
Directory for temporary sessions files
Section
Parameter
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
Default value
Directory for images
Section
Parameter
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
Default value
List of Calendar Domain Service hosts -- disregarded
Section
Parameter
Description
Not for use in CorporateTime Server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.
CGI or FCGI operation
Section
Parameter
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
Default value
SYSOP password -- disregarded
Section
Parameter
Description
Not for use in CorporateTime Server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.
Old SYSOP password -- disregarded
Section
Parameter
Description
Not for use in CorporateTime Server installations. Please do not set a value for this parameter without explicit instructions from technical support personnel.
Site name
Section
Parameter
Description
Specifies the display name of the Calendar Administrator provider within the Web interface.
Accepted values
Default value
Site logo
Section
Parameter
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
Default value
Domain logo
Section
Parameter
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
Default value
Support e-mail
Section
Parameter
Description
Specifies an e-mail address for Calendar Administrator users to contact in case of errors or difficulties.
Accepted values
Default value
User management
Section
Parameter
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
Resource management
Section
Parameter
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
Holiday management
Section
Parameter
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
Event calendar management
Section
Parameter
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
Admin password management
Section
Parameter
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
|
|
|
|
|
| Copyright information | |||