1/24

Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Documentation Accessibility

Part I Monitoring and Managing Calendar Server

1 Calendar Server System Administration Overview

• About Calendar Server
• Overview of Calendar Server Administration Tasks
• About Calendar Server Administration Tools
• Directory Placeholders Used in This Guide

2 Stopping and Starting Calendar Server Services

• Stopping and Starting Calendar Server
• Starting and Stopping the Remote Document Store

3 Monitoring and Managing Calendar Server

• Administering GlassFish Server
• Administering the Document Store
  • Changing the Password Used for Remote Document Store Authentication
• Using Calendar Server Administration Utilities
• Managing Logging
  • Overview of Calendar Server Logging
  • Logging Calendar Server Information to the GlassFish Server Log File
  • Configuring Logging
  • Viewing the Document Store Logs
  • Using the scheduling Log
  • Using the commands Log
• Administering Calendar Server Access
  • Overview of ACLs
  • Calendar Access Controls
  • Scheduling Access Controls
  • Setting Access Control for LDAP Groups
  • Retrieving Access Control Information
  • Access Control Configuration Parameters
  • Command-Line Utilities for Access Control
  • WCAP Commands for Access Control
  • Managing Domain ACLs
  • Managing Dynamic Group ACLs
• Administering Scheduling Options
  • Configuring Scheduling Options
  • Overview of Calendar Booking Window
  • Configuring a Booking Window
  • Modifying Calendar Double Booking
  • Controlling Double Booking When Creating Accounts Automatically
  • Modifying Configuration Parameters That Control Double Booking
  • Overriding the Account Autocreation Through LDAP
  • Manually Creating Accounts
  • Modifying Double Booking on Existing Accounts
  • Inviting LDAP Groups
• Administering Resource Calendars
  • About Resource Calendars
  • Provisioning Resource Calendars (commadmin)
  • Provisioning Resource Calendars (Delegated Administrator Console)
  • Managing a Resource Calendar's Mailbox
• Administering Time Zones Support
  • Adding New WCAP Time Zones
  • Adding an Alias to an Existing Time Zone
  • Adding a New Time Zone
• Customizing Calendar Notifications
• Administering the Calendar Server Back End Databases
  • Administering the MySQL Database
  • Administering the Oracle Database
• Backing Up and Restoring Calendar Server Data
• Removing Unwanted Calendar Data to Reclaim Space
  • Purging Deleted Calendar Entries
  • Purging Messages From the Scheduling Inbox and Outbox

4 Setting Up and Managing Calendar Server Users

• Provisioning Calendar Server Users
  • Overview of Provisioning Calendar Server
  • Provisioning Calendar Users by Using Delegated Administrator
  • Provisioning Calendar Users Across Virtual Domains
• Managing Calendar Users and Accounts
  • Defining Valid Calendar Users
  • Enabling and Disabling Automatic Account Creation
  • Creating Calendar Account with Default Calendar Automatically Upon Login
  • Preventing a User or Resource From Accessing Calendar Server
  • Checking for Active Calendar Users
  • Removing Calendar Users
  • Removing a Calendar User (Example)
  • Moving Calendar Users to a New Back-End Database
  • Changing a User's Email Address in the Calendar Server Database
• Subscribing and Unsubscribing Calendars
• About Configuring External Authentication
  • Configuring Calendar Server for External Authentication
  • Example: External Authentication by Using cn
• Configuring Proxy Authentication

5 Enabling Advanced Features

• Enabling Attachments
• Enabling Apple iCal Private/Confidential Support
• Enabling SMS Calendar Notifications in Convergence
• Enabling the iSchedule Channel to Handle iMIP Messages
• Enabling CalDAV and CardDAV Autodiscovery

6 Configuring CalDAV Clients

• Prerequisites
• Configuring CalDAV Clients
  • Configuring Apple iCal for Calendar Server
  • Configuring Apple iPhone for Calendar Server
  • Configuring Lightning 1.0 beta2 for Calendar Server
  • Configuring Lightning 1.0 beta for Calendar Server
  • Configuring Lightning 0.9 for Calendar Server
  • Accessing a Shared Calendar
  • Configuring a CalDAV Account by Using Non-standard or Demo Settings
    • iOS 3.x and 4.x Non-standard Configuration
    • Apple iCal Non-standard Configuration
  • Configuring Android for Calendar Server
• Using the iPhone Configuration Utility
• Exporting and Importing Calendars in Thunderbird Lightning
  • Exporting a Calendar
  • Importing a Calendar
• Client Issues
  • Troubleshooting CalDAV Clients
  • Connector for Microsoft Outlook and Event Time Modifications

7 Configuring and Managing Virus Scanning

• About Calendar Server and Virus Scanning
• Calendar Server Virus Scanning Architecture
• Configuring Calendar Server Virus Scanning
  • Configuring the MTA
    • Installing a Standalone Message Transfer Agent
  • Configuring the Messaging Server MTA for the Virus Spam Filter
    • Creating an Incoming SMTP Channel That Uses the Filter
    • Configuring the Rewrite Rule to Detect Calendar Data and Discard it After Scanning
  • Configuring Calendar Server for Virus Scanning
• Example MTA Configuration for Calendar Server Virus Scanning
• Calendar Server Configuration Examples
• Calendar Server Virus Scan Command-line Utility
• Virus Scan Logging
• MTA Logging

8 Using Calendar Server Notifications

• Overview of Notification Architecture
• About Reminders (Alarms)
• About Server Email Notifications
  • Enabling Calendar Server Notifications
    • Enabling Notifications on an Account
    • Modifying Notifications on an Account
• Managing Notification Templates
  • Notification Types
  • Templates, Resource Bundle, and Other Configuration Files
    • Notification Configuration
    • Resource Bundles
    • Template Files
  • Customizing Templates
  • Preserving Customized Template Files During Calendar Server Upgrade
• Writing a Java Messaging Service Consumer
  • Notification Message Format
  • Code Sample
• Managing Calendar Server Java Messaging Server Destinations
  • Overview of Calendar Server JMS Destinations
  • Using the imqcmd Command with Calendar Server
    • Listing a JMS Destination's Metrics
    • Purging All Messages
    • Monitoring Disk Utilization
    • Accessing Remote Brokers Tip
• Presence Notifications
  • Configuring Presence Notifications

9 Troubleshooting Calendar Server

• Troubleshooting Calendar Server Initial Configuration
• Troubleshooting GlassFish Server and Java
• Troubleshooting Tips
  • Using the asadmin Command to Specify GlassFish Server Port
  • Using the GlassFish Server Administration Console to Check Calendar Server Status
  • Using the asadmin Command-line Utility to Check Calendar Server Status
  • Troubleshooting the Calendar Server davserver Process
  • Troubleshooting a Failing davadmin Command
  • Troubleshooting MySQL Server Errors
  • Importing a Convergence ics File
  • Refreshing Domain Information
  • Troubleshooting the iSchedule Back End on MySQL Server
• Enabling Telemetry Logging
• Common Errors in Log Files
  • Using the Same Start and End Date for an Event
  • Same UID Already in Use
  • No Specification of Content-type Header
  • Deleting a Non-existing File
  • Posting to Calendar Collection Without a File Name
  • Using a Non-implemented HTTP Method
• Using the Browser Servlet
• Troubleshooting CalDAV Clients
  • Lightning
  • Apple iCal
  • iPod touch
  • Known Issues
  • Troubleshooting Clients Running iOS 5 and Mac OS 10.7
  • Mac OS 10.9 iCal Client Not Able to Delete Events
  • Checking Active Calendar Users
• Troubleshooting Calendar Server Agent Alerts in Instant Messaging Server

10 Improving Calendar Server Performance

• Tuning Calendar Server Logging
• Tuning Oracle GlassFish Server
  • Tuning JVM Options
  • Tuning JDBC Pool
  • Tuning HTTP Service and Listener
• Tuning MySQL Server
• Tuning Oracle Solaris CMT Server
• Tuning Reference

11 Backing Up and Restoring Calendar Server Files and Data

• Overview of Calendar Server Backup and Restore
• Calendar Server Backup and Restore Techniques
  • Using the davadmin db backup Command
  • ZFS Snapshots
• MySQL Backup and Restore Techniques
  • MySQL Asynchronous Replication
  • MySQL Database Dump
  • Point-In-Time Binlog Backup and Recovery
• Oracle Database Backup and Restore Techniques

Part II Administering a High-Availability System

12 Configuring a High-Availability Database

• Overview of MySQL Server Asynchronous Replication
• MySQL Server Asynchronous Replication Example
• MySQL Server Two-Way Replication Example
• Replication Synchronization Issues
• Using the Multi-Host Failover Feature of JDBC Connector/J
• Test for MySQL Server Asynchronous Replication (Manual)
• Test for MySQL Server Two-Way Replication with Connector/J Failover

13 Configuring Calendar Server for Highly Availability

• Front End High Availability: Configuring Calendar Server in GlassFish HA Cluster
  • About This Deployment Example
  • Prerequisites and Deployment Example Architecture
  • Configuring a Calendar Server Cluster Deployment
    • Configuring Machine A Where DAS, Node Agent, and HADB Reside
    • Configuring Machine B Where Node Agent Resides
    • Configuring Machine C Where Web Server 7 Is Used as the Load Balancer
  • GlassFish Server Load Balancer Limitations
• Back End High Availability: MySQL Async Replication
• Back End High Availability: Oracle Data Guard
• Document Store High Availability

14 Configuring Calendar Server on a GlassFish Server Cluster

• Prerequisites for Deploying Calendar Server on a GlassFish Cluster
• Example GlassFish Server Cluster Deployment Architecture
• Configuring a Calendar Server and GlassFish Server Cluster Deployment
  • To Create a Two-Instance GlassFish Server Cluster
  • Deploying Calendar Server on a Two-Instance GlassFish Server Cluster
• Limitations of This Deployment

Part III Calendar Server Reference

15 Calendar Server Configuration Reference

• davserver.properties File
• davservercreds.properties File
• Document Store Server Configuration File
• certmap.conf File
• davadmin.properties File
• Notification Templates

16 Calendar Server Command-Line Utilities

• Overview of the Command-Line Utilities
  • davadmin Security
  • Environment Variables
• davadmin Utility
  • Location
  • General Syntax
  • Ways to Provide Options
  • Clifile Properties
  • Common Options
  • davadmin Operations
  • Tool-Only Options
  • Exit Code
• davadmin account
  • Syntax
  • account Operation
  • Options for account Operation
  • davadmin account Examples
• davadmin backend
  • Syntax
  • backend Operation
  • Options for backend Operation
  • davadmin backend Examples
• davadmin cache
  • Syntax
  • cache Operation
  • Options for the cache Operation
• davadmin calendar
  • Syntax
  • calendar Operation
  • Options for calendar Operation
  • davadmin calendar Examples
• davadmin calcomponent
  • Syntax
  • calcomponent Operation
  • Options for calcomponent Operation
  • davadmin calcomponent Examples
• davadmin config
  • Syntax
  • config Operation
  • Options for config Operation
  • davadmin config Examples
• davadmin db
  • Syntax
  • db Operation
  • Options for db Operation
  • davadmin db Examples
• davadmin ldappool
  • Syntax
  • ldappool Operations
  • Options for ldappool Operation
  • davadmin ldappool Examples
• davadmin migration
  • Syntax
  • migration Operation
  • Options for migration Operation
  • davadmin migration Examples
• davadmin passfile
  • Syntax
  • passfile Operation
  • Options for passfile Operation
  • davadmin passfile Examples
• davadmin vscan
  • Syntax
  • vscan Operation
  • Options for vscan Operation
  • davadmin vscan Examples
• JConsole
  • AdminAccountMXBean Operation
  • AdminBackendMXBean Operation
  • AdminCalComponentMXBean Operation
  • AdminCalendarMXBean Operation
  • AdminConfigMBean Operation
  • AdminMigrationMXBean Operation
  • AdminMiscMXBean Operation
  • AdminUtilMXBean
  • Starting GlassFish Server in Secure Mode
• Summary of davadmin Changes by Release
  • Changes in Calendar Server 7 Update 1
  • Changes in Calendar Server 7 Update 2
  • Changes in Calendar Server 7 Update 2 Patch 5
  • Changes in Calendar Server 7 Update 3
  • Changes in Calendar Server 7.0.4.14.0
  • Changes in Calendar Server 7.0.4.16.0
  • Changes in Calendar Server 7.0.5.17.0
• Deprecated Options

17 Calendar Server Configuration Parameters

18 Time Zone Database

• Africa
• America
• Antarctica
• Arctic
• Asia
• Atlantic
• Australia
• Europe
• Indian
• Pacific