Icon

    This guide describes how to install BellaDati WAR on Jetty. BellaDati supports Jetty 7 and above. We recommend to use one of latest stable releases of Jetty 9.

    Icon
    The BellaDati WAR file is the BellaDati application packaged in a WAR archive. It must be deployed into an existing application server and needs to be connected to a data warehouse running on an existing database server.

    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 - belladati.war.

    (warning)  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.

    (warning)  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:

    1. Extract 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:

    Icon

    Configuration settings are explained in detail in the BellaDati WAR Configuration Overview.

    3. Save configuration file WEB-INF/classes/conf/application.properties and update the WAR archive. On Linux, the command looks like:

    4. Copy the belladati.war to $JETTY_HOME/webapps.

    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 OutOfMemory errors 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 /etc/default/jetty file:


    If you are using the Java Service Wrapper, follow these instructions:

    Edit $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.

    Icon

    Please note, that the value 2048MB for -Xmx (max heap size) is dedicated for evaluation purposes only. Please refer to Recommended JVM Options article to find suggested settings for production deployments.

    Icon

    You can download the Java Service Wrapper for many different platforms.

    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:

    • bin/jetty.sh run
    • bin/Jetty-Service.exe

    6. Run the Setup Wizard

    Point your browser to http://localhost:8080/belladati. This starts the Setup Wizard, which will take you through BellaDati's setup procedure.

    • No labels