...
Update the distributed configurations
...
This version of Bedework uses configurations stored in 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/jboss-postgresql, for example, because you plan to use postgresql – 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 |
---|
...
directory in jboss. These configurations should be edited or modified using the JMX console.
Before starting ensure that you have a working quickstart and it is recommended that you save your entire configuration elsewhere so that it does not get overwritten.
In all cases when using the jmx console, navigate to the appropriate page, modify the field(s), click on the "Apply Changes" button then click on the "Invoke" button for the "saveConfig" operation. That last step saves the change to the configuration file.
All configuration files are under <quickstart>/jboss-5.1.0.GA/server/default/conf/bedework
The files and their corresponding JMX page are described below. Note that only the JMX console shows all available configuration options. Those that are not set do not appear in the xml configuration.
bwcore/dbconfig.xml
JMX: org.bedework.bwengine.core -> service=DbConf
This sets the hibernate configuration for the bedework calendar engine. You probably only need to set the dialect.
bwengine/dirconfigs/dir-config.xml
JMX: org.bedework.bwengine -> Name=dir-config,Type=dirconfig,service=System
Set the defaultDomain and domains values. For a single domain they will both be the same - your domain
bwengine/dirconfigs/user-ldap-group.xml
JMX: org.bedework.bwengine -> Name=user-ldap-group,Type=dirconfig,service=System
Set the defaultDomain and domains values. For a single domain they will both be the same - your domain.
The remaining values provide the configuration needed to link to your enterprise directory. This is mostly required to obtain group information for personal calendaring.
bwengine/authCardDav.xml
JMX: org.bedework.bwengine ->Type=authCardDav,service=carddavInfo
The location of the authenticated carddav service. The values may be appropriate for your deployment.
bwengine/authSystem.xml
JMX: org.bedework.bwengine -> service=authSystem
This provides settings and limits for authenticated users of the system. Most of them affect personal calendaring. At least in the first instance the provided settings should be fine.
bwengine/basicSystem.xml
This has no JMX presence and should not be changed.
bwengine/dumprestore.xml
JMX: org.bedework.bwengine -> service=dumprestore
This provides settings for the dump/restore service. No changes needed.
bwengine/genkeys.xml
JMX: org.bedework.util -> service=BwGenKeys
This provides settings for the key generation service. No changes needed. You should navigate to that jmx page and press the "invoke" button for the "genKeys" operation - this ensures your own copy of the keys for encryption.
bwengine/httpConfig.xml
JMX: org.bedework.bwengine -> service=httpConfig
Provides limits on outbound connections. No changes needed.
bwengine/indexing.xml
JMX: org.bedework.bwengine -> service=indexing
Configuration for the indexing process. This will be described in more detail elsewhere. This may need changes to enable a separate indexer process depending on the size of your data and/or clustering options.
This is also the JMX page you visit to reindex the data should that be required.
bwengine/mailer.xml
JMX: org.bedework.bwengine -> service=mailer
Provides some configuration for outbound mail. No changes needed.
bwengine/synch.xml
JMX: org.bedework.bwengine -> service=synch
Provides some configuration for the bedework end of the synchronization engine connection. If the synch engine runs locally changes are probably not needed.
bwengine/system.xml
JMX: org.bedework.bwengine -> service=system
A number of changes may be needed here - the more important settings:
- tzid - the default timezone for the system. Should be set to your local timezone.
- eventregAdminToken - see event registration.
- systemid - change top refer to your local domain. Only used for identification purposes.
- rootUsers - you may need to change this. Should be a very restricted set of users.
- mailerClass - set to "org.bedework.mail.SimpleMailer" to enable outbound mail
- tzServeruri - only change if running an outboard timezone server
In addition to the settings there is a display of some system collected statistics. Refreshing the page should show an updated view.
bwengine/unauthCardDav.xml
JMX: org.bedework.bwengine -> Type=unauthCardDav,service=carddavInfo
The location of the authenticated carddav service. The values may be appropriate for your deployment.
bwengine/unauthSystem.xml
JMX: org.bedework.bwengine -> service=unauthSystem
This provides settings and limits for unauthenticated users of the system. At least in the first instance the provided settings should be fine.