Contents


About This Guide

Who Should Read This Guide
What You Need to Know
How This Guide is Organized
Document Conventions Used in This Guide
Where to Find Related Information
Where to Find This Guide Online

Chapter 1 Introduction to iPlanet Calendar Server

Calendar Server Administrators

Calendar Server Administrator (calmaster)
Calendar Server User and Group (UNIX only)
root (UNIX only)
Windows NT Administrator

Calendar Server Users

Creation of Calendar Server Users
Authentication of Calendar Server Users

Calendar Server Data

Calendar Server Data Format
Calendar Server Format Encoding
Calendar Groups
Calendar Server Event Feeds
Calendar Server Data Exchange and Alarms
Calendar Server User Preferences

Calendar Server Architecture

Calendar Server Internal Subsystems

Protocol Subsystem
Core Subsystem
Database Subsystem

Calendar Server Services

Administration Service - csadmind
HTTP Service - cshttpd
Notification Service - csnotifyd
Event Notification Service (ENS) - enpd
Distributed Database Service - csdwpd

Basic Calendar Server Configurations

Minimal Calendar Server Configuration
Scalable Calendar Server Configuration

Calendar Server Access Control
Calendar Server APIs and SDKs

Calendar Server API (CSAPI)
Event Notification Service (ENS) API
Proxy Authentication SDK (authSDK)
Web Calendar Access Protocol (WCAP)

Single Sign-on (SSO)
Calendar Server Deployment Configurations

Network Front End, Single Database Back End
Multiple Front Ends, Multiple Database Back Ends

Chapter 2 Managing Calendar Server Users and Calendars

Provisioning New Calendar Server Users

Directory Server Requirements
Calendar Identifiers (calids)

Calendar Lookup Database Plug-in

Checking if a User is Enabled for Calendaring
Provisioning a New User
Creating a New Calendar

Managing Calendar Server Users

Displaying User Information
Disabling and Enabling a User
Deleting a User
Resetting a User's Attributes

Managing User Calendars

Displaying Calendars
Deleting a Calendar
Disabling and Enabling a Calendar
Modifying Calendar Properties
Removing Properties From a Calendar
Recovering a "Lost" Calendar

Creating and Managing Resource Calendars

Setting Resource Calendar Configuration Parameters
Creating a Resource Calendar
Displaying Resource Calendars and Attributes
Modifying a Resource Calendar
Disabling and Enabling a Resource Calendar
Deleting a Resource Calendar
Linking to a Resource Calendar

Chapter 3 Managing the Calendar Server

Starting and Stopping the Calendar Server

Using the start-cal and stop-cal Commands
Using the Windows NT Control Panel
Troubleshooting the start-cal and stop-cal Commands

Configuring Calendar Server Timeout Values

Configuring Timeout Values for csadmind
Configuring HTTP Timeout Values for End Users

Configuring Single Sign-on (SSO)
Configuring Database Wire Protocol (DWP)

Front-End Machine and a Back-End Server
Multiple Front-End Machines

Managing LDAP Attributes

Listing LDAP Attributes
Adding an LDAP Attribute
Deleting an LDAP Attribute

Managing the Group Scheduling Engine (GSE) Queue

Listing Entries in the GSE Queue
Deleting Entries in the GSE Queue

Monitoring the Calendar Server

Listing Counter Statistics
Monitoring the Calendar Server Log Files

Pinging the Calendar Server
Refreshing the Calendar Server Configuration

Chapter 4 Managing Calendar Server Access Control

Access Control by Users
Access Control Lists (ACLs)

Who
What
How
Grant
Examples of ACEs
Placing ACEs in an ACL

Configuration Parameters for Access Control
Public and Private Events and Tasks Filter
Command-Line Utilities for Access Control

Chapter 5 Managing Calendar Server Databases

Specifying a Target Database
Viewing Calendar Database Status
Deleting a Calendar Database
Importing and Exporting Calendar Data

Exporting Calendar Data
Importing Calendar Data

Recovering a Damaged Database
Checking and Rebuilding a Calendar Database

Checking a Calendar Database for Corruption
Rebuilding a Corrupted Calendar Database

Chapter 6 Backing Up and Restoring Calendar Server Data

Backing Up Calendar Server Data

Backing Up the Calendar Database to a Directory
Backing Up a Specific Calendar to a File
Backing Up a User's Default Calendar to a File

Restoring Calendar Server Data

Restoring the Calendar Database
Restoring a Calendar From a Backup Directory
Restoring a Calendar From a File
Restoring a User's Default Calendar

Using Solstice Backup™ or Legato Networker®

Backing Up Calendar Server Data Using Solstice Backup or Legato Networker
Restoring Calendar Server Data Using Solstice or Legato Software

Chapter 7 Calendar Server Command-Line Utilities

Running the Command-Line Utilities

Syntax for Command-Line Utilities
Usage Rules for Command-Line Utilities

Descriptions of Command-Line Utilities
csattribute
csbackup
cscal
cscomponents
csdb
csexport
csimport
csplugin
csresource
csrestore
csschedule
csstart
csstats
csstop
cstool
csuser

Chapter 8 Calendar Server Configuration

Editing the ics.conf Configuration File
Configuration Parameters (ics.conf) File

Local Configuration
Calendar Store Configuration
Calendar Log Information Configuration
Services Configuration
Calendar Store Configuration
Calendar Lookup Database Configuration
Single Sign-on (SSO) Configuration
Group Scheduling Configuration
Database Configuration
Calendar Server API Configuration
Event Notification Server (ENS) Configuration
User Interface Configuration

Counters Configuration (counter.conf) File

Alarm Counters
Disk Usage Counters
HTTP Counters
Group Scheduling Counters
Authentication Counters
WCAP Counters
Database Counters
Server Response Counters
Session Status Counters

Notification Messages

Calendar Server Mail Parameters
Special Character Sequences for Events
Date Sub-Formatting
Conditional Printing
Special Character Sequences for Task Notification
Special Character Sequences for Dates
Simple Event Reminder Example
Complex Event Reminder Example

Appendix A Monitoring Tools

General UNIX Tools
Various Platform-Specific Tools

Solaris Operating Environment
HP-UX Operating Environment

Appendix B Time Zones

Time Zone Administration Overview
Managing Calendar Server Time Zones

Customizing Time Zones in the User Interface
iPlanet Calendar Server Time Zones Table

Glossary

Index