Difference between revisions of "Install Apache Tomcat"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Changing the Tomcat port number)
Line 8: Line 8:
  
 
Choose either Tomcat 8.5 or 9.0.
 
Choose either Tomcat 8.5 or 9.0.
 +
 +
=Set the Java runtime options=
 +
Tomcat needs to be configured to set certain Java options when it starts. The most important is to set the amount of memory that the Fusion Registry service will be allocated. The following explains how to set the minimim options to allocate Fusion Registry 4GB of memory.
 +
====Windows====
 +
* Go to tomcat\bin folder
 +
* Create a file called 'setenv.bat' with the following content
 +
set "JAVA_OPTS=-Xmx4G"
 +
====Linux====
 +
* Go to the tomcat/bin folder
 +
* Create a file called 'setenv.sh' with the following content
 +
export JAVA_OPTS="-Xmx4G"
  
 
=Changing the Tomcat port number=
 
=Changing the Tomcat port number=
Line 15: Line 26:
 
You will need to choose a different port if other software on the machine is already using port 8080.
 
You will need to choose a different port if other software on the machine is already using port 8080.
  
* Go to tomcat>conf folder
+
* Go to tomcat/conf folder
 
* Edit server.xml
 
* Edit server.xml
 
* Search "Connector port"
 
* Search "Connector port"
 
* Replace "8080" by your port number
 
* Replace "8080" by your port number
 
* Restart tomcat server.
 
* Restart tomcat server.

Revision as of 09:37, 18 September 2020

Overview

Fusion Registry Core, Fusion Edge Server and other modules are Java applications which run under a Java Web Application Server.

A number of different open source and commerical options are available, but this guide explains how to install the free to use Apache Tomcat.

Installing the Apache Tomcat

Download and install Apache Tomcat.

Choose either Tomcat 8.5 or 9.0.

Set the Java runtime options

Tomcat needs to be configured to set certain Java options when it starts. The most important is to set the amount of memory that the Fusion Registry service will be allocated. The following explains how to set the minimim options to allocate Fusion Registry 4GB of memory.

Windows

  • Go to tomcat\bin folder
  • Create a file called 'setenv.bat' with the following content
set "JAVA_OPTS=-Xmx4G"

Linux

  • Go to the tomcat/bin folder
  • Create a file called 'setenv.sh' with the following content
export JAVA_OPTS="-Xmx4G"

Changing the Tomcat port number

Tomcat's default configuration is to serve its applications on port 8080. That means, by default, the Fusion Registry user interface will be available on the following URL:
http://localhost:8080/FusionRegistry

You will need to choose a different port if other software on the machine is already using port 8080.

  • Go to tomcat/conf folder
  • Edit server.xml
  • Search "Connector port"
  • Replace "8080" by your port number
  • Restart tomcat server.