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
G21SP1Jan 2021-
G20SP3May 2020-
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 notice for BI users

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. SAP announced it will be corrected in the upcoming SP8 patch 6.
  • BI Platform Servers 4.2 SP7 patches 12 and 13. This may be corrected in a future Hotfix but we still expect confirmation from SAP.
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