Getting Started

Documentation status: Done
Used with Bedework version 3.5

To try out Bedework, download and run the quickstart package.

The Bedework quickstart comes pre-built, allowing you to get familiar with the calendar quickly and easily, without having to compile and deploy code, and without having to set up a database. It is preloaded with data so you can see how the system looks in production. It is the foundation from which a production release is built.

Packaged with the quickstart

  1. Bedework
  2. Tomcat 5.5 (apache-tomcat-5.5.17)
  3. Hypersonic SQL 1.7 (hsqldb-1.7.3.3)
  4. Apache Ant 1.7 (apache-ant-1.7.0)

System requirements

  1. JDK 1.5 - specifically, Java 1.5.0_11 or later
  2. JAVA_HOME environment variable must be set.
  3. Nothing else should be running on port 8080 and 8887.

Starting Bedework

  1. Open a console window and cd to the quickstart directory.
  2. Set JAVA_HOME environment variable. For example:
    • Linux: export JAVA_HOME=/usr/java/jdk1.5.0_13
    • Windows: set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_13
  3. Enter the following command:
    • Linux: ./bw.sh -quickstart start
    • Windows: bw -quickstart start
    This will start Hypersonic, Tomcat, and the Apache DS ldap directory.
  4. Access the web applications at http://localhost:8080/bedework
    Note: this link will only work on the system on which the quickstart is running.
  5. When finished, you can stop Bedework by entering CTRL-C in the window in which the command was started.

Logging

Log messages largely appear in the tomcat log in <tomcat-dir>/logs. This release uses log4j for most of the application logging. The distributed log4j.xml appears in calendar/resources in the quickstart and in common/classes in the tomcat directory. It is configured to maintain a rolling log file, <tomcat-dir>/logs/server.log, and also append output to the console.

In addition, a socket appender is defined which allows chainsaw to be used to watch the log output.

Notes

Calendar binaries are included so there is no need to compile any calendar source code. Also, the database is pre-loaded, so there is no need to run any database scripts.

Thanks to the uPortal team (http://www.ja-sig.org) for the inspiration and the quickstart release on which ours is based.

Taking it further

For more information including steps for creating user accounts, dumping and restoring the database, and deploying a production system, please refer to the Bedework Manual for instructions.