Skip to content

New Galigeo installation

advice If Galigeo is already installed on your server, go the section Update installation

Content of the download package

  • Galigeo.war: The Java web application
  • Documentation: Directory containing the PDF version of this installation guide

Deploy Galigeo.war on Tomcat

First make sure you have Tomcat server installed on your server.

note If SAP BI Platform is installed on the server, Galigeo can be deployed in the embeded SAP Tomcat.

  1. Stop the Tomcat service
  2. Copy Galigeo.war to /webapps
  3. Start the Tomcat service. A folder /webapps/Galigeo will be created automatically

note If Galigeo is not deployed automatically, check that unpackWARs et autoDeploy Tomcat parameters from "<Host .." tag are set to true in "/conf/server.xml" file.

Tomcat configuration

advice SAP BI Platform users, you can skip this section.

For configuring the memory, please go to the section Tomcat memory configuration

UTF-8 encoding

To display and print correctly special characters, you need to apply the following settings. Once changes are done, you need to restart Tomcat.

Add parameter -Dfile.encoding=UTF-8

If Tomcat is installed as a service

  • Open the Tomcat configuration console,
  • Go to the tab "Java",
  • In the area « Java Options » add the following lines: -Dfile.encoding=UTF-8

If Tomcat starts as a script "startup.bat"

  • Edit the file <GGO_TOMCAT_HOME>/bin/catalina.bat
  • At the beginning of the script, add the line: set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8

Add parameter URIEncoding="UTF-8"

  • Edit file <GGO_TOMCAT_HOME>/conf/server.xml,
  • Go to tag <Connector port="8080".. corresponding to Tomcat port (by default 8080), and modify or add the parameter URIEncoding="UTF-8" Example: <Connector port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>

Finalize the installation

  • The following operation takes place only once. This operation creates a folder that will be used to store the Galigeo resources. Galigeo Tomcat user needs to have read/write access to folder.
  • In a browser, launch the following URL: http(s):// :/Galigeo/
  • Fill the text area with a valid path to folder at Galigeo Server, outside Tomcat directory. If the folder does not exist, it is created. Example: C:\Program Files\Galigeo
  • Click on [Continue]

Cluster deployment

You can have multiple instances of Galigeo running behind a load balancer. However, make sure that the directory refers to the same location for each instance.

This is usually done using a mount point (NFS, Samba) accross the existing instances.