Documentation Home
> Sun Java System Calendar Server 6 2005Q4 Administration Guide
Sun Java System Calendar Server 6 2005Q4 Administration Guide
Book Information
Index
Numbers and Symbols
A
B
C
D
E
F
G
H
I
L
M
N
O
P
R
S
T
U
W
X
Preface
Part I Overview
Chapter 1 Overview
Calendar Server Installation
Post Installation Configuration
High Level Task List
Calendar Server Special Accounts
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 Resources
Calendar Server Data
Calendar Server Data Format
Import and Export of Calendar Data
Calendar Links for Data Exchange
Calendar Server Alarms
LDAP Data Cache Option
Considerations for Using the LDAP Data Cache
Master/Slave LDAP Configuration
LDAP Data Cache
Limitations
Calendar Access Control
Secure Calendar Server Logins
Access Control by Users
Access Control Lists (ACLs)
Who
What
How
Grant
Examples of ACE's
Placing ACE's in an ACL
Calendar Server Internal Subsystems
Protocol Subsystem
Core Subsystem
Database Subsystem
Calendar Server Services
Administration Service: csadmind
HTTP Service: cshttpd
Automatic Backup Service: csstored
Event Notification Service (ENS): csnotifyd and enpd
Distributed Database Service: csdwpd
Calendar Server API's and SDK's
Web Calendar Access Protocol (WCAP)
Calendar Server API (CSAPI)
Event Notification Service (ENS) API
Proxy Authentication SDK (authSDK)
Part II Postinstallation Configuration
Chapter 2 Directory Preparation Script (comm_dssetup.pl)
Installing the Directory Preparation Script
Before You Run the Directory Preparation Script
What the Directory Preparation Script Does
High Level Steps of the Directory Preparation Script
Directory Server Considerations
Information You Need to Gather
About the Schema Choices
Access Manager Considerations
Attribute Indexes
Running the Directory Preparation Script
To Run the Directory Preparation Script
To Run in Silent Mode
comm_dssetup.pl Syntax
To Run in Interactive Mode
Manually Updating Schema Files
To Update Your LDAP Directory Manually
Resolving Conflicting OID's in the LDAP Schema Directory
Chapter 3 Calendar Server Configuration Program (csconfigurator.sh)
Gathering Your Configuration Information
LDAP Server Options
Directory Manager Options
Calendar Server Administrator
Email and Email Alarms Options
Runtime Configuration Options
Calendar Server Startup
Database, Logs, and Temporary Files Directories
Running csconfigurator.sh
To Run the Configuration Program from the Command Line
To Run the Configuration Program from the GUI
Welcome Panel
Administration, User Preferences and Authentication Panel
User Preferences Directory Options
Calendar Server Administrator Options
Email and Email Alarms Panel
Runtime Configuration Panel
Select Directories Panel
Archive and Hot Backup Configuration Panel
Ready to Configure Panel
Configuration Summary Panel
Chapter 4 Database Migration Utilities
Postinstallation Database Migration Utilities
Choosing the Right Utilities
csmig
csmig Functions
Migrates Calendars
Assigns Owners to Calendars
Updates LDAP Attributes
csmig Requirements
csmig Syntax
csmig Migration Steps
High Level Steps for Using csmig
To Perform a Test Dry Run
To Migrate Your Production Data
csmig Tips and Troubleshooting
The csmig dry run calendar shows the wrong owner for a calendar.
Example Problem
Example Solution
The LDAP calendar search doesn’t work correctly.
Example Problem
Example Solution
The csmig dry run indicates duplicate calendar names.
Example Problem
Example Solution
How do I assign orphan calendars to different owners?
Example Problem
Example Solution
How do I move calendar users to another back-end server?
Example Problem
Example Solution
csvdmig
csvdmig Functions
csvdmig Syntax
Mapping File
Destination DB
csvdmig Examples
commdirmig
Who Should Run the Utility
When to Run the Utility
Where to Find Documentation
Where to Find the Utility
Part III Customizing Your Calendar Server Configuration
Chapter 5 Customizing Calendar Server
Configuring for Communications Express
To Configure Proxy Authentication
To Enable Anonymous Access
Configuring Calendars
To Configure User Calendars
To Configure Resource Calendars
To Disable Autoprovisioning of User Calendars at Login
To Configure Free-Busy Lookup
Configuring Calendar Users
To Configure Users
To Set User Preferences
Configuring Calendar Server
To Configure Server Behavior
To Configure Calendar Logging
To Configure WCAP Commands
Configuring Logins and Authentication
To Configure Proxy Administrator Logins
To Configure Authentication
To Configure the Authentication Cache
To Enable Checking the Client IP Address at Login
Configuring Calendar Services
To Configure Administrative Services (csadmind)
To Configure HTTP Services (cshttpd)
To Configure Alarm Notification
Configuring Periodic Deadlock Checking for the Berkeley Databases
To Enable Periodic Checking of Berkeley Databases for Deadlocks
Configuring Calendar Server for LDAP
To Configure Anonymous Access to LDAP
To Configure LDAP Attendee Lookup
To Configure Search Filters for LDAP Attendee Lookup
To Configure LDAP Resource Lookup
To Configure LDAP Mail-to-Calid Lookup
To Configure Calendar Server to Use the User Preferences LDAP Directory
To Configure User Preferences
To Enable and Configure the LDAP Data Cache
To Enable and Configure the LDAP SDK Cache
To Set the Date Range for Free Busy Searches
To Enable Wildcard LDAP Searches of Calendar Properties
To Set the LDAP Root Suffix
Chapter 6 Configuring Calendar Database Distribution Across Multiple Machines
Background Information
CLD Plug-in Overview
How the CLD Plug-in Works
Configurations Supported by the CLD Plug-in
Multiple Front-end Servers with Multiple Back-end Servers
Multiple Machines Functioning as Both Front-end and Back-end Servers
Simple Sizing Exercise
Definition of Medium Usage Profile
Number of Front-End CPU's
Number of Back-End CPU's
Amount of Storage Needed
Configuring Calendar Servers for CLD and DWP
To Configure a Front-End Server for CLD
To Configure a Back-end Server for CLD and DWP
To Configure a Server as Both a Front-end and a Back-end
Maintaining Security Between Front-End and Back-End Servers
How Authentication is Accomplished
To Set Up Authentication for DWP Connections for a Front-end Server
To Set up Authentication for DWP Connections for a Back-end Server
Chapter 7 Configuring for High Availability (Failover Service)
Requirements for an HA Configuration
Installation and Configuration
To Install and Configure a Calendar Server HA Configuration
Log in as Superuser
Prepare Each Node in the Cluster
Install Sun Java Enterprise System Products and Packages
Node 1
Node 2
Selecting the Calendar Server Installation Directory
Installing Shared Components
Configure the Logical Host
Activate the Storage Resource
Run Postinstallation Configuration Programs
Locate Automatic Backup Directories on Shared Storage
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/sbin:
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 8 Configuring SSL
Configuring SSL for Calendar Server
To Create a Certificate Database
To Request and Import a Certificate from a Root Certificate Authority
To 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
Making cshttpd Stop Listening on the Regular HTTP Port
Chapter 9 Configuring Single Sign-on
Configuring SSO Through Access Manager
To use SSO with Calendar Server
Considerations for Using SSO With Access Manager
Configuring SSO Through Communications Servers Trusted Circle Technology
Chapter 10 Configuring Automatic Backups (csstored)
Automatic Backups Overview
How Automatic Backups Work
How csstored Works
How Circular Backups Work
High Level Steps for Enabling Automatic Backups
Setting up Transaction Log Files
Understanding Transaction Log Files
To Set up Transaction Log Files
Specifying the Administrator’s Email Address
Email Messages Sent to the Administrator
To Set the Administrator’s Email Address
Enabling Hot Backups
What are Hot Backups?
To Enable Hot Backups
Enabling Archive Backups
What are Archive Backups?
To Enable Archive Backups
Disabling the Warning Message
Why is the Message Emitted?
How to Disable csstored from Running
Chapter 11 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
Setting up a Hosted Domain Environment
Using Domains Created by Messaging Server
Enabling Calendaring in Schema 1 Messaging Domains
Enabling Calendaring in Schema 2 Messaging Domains
Part IV Calendar Server Administration
Chapter 12 Administering Calendar Server
Starting and Stopping Calendar Server
About start-cal and stop-cal
To Start Calendar Server with start-cal
To Stop Calendar Server with stop-cal
Enabling or Disabling Automatic Backups
To Enable Hot Backups
To Enable Archive Backups
To Disable Hot Backups
To Disable Archive Backups
Managing the Group Scheduling Engine Queue
About GSE
About the GSE Queue
Listing Entries in the GSE Queue
Deleting Entries in the GSE Queue
Monitoring Calendar Server
About csmonitor
To Configure csmonitor
Listing Counter Statistics
Using cstool for Monitoring
Using Calendar Server Log Files
Clearing the CLD Cache
Why Clear the CLD Cache?
To Clear the CLD Cache
Changing a Server Name
Configuring Anonymous Access
To Enable Anonymous Access
To Disable Anonymous Users to Write to Public Calendars
Enabling Proxy Administrator Logins
To Enable Proxy Authentication without Communications Express
To Verify Proxy Authentication is Working
Refreshing the Calendar Server Configuration
Chapter 13 Administering Hosted Domains
Choosing the Correct User Management Tool
Creating New Hosted Domains
To Add a Hosted Domain (Schema 2)
To Add a Hosted Domain (Schema 1)
Enabling Cross Domain Searches
Adding Names of Domains Allowed to Search This Domain
To Allow Specific Domains to Search This Domain
To Allow All External Domains to Search This Domain
Adding Names of Domains to be Searched by This Domain
Enabling Hosted Domains
To Enable Hosted Domains
To Disable Hosted Domains
Chapter 14 Administering Users and Resources
User Management Tools
Creating Users and Resources
To Create New Users in Schema 2
To Create New Users For Schema 1
To Create New Resources for Schema 2
To Create New Resources for Schema 1
To Add the Required mail Attribute
To Check if the mail Attribute Has Been Set
To Add the Mail Attribute to Existing Users and Resources
Administering Users
To Display User Information
To Disable a User
Delegated Administrator Console
Delegated Administrator Utility (commadmin user delete)
Calendar Server Utilities (csuser disable)
To Enable a User
Delegated Administrator Console
Delegated Administrator (commadmin user create)
Calendar Server Utilities (csuser enable)
To Set Up Email Aliases
To Check if a User is Enabled for Calendaring
To Delete a User from LDAP
Deleting Users in Schema 2 Using Delegated Administrator
Deleting Users in a Schema 1 Environment
For Non-Hosted Domains Only: Undeleting Users Marked for Deletion but Not Purged
To Reset a User’s Attributes
To Rename a User
To Disable Users from Having Publicly Writable Calendars
Managing Resources
To List Resources
To Enable Resources
To Disable Resources
To Delete Resources
To Set Up a Bitbucket Channel for Resource Email
To Set up the Messaging Server Bitbucket Channel
To Set up a Sendmail Bitbucket Channel
Managing User and Resource LDAP Attributes
To List LDAP Entry Attributes
To Add an LDAP Entry Attribute
To Delete an LDAP Entry Attribute
To Modify an LDAP Entry Attribute
Chapter 15 Administering Calendars
Calendar Administration Overview
Creating Calendar Unique Identifiers (calid's)
Calid Syntax
Calendar ID Creation Rules
Converting Non-Hosted calid's to Hosted Domain Format calid's
Automatic Creation of User Calendars
Automatic Calendar Creation Feature
To Enable Autoprovisioning
To Disable Autoprovisioning
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
Allowing Double Booking of Resource Calendars
Limiting Access to Resource Calendars
Managing User Calendars
To Display Calendars
To Delete a Calendar
To Remove Calendars of Deleted Users
To Remove All Calendars of a User Deleted with csuser
To Remove All Calendars for Users Deleted by Delegated Administrator
To Enable a Calendar
To Disable a Calendar
To Modify Calendar Properties
To Remove Properties From a Calendar
To Recover a “Lost” Default Calendar
To Move a User Calendar to a Different Back-End Server
Managing Resource Calendars
To Display Resource Calendars and Attributes
To Modify a Resource Calendar
To Disable or Enable a Resource Calendar
To Delete a Resource Calendar
To Move a Resource Calendar to a Different Back-End Server
Linking to a Calendar
Importing and Exporting Calendar Data
Importing Calendar Data
Exporting Calendar Data
Chapter 16 Administering Calendar Server Databases with csdb
Using csdb to Manage Calendar Databases
How csdb Groups Database Files
Calendar Database (caldb)
Session Database (sessdb)
Statistical Database (statdb)
csdb Can Target Specific Databases
csdb Administrative Tasks
To List Status for a Database Group
To Check for Calendar Database Corruption
To Rebuild the Calendar Databases (caldb) - No GSE
To Rebuild the Calendar Databases, Including the GSE Database
To Delete a Database Group
Chapter 17 Backing Up and Restoring Calendar Server Data
Backing Up Calendar Server Data
To Back Up the Calendar Database to a Directory
To Back Up a Specific Calendar to a File
To Back Up a User’s Default Calendar to a File
Restoring Calendar Server Data
To Restore the Calendar Database
To Restore a Calendar From a Backup Directory
To Restore a Calendar From a File
To Restore a User’s Default Calendar
Using Sun StorEdge Enterprise Backup or Legato Networker
StorEdge or Legato Tools
To Back Up Calendar Data Using Sun StorEdge Enterprise Backup software or Legato Networker
To Restore Calendar Data Using Sun StorEdge Enterprise Backup Software or Legato Software
Chapter 18 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 Calendar Server Utilities for the Delete Log Database
Chapter 19 Administering Calendar Server Time Zones
Overview of Calendar Server Time Zones
Managing Calendar Server Time Zones
Adding a New Time Zone
To Add a New Time Zone
Modifying an Existing Time Zone
To Modify an Existing Time Zone
Chapter 20 Using Instant Messaging Pop-up Reminders
Pop-up Reminders Overview
Pop-up Reminders Operation
Pop-up Reminders Architectural Flow
Configuring Pop-up Reminders
To Configure Instant Messaging Server
To Configure Calendar Server
To Configure Instant Messenger
Chapter 21 Tuning Calendar Server Performance
Indexing the LDAP Directory Server
Improving Calendar Search Performance in a DWP Environment
To Enable Calendar Searches to Look at LDAP
To Improve Search Performance by Indexing
Improving Performance of Calendar Searching by Disabling Wildcard Searches
Improving Performance of the CLD Plug-in
Improving Performance of the LDAP Data Cache
Tuning the LDAP SDK Cache
Tuning Automatic Backups
Using Load Balancing Across Multiple CPU's
Using Timeout Values
Timeout Values for csadmind
HTTP Timeout Values for End Users
GSE Queue Timeout Value
Chapter 22 Troubleshooting
Turning on Debugging Information
Increase Logging Level
Enable Logging Access to the LDAP Cache
Clearing the LDAP Cache
To Clear the LDAP Cache
Monitor the System Using Calendar Server Utilities
Troubleshooting LDAP Issues
Troubleshooting Migration Utilities
What to do Before Calling Technical Support
Where to Find the Migration Utilities
Troubleshooting Calendar Server
Pinging a Calendar Service
Service Options for cstool
cstool Example
Fixing start-cal Problems
Fixing stop-cal Problems
To Stop Child Processes
To Recover After an Improper Shutdown
Can't Connect to Back-end Server
Can’t Find Calendar
Get “Unauthorized” When Trying to Log In Using Proxy Authentication
Troubleshooting Searches that Don’t Complete Properly
To Determine if Limit Attributes Have Appropriate Values
To Set the Limit Attributes to Appropriate Values
Turning Off Those Annoying Daily Messages from csstored
Dealing with Database Issues
Finding Berkeley Database Tools
To Access the Berkeley Database Utilities
List of Available Tools
To Detect and Fix Database Deadlocks
Detecting Database Corruption
Database Corruption Basics
Monitoring Log Files
Using csmonitor
To Check for Calendar Database Corruption
Preventing Service Interruptions When Your Database is Corrupted (Read-only Mode)
Using Read-only Mode
To Put a Database in Read-only Mode
Handling Common Database Failures
csadmind Won’t Start or Crashes During Startup
Services Hung, and End Users Can’t Connect–Orphaned Locks
csdb rebuild Never Finishes–Database Looping
Rebuilding a Corrupted Calendar Database
rebuild Overview
To Rebuild a Calendar Database
Sample Rebuild Output
Using the Dump and Load Procedure to Recover a Calendar Database
Dump and Load Overview
To Perform the Dump and Load Procedure
Restoring an Automatic Backup Copy
Before You Restore
To Restore a Hot Backup
To Restore an Archive Backup
Repairing Custom Backup Scripts
Berkeley Tools Now Compiled with a Dynamic Library
To Repair a Custom Backup Script
Part V Appendixes
Appendix A Directory Configuration 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
Short Description 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
icsAllowRights Attribute: csdomain Utility
icsExtendedDomainPrefs Attribute: csdomain Utility
Other LDAP Directory Attributes: csdomain Utility
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
csstats
Requirements
Syntax
Examples
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
To edit the ics.conf file:
Configuration Parameters (ics.conf) File
Local Configuration
Calendar Store Configuration
Calendar Log Information Configuration
Administrator Configuration Parameters
Services Configuration
SSL Configuration
Hosted Domain Configuration
Alarm Notification Parameters
Calendar Lookup Database Configuration
LDAP Data Cache Configuration Parameters
Resource Calendar Configuration Parameters
Single Sign-on (SSO) Configuration
Configuring SSO Through Access Manager
Configuring SSO Through Communications Servers Trusted Circle Technology
Group Scheduling Engine (GSE) Configuration
Database Configuration
Automatic Backups of the Calendar Database
Calendar Database Parameters for ENS Messages
Event Notification Server (ENS) Configuration
Calendar Server API 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
© 2010, Oracle Corporation and/or its affiliates