Difference between revisions of "Tomcat setenv file"
(→Linux) |
(→CLASSPATH Settings for Oracle) |
||
Line 20: | Line 20: | ||
The CLASSPATH environment variable tells the Java Virtual Machine where to look for additional classes. | The CLASSPATH environment variable tells the Java Virtual Machine where to look for additional classes. | ||
− | If you want to use an Oracle database, you must download the JDBC driver directly from Oracle and reference the location of the ''jar'' by setting the CLASSPATH variable as illustrated in the | + | If you want to use an Oracle database, you must download the JDBC driver directly from Oracle and reference the location of the ''jar'' by setting the CLASSPATH variable as illustrated in the example. |
+ | |||
+ | CLASSPATH=/home/oracle/jdbc/ojdbc8.jar | ||
==CLASSPATH Settings for MySQL== | ==CLASSPATH Settings for MySQL== |
Revision as of 01:15, 6 October 2022
Configuration for Fusion Metadata Registry is principally set by creating a setenv.bat or setenv.sh script in the Tomcat bin directory.
Below are examples for Windows and Linux.
Contents
Windows
tomcat\bin\setenv.bat
set "JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx4G -server -DRegistryProperties=file:///C:/Tomcats/Environments/fusion_registry.properties"
set CLASSPATH=c:\oracle\ojdbc8.jar
Linux
tomcat/bin/setenv.sh
#!/bin/sh
export JAVA_OPTS="-Xms128m -Xmx4G -server -DRegistryProperties=file:\\opt\tomcats\environments\fusion_registry.properties"
export CLASSPATH="/opt/oracle/ojdbc8.jar"
CLASSPATH Settings for Oracle
The CLASSPATH environment variable tells the Java Virtual Machine where to look for additional classes.
If you want to use an Oracle database, you must download the JDBC driver directly from Oracle and reference the location of the jar by setting the CLASSPATH variable as illustrated in the example.
CLASSPATH=/home/oracle/jdbc/ojdbc8.jar
CLASSPATH Settings for MySQL
The variable shaown the location of the MySql connector jar file.
set CLASSPATH=C:\SQL_Connector\mysql-connector-java-8.0.30\mysql-connector-java-8.0.30.jar
JAVA_OPTS Configuration Parameters
JAVA_OPTS parameters configure the Java virtual machine, and also allow system parameters to be passed to the Fusion Metadata Registry application to alter its behaviour.
Parameter | Purpose | Example |
---|---|---|
-Xmx | Sets the maximum amount of memory that can be allocated to the Java heap. This should be a minimum of 4GB and ideally about 75% of available memory on the machine. Setting too low may result in Java 'out of memory' errors. | -Xmx4GB sets the maximum heap size to 4GB |
-Xms | Sets the initial amount of memory to be allocated to the Java heap. When running in production, there may be a performance benefit to setting this to the same value as -Xmx which avoids the need to grow the heap as memory demand grows. | -Xms128m sets the initial heap to 128MB |
-server | Improves performance by optimising the way the Java Virtual Machine works. | |
-DRegistryProperties | System Property: Sets a specific path for the Fusion Registry properties file. If not set, the default location is used | -DRegistryProperties=file:\\opt\tomcats\environments\fusion_registry.properties In Linux, sets the properties file location to the path specified. |
-Djson.legacy.enabled=true or -Djson.legacy.enabled=false (default) |
System Property: Sets whether the Fusion Registry instance uses the legacy Metadata Technology JSON dialect, or the official SDMX-JSON version 1.0 Structure and Data Exchange format. By default, or if the property is explicity set to false, JSON returned will conform to the official SDMX-JSON specification when:
If the property to true, JSON returned will conform to Metadata Technology's legacy JSON format for structures and data. Use this for backward compatibility where existing client-side applications rely on the legacy JSON format. |
-Djson.legacy.enabled=true Force Fusion Registry to produce and accept structures and data in the legacy Metadata Technology dialect |
-DLicenseFile= (Data Essentials only) | Sets the location of the License file and the Public key which is used in Data Essentials. | -DLicenseFile=file:///C:/tomcats/RegistryProperties/8080_LICENSE/fusionLicense.fl |