Table of content

Update the version of Galigeo.war

Upgrading the version of Galigeo consists in redeploying a new webapp in Tomcat. Since no configuration is stored in the web application (all the configurations are stored in the directory $GALIGEO_HOME), this action will not require any re-configuration.

There are multiple ways to re-deploy a webapp in Tomcat. Here we propose a simple solution.

Hardware requirements

This section will help choosing the right hardware for running Galigeo G20.

Memory sizing
Galigeo is a J2EE application which means only the memory settings of the JVM matters. Usually the maximum memory allocated to Tomcat does not exceed half the memory of the server. For example, if a server has 16Go of RAM, the Java xmx won't exceed 8Go.
The memory settings are highly dependent on the usage of the application. The following table helps understand the order of magnitude for several scenarios (assuming the map documents are compliant with the best practices).
Usage Memory Settings
Minimal Settings -Xmx1G -Xss512K
10 concurrent users -Xmx16G -Xss1024K
20 concurrent users -Xmx32G -Xss1024K
More than 20 concurrent users We recommand using multiple instances with a load balancer
Disk sizing
Galigeo is divided in two parts on the disk: the Java webapp and the $GALIGEO_HOME directory. Usually we recommand using a machine with at least 600Go of hard disk.

The Java webapp unzipped is about 200Mo.

The $GALIGEO_HOME directory uses 100Mo of space on a fresh install. This directory will store all the resources used by the application (data, logs, cache, ...). The folder can grow to 1Go or 2Go according to the usage.

Supported versions

List of supported versions.

VersionLatest service packRelease dateEnd of support
G23SP0Sept 2023Sept 2025
G22SP3Apr 2023Apr 2025
G21SP5Jan 2021Jan 2023
G20SP3May 2020May 2022
G19.5SP3Sept 2019Sept 2021
G19.0SP2Feb 2019Feb 2021
G18.0SP5Feb 2018Feb 2020
G17.6Aug 2017Aug 2019
G17.5Apr 2017Apr 2019
G17.0SP1Jan 2017Jan 2019

Migration from Galigeo Enterprise < G20

This section concerns only the Galigeo Enteprise administrators

Galigeo Enterprise G20 is a major release which introduce lots of simplicity compared to the previous versions. The main change with this version is that the administration panel (based on Adobe Flash) is not used any more and all the administration is done through the Galigeo Manager common to all versions.

However, if you are using a version < G20 and you want to upgrade to a version >= G20, you will need to convert your documents to the new version. Galigeo provides a tool to help doing this conversion. Note that the migration creates a copy of the documents so the configuration will still work with the previous version (but the modifications won't be synchronized).

listMigration steps:

If you want to have both versions running in parallel, instead of step 3. you can install a new Tomcat server and install the new version on it. When you first open the application you will be asked to specify the location of the GALIGEO_HOME directory. During this step, make sure you specify the existing one.

The conversion tool will not be able to convert everything because some features are too different between the two versions. Here are the limitations:

Guidelines to add Galigeo Rewrite Rule in Microsoft IIS

Find below the steps to add Galigeo Rewrite Rule in IIS. These steps are only guidelines as it may differ depending on IIS version.
There is no support on IIS setup.
Grapefruit slice atop a pile of other slices

Important notices for Galigeo users

October 2022 - According to CVE-2022-42889 recommendation, Apache lib "commons-text" has been updated from commons-text-1.9.jar to commons-text-1.10.0.jar in Galigeo G22 SP1 and subsequent versions.

July 2022 - According to CVE-2021-4104 recommendation, Apache LOG4J1 has been updated to LOG4J2 (2.17.2) in Galigeo G22 SP0 and subsequent versions.

July 2022 - Spring vulnerability CVE-2022-22950 - No impact on Galigeo Platform, Cloud or On Premise:

  • As mentioned in the above note, this vulnerability is related to the usage of "specially crafted SpEL (Spring Expression Language) expression".
  • As Galigeo Platform does not use at all "Spring Expression Language", It is not impacted by the CVE-2022-22950 vulnerability.

April 2022 - Spring vulnerability CVE-2022-22965 - No impact on Galigeo Platform, Cloud or On Premise:

  • As mentioned in the above note, one pre-requisite to exploit this vulnerabilty is to run JDK-9 or higher.
  • As Galigeo Platform does only support and run on JDK-8, It is not impacted by the CVE-2022-22965 vulnerability.

February 2022 - LOG4J-1 vulnerability CVE-2021-4104 - No impact on Galigeo Platform, Cloud or On Premise:

  • LOG4J-1, version 1.2, may be affected by CVE-2021-4104 vulnerability only when, as mentionned in the note, it is specifically configured to use JMSAppender (Java Message Service  Appender), which is not the default.
  • As Galigeo LOG4J-1 configuration does not use at all JMSAppender, It is not impacted by the CVE-2021-4104 vulnerability. Galigeo LOG4J-1 configuration only uses RollingFileAppender (to write log messages in Galigeo log files).

December 2021 - LOG4J-2 vulnerability CVE-2021-44228 - No impact on Galigeo Platform, Cloud or On Premise:

  • As mentioned in note CVE-2021-44228 from cve.mitre.org this potential vulnerability does affect LOG4J-2 in versions from 2.0 to 2.14.1. It is fixed in log4j 2.15.0.
  • As Galigeo Platform does not use LOG4J-2 (but LOG4J-1, version 1.2), It is not impacted by the CVE-2021-44228 vulnerability.

Important notices for BI users

Important Notice 30 Sept. 2021 (updated on November 19, with 4.2 SP9 patch 4 notice):
SAP reported a critical issue affecting Custom Elements. See SAP Note 3103998.
In the BOE CMC, testing any Custom Element (Galigeo or other) always fails with the error: "Test has failed. [IllegalArgumentException] (Error: RWI 00011)". Therefore it is impossible to declare any Custom Element (Galigeo or other). The issue concerns the following patches releases:

  • BI Platform Servers 4.2 SP8 patches 10, 11 and 12. The issue has been fixed in SP8 Patch 12 Hotfix 1.
  • BI Platform Servers 4.2 SP9 patch 4. The issue has been fixed in SP9 Patch 5.
Therefore, to keep using Galigeo properly, we would advise to avoid upgrading to 4.2 SP8 Patches 10 to 12 or to SP9 Patch 4.

January 2021 - Galigeo G21, Beta support of BI 4.3 SP1:
The support of BI 4.3 is still in Beta because of limitations in SAP 4.3 APIs (vs. 4.2). We are collaborating with SAP to overcome those limitations.
Features not yet supported with BI 4.3 are:

  • Map To BI
  • Scheduling in WebI format (PDF format is OK)
  • Save As a WebI document with a map (copy / paste is OK)

Important Notice 29 Sept. 2020:
SAP reported a critical bug affecting Custom Elements. See SAP Note 2966271.
There is a rendering problem with an empty custom element, not showing any content (Galigeo or other) in the following patches releases:

  • BI Platform Servers 4.2 SP8 patches 3 to 5. The issue has been fixed in SP8 Patch 6.
  • BI Platform Servers 4.2 SP7 patches 12 and 13. The issue has been fixed in SP7 patch 13 Hotfix 1.
Therefore, to keep using Galigeo properly, we would advise to avoid upgrading to 4.2 SP8 patch 3 to 5 or to SP7 patch 12 and 13.

Important Notice 18 Dec. 2019:
For customers using Galigeo G19.5 or earlier
if you plan to update to SAP BI 4.2 SP6 patch11 (10/23/2019) or greater, SAP BI 4.2 SP7 patch5 (09/05/2019) or greater, SP8 (02/24/2020) or greater
Security rules to access the BOE APIs are continuously reinforced by SAP, which leads to changes starting in BI 4.2 SPs and/or patches released since 2019 September.
BOE APIs, used by Galigeo eXperience for WebI, are no more available by default in those SPs and/or patches and need a specific procedure to get activated.
The procedure is quite simple and does not need Tomcat service to be restarted. The necessary elements and the detailed procedure can be downloaded here.

Product documentation

Link to the documentation