Installing Panorama from scratch

This guide describes how to perform a clean installation of Primeur Panorama, from unpacking the distribution package to configuring the application.

Extract the installation package

Extract the panorama-<version>.tar.xz package into the Panorama installation directory.

After extraction, the directory structure includes:

• app

  • config – contains the panorama-config.sh configuration file

  • db – scripts for full installation and version upgrades

  • license – third‑party library license

  • panorama – the Panorama application directory

  • scripts – utility scripts

• jre – bundled Java Runtime Environment (version 17)

Note: If the JRE is not yet installed, unzip it before continuing.

If any .sh script is not executable, assign execution permissions using:

chmod +x <script-name>.sh

Initialize the Panorama database

1. Navigate to the app/config directory and open panorama-config.sh.

2. Configure the MongoDB connection parameters:

   • MONGODB_PORT – port used by MongoDB

   • MONGODB_TOOLS_DIR – path to MongoDB tools

   • MONGODB_SHELL_DIR – path to the MongoDB shell executable

If required, make the script executable using:

chmod +x panorama-config.sh

If MongoDB authentication is enabled

Set the following variables:

• MONGODB_AUTH_DATABASE – authentication database

• MONGODB_USERNAME – username to access MongoDB

• MONGODB_PASSWORD – obfuscated password

To obfuscate the password, go to app/scripts and run:

./panorama.sh obfuscate <password>

Import Collections and create Indexes

Run the full database initialization script located in app/scripts/db/:

db-full.sh

If required, make the script executable:

chmod +x db-full.sh

Configure Primeur Panorama

Edit the panorama-config.sh file in app/config to set application parameters.

HTTP Configuration

• PQAPP_PORT – HTTP port for Panorama

HTTPS Configuration

To enable HTTPS, configure:

• PQAPP_HTTPS_PORT – HTTPS port

• PQAPP_KEYSTORE_FILE – path to the keystore file

• PQAPP_KEYSTORE_TYPE – keystore format (e.g., PKCS12)

• PQAPP_KEYSTORE_PASSWORD – obfuscated keystore password

Generate the obfuscated password going to the app/scripts folder and executing this command:

./panorama.sh obfuscate <password>

(Optional) Custom Logs directory

To customize the logs directory, modify:

export PQAPP_LOGS=<path_to_logs_directory>