Bedework Calendar System 3.5

Bedework version 3.5

Last modified: October 19, 2009

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

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

Hibernate and caching	35

3.14 Access Control	36

An overview	36

Definitions	36

Principals	36

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	47

Event administrators and superusers	48

4.4 Understanding and architecting your calendar hierarchy	48

Introduction	48

The Structure	49

4.5 Managing Calendar Suites	51

Managing a calendar suite	52

Calendar Suites and Administrative Groups	52

Administering a Calendar Suite	52

Managing Calendar Suite Preferences:	53

Managing Calendar Suite Subscriptions:	53

Managing Calendar Suite Views:	53

Adding a New Calendar Suite	54

Building a Bedework Calendar Suite	54

Configuring a Bedework Calendar Suite	54

4.6 Managing Events	56

Getting events in	56

Administrative web client	56

Importing events	60

Community submissions client	60

Getting events out	67

Calendar suites	67

Downloads	67

Subscriptions	67

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

Action: listEvents	68

Parameters:	68

Examples:	69

Output:	70

4.7 Adding custom properties (X-Properties)	70

Bedework X-Properties	71

Adding Custom X-Properties	71

X-Property Output	72

Chapter 5 Personal and Group Calendaring	74

5.1 Overview.	74

Default calendars	74

Subscriptions and views.	74

5.2 Scheduling Meetings	74

Calendar users and addresses	75

Special Calendars: Inbox and Outbox	75

Automatic processing	75

Scheduling resources	76

Special Calendars: Deleted	76

Chapter 6 Bedework Theming	77

6.1 Overview	77

Skins	77

Examples:	78

Prerequisites	79

Structure of the Template Directories	79

Making Basic Stylistic Changes	81

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

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

6.2 Actions & Parameters	82

What are Actions & Parameters?	82

Normal Actions & Render Actions	82

Bedework Actions & Parameters in Detail	83

Bedework Skin Parameters	83

6.3 XML	85

Bedework XML Structure	85

6.4 Bedework XSLT	86

XSLT References	86

Chapter 7 Integration With the Enterprise	87

7.1 Directories	87

7.2 Portals	87

Introduction	87

Limitations of JSR168	87

Binary – or ics – downloads.	88

Popups	88

Hope on the horizon	88

7.3 Email	88

7.4 Other calendar systems	88

Chapter 8 Other Features of the Bedework Project	89

8.1 Timezone Server	89

System timezones	89

Building timezone information.	89

8.2 Bedework and CalDAV	90

Summary	90

The Bedework implementation	90

CalDAV clients	91

Unsupported features	91

Recurrence features	91

Recurrence id ranges	91

8.3 Bw and CardDAV	91

8.4 Other Features	91

Freebusy URL	91

Real-time scheduling	93

Oct 19, 2009	Go to table of contents	p.5

Arlen Johnson

2006-02-15T15:08:33

Arlen Johnson