Updating a Jedox Installation in Linux

image_pdfimage_print

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.

Existing Jedox components are from version 2018.1 or 7.1 or 7.0 (SRx)

Description of an installation update to Jedox Version 2018.2 with data copying of existing data and settings:

Step 1 – Stop Jedox

cd /opt/jedox/ps.

./jedox-suite.sh stop

Step 2 – Create a copy of the existing installation folder (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 – Installation
Execute install.sh in a “bash” shell (other shells, such as “dash”, are not supported):

./install.sh

Use the existing ps directory as 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, 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 do the following:

Example:      cp -R < source > < target >

For the Jedox configuration file, the command is as follows:

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

For the other files the paths are listed below. You can use these for the copy command:

Configuration files1):
/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)   Please 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.

Existing Jedox components are 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