Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Calendar Server 6 2005Q1 Administration Guide 

About This Guide

This guide explains how to administer Sun Java™ System Calendar Server 6 2005Q1 (Calendar Server), formerly Sun™ ONE Calendar Server.

Calendar Server provides a scalable, Web-based solution for centralized calendaring and scheduling for enterprises and service providers. Calendar Server supports personal calendars as well as group and resource scheduling.

Topics in this chapter include:

Who Should Read This Guide

This guide is intended for Calendar Server administrators and support specialists who are responsible for administering and configuring Calendar Server.

What You Need to Know

Before you install and administer Calendar Server, you must be familiar with the following concepts:

How This Guide is Organized

Table 1  Organization of the Calendar Server Administration Guide 

Chapter or Appendix


About This Guide (this chapter)

Describes the audience, requirements, organization, document conventions, and related information.

Chapter 1, "Overview"

Provides a high-level overview of Calendar Server, including the components, architecture, interfaces, and protocols.

Part I, "Postinstallation Configuration"

Chapters on running the two configuration programs and database migration utilities after installation and before attempting to run Calendar Server.

Chapter 2, "Directory Preparation Script ("

Provides instructions for running the Directory Preparation Script (

Chapter 3, "Calendar Server Configuration Program ("

Provides instructions for running the program.

Chapter 4, "Database Migration Utilities"

Provides instructions for using the two postinstallation database migration utilities, csmig and csvdmig.

Part II, "Customizing Your Calendar Server Configuration"

Chapters on customizing and reconfiguring Calendar Server using the ics.conf file.

Chapter 5, "Customizing the Configuration File"

Provides instructions on customizing various aspects of Calendar Server.

Chapter 6, "Configuring Calendar Database Distribution Across Multiple Machines"

Describes the configuring CLD plug-in, which enables distribution of the calendar database over multiple servers.

Chapter 7, "Configuring for High Availability (Failover Service)"

Describes how to set up a High Availability environment.

Chapter 8, "Configuring SSL"

Describes how to set up and manage SSL.

Chapter 9, "Configuring Single Sign-on"

Describes how to configure single sign-on through either Access Manager authentication, or through Messaging Server (circle of trust).

Chapter 10, "Configuring Automatic Backups (csstored)"

Describes how to configure csstored to take automatic backups.

Chapter 11, "Setting Up Hosted Domains"

How to configure Calendar Server with hosted domains.

Part III, "Calendar Server Administration"

Chapters on administering Calendar Server.

Chapter 12, "Administering Calendar Server"

Describes the general Calendar Server tasks such as starting and stopping services.

Chapter 13, "Administering Hosted Domains"

How to create, modify, delete and list domains for a hosted domain environment.

Chapter 14, "Administering Users and Resources"

Describes how to administer user and resource LDAP entries.

Chapter 15, "Administering Calendars"

Describes how to administer Calendars, including access control.

Chapter 16, "Administering Calendar Server Databases with csdb"

Describes how to administer and maintain the Calendar Server databases and data.

Chapter 17, "Backing Up and Restoring Calendar Server Data"

Describes how to back up and restore Calendar Server data.

Chapter 18, "Administering the Delete Log Database"

Describes how to manage the Delete Log database (ics50deletelog.db).

Chapter 19, "Administering Calendar Server Time Zones"

Describes how Calendar Server processes time zones and how to add a new time zone table or modify the time zone tables supplied.

Chapter 20, "Using Instant Messaging Pop-up Reminders"

Describes how to set up Instant Messaging Pop-up reminders for Calendar events.

Chapter 21, "Tuning Calender Server Performance"

Describes how to tune Calendar Server for optimum performance, including using the LDAP data cache.

Chapter 22, "Troubleshooting"

Covers various ways to gather information and fix problems.

Part IV, "Appendixes"


Appendix A, "Directory Configuration Worksheet"

Worksheet for gathering Directory Preparation Script information.

Appendix B, "Calendar Server Configuration Worksheet"

Worksheets for gathering information for

Appendix C, "High Availability (HA) Configuration Worksheets"

Provides worksheets to plan a high availability (HA) configuration.

Appendix D, "Calendar Server Command-Line Utilities Reference"

Reference for the non-commadmin command-line utilities included with Calendar Server.

Appendix E, "Calendar Server Configuration Parameters"

Reference for ics.conf parameters


Refers to the Sun Java Enterprise System Glossary


Document Conventions Used in This Guide

This guide uses conventions for the Solaris OS. If you are running Calendar Server on another operating system, use the file path equivalents for your operating system whenever Solaris file paths are shown.

Monospaced Font

The Monospaced Font typeface is used for any text that appears on the computer screen or text that you should type. It is also used for file names, distinguished names, functions, and examples.

Italicized Font

The Italicized Font typeface represents text that you enter using information unique to your installation. It is used for server directory paths and names. For example, in this guide you will see directory path references in the form:


In these situations, cal_svr_base represents the base or root directory where Calendar Server 6 2005Q1 is installed.

Square Brackets [  ]

Square (or straight) brackets [ ] enclose optional parameters. For example, the syntax for the csdb utility check command is: csdb check [dbdir]

The dbdir parameter is optional. If you omit dbdir, the csdb utility uses the current directory specified in the ics.conf file.

Braces {  }

Braces {  } enclose a group of items from which you must choose one item. For example, in the following syntax, you must specify either the -a or -f option:

{-a attr[=value] | -f filename}

Vertical Bar (|)

A vertical bar (|) separates alternatives in a horizontal list. For example, the syntax for the csdb utility create or delete command uses the vertical bar to specify various options you can use:

csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir]

Command-Line Prompts

Command-line prompts (such as % for a C-Shell or $ for a Korn or Bourne shell) are not shown in the examples in this guide. The actual prompt you will see depends on the operating system you are using. Unless specifically noted, enter each command as it appears in this document.

Related Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.


Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.


Accessing Sun Documentation Online

Calendar Server includes documentation for administrators, developers, and end users on the following Web site:

The following Calendar Server documents are available in PDF and HTML formats:

For end users, online help is available from either user interface: Sun Java System Calendar Express, or Sun Java System Communications Express.

Previous      Contents      Index      Next     

Part No: 819-0024-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.