Sun logo      Copyright      Index      Next     

Sun ONE Calendar Server 6.0 Administrator's Guide

Contents


List of Tables

List of Figures

About This Guide
Who Should Read This Guide
What You Need to Know
How This Guide is Organized
Document Conventions Used in This Guide
Related Third-Party Web Site References
Accessing Sun Documentation Online

Chapter 1   Introduction to Sun ONE Calendar Server
Calendar Server Configurations
Single-Server Minimal Configuration
Sun ONE Calendar Server
Directory Server
Sun ONE Identify Server
End Users
Network Front-End/Database Back-End Server Configuration
Sun ONE Calendar Server
Directory Server
Sun ONE Identify Server
End Users
Multiple Front-End/Back-End Server Configuration
Sun ONE Calendar Server
Directory Server
Sun ONE Identify Server
End Users
Calendar Server Installation and Configuration
Calendar Server Administrators
Calendar Server Administrator (calmaster)
Calendar Server User and Group
Superuser (root)
Calendar Server End Users
Creation of Calendar Server Users
Authentication of Calendar Server Users
Calendar Server User Preferences
Calendar Groups
Calendar Server Data
Calendar Server Data Format
Import and Export of Calendar Data
Calendar Links for Data Exchange
Calendar Server Alarms
Calendar Server Internal Subsystems
Protocol Subsystem
Core Subsystem
Database Subsystem
Calendar Server Services
Administration Service: csadmind
HTTP Service: cshttpd
Event Notification Service (ENS): csnotifyd and enpd
Distributed Database Service: csdwpd
Calendar Server APIs and SDKs
Web Calendar Access Protocol (WCAP)
Calendar Server API (CSAPI)
Event Notification Service (ENS) API
Proxy Authentication SDK (authSDK)

Chapter 2   Managing Calendar Server Users and Calendars
Provisioning New Calendar Server Users
Directory Server Requirements
Required LDAP mail Attribute for Calendar Server Users
Email Alias (mailalternateaddress Attribute)
Calendar Identifiers (calids)
Calendar Lookup Database (CLD) 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 Calendar

Chapter 3   Managing Calendar Server
Starting and Stopping Calendar Server
Using the start-cal and stop-cal Utilities
Troubleshooting the start-cal and stop-cal Utilities
Configuring Calendar Server Timeout Values
Configuring Timeout Values for csadmind
Configuring HTTP Timeout Values for End Users
Configuring Single Sign-on (SSO)
Configuring SSO Through Identity Server
Considerations for Using SSO With Identity Server
Configuring SSO Through Communications Servers Trusted Circle Technology
Configuring the LDAP Calendar Lookup Database (CLD) Plug-in
How the LDAP CLD Plug-in Works
Calendar Server Configurations for the LDAP CLD Plug-in
Multiple Front-End Servers with Multiple Back-End Servers
Multiple Front-End/Back-End Servers
Maintaining Security Between Front-End and Back-End Servers
Improving Performance of the LDAP CLD Plug-in
Clearing the CLD Cache
Moving a Calendar to a Different Back-End Server
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 Calendar Server
Listing Counter Statistics
Monitoring Calendar Server Log Files
Pinging Calendar Server
Refreshing the Calendar Server Configuration

Chapter 4   Managing Calendar Server Access Control
Secure Calendar Server Logins
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
Proxy Administrator Logins
Command-Line Utilities for Access Control

Chapter 5   Managing Calendar Server Databases
Calendar Server Database Files
Using the csdb Utility to Manage a Database
Specifying a Target Database
Viewing Calendar Database Status
Importing and Exporting Calendar Data
Exporting Calendar Data
Importing Calendar Data
Recovering a Damaged Database
Deleting a Calendar Database
Detecting and Recovering From Database Corruption
Minimizing Data Loss
Checking and Rebuilding a Calendar Database
Checking a Calendar Database for Corruption
Rebuilding a Calendar Database
Using the Dump and Load Procedure to Recover a Database
Calendar Database Version

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 Sun StorEdge Enterprise Backup™ or Legato NetworkerŽ
Calendar Server Backup/Restore Files
Backing Up Calendar Server Data Using Sun StorEdge Enterprise Backup software or Legato Networker
Restoring Calendar Server Data Using Sun StorEdge Enterprise Backup software or Legato Software

Chapter 7   Managing the Delete Log Database
Creation of the Delete Log Database
Querying the Delete Log Database
Purging the Delete Log Database
Automatic Purge of the Delete Log Database
Manual Purge of the Delete Log Database
Using CLI Utilities for the Delete Log Database

Chapter 8   Using Hosted Domains
Overview of Hosted Domains
Organization of the LDAP Directory
Sun ONE LDAP Schema, v.2
Sun ONE LDAP Schema, v.1
Calendar Server Logins
Cross Domain Searches
Support for a Calendar Server Legacy Installation
Creation and Management of Hosted Domains
Running the Directory Server Setup Script
Creating New Domains
Using Domains Created by Messaging Server
Setting Domain Specific Attributes and Preferences
Provisioning New Calendar Server Users
Managing Domains Using Calendar Server Utilities
Hosted Domain Configuration Parameters
Using WCAP Commands
Migration to a Hosted Domain Environment

Chapter 9   Using SSL With Calendar Server
Configuring SSL for Calendar Server
Create the SSL Certificate Database
Mozilla Tools
Library Path Variable
Example Files and Directories
Request and Import a Certificate From a Root Certificate Authority (CA)
Configure SSL Parameters in the ics.conf File
SSL Configuration Parameters
Encryption of Calendar Server Login or Entire Calendar Session
Troubleshooting SSL
Checking for the cshttpd Process
Verifying Certificates
Reviewing Calendar Server Log Files
Connecting to the SSL Port

Chapter 10   Setting Up a High Availability (HA) Configuration
Requirements for an HA Configuration
Installation and Configuration
Log in as root
Prepare Each Node in the Cluster
Install Sun Products and Packages
Node 1
Node 2
Selecting the Calendar Server Installation Directory
Installing Shared Components
Configure the Logical Host
Activate the Storage Resource
Configure Calendar Server
Relocate the Calendar Server config Directory
Edit the Calendar Server ics.conf File
Start the HA Calendar Server
Verify the HA Configuration
Starting and Stopping Calendar Server HA Service
Related Documentation

Chapter 11   Calendar Server Command-Line Utilities
Running the Command-Line Utilities
Syntax for Command-Line Utilities
Usage Rules for Command-Line Utilities
Return Code in Scripts
Table of Command-Line Utilities
csattribute
csbackup
cscal
csclean
cscomponents
csdb
csdomain
csexport
csimport
csmonitor
csplugin
cspurge
csresource
csrestore
csschedule
csstart
csstats
csstop
csstored.pl
cstool
csuser
start-cal
stop-cal

Chapter 12   Calendar Server Configuration Parameters
Editing the ics.conf Configuration File
Configuration Parameters (ics.conf) File
Local Configuration
Calendar Store Configuration
Calendar Log Information Configuration
Services Configuration
SSL Configuration
Hosted Domain Configuration
Alarm Notification Configuration
Calendar Lookup Database Configuration
Single Sign-on (SSO) Configuration
Configuring SSO Through Identity Server
Configuring SSO Through Communications Servers Trusted Circle Technology
Group Scheduling Engine (GSE) Configuration
Database Configuration
Calendar Database Parameters for ENS Messages
Calendar Server API Configuration
Event Notification Server (ENS) Configuration
User Interface (UI) Configuration
csmonitor Utility 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 Notifications
Special Character Sequences for Dates
Simple Event Reminder Example
Complex Event Reminder Example

Appendix A   Monitoring Tools
General UNIX Tools
Solaris Operating System Tools

Appendix B   Calendar Server Time Zones
Overview of Calendar Server Time Zones
Managing Calendar Server Time Zones
Adding a New Time Zone
Modifying an Existing Time Zone

Appendix C   Calender Server Performance Tuning
Indexing the LDAP Directory Server
Using Calendar Searches of the LDAP Directory Server
Indexing the icsCalendarOwned Attribute
Setting the nsSizeLimit and nsLookthroughLimit Parameters
Using the LDAP Data Cache Option
Using the CLD Cache Option
Using a Memory-Based File System for the Session Database
Using Load Balancing Across Multiple CPUs
Setting the gse.belowthresholdtimeout Parameter
Using the Refresh View Option
Disabling the Calendar Express Tool Bar Repainting Option
XSL Rendering in the Client Browser

Appendix D   Using the LDAP Data Cache
Considerations for Using the LDAP Data Cache
Master/Slave LDAP Configuration
LDAP Data Cache
LDAP Data Cache Configuration Parameters

Appendix E   High Availability (HA) Configuration Worksheets
Calendar Server HA Configuration Worksheet
Calendar Server Installation Worksheet
Calendar Server Configuration Worksheet

Appendix F   Using Sun ONE Instant Messaging Pop-up Reminders
Pop-up Reminders Operation
Pop-up Reminders Architectural Flow
Configuring Instant Messaging Pop-ups
Instant Messaging Server Configuration
Calendar Server Configuration
Instant Messenger Configuration

Glossary

Index


Copyright      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.