Info |
---|
This page will show you step by step how to install BellaDati on 64-bit Linux using BellaDati linux installer. The description uses an example with BellaDati 2.9.20 version but the process is the same for BellaDati 2.10+ versions running over Payara a.s. with java 11. |
IntroductionBellaDati platform is complex of - Java application BellaDati (java 8, starting BellaDati version 2.10 java 11)
- Aplication server (GlassFish server , Payara server (starting Belladati 2.10 version) )
- Database Engine (PostgreSQL 10,(PostgreSQL 12 starting BellaDati 2.10+) , MSSQL)
Info |
---|
The BellaDati linux installer file delivers / installs JRE (java run time environment ), Application server and BellaDati Java application belladati.war . Unlike of windows installer it does not contain any SQL database engine data. The SQL engine is required to install before the script is applied. ................................................... BellaDati 2.10 java version openjdk version "11.0.2" 2019-01-15 OpenJDK Runtime Environment 18.9 (build 11.0.2+9) OpenJDK 64-Bit Server VM 18.9 (build 11.0.2+9, mixed mode) BellaDati 2.10 application server Version = Payara Server 5.2021.4 #badassfish (build 740)
|
Before You BeginPlease read the following important notes before you begin installing BellaDati:
- You need to have successfully downloaded the BellaDati Linux installer from the BellaDati website.
see https://my.belladati.com/mybelladati/product/downloaditemarchive/1 take into account Operating System requirements too minimal hw is 4 vCPU, 8 GB ram and 30 GB storage e.g. https://www.postgresql.org/download/linux/ubuntu/ ( installation on UbuntuUbuntu )
PostgreSQL 12 is recommended for BellaDati 2.10+
e.g. for PostgreSQL most important are pg_hba.conf and postgresql.conf files
remember host identification (IP, DNS), dbs engine port , database name, username, password - Check that default ports reserved for BellaDati (4848, 8080, 8181, 443) are available and not used by any other applications.
port for Database engine is required as well ( e.g. 5432) - (Ubuntu only) Check the libfontconfig1 is installed (required for map exports). If not, install using apt-get install libfontconfig1
To run installer (root): - Please make sure the installer has execute privileges. You can use following command to add execute rights:
- Execute following command (you can use argument -c if you want to run installer in console mode):
1. Starting & checking host parametersThe script will check your machine against the minimal system requirements. Upgrade to a higher-performance machine in case your configuration does not meet the criteria, to avoid experiencing a decreased performance of BellaDati. Start installation : ./Belladati_linux-x64_X_Y_Z.sh example: the machine does not meet minimal requirements and it is recommended to change computer configuration :
The host machine configuration has been changed and the installation process started again;
2. License TermsThe new machine meets minimal requirements. Start installation and read and Accept the license agreement.
Continue up to license agreement acceptation.
3. Select Destination DirectoryLicense agreement is accepted and process continue to installation directory selection : Info |
---|
title | destination directory |
---|
| By default, BellaDati is installed into a predefined installation directory. Insert different folder if you want to modify these settings. BellaDati installation script will check your free disk capacity to ensure enough space is available. |
4. Database SetupLinux installer does not install database for BellaDati, and therefore a PostgreSQL or MSSQL database has to be installed and configured manually. Please see our documentation for instructions how to accomplish this step. This example uses running PostgreSQL dbs engine available on separate machine :
5. Connecting to an Existing DatabaseSpecify the following connection parameters relating to running database engine/ database: - Hostname or IP
- Port
- Database name
- Username
- Password
The installer process checks connectivity to the dbs environment...
6. Application Server ParametersContinue and set up parameters needed for application server. Approve or edit the following default settings: - Port. Make sure this port is not being used by other applications or services.
- Xmx
- Maximum Pool Size
- Validate at most once in
- HTTP Thread Pool Max Size
- Thread Pool 1 Max Size
Info |
---|
| Port host IP:port ; Xmx (-Xmx) JavaVirtualMachine heap space size; Maximum Pool Size (-Djdbc.pool.maxActive) maximum number of connections ; |
Tip |
---|
Please see our documentation for more details. Leave the default values if you are unsure about the configuration. The parameters can be modified later after installation completed by tools available in application server GlassFish (or Payara starting used with BellaDati 2.10... ) e.g. CL commands asadmin... or GUI application server console. |
Tip |
---|
Check Start service automatically to have BellaDati up and running right after the installation. |
7. Directory for Symlinks and final part of installationSelect additional options: - Create symlinks
- Destination directory
Continue and wait while BellaDati is installed on your computer
Info |
---|
title | Executive part of installation script process |
---|
| -installing BellaDati data & metadata into sql database , i.e. schemas, tables and initial data are implemented into SQL dbs template, -installing application server (GlassFish or Payara (newer versionswith BellaDati 2.10+) ); parameters setting before are used and can be modified later -deploying application file belladati.war |
8. Finishing InstallationThe installation is complete now. It could take some time to start BellaDati for a first time. Then continue with the BellaDati Setup Wizard. 9. Troubleshooting- If BellaDati is not running then check if database is running and if it is accessible at first.
- If you have disabled automatically starting the server in the web server configuration, or starting the server failed, you can run it manually from terminal:
- To start BellaDati run following command from installation directory:
- To stop BellaDati run following command from installation directory:
- To open BellaDati after the installation is complete, point your browser to
http://localhost:8080 . This is the default URL, which may differ depending on the data you entered in step 6 of the installation. - If you have any problems during installation, please try to complete installation (retry or ignore errors) and then send us following log file:
Next Steps
|