The commands listed below are needed to install the Dashboard on Linux. If you’d like to use containers instead, please see our docker deployment examples.

Installing the Dashboard

Firstly, download the latest release from our portal:

Then extract the contents of the zip file. Below it’s been extracted to /opt/panintelligence/Dashboard:

mkdir /opt/panintelligence
unzip ~/Downloads/Dashboard-linux-2021_06_24.2-x86_64.zip -d /opt/panintelligence/

Copy Licence Command

Once you’ve obtained a licence from your Customer Success Manager, after downloading it, you’ll need to load it. A quick way of doing this without having to restart the dashboard is to copy it directly, like so:

cp ~/Downloads/licence.xml /opt/panintelligence/Dashboard/tomcat/webapps/panLicenceManager/WEB-INF/classes/

Commands to Start/Stop the Dashboard

The Dashboard directory contains the file dashboard.sh. You’ll know you’re in the right place if ls lists the dashboard.sh script file:

cd /opt/panintelligence/Dashboard
ls

The above should show something like this:

configuration-tool*               jcs_swap/      s3_backup.sh*
configuration-tool-GUI.AppImage*  keys/          s3_restore.sh*
dashboard.json                    logs/          Scheduler/
dashboard.sh*                     migration/     temp/
db/                               Pirana/        tomcat/
defaults.json                     PortSelector/  upgrade_dashboard.sh*
ExcelReader/                      Renderer/


This script can be used to manage the dashboard:

./dashboard.sh all start  # To start the Dashboard
./dashboard.sh all stop   # To stop the Dashboard
./dashboard.sh all status # To list the status of all Dashboard services

Upgrade the Dashboard on Linux

  1. Extract the new dashboard to the preferred location (e.g. /panintelligence/dashboard).

  2. Go into the Dashboard directory and there should be an upgrade_dashboard.sh file.

  3. Run the bash file and point to the location of the old dashboard (e.g. /panintelligence/old_dashboard) for example the command below.

cd /opt/panintelligence/Dashboard
./upgrade_dashboard.sh /opt/panintelligence/Old_Dashboard

Taking a backup of a repository

If you wish to take a backup of your repository, it can be done with:

cd /opt/panintelligence/Dashboard
./configuration-tool --database --backup

The new backup of your repository will be stored at /opt/panintelligence/Dashboard/db/backups directory.

Restoring a repository.

Assuming you have backed up the dashboard and have a .sql file, it can be restored with

cd /opt/panintelligence/Dashboard
./configuration-tool --database --restore=/path/to/backup.sql

This will restore your old repository.