Bedework Calendar System 3.5

Bedework version 3.5

Last modified: August 10, 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

Copy the Bedework themes (templates)	22

HTTPS and mixed content messages	23

Directory browsing and pathname discovery	23

3.3 Set up a production database	24

Language settings.	24

Configure your applications context.xml	25

Configure Tomcat 5.5.x	26

Allow no roles	26

Add Jdbc drivers	27

Allow directory browsing	27

Uri encoding	27

JVM parameters	28

Configure Hibernate	28

Setting your SQL dialect	28

Build the newly configured system	29

Build the schema and initialize	29

3.4 Authentication	31

3.5 Build and deploy	31

3.6 Add a super user	31

3.7 Add administrative groups and users	32

3.8 Create initial public calendar aliases	32

3.9 Add Calendar Suites	32

3.10 Access rights and groups	33

Using ldap for groups and account validation	33

3.11 Upgrading	34

3.12 Performance and tuning	34

Hibernate and caching	34

3.13 Access Control	35

An overview	35

Definitions	35

Principals	35

ACE	35

ACL	35

Scheduling and freebusy access	36

Simplifying:	36

Chapter 4 Public Events Calendaring	38

4.1 Planning your Bedework public events system	38

4.2 Definitions	38

4.3 Managing Users and Admin Groups	39

Group structure and access control	41

Event administrators and superusers	41

4.4 Understanding and architecting your calendar hierarchy	42

Introduction	42

The Structure	43

4.5 Managing Calendar Suites	44

Managing a calendar suite	45

Calendar Suites and Administrative Groups	45

Administering a Calendar Suite	45

Managing Calendar Suite Preferences:	47

Managing Calendar Suite Subscriptions:	47

Managing Calendar Suite Views:	47

Adding a New Calendar Suite	48

Building a Bedework Calendar Suite	48

Configuring a Bedework Calendar Suite	48

4.6 Managing Events	50

Getting events in	50

Administrative web client	50

Importing events	54

Community submissions client	54

Getting events out	61

Calendar suites	61

Downloads	61

Subscriptions	61

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

Action: listEvents	62

Parameters:	62

Examples:	63

Output:	64

4.7 Adding custom properties (X-Properties)	64

Bedework X-Properties	65

Adding Custom X-Properties	65

X-Property Output	66

Chapter 5 Personal and Group Calendaring	68

5.1 Overview.	68

Default calendars	68

Subscriptions and views.	68

5.2 Scheduling Meetings	68

Calendar users and addresses	69

Special Calendars: Inbox and Outbox	69

Automatic processing	69

Scheduling resources	70

Special Calendars: Deleted	70

Chapter 6 Bedework Theming	71

6.1 Overview	71

Skins	71

Examples:	72

Prerequisites	73

Structure of the Template Directories	73

Making Basic Stylistic Changes	75

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

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

6.2 Actions & Parameters	76

What are Actions & Parameters?	76

Normal Actions & Render Actions	76

Bedework Actions & Parameters in Detail	77

Bedework Skin Parameters	77

6.3 XML	79

Bedework XML Structure	79

6.4 Bedework XSLT	80

XSLT References	80

Chapter 7 Integration With the Enterprise	81

7.1 Directories	81

7.2 Portals	81

Introduction	81

Limitations of JSR168	81

Binary – or ics – downloads.	82

Popups	82

Hope on the horizon	82

7.3 Email	82

7.4 Other calendar systems	82

Chapter 8 Other Features of the Bedework Project	83

8.1 Timezone Server	83

System timezones	83

Building timezone information.	83

8.2 Bedework and CalDAV	84

Summary	84

The Bedework implementation	84

CalDAV clients	85

Unsupported features	85

Recurrence features	85

Recurrence id ranges	85

8.3 Bw and CardDAV	85

8.4 Other Features	85

Freebusy URL	85

Real-time scheduling	87

Aug 10, 2009	Go to table of contents	p.87

Arlen Johnson

2006-02-15T15:08:33

Arlen Johnson