Difference between revisions of "Install Apache Tomcat"
(→Linux) |
(→Installing the Apache Tomcat) |
||
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | [[Category:How_To]] | ||
| + | [[Category:Fusion Registry Install]] | ||
=Overview= | =Overview= | ||
Fusion Registry Core, Fusion Edge Server and other modules are Java applications which run under a Java Web Application Server. | Fusion Registry Core, Fusion Edge Server and other modules are Java applications which run under a Java Web Application Server. | ||
| Line 7: | Line 9: | ||
Download and install [http://tomcat.apache.org/ Apache Tomcat]. | Download and install [http://tomcat.apache.org/ Apache Tomcat]. | ||
| − | Choose either Tomcat 8.5 or 9.0. | + | Choose either Tomcat 8.5 or 9.0. The Fusion Registry does not work with version 10 or later of Apache Tomcat. |
=Set the Java runtime options= | =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. A minimum of 4GB is recommended and the following explains how to do that. | 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. A minimum of 4GB is recommended and the following explains how to do that. | ||
| + | |||
====Windows==== | ====Windows==== | ||
* Go to <code>tomcat\bin</code> folder | * Go to <code>tomcat\bin</code> folder | ||
| Line 18: | Line 22: | ||
====Linux==== | ====Linux==== | ||
* Go to the <code>tomcat/bin</code> folder | * Go to the <code>tomcat/bin</code> folder | ||
| − | * Create a file called <code>setenv.sh</code> with the following content | + | * Create a file called <code>setenv.sh</code> with the following content (it does not need to have 'x' executable permissions, but must be readable 'r') |
export JAVA_OPTS="-Xmx4G" | export JAVA_OPTS="-Xmx4G" | ||
| + | |||
| + | ==== GMT ==== | ||
| + | It is also reccomended to set the timezone to GMT | ||
| + | |||
| + | -Duser.timezone=GMT | ||
| + | |||
| + | e.g. | ||
| + | |||
| + | set "JAVA_OPTS=-Xmx4G -Duser.timezone=GMT" | ||
====Special purpose Java runtime options==== | ====Special purpose Java runtime options==== | ||
| − | + | Other Java runtime options that can be set for special purposes and are explained in [[Tomcat setenv file]] article. | |
=Changing the Tomcat port number (optional)= | =Changing the Tomcat port number (optional)= | ||
| Line 30: | Line 43: | ||
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 <code>tomcat/conf</code> folder |
| − | * Edit server.xml | + | * Edit <code>server.xml</code> |
* Search "Connector port" | * Search "Connector port" | ||
| − | * Replace "8080" by your port number | + | * Replace "8080" by your port number (8081 for instance) |
* Restart tomcat server. | * Restart tomcat server. | ||
Latest revision as of 05:55, 24 January 2024
Contents
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. The Fusion Registry does not work with version 10 or later of Apache Tomcat.
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. A minimum of 4GB is recommended and the following explains how to do that.
Windows
- Go to
tomcat\binfolder - Create a file called
setenv.batwith the following content
set "JAVA_OPTS=-Xmx4G"
Linux
- Go to the
tomcat/binfolder - Create a file called
setenv.shwith the following content (it does not need to have 'x' executable permissions, but must be readable 'r')
export JAVA_OPTS="-Xmx4G"
GMT
It is also reccomended to set the timezone to GMT
-Duser.timezone=GMT
e.g.
set "JAVA_OPTS=-Xmx4G -Duser.timezone=GMT"
Special purpose Java runtime options
Other Java runtime options that can be set for special purposes and are explained in Tomcat setenv file article.
Changing the Tomcat port number (optional)
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/conffolder - Edit
server.xml - Search "Connector port"
- Replace "8080" by your port number (8081 for instance)
- Restart tomcat server.
