1/17

Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Documentation Accessibility

1 Calendar Server Installation Overview

• Overview of Calendar Server Installed Components
• Overview of the Calendar Server Installation Procedure
• Calendar Server Installation Options
• Ensuring a Successful Calendar Server Installation
• Directory Placeholders Used in This Guide

2 Planning Your Calendar Server Installation

• About Calendar Server
• Calendar Server Front-End and Back-End Components
  • Mapping Calendar Users to Back-End Servers
  • davStore LDAP Attribute
• Planning Your Calendar Server Installation
  • Using a Single Web Container for Multiple Applications
  • Deciding on the Database
  • Planning for Multiple Calendar Server Hosts
  • Planning the Document Store
    • Remote Document Store Authentication
    • Securing Connections to Remote Document Store
  • Planning the iSchedule Database
  • Planning for Virus Scanning
  • Planning to Use an External Directory for Authentication
  • Planning for the Unique Identifier
    • How Do You Set the Unique Identifier?
    • Setting the Unique Identifier During Calendar Server Installation
    • Changing the Unique Identifier During Calendar Server Upgrade
• System Deployment Planning
  • Planning for High Availability
  • Using Load Balancing
  • Planning Backup Strategies
• Calendar Server Logical Architecture
• Sample Calendar Server Physical Architecture
• About Installing a Secure System

3 Calendar Server System Requirements

• Software Requirements
  • Supported Operating Systems
  • Required Software
• Client Requirements
• Hardware Requirements
• Information Requirements
  • Calendar Server Information
  • Database Information
    • MySQL Server Database Information
    • Oracle Database Information
    • Document Store Information
    • iSchedule Database Information
  • GlassFish Server Information
  • LDAP Information
  • Notification Information

4 Calendar Server Pre-Installation Tasks

• Installing Java
• Installing GlassFish Server
• Installing Directory Server
• Installing the Database
  • Installing and Configuring MySQL Server
  • Installing and Creating an Oracle Database Instance for Calendar Server
    • Installing a New Oracle Database
    • Creating a New Database From an Existing Oracle Installation
    • Using an Existing Database for the Calendar Server Schema

5 Installing Calendar Server

• Installation Assumptions
• Installing Calendar Server
  • Downloading the Calendar Server Software
  • Preparing Directory Server
  • Installing the Calendar Server Software
    • Preparing MySQL Server for Use with Calendar Server
    • Preparing Oracle Database for Use with Calendar Server
• Configuring Calendar Server
  • Calendar Server Initial Configuration Prerequisites
  • Configuring Java for Calendar Server
  • Running the Calendar Server Initial Configuration Script
• Next Steps

6 Configuring Calendar Server with Multiple Hosts

• About Installing and Configuring Multiple Calendar Server Back-End Hosts
• Installing and Configuring Multiple Calendar Server Back-End Hosts
• Renaming the Default Calendar Server Back-End Host
• Provisioning Calendar Accounts in a Multiple Back-End Deployment
• Examples: Creating Pools and Resources for Calendar Server Back-End Hosts
  • Using the GlassFish Server Administration Console to Create a Connection Pool
  • Using the Command Line to Create a Connection Pool for Non-Default Back-End Hosts
• User Login in a Multiple Back-End Host Deployment

7 Configuring the Calendar Server Document Store

• About Configuring the Document Store
• Java Version
• Configuring Oracle Database for Both Calendar Data and Large Data
• Configuring a Local Document Store
• Configuring a Remote Document Store
  • Configuring Remote Document Store Authentication
  • Configuring Remote Document Store SSL
• Configuring the Document Store for High Availability
• Migrating the Document Store

8 Calendar Server Post-Installation Tasks

• Changing the User Unique Identifier
• Configuring Virus Scanning
• Adding LDAP Access Control for Calendar Server Features
• Using the iSchedule Channel to Handle iMIP Messages
• Next Steps

9 Upgrading Calendar Server

• About Upgrading Calendar Server
• About Calendar Server Database Upgrades
  • Database Schema and Structure Version
  • Calendar Server Start Up and Automatic Database Upgrade
    • Monitoring the MySQL Server Database Upgrade
  • Database Schema Upgrade Patches and Releases
  • Database Performance During Upgrade
  • About Upgrading the Database Schema
  • Preupgrade Functions
• Calendar Server Upgrade Dependencies
• Upgrading to Calendar Server 7.0.5
  • Prerequisites for Upgrading Calendar Server
  • Backing Up the Calendar Server Database
  • Upgrading the Database Schema
  • Installing Java 7
  • Preparing the Directory Server
  • Running commpkg upgrade
    • Upgrading the Remote Document Store
    • Upgrading a Non-SSL Document Store
    • Upgrading a Non-SSL Document Store to SSL
  • Upgrading the Calendar Server Back-End Database
  • Updating the Calendar Server Back-end Database Charset on MySQL
  • Creating the iSchedule Database
  • Installing GlassFish Server 3
  • Setting Environment Variables
  • Running the populate-davuniqueid Script
  • Performing the Calendar Server Configuration
  • davadmin account upgrade Operation
  • Post-Upgrade Tasks

10 Creating a Calendar Server 6 and 7 Coexistent Deployment

• Calendar Coexistence Overview
• Minimum Software Requirements
• Configuring the Calendar Server 6 Environment
• Configuring the Calendar Server 7 Environment
• Workflow Description of This Configuration
  • About the Calendar Server 6 Configuration
  • About the Calendar Server 7 Configuration

11 Migrating to Calendar Server

• Introduction to Migrating
• How the Migration Works
• High-Level Migration Steps
• Migrating From an SSL-Enabled Calendar Server 6 Deployment
• Migration Logging
• How the Migration Reformats the Calendar Server 6 Data
• Troubleshooting the Migration
  • Count Reported by Tools Differs
  • No Events Migrated When The Calendar Contains Events
  • Exception on creation of userpref Error
  • Back-End Database Errors
  • LDAP Error
  • Read Timed Out Error
  • Error Parsing iCal Data
    • Error Parsing iCal Data Example 1
    • Error Parsing iCal Data Example 2
    • Error Parsing iCal Data Example 3
  • Owner Property Error
  • Other Migration Errors
    • Multiple Components with the Same uid but Different Date Type
    • Failed to store component: F0095280-BC13-11D9-81F6-000A958EAC78
    • Error parsing ical data for: 3d6cd576000000a70000000a00000a55: failed to parse
    • Failed to store component: 9DE4F2DA-D020-11D8-9530-000A958A3252
    • Failed to store component
    • Failed to store component: failed to parse - Error at line 84
    • Error parsing ical data for: F0076B82-BC13-11D9-81F6-000A958EAC78

12 Uninstalling Calendar Server

• Uninstalling Calendar Server

13 Installing Patches

• About Patching Calendar Server
• Planning Your Patch Installation
• Installing a Patch
• Installing an ARU Patch
• Installing an SRV4 Patch
• Installing a Linux Patch
• Disabling GlassFish Server Incoming Connections During Patch Application
  • Disabling GlassFish Server Incoming Connections Overview
  • Disabling GlassFish Server Incoming Connections
  • Re-enabling GlassFish Server http Listeners

A Calendar Server Configuration Scripts

• init-config Script
• Database Installation Scripts
  • config-mysql Script
    • Syntax and Examples
    • Running the config-mysql Script
  • config-oracle Script
    • Syntax and Examples
    • Running the config-oracle Script
• populate-davuniqueid Script
  • Syntax
  • Options
  • populate-davuniqueid Examples
    • Adding davUniqueId to All Calendar Server Users
    • Adding the daventity Object Class and davuniqueid to All Calendar Server 6 Users