Upgrading to a new version of Panorama

To upgrade to a new version of Primeur Panorama, follow these steps:

1. Stop Primeur Panorama Stop Panorama launching this command: ./panorama.sh stop

2. Check status Check that Panorama is stopped using this command: ./panorama.sh status

3. Backup current installation Backup your current installation of Panorama.

4. Extract latest Panorama package Extract the panorama-<version>.tar.xz package in a temporary directory.

5. Copy package Copy the content of panorama-1.2.5 in the Panorama home directory of your current installation. This will overwrite all your files – but you have the backup.

6. Copy customized values Manually copy customized values of the backed-up panorama-config.sh file into the new panorama-config.sh file.

7. This step is not needed if upgrading from 1.2.3 to 1.2.5 or from 1.2.4.1 to 1.2.5 Download the MongoDB Shell. Go to https://www.mongodb.com/try/download/shell and:

   1. Extract the new shell in the mongo bin path.

   2. Add it to the panorama-config.sh file new variable: ## Mongo shell dir export MONGODB_SHELL_DIR=<mongo_shell_path>

8. Edit Mongo shell and tools paths In the panorama-config.sh file, add or update:

   1. MONGODB_SHELL_DIR ## Mongo shell dir export MONGODB_SHELL_DIR=<mongo_shell_path> Do not add /bin to the path.

   2. MONGODB_TOOLS_DIR ## Mongo tools dir export MONGODB_TOOLS_DIR=<mongo_tools_path>

9. Launch the cleaner Verify that MongoDB is up and running. Go to the app/db/upgrade/1.2.5.cleaner folder and run the following command: cleandb.sh All data will be deleted. A new synchronization will be needed and must be manually launched in Panorama. See step 12 below.

10. Launch the upgrade package or packages

    1. Go to app/db/upgrade.

    2. Launch all upgrade packages from the package following your current version to the package of the version you are upgrading to.

    For example, to upgrade from version 1.2.2 to 1.2.5 follow these steps:

    1. Enter the db/upgrade/1.2.3 folder and run the upgrade.sh file.

    2. Enter the db/upgrade/1.2.4 folder and run the upgrade.sh file.

    3. Enter the db/upgrade/1.2.5 folder and run the upgrade.sh file.

11. Start Primeur Panorama and access the application Go to the scripts folder and start Panorama running this command: ./panorama.sh start To check the status of the application, use this command: ./panorama.sh status Access Primeur Panorama at the following URL: http://<host:http_port>/panorama/ If you are using HTTPS, use this URL: https://<host:https_port>/panorama/

12. Manually launch data synchronization In Panorama, go to Setup → System tab, click the To init yellow chip at the top and specify the period you want to synchronize. Refer to the online user documentation for details: Data Synchronization.