Server Bundle Development

Getting Started

Those who do not need to develop the server bundle code itself can download and install one of the pre-built packages (see ServerBundleInstallation for download and install instructions).

Otherwise you can check the code out of Subversion and build it yourself - see ServerBundleBuildInstructions.

For Cosmo Developers

The Cosmo distribution includes a war file, not fully executable servlet container environments. You must provide your own runtime environment. An easy way to do this is by using the server bundle.

These instructions use $OSAFSRV_HOME to denote the directory in which you installed the server bundle. If you built from source, this will be the dist/osaf-server-bundle-x.x subdirectory that you created by running maven dist.

1. In your Cosmo checkout, run maven war:inplace to set up src/webapp with all the runtime files it needs to act as a functioning webapp
2. Install a server bundle distribution or build from source
3. Edit $OSAFSRV_HOME/tomcat/conf/server.xml:
   • Find the Context element for Cosmo
   • Change the docBase attribute of that element to be the fully qualified path to the src/webapp subdirectory of your Cosmo checkout (eg /Users/bcm/work/osaf/cosmo/src/webapp)
4. Run the server with $OSAFSRV_HOME/bin/osafsrvctl start
5. Point your browser at http://localhost:8080/ - if all has gone well, you should see a welcome page with information about Cosmo and links to sign up for an account and to log in.

With this setup, your Cosmo repository is located in $OSAFSRV_HOME/db.