Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Do I need to rebuild?

Bedework comes with a full set of demonstration web applications. If you wish to create a pruned version of the system - or add more calendar suites - you will need to rebuild with your own configuration. Note that the build configuration only affects what is built. The run-time configuration of the system is all set by the files described in  Configuring Bedework

Copy the

...

Bedework uses a configuration directory to store multiple configurations. The quickstart copy of this directory is at <quickstartDirectory>/bedework/config/bwbuild.

Copy the entire directory structure – bwbuild on down – into your home directory (/home/userid on many Unix systems and C:\Users\userid on a typical Windows system).   So, for example, the bwbuild directory in windows would live here:  C:\Users\userid\bwbuild  or here: /home/userid/bwbuild

Inside bwbuild you will find a number of example configurations in subdirectories, for example default and jboss-mysqldefault is configured to use HSQL.

Note
titleDo I need to copy the whole bwbuild configuration tree?

Yes. There are hidden directories – .platform and .defaults – that must be present in your configuration directory.   After you copy the bwbuild tree, you can remove any configurations you aren't using.

Info
titleCan I copy the configs outside of /home?

Yes.  You may choose to copy the bwbuild directory structure to another directory. Some prefer to keep the configuration files in the vicinity of their Bedework files.  If you do so, add -bwchome <config-directory> to your Bedework build commands.  This will become clearer as you read on.

Copy one of the configurations to create your own

Choose the sample configuration that is the best fit – bwbuild/default, for example,  – and make a copy of the entire directory tree.  You might name your copy for your organization: bwbuild/mycompany or bwbuild/myuniversity

...

titlebwbuild/myconfig

...

deployment configurations properties file

The final configuration of deployed applications is set by the deployment properties file bedework/config/deploy.properties. Copy the file to some other location.

Edit the file to set the values needed for your deployment. You may find you don't need to change much.

Transport Guarantees

These are what determine if connections are made over SSL or in plain-text. The two allowable values are NONE and CONFIDENTIAL. If you run jboss behind a web server such as apache - and if that web server handles ssl for you - then you don't need to modify this setting. The global default of NONE is fine. Otherwise you need to set it to CONFIDENTIAL for those applications that require SSL. You will also need to install certificates in jboss.

Virtual hosts

If you need to set the virtual hosts for the applications you can set them all to the same value(s) with the property

    org.bedework.global.virtual-hosts=host1.example.com,host2.example.com

or change them for one ear only e.g. for ear "bwcal"

    org.bedework.app.bwcal.virtual-hosts=host1.example.com,host2.example.com

or per application: e.g. for application "ucal" in ear "bwcal"

    org.bedework.app.bwcal.ucal.virtual-hosts=calendars.example.com

 Adding Calendar Suites

For example to duplicate the "cal" webapp as "soedept" in the ear "bwcal" add the property

    org.bedework.app.bwcal.copy.soedept=cal

You then need to add any specific configuration options for that calendar suite, e.g.

    org.bedework.app.bwcal.soedept.virtual-hosts=calendars.example.com