Updating a Jedox Installation in Linux

image_pdfimage_print

Important note: databases that have been loaded in Jedox version 2018.2 cannot be loaded in version 2018.1 or older!

Before you begin:

  • Create a backup of your Jedox data (spreadsheets, reports, and DBs).
  • Create a backup of your manually adapted Jedox config files.
  • You must have root rights to install and to start Jedox Web on Linux
  • Before you upgrade a production system, we recommend that you perform the update on a test system and check it with appropriate plausibility tests.

Jedox 2018.1, 7.1 or 7.0 (SRx)

The section below describes how to perform an installation update to Jedox Version 2018.2 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 (Stop before Jedox)
As described above, most data is kept in place when running an update installation. If you manually need to replace content, you can run the following command:

 cp -R < source > < target >

For the Jedox configuration file, the command is as in the following example:

cp -R opt/jedox/ps_copy/Data/palo.ini /opt/jedox/ps/Data/

For the other configuration files1), the paths are listed below. You can use them for the copy command:
/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

1) 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.

Jedox components older than version 7.0

For versions of Jedox older than 7.0, we recommend updating Jedox from one version to the next major release, without skipping over main versions. For example, we don’t recommend updating from Jedox version 6.0 to 2018.2. Therefore, please update your data first to version 7.0 and then to 2018.2.

Main Jedox versions are all versions without additional service releases (SR).
Please refer to the Knowledge Base article Support Lifecycle for more information.

Further instructions can be found in Jedox Setup Guide 7.0.

 

image_pdfimage_print