Updating a Jedox Installation in Linux

image_pdfimage_print

Important notes: 

  • Databases that have been loaded in Jedox version 2018.3 cannot be loaded in version 2018.2 or older!
  • Before you upgrade a production system we recommend performing the update on a test system and to check it with appropriate plausibility tests.

Before you begin:

  • Create a backup of your Jedox data (spreadsheets, reports, and DBs).
  • Create a backup of your manually adapted Jedox config files.
  • To install and to start Jedox Web on Linux you need root rights.

Updating existing Jedox versions 2018.2, 2018.1, 7.1 or 7.0 (SR2)

The section below describes how to perform an installation update to Jedox Version 2018.3 with data copies of existing data and settings:

Step 1 Run the following command to stop any Jedox process:

cd /opt/jedox/ps.

./jedox-suite.sh stop

Step 2 Create a copy of the existing installation folder as a backup:

cp –R /opt/jedox/ps /opt/jedox/ps_copy

Note: the update installation could overwrite manually changed configuration files. Therefore you should have a backup from which it is possible to restore manually changed files.

Step 3 – Execute install.sh in a “bash” shell (other shells, such as “dash”, are not supported) to run the installation:

./install.sh

Use the existing ps directory as the installation directory.

Follow the instructions. Setup will prompt you for several existing data directories (OLAP, Jedox Web, and ETL Server), asking you whether you want to keep existing data or replace it with new data. If you choose to replace it, your existing data will be lost for the respective directory.

For Supervision Server, a folder with sample scripts (called “sample_scripts”) will be created. If you had used a custom script, you need to re-add it after setup has finished.

Step 4 Restore desired data

As described above, most data is kept in place when running an update installation.

Note: after updating, delay loading may take longer than usual due to potential database conversion at first start. Jedox processes should not be stopped or shutdown until delay loading has finished.

Jedox configuration files

The following files can be manually configured in Jedox. They should be backed up before updating your Jedox installation.

  • /opt/jedox/ps/Data/palo.ini
  • /opt/jedox/ps/etc/httpd/conf/httpd.conf
  • /opt/jedox/ps/tomcat/conf/server.xml
  • /opt/jedox/ps/htdocs/app/etc/config.php
  • /opt/jedox/ps/core-Linux-i686/etc/config.xml
  • /opt/jedox/ps/tomcat/webapps/etlserver/config/config.xml
  • /opt/jedox/ps/core-Linux-i686/etc/palo_config.xml
  • /opt/jedox/ps/etc/php.ini
  • /opt/jedox/ps/svs-Linux-i686/php.ini
  • /opt/jedox/ps/tomcat/bin/setenv.sh

Note: Setup either modifies existing configuration files upon update (such as palo.ini), or replaces existing ones with new ones. The replace operations are necessary because of larger changes in the configuration. If you had modified configuration files in your previous installation, we recommend that you apply your changes to the new files rather than copy files from the previous version’s backup.

image_pdfimage_print