Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Calendar Server Administration Guide 

Contents


List of Procedures

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
Monospaced Font
Italicized Font
Square Brackets [ ]
Braces { }
Vertical Bar (|)
Command-Line Prompts
Related Third-Party Web Site References
Accessing Sun Documentation Online

Chapter 1   Overview
Calendar Server Configurations
Single-Server Minimal Configuration
Calendar Server
Directory Server
Sun Java System Identify Server
End Users
Network Front-End/Database Back-End Server Configuration
Calendar Server
Directory Server
Sun Java System Identify Server
End Users
Multiple Front-End/Back-End Server Configuration
Calendar Server
Directory Server
Identify Server
End Users
Calendar Server Installation
Post Installation Configuration
Calendar Server Administrators
Calendar Server Administrator (calmaster)
Calendar Server User and Group
Superuser (root)
Proxy Administrator Logins
Calendar Server End User Administration
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 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
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   Configuring Your LDAP Directory
Updating Your LDAP Directory
You Have Sun Java System Directory Server
You Have Customized Directory Server
You Do Not Use a Sun Product for Your Directory Server
Updating with comm_dsetup.pl
Functions of comm_dssetup.pl
Requirements to Run comm_dssetup.pl
Gathering Information Needed to Run comm_dssetup.pl
Deciding Which Schema to Use
Running comm_dssetup.pl
Silent Mode
Example
Interactive Mode
Manually Updating Schema Files
Sun Directory Servers
Netscape Directory Server
Resolving Conflicting OIDs in the LDAP Schema Directory

Chapter 3   Configuring Calendar Server
Gathering Your Configuration Information
Administration, User Preferences and Authentication Options
Email and Email Alarms Options
Runtime Configuration Options
Calendar Server Startup
Database, Logs, and Temporary Files Directories
Running csconfigurator.sh
Welcome Panel
Administration, User Preferences and Authentication Panel
Email and Email Alarms Panel
Runtime Configuration Panel
Select Directories Panel
Ready to Configure Panel
Configuration Summary Panel

Chapter 4   Migration Utilities
Overview of Calendar Server Migration Utilities
Component Databases Migration Utilities
LDAP Databases Migration and Upgrade Utilities
Migration Utility Roadmap
Migrations Web Site
ics2migrate
Migration Requirements
What Gets Migrated?
Migration Process
Run the db_recover on your 2.x Berkeley Database
Download and Install Calendar Server 5.1.1
Upgrade the 2.x Calendar Database
Migrate the Data (run ics2migrate)
Check the Migration Results
Migration Examples
Migrate in Quiet Mode
Migrate Only the Calendar Database
Migrate Only LDAP User Information
Migrate Both Calendar Database and LDAP User Information
csmig
csmig Functions
csmig Requirements
csmig Syntax
csmig Migration Steps
Configure Your LDAP Directory Server
Perform a Test Dry Run
Migrate Your Production Data
csmig Tips and Troubleshooting
csvdmig
csvdmig Syntax
csvdmig Examples

Chapter 5   Setting Up Hosted Domains
Overview of Hosted Domains
Organization of the LDAP Directory
Sun LDAP Schema 2
Sun LDAP Schema 1
Calendar Server Logins
Cross Domain Searches
Support for a Non-Hosted Domains Environment
Migrating to a Hosted Domain Environment
Using Domains Created by Messaging Server

Chapter 6   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
To Change the Symbolic Link Found in /opt/SUNWics5/cal:
To Change the Symbolic Link Found in /opt/SUNWics5/lib:
To Change the Symbolic Link Found in /opt/SUNWics5/lib:
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 7   Configuring SSL
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
Troubleshooting SSL
Checking for the cshttpd Process
Verifying Certificates
Reviewing Calendar Server Log Files
Connecting to the SSL Port

Chapter 8   Configuring Single Sign-on
Configuring SSO Through Identity Server
Considerations for Using SSO With Identity Server
Configuring SSO Through Communications Servers Trusted Circle Technology

Chapter 9   Configuring Calendar Lookup Database Plug-in
CLD Plug -in Overview
How the CLD Plug-in Works
Configurations for the CLD Plug-in
Multiple Front-End Servers with Multiple Back-End Servers
Configuring a Front-End Server
Example Configuration Parameters for a Front-End Server
Configuring a Back-End Server
Example Configuration Parameters for a Back-End Server
Multiple Front-End/Back-End Servers
Configuring a Front End/Back-End Server
Example Configuration Parameters for Each Front-End/Back-End Server
Maintaining Security Between Front-End and Back-End Servers
Setting Up Authentication for DWP Connections
Improving Performance of the CLD Plug-in
Clearing the CLD Cache
Moving a Calendar to a Different Back-End Server

Chapter 10   Administering Calendar Server
Starting and Stopping Calendar Server
Using the start-cal and stop-cal Utilities
Troubleshooting the start-cal and stop-cal Utilities
Managing the Group Scheduling Engine Queue
About GSE
About the GSE Queue
Monitoring Calendar Server
Listing Counter Statistics
Monitoring Calendar Server Log Files
Pinging Calendar Server
Refreshing the Calendar Server Configuration
Turning Off the Old Calendar Express UI

Chapter 11   Administering Domains
Creating New Domains
Creating New Domains
Setting Domain Specific Attributes and Preferences
Administering Domains

Chapter 12   Administering Users and Resources
Two Provisioning Tools
Preparing to Provision Users and Resources
Required mail Attribute
Email Alias (mailalternateaddress Attribute)
Checking if a User is Enabled for Calendaring
Enabling a User
Managing Calendar Server Users
Displaying User Information
Disabling and Enabling a User
Deleting a User
Resetting a User’s Attributes
Renaming Users
Managing LDAP Attributes
Listing LDAP Attributes
Adding an LDAP Attribute
Deleting an LDAP Attribute

Chapter 13   Administering Calendars
Calendar Administration Overview
Calendar Types
Schema 1 Tools for Calendars
Schema 2 Tools for Calendars
Creating Calendar Unique Identifiers (calids)
Calid Syntax
Calendar ID Creation Rules
Converting Non-Hosted Calids to Hosted Domain Format Calids
Auto-Provisioning of User Calendars
Calendar Access Control
Configuration Parameters for Access Control
Public and Private Events and Tasks Filter
Command-Line Utilities for Access Control
Creating Calendars
Creating a User Calendar Using cscal
Preparing to Create Resource Calendars
Creating a Resource Calendar
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
Managing Resource Calendars
Displaying Resource Calendars and Attributes
Modifying a Resource Calendar
Disabling and Enabling a Resource Calendar
Deleting a Resource Calendar
Linking to a Calendar
Importing and Exporting Calendar Data
Exporting Calendar Data
Importing Calendar Data

Chapter 14   Administering Calendar Server Databases
Calendar Server Database Files
Using csdb to Manage Calendar Databases
Specifying a Target Database
Viewing Calendar Database Status
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 Calendar Database
Calendar Database Version
Best Practices: Calendar Store Administration and Maintenance

Chapter 15   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 16   Administering 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 17   Administering 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

Chapter 18   Using 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

Chapter 19   Tuning Calender Server Performance
Indexing the LDAP Directory Server
Improving Calendar Search Performance in a DWP Environment
Indexing the icsCalendarOwned Attribute
Setting the nsSizeLimit and nsLookthroughLimit Parameters
Enabling the CLD Cache Option
Using the LDAP Data Cache Option
Considerations for Using the LDAP Data Cache
Master/Slave LDAP Configuration
LDAP Data Cache
Limitations
LDAP Data Cache Configuration Parameters
Using the CLD Cache Option
Using a Memory-Based File System for the Session Database
Using Load Balancing Across Multiple CPUs
Using Timeout Values
Timeout Values for csadmind
HTTP Timeout Values for End Users
GSE Queue Timeout Value
Using the Refresh View Option
Disabling the Calendar Express Tool Bar Repainting Option
XSL Rendering in the Client Browser

Appendix A   Directory Configuration Worksheet
Calendar Server Configuration Worksheets
Administration, User Preferences and Authentication Panel Worksheet
Email and Email Alarms Worksheet
Runtime Configuration Worksheet
Database, Logs, and Temporary Files Directories Worksheet

Appendix B   Calendar Server Configuration Worksheet
Administration, User Preferences and Authentication Panel Worksheet
Email and Email Alarms Worksheet
Runtime Configuration Worksheet
Database, Logs, and Temporary Files Directories Worksheet

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

Appendix D   Calendar Server Command-Line Utilities Reference
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
Requirements
Syntax
Examples
csbackup
Requirements
Syntax
Examples
cscal
Requirements
Syntax
Examples
csclean
Requirements
Syntax
Examples
cscomponents
Requirements
Syntax
Examples
csdb
Requirements
Syntax
Examples
csdomain
Requirements
Syntax
LDAP Attributes and Property Names
Examples
csexport
Requirements
Syntax
Examples
csimport
Requirements
Syntax
Examples
csmonitor
Syntax
csplugin
Requirements
Syntax
Examples
cspurge
Requirements
Syntax
Examples
csrename
Requirements
Syntax
Examples
csresource
Requirements
Syntax
Examples
csrestore
Requirements
Syntax
Examples
csschedule
Requirements
Syntax
Examples
csstart
Requirements
Syntax
Examples
csstats
Requirements
Syntax
Examples
csstop
Requirements
Syntax
Examples
csstored.pl
Requirements
Syntax
cstool
Requirements
Syntax
Examples
csuser
Requirements
Syntax
Examples
start-cal
Requirements
Syntax
Example
stop-cal
Requirements
Syntax
Example

Appendix E   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
Example
Conditional Printing
Special Character Sequences for Task Notifications
Special Character Sequences for Dates
Simple Event Reminder Example
Complex Event Reminder Example

Glossary

Index


Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.