Sun Java System Calendar Server 6 2005Q4 Administration Guide


This guide explains how to administer Sun JavaTM System Calendar Server 6 2005Q4 (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 Use This Book

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

Before You Read This Book

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

How This Book Is Organized



Preface (this chapter)

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

Part I, Overview

Chapter 1, Overview

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

Part II, Postinstallation Configuration

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 III, Customizing Your Calendar Server Configuration

Chapter 5, Customizing Calendar Server

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 IV, Calendar Server Administration

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 Calendar 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 V, 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 Calendar Server command-line utilities. 

Appendix E, Calendar Server Configuration Parameters

Reference for ics.conf parameters

Related Books

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

In addition, the graphical user interfaces, Communications Express and Delegated Administration Console, have online help.

Related Third-Party Web Site References

Third-party URL's are referenced in this document and provide additional, related information.

Note –

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 or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Documentation, Support, and Training

Sun Function 




Download PDF and HTML documents, and order printed documents 


Learn about Sun courses 


Obtain technical support and patch downloads. 

Typographic Conventions

The following table describes the typographic changes that are used in this book.

Table P–1 Typographic Conventions

Typeface or Symbol 




The names of commands, files, and directories, and onscreen computer output 

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.


What you type, contrasted with onscreen computer output 

machine_name% su



Placeholder: replace with a real name or value 

The command to remove a file is rm filename.


Book titles, new terms, and terms to be emphasized 

Read Chapter 6 in the User's Guide.

Perform a patch analysis.

Do not save the file.

[Note that some emphasized items appear bold online.] 

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–2 Shell Prompts



C shell prompt 


C shell superuser prompt 


Bourne shell and Korn shell prompt 


Bourne shell and Korn shell superuser prompt