Before You Begin

Please read the following important notes before you begin installing BellaDati on Payara:

• Make sure you have the right version of Java. See Installing Java for more details.

  Since Belladati 2.10 Java 11 is required.

  
  

• Install Payara application server
• Deploying multiple BellaDati WAR application in a single Payara application server 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 Payara container that runs BellaDati, especially if these other applications have large memory requirements or require additional libraries in Payara'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.

Watch the video tutorial and or follow guidelines below

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.

 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

Since version 2.7.14 there is no special configuration change needed, however, there are several advanced settings (e.g. enforcing the SSL), which are configurable in application.properties only.

4. Configure Payara

4.1 Configure Memory Settings in Payara

BellaDati requires more memory than what Payara provides by default. This may lead to OutOfMemory errors when running BellaDati if these memory settings are not increased.

To increase the available memory, log in into the Payara Administration console (by default available at port 4848). Open the Application server's JVM Settings menu and click on JVM Options. Change the setting for -XX:MaxPermSize to 512m and -Xmx to 2048m and change -client to -server as shown in the screenshot below. If any of these options doesn't exist yet, create it. Please make sure you don't have set a -server and -client option at the same time.

If you are using the command line, execute the following commands instead:

$PAYARA_HOME/bin/asadmin delete-jvm-options \"-client\"
$PAYARA_HOME/bin/asadmin delete-jvm-options \"-Xmx512m\"
$PAYARA_HOME/bin/asadmin delete-jvm-options \"-XX:MaxPermSize=192m\"

$PAYARA_HOME/bin/asadmin create-jvm-options \"-server\"
$PAYARA_HOME/bin/asadmin create-jvm-options \"-Xmx2048m\"
$PAYARA_HOME/bin/asadmin create-jvm-options \"-XX:MaxPermSize=512m\"

Restart Payara. For other environments and more information on memory settings, see the System Requirements and Recommended JVM Options.

4.2 Configure Thread Pool Settings in Payara

We highly recommend to increase maximum thread pool size for thread pools called "http-thread-pool" and "thread-pool-1" in thread pool settings.

1. Login to Administration console.
2. Open Configurations->server-config-> Thread Pools
3. Click on "http-thread-pool", set Max Thread Pool Size to 512 and save this change
4. Click on "thread-pool-1", set Max Thread Pool Size to 512 and save this change

4.3 Configure the JDBC settings

Please configure JDBC settings using JVM options as listed in BellaDati Application Properties.

4.4 Configure location for logs

The default location for logs generated by BellaDati (see Configure logging for more details) is relative to the exploded belladati.war which is not suitable for long term storage. 

To change the logs directory, log in into the Payara Administration console (by default available at port 4848), open the Application server's JVM Settings menu and click on JVM Options. Add new option -Dlogs.location=<location> where <location> is the desired absolute path to the parent directory in which logs will be stored.

If you are using the command line, execute the following commands instead:

$PAYARA_HOME/bin/asadmin create-jvm-options \"-Dlogs.location=<location>\"

Restart Payara. 

5. Deploying BellaDati into Payara

5.1 Using Payara's Administration console

You can use the Admin Console to deploy BellaDati into Payara.

1. Log in to Administration console.
2. Open Applications.
3. Click on the Deploy button.
4. Click Browse and select the belladati.war file.

5.2 Using the asadmin command

In order to deploy BellaDati, execute this command:

$PAYARA_HOME/bin/asadmin deploy --user admin /belladati.war

This command deploys the BellaDati WAR file under the /belladati context.

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.

7. Starting/Stopping Payara

Payara application server can be started/stopped from the command line or by using the service. This differs depending on the operating system used:

7.1 Windows command line

#server start
$PAYARA_HOME\bin\asadmin start-domain

 
#server stop
$PAYARA_HOME\bin\asadmin stop-domain

7.2 Windows service

If you want to install Payara as Windows service, you can either execute the following script or create it using the sc command manually:

$PAYARA_HOME\bin\asadmin create-service

Please note, that this script requires the Administrator privileges and .NET 3.5 installed on the machine.