Building and Deploying Bedework
The Bedework release is made of up a number of related parts which are built and deployed through the action of the bw (bw.bat on Windows) script found in the quickstart directory. To run bw, first cd to the quickstart directory.
The bw commands that immediately follow deploy the bedework core: the calendar server (including the caldav server) and the web clients. You'll need to reinvoke the bw command with different arguments to build and deploy the timezone server, the carddav server, the addressbook client, etc. Those commands are covered in the sections below.
| Notetip | ||
|---|---|---|
| ||
Invoking the bw script without arguments displays very useful usage information. |
Apart from the Bedework core, only the timezone server is critical to getting Bedework running. You'll need to rebuild the timezone server after you change <timezoneUri> in bwbuild/myconfig/cal.options.xml.
Assuming your configuration mycompany is under bwbuild/myconfig in your home directory in the bwbuild subdirectory, run this command:
| Code Block |
|---|
./bw -bwc mycompanymyconfig clean.deploy.debug |
If you created a configuration area somewhere else in your filesystem, then
| Code Block |
|---|
./bw -bwchome configdir -bwc mycompanymyconfig deploy.debug |
To build with the jboss-mysql configurations shipped in the quickstart:
| Code Block |
|---|
./bw -quickstart -bwc jboss-mysql deploy
|
These commands build a number of EAR and WAR files in <qs><quickstart>/bedwork/dist/, then deploy them to <qs><quickstart>/jboss-5.1.0.GA/server/default/bwdeploy
| Notetip | ||
|---|---|---|
| ||
If you build Bedework with "debug ", Bedework will log more information. You may want to rebuild without it when you are in production.If you build with "clean", the build will remove all the previously built files before building. |
Build and Deploy the Bedework Timezone Server
As with the above examples, unless your configuration files are under <home>/bwbuild, specify where the configuration files come from (-quickstart/-bwchome) and unless you are using the "default" configuration, specify the name of your configuration folder (-bwc).
| Code Block |
|---|
./bw <config files args> -tzsvr
|
This command builds bw-tzsvr.ear and deploys it to jboss-5.1.0.GA/server/default/bwdeploy.
Build and Deploy the Bedework CardDAV Server
Use -quickstart, -bwchome, -bwc as appropriate.
| Code Block |
|---|
./bw <config files args> -carddav
|
This command builds bw-carddav.ear and deploys it to <qs>/jboss-5.1.0.GA/server/default/bwdeploy.
Deploy the Bedework Addressbook Client
Use -quickstart, -bwchome, -bwc as appropriate.
| Code Block |
|---|
./bw <config files args> -carddav deploy-addrbook
|
This command copies the files in <qs>bedework-carddav/clients/javascript/bwAddrbookClient to <qs>/jboss-5.1.0.GA/server/default/deploy/ROOT.war.
Deploy the Bedework Synch Server
Use -quickstart, -bwchome, -bwc as appropriate.
| Code Block |
|---|
./bw <config files args> -synch
|
This command builds the bw-synch.ear and deploys it to <qs>/jboss-5.1.0.GA/server/default/bwdeploy.
Build and Deploy webcache/urlbuilder
See this section.
Hot Deploys
If you build and deploy Bedework while Bedework is running, JBoss <<should>> undeploy what was already running in favor of the newer packages. Often it works as advertises. Sometimes it doesn't. Stopping Bedework, re-deploying, and starting Bedework is safer. If you succeed in "hot deploying", you might want to schedule a restart for the next convenient time. Even successful hot deploys are likely to result in a larger memory footprint.