Before You Begin
Please read the following important notes before you begin installing BellaDati on Jetty:
- Make sure you have the right version of Java. See Installing Java for more details.
- Deploying multiple BellaDati WAR application in a single Jetty container is not supported. We do not test this configuration and updating any of the applications (even for point releases) is likely to break it.
- We recommend not deploying any other applications in the same Jetty container that runs BellaDati, especially if these other applications have large memory requirements or require additional libraries in Jetty's lib sub-directory. Multiple applications in a container can impact stability as a crash in one application could make the entire container inaccessible. Additionally, in order to update or reconfigure any of the applications, you'll need to restart the whole container.
1. Setup data warehouse
Please follow the instructions on the Setting up the PostgreSQL Database page.
2. Download and extract BellaDati WAR Archive
Download the BellaDati WAR distribution as a ZIP archive from the BellaDati download page and extract its content using a tool such as 7-Zip for Windows or Linux's GNU tar tools. Only one of the files in the ZIP archive is used for this setup -
Avoid using Windows' built-in file extraction tool! This tool silently fails to extract files with long names. Other users have also reported problems with WinRAR.
Avoid using Solaris' default tar utility! Please use GNU tar on this operating system to extract BellaDati, as GNU tar handles long file names better.
3. Configure BellaDati WAR
You have successfully downloaded and extracted the BellaDati WAR distribution as described in the previous step. To configure Belladati, you need to extract and modify a configuration file placed inside the WAR archive by following these easy steps:
application.properties file from the WAR file using a tool such as 7-Zip for Windows or Linux's unzip tool.
2. Edit extracted file
WEB-INF/classes/conf/application.properties. Under JDBC properties, remove the # sign in the first line. Update jdbc.url, jdbc.username and jdbc.password to match your system configuration. You can remove all lines starting with # from the JDBC properties section. The configuration should look like:
3. Save configuration file
WEB-INF/classes/conf/application.properties and update the WAR archive. On Linux, the command looks like:
4. Copy the
4. Configure Jetty
4.1 Java environment
Before you start Jetty, make sure you have configured the JAVA_HOME variable, which points to the installed Java. You can do it in this way:
You can also add the
JAVA_HOME parameter to
/etc/default/jetty. This will set the
JAVA_HOME variable whenever you start Jetty.
4.2 Configure Memory Settings in Jetty
Jetty memory settings need to be modified to avoid the following issue:
- BellaDati requires more memory than what Jetty provides by default. This may lead to
OutOfMemoryerrors when running BellaDati if these memory settings are not increased.
To prevent this issue, follow the instructions below.
Set the JAVA_OPTIONS variable:
Alternatively, you can set the JAVA_OPTIONS parameter in the
If you are using the Java Service Wrapper, follow these instructions:
$JETTY_HOME/bin/jetty-service.conf file (or create this file if it does not exist) and add the following to this file:
For other environments and more information on memory settings, see the System Requirements.
5. Start or Restart Jetty
BellaDati is now ready to run in Jetty. You can start (or restart) the Jetty server with one of Jetty's start scripts (depends on Jetty version and your OS) from $JETTY_HOME directory: