Bedework Calendar System 3.6

Bedework version 3.6

Last modified: January 28, 2010

http://www.bedework.org

Bedework Calendar System

The Bedework Calendar System Manual contains an overview of the system, instructions for customizing and installing a production version of Bedework, administration and user guides, and detailed descriptions of Bedework components.

Table of Contents

Chapter 1 Introducing Bedework 3.5	7

1.1 Bedework System Overview	7

Bedework System Architecture	7

Features of Bedework	9

1.2 Bedework History / Background	11

1.3 Calendaring Standards & Interoperability	12

Chapter 2 Getting Started	13

2.1 The Bedework Quickstart	13

Packaged with the quickstart	13

System requirements	13

Starting Bedework	13

Logging	14

Building the Quickstart release	14

Creating user accounts	14

Accessing the Apache DS Ldap Server	14

Dumping and restoring the database	15

To re-initialize Hypersonic (hsql) with default Quickstart data:	15

To dump or restore your own data files:	16

To create an empty system:	16

Chapter 3 Deploying Bedework	17

3.1 Prerequisites	17

Install the quickstart and test your environment	17

Requirements	17

Supported databases.	17

Unsupported databases	18

3.2 Prepare a localized version of Bedework	18

Prepare your build and runtime properties	18

Copy the distributed configurations to your home directory	19

The properties file	20

Install	20

Global	21

Application	21

The options file.	21

The tzid property	22

The systemid property	22

Other properties	22

3.3 Set up a production database	23

Language settings.	23

Configure your applications context.xml	24

Configure Tomcat 5.5.x	25

Allow no roles	25

Add Jdbc drivers	26

Allow directory browsing	26

Uri encoding	27

JVM parameters	27

Configure Hibernate	27

Setting your SQL dialect	27

Build the newly configured system	28

Build the schema and initialize using the Dump / Restore Utility	28

3.4 Authentication	30

3.5 Build and deploy	31

3.6 Add a super user	31

3.7 Add administrative groups and users	31

3.8 Create initial public calendar aliases	32

3.9 Add Calendar Suites	32

3.10 Access rights and groups	32

Using ldap for groups and account validation	33

3.11 Setting up the Bedework Themes	34

Copy the Bedework themes (templates)	34

HTTPS and mixed content messages	34

Directory browsing and pathname discovery	35

Rebuild / Redeploy Bedework	35

3.12 Upgrading	35

3.13 Performance and tuning	35

Caching	35

Database Caching and Hibernate	35

Web Feed Caching	36

3.14 Access Control	36

An overview	36

Definitions	37

Principals	37

ACE	37

ACL	37

Scheduling and freebusy access	37

Simplifying:	38

3.15 TUTORIAL: setting up Bedework to work with MySQL & LDAP	38

Chapter 4 Public Events Calendaring	42

4.1 Planning your Bedework public events system	42

4.2 Definitions	42

4.3 Managing Users and Admin Groups	43

Group structure and access control	45

Event administrators and superusers	45

4.4 Understanding and architecting your calendar hierarchy	46

Introduction	46

The Structure	47

4.5 Managing Calendar Suites	48

Managing a calendar suite	49

Calendar Suites and Administrative Groups	49

Administering a Calendar Suite	49

Managing Calendar Suite Preferences:	50

Managing Calendar Suite Subscriptions:	50

Managing Calendar Suite Views:	50

Adding a New Calendar Suite	51

Building a Bedework Calendar Suite	51

Configuring a Bedework Calendar Suite	51

4.6 Managing Events	53

Getting events in	53

Administrative web client	53

Importing events	57

Community submissions client	57

Getting events out	64

Calendar suites	64

Downloads	64

Subscriptions	64

Data feeds - ical, raw xml, rss, json, js, etc.	64

Action: listEvents	65

Parameters:	65

Examples:	66

Output:	67

URL Builder	67

4.7 Adding custom properties (X-Properties)	67

Bedework X-Properties	68

Adding Custom X-Properties	68

X-Property Output	69

Chapter 5 Personal and Group Calendaring	71

5.1 Overview.	71

Default calendars	71

Subscriptions and views.	71

5.2 Scheduling Meetings	71

Calendar users and addresses	72

Special Calendars: Inbox and Outbox	72

Automatic processing	72

Scheduling resources	73

Special Calendars: Deleted	73

Chapter 6 Bedework Theming	74

6.1 Overview	74

Skins	74

Examples:	75

Prerequisites	76

Structure of the Template Directories	76

Making Basic Stylistic Changes	77

Setting event colors in the calendar grid (Public Web Client)	78

Setting event colors in the calendar grid (Personal Web Client)	79

Internationalization	79

6.2 Actions & Parameters	79

What are Actions & Parameters?	79

Normal Actions & Render Actions	79

Bedework Actions & Parameters in Detail	80

Bedework Skin Parameters	80

6.3 XML	82

Bedework XML Structure	82

6.4 Bedework XSLT	83

XSLT References	83

Chapter 7 Integration With the Enterprise	84

7.1 Directories	84

7.2 Portals	84

Introduction	84

Limitations of JSR168	84

Binary – or ics – downloads.	85

Popups	85

Hope on the horizon	85

7.3 Email	85

7.4 Other calendar systems	85

Chapter 8 Other Features of the Bedework Project	86

8.1 Timezone Server	86

System timezones	86

Building timezone information.	86

8.2 Bedework and CalDAV	87

Summary	87

The Bedework implementation	87

CalDAV clients	88

Unsupported features	88

Recurrence features	88

Recurrence id ranges	88

8.3 Bw and CardDAV	88

8.4 Other Features	88

Freebusy URL	88

Real-time scheduling	90

Jan 28, 2010	Go to table of contents	p.1

Arlen Johnson

2006-02-15T15:08:33

Arlen Johnson