Deployment
This document explains various options to deploy and configure your Berlioz app to your site.
The publish script is responsible for deploying the PageSeeder data to your site. See Integration.
Development environment
In a PageSeeder development environment, it is recommended to install a local version of Jetty which is lightweight and can be started and stopped easily.
You can get Jetty from: www.eclipse.org/jetty/ .
Jetty configuration
It is possible to start using Jetty with a Berlioz app right out of the box, but some straightforward configuration lets you get the most out of Jetty+Berlioz.
If a project has been started with Berlioz Base, it should already include some sample jetty configuration files.
By convention, PageSeeder developers use port 8099 in development. Start a jetty as:
java -Djetty.port=8099 -jar start.jar
Berlioz mode
During development, developers need to see what is happening to their app. The convention is to use the 'dev' or 'local' modes for development.
The mode allows Berlioz to load specific Berlioz global settings file and logging files. It can be specified in two ways:
- By using the berlioz.mode system property.
For example, by starting your server with-Dberlioz.mode=dev
in the command line. - By only including the the mode to use in the
/WEB-INF/config
folder.
Production environment
Jetty is perfectly suitable for a production system. However, Berlioz is a simple J2EE app, so it could be deployed on any J2EE compliant server and has successfully tested on Tomcat, Glassfish, Resin and Websphere in the past.