Difference between revisions of "Install Apache Tomcat"
(→Changing the Tomcat port number) |
|||
(20 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | [[Category:Installation_and_Configuration]] | ||
+ | [[Category:How_To]] | ||
+ | [[Category:How_To V11]] | ||
+ | =Pre-requisite= | ||
+ | |||
+ | In order to install Apache Tomcat you need to Install a Java Runtime Environment [[Install Java Runtime Environment|More]] | ||
+ | |||
=Overview= | =Overview= | ||
− | Fusion Registry | + | Fusion Meta Data Registry is a Java application which run under a Java Web Application Server. |
− | A number of different open source and | + | A number of different open source and commercial options are available, but this guide explains how to install the free to use Apache Tomcat. |
=Installing the Apache Tomcat= | =Installing the Apache Tomcat= | ||
Line 9: | Line 16: | ||
Choose either Tomcat 8.5 or 9.0. | Choose either Tomcat 8.5 or 9.0. | ||
− | =Changing the Tomcat port number= | + | =Set the Java runtime options= |
− | Tomcat's default configuration is to serve | + | 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. |
− | <nowiki>http://localhost:8080/FusionRegistry</nowiki> | + | ====Windows==== |
+ | * Go to <code>tomcat\bin</code> folder | ||
+ | * Create a file called <code>setenv.bat</code> with the following content | ||
+ | set "JAVA_OPTS=-Xmx4G" | ||
+ | |||
+ | ====Linux==== | ||
+ | * Go to the <code>tomcat/bin</code> folder | ||
+ | * 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" | ||
+ | |||
+ | ====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:<br> | ||
+ | <nowiki>http://localhost:8080/FusionRegistry</nowiki> | ||
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> | + | * 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. | ||
+ | |||
+ | =New Installations of FMR= | ||
+ | If you are installing a new installation of Fusion Metadata Registry, having installed Apache Tomcat the next step is to install and configure a MySQL database [[Install MySQL|More]] |
Latest revision as of 04:56, 30 March 2024
Contents
Pre-requisite
In order to install Apache Tomcat you need to Install a Java Runtime Environment More
Overview
Fusion Meta Data Registry is a Java application which run under a Java Web Application Server.
A number of different open source and commercial 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. A minimum of 4GB is recommended and the following explains how to do that.
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 (it does not need to have 'x' executable permissions, but must be readable 'r')
export JAVA_OPTS="-Xmx4G"
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/conf
folder - Edit
server.xml
- Search "Connector port"
- Replace "8080" by your port number (8081 for instance)
- Restart tomcat server.
New Installations of FMR
If you are installing a new installation of Fusion Metadata Registry, having installed Apache Tomcat the next step is to install and configure a MySQL database More