Bedework Calendar System 3.6

Bedework version 3.6

Last modified: March 31, 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.6	8

1.1 Bedework System Overview	8

Bedework System Architecture	8

Features of Bedework	9

1.2 Bedework History / Background	12

1.3 Calendaring Standards & Interoperability	12

Chapter 2 Bedework Basics	13

The Bedework Quickstart	13

Packaged with the quickstart	13

System requirements	13

Starting Bedework	14

Logging	14

Creating user accounts	14

Accessing the Apache DS Ldap Server	15

Dumping and restoring the database	15

Bedework Quickstart Data Files	15

JMX Console	16

To dump a data file:	16

To restore a data file:	16

To create an empty system:	17

Building the Quickstart release	17

Chapter 3 Deploying Bedework	18

3.1 Prerequisites	18

Install the quickstart and test your environment	18

Requirements	18

Supported databases.	19

Unsupported databases	19

3.2 The Config Files: Prepare a localized version of Bedework	19

Prepare your build and runtime properties	19

Copy the distributed configurations to your home directory	20

The properties file	21

Install	21

Global	22

Application	22

The options file.	23

The tzid property	23

The systemid property	24

The browserResourcesRoot	24

Other properties	24

3.3 Set up a production database	24

Language settings.	25

Create the Database	26

Configure the Bedework Datasource	26

Add JDBC Drivers to JBoss	26

Configure Hibernate to Work with Your Database	27

Setting your SQL dialect	27

Build the newly configured system	27

Initialize the database	28

3.4 Authentication	28

Add a superuser	28

Localizing authentication	29

3.5 JVM parameters	29

3.6 Configuring JBoss for production	30

Securing JBoss's JMX Console	30

Securing JBoss's Web Console	31

More about JBoss configuration...	31

3.7 Other configuration notes	31

Allow directory browsing	31

Uri encoding	31

3.8 Build and deploy	32

3.9 Add administrative groups and users	32

3.10 Create initial public calendar aliases	32

3.11 Add Calendar Suites	33

3.12 Access rights and groups	33

Using ldap for groups and account validation	34

3.13 Setting up the Bedework Themes	34

Copy the Bedework themes	34

Change the cal.properties file	35

Change the cal.options.xml file	35

browserResourcesRoot, HTTPS, and mixed content messages	35

Directory browsing and pathname discovery	36

Rebuild / Redeploy Bedework	36

3.14 Upgrading	36

3.15 Performance and tuning	36

Caching	36

Database Caching and Hibernate	37

Web Feed Caching via the Bedework Page Cache	37

The Feed URL/Widget Builder	38

3.16 Access Control	38

An overview	38

Definitions	39

Principals	39

ACE	39

ACL	39

Scheduling and freebusy access	39

Simplifying:	40

3.17 TUTORIAL: setting up Bedework to work with MySQL & LDAP	40

Chapter 4 Public Events Calendaring	46

4.1 Planning your Bedework public events system	46

4.2 Definitions	46

4.3 Managing Users and Admin Groups	47

Group structure and access control	49

Event administrators and superusers	49

4.4 Understanding and architecting your calendar hierarchy	50

Introduction	50

The Structure	51

4.5 Categories	52

4.6 Managing Calendar Suites	53

Managing a calendar suite	53

Calendar Suites and Administrative Groups	53

Administering a Calendar Suite	54

Managing Calendar Suite Preferences:	55

Managing Calendar Suite Subscriptions:	55

Managing Calendar Suite Views:	55

Adding a New Calendar Suite	56

Building a Bedework Calendar Suite	56

Configuring a Bedework Calendar Suite	57

4.7 Managing Events: Getting Events In	58

Administrative web client	58

Importing events	61

Community submissions client	62

4.8 Managing Events: Getting Events Out	67

Calendar suites	67

Downloads	67

Subscriptions	67

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

Action: listEvents	68

Parameters:	69

Examples:	70

Output:	70

4.9 Cached Feed and URL/Widget Builder	71

URL/Widget Builder	71

CachedFeeder	71

Feeder Application	72

4.10 Adding custom properties (X-Properties) to events	72

Bedework X-Properties	72

Adding Custom X-Properties	73

X-Property Output	74

Chapter 5 Personal and Group Calendaring	76

5.1 Overview.	76

Default calendars	76

Subscriptions and views.	76

5.2 Scheduling Meetings	76

Calendar users and addresses	77

Special Calendars: Inbox and Outbox	77

Automatic processing	77

Scheduling resources	78

Special Calendars: Deleted	78

5.3 Calendar Sharing	78

Granting access to a calendar or folder	78

Subscribing to another user's calendar or folder	79

5.4 Using Bedework CalDAV with Desktop & Mobile Clients	79

Using Mozilla Lightning with Bedework	79

Using Apple's iCal with Bedework	80

Using the iPhone with Bedework	83

Chapter 6 Bedework Theming	84

6.1 Overview	84

Themes	84

Theming Prerequisites	85

Definitions	85

Location of the Theme Directories	85

Editing, Building, and Avoiding SSL Mixed Content	86

Structure of the Theme Directories	87

Stylesheet discovery	87

Locale selection	88

Browser type selection	88

Skin selection	88

Internationalization	89

Caveats	90

Making Stylistic Changes – the Public Client Themes	90

Working with the bedeworkTheme	91

Setting event colors in the Public Web Client	91

Making Stylistic Changes – the Personal, Admin, and Submissions Clients	92

6.2 Actions & Parameters	92

What are Actions & Parameters?	92

Normal Actions & Render Actions	93

Bedework Actions & Parameters in Detail	93

Bedework Skin Parameters	93

6.3 XML	95

Bedework XML Structure	95

6.4 Bedework XSLT	96

XSLT References	97

Chapter 7 Integration With the Enterprise	98

7.1 Directories	98

7.2 Portals	98

7.3 Email	98

7.4 Other calendar systems	98

Chapter 8 Other Features of the Bedework Project	99

8.1 Timezone Server	99

System timezones	99

Building timezone information.	99

8.2 Bedework and CalDAV	100

Summary	100

The Bedework implementation	100

CalDAV clients	101

Unsupported features	101

Recurrence features	101

Recurrence id ranges	101

8.3 Bw and CardDAV	101

8.4 Other Features	101

Freebusy URL	101

Real-time scheduling	103

Mar 31, 2010	Go to table of contents	p.102

Arlen Johnson

2006-02-15T15:08:33

Arlen Johnson