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-mysql. default is configured to use HSQL.
Note | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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.
...
title | bwbuild/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