Configuring environment variables for Apache Tomcat

1min
Apache Tomcat relies on several environment variables to function correctly. Select one of the following operating systems to set the required environment variables:
Linux
Windows
1
Determine the installation path of Oracle Java: 
Find the path where Oracle Java is installed, such as /usr/lib/jvm/. Use the following command to list the installed JDKs: 
Shell
ls /usr/lib/jvm/
ls /usr/lib/jvm/
﻿
For example, if you installed Oracle Java 11, the path is likely: /usr/lib/jvm/jdk-11-oracle-x64.
2
Determine the installation path of Tomcat:
You can use the find command to locate the Tomcat installation directory:
Shell
sudo find / -name "catalina.sh"
sudo find / -name "catalina.sh"
﻿
catalina.sh is stored in the bin directory of the Tomcat installation. The directory containing catalina.sh is the CATALINA_HOME. 
3
Edit the profile file: 
Open a terminal and use a text editor to edit the /etc/profile file, which the system uses when users log in. You might need superuser privileges to edit this file. 
Shell
sudo nano /etc/profile
sudo nano /etc/profile
﻿
4
Add the environment variables and update PATH:
Add the following lines to the end of the /etc/profile file, replacing the path with the actual path to your Oracle Java installation: 
Text
export JAVA_HOME=/path/to/jdk
export CATALINA_HOME=/path/to/tomcat
export LD_LIBRARY_PATH=/usr/local/bin/fxpkcs11/libfxpkcs11.so 
export FXPKCS11_CFG=/etc/fxpkcs11.cfg
export PATH=$PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin
export JAVA_HOME=/path/to/jdk
export CATALINA_HOME=/path/to/tomcat
export LD_LIBRARY_PATH=/usr/local/bin/fxpkcs11/libfxpkcs11.so 
export FXPKCS11_CFG=/etc/fxpkcs11.cfg
export PATH=$PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin
﻿
5
Apply the changes: 
After saving the file, apply the changes by sourcing the profile file: 
Shell
source /etc/profile
source /etc/profile
﻿
6
Verify the configuration: 
To ensure that the environment variables are set correctly and the PATH is updated, check their values with the following commands: 
Shell
echo $JAVA_HOME
echo $CATALINA_HOME
echo $LD_LIBRARY_PATH
echo $FXPKCS11_CFG
echo $PATH
echo $JAVA_HOME
echo $CATALINA_HOME
echo $LD_LIBRARY_PATH
echo $FXPKCS11_CFG
echo $PATH
﻿
You should see the individual paths set for JAVA_HOME and CATALINA_HOME, as well as their inclusion in the PATH. 
1
Determine the installation path of Oracle Java: 
Ensure Oracle Java is installed on your system. Note the installation path, typically something similar to C:\Program Files\Java\jdk-11. 
2
Determine the installation path of Tomcat: 
Ensure Apache Tomcat is installed on your system. Note the installation path. Common default installation paths include C:\Program Files\Apache Software Foundation\Tomcat or C:\Tomcat. 
3
Open System Properties: 
Select the Win + Pause/Break keys to open the System Properties window, or right-click This PC (or My Computer) and select Properties. 
Go to Advanced System Settings on the left sidebar. 
4
Open Environment Variables: 
In the System Properties window, select [ Environment Variables ] near the bottom of the window. 
5
Create new system variables: 
In the Environment Variables window, under the System Variables section, select [ New ]. 
For JAVA_HOME: 
Variable name: JAVA_HOME 
Variable value: The path to your JDK installation (such as C:\Program Files\Java\jdk-11)
For CATALINA_HOME: 
Variable name: CATALINA_HOME 
Variable value: The path to your Tomcat installation (such as C:\Program Files\Apache Software Foundation\Tomcat or C:\Tomcat) 
For LD_LIBRARY_PATH:
Variable name: LD_LIBRARY_PATH
Variable value: The path to your FXPKCS11 library (such as C:\Program Files\Futurex\fxpkcs11\fxpkcs11.dll) 
For FXPKCS11_CFG:
Variable name: FXPKCS11_CFG
Variable value: The path to your FXPKCS11 configuration file (such as C:\Program Files\Futurex\fxpkcs11\fxpkcs11.cfg) 
6
Update the PATH variable: 
In the System variables section, find and select the Path variable, and select [ Edit ]. 
Add new entries: 
Select [ New ] and add %JAVA_HOME%\bin 
Select [ New ] and add %CATALINA_HOME%\bin 
7
Apply the changes: 
Select [ OK ] on each dialog box to apply the changes and exit the dialog boxes.
8
Verify the configuration:
Open a new Command Prompt window (press Win + R, type cmd, and select the Enter key). 
Enter echo %JAVA_HOME% and select the Enter key. You should see the path to your JDK installation. 
Enter echo %CATALINA_HOME% and select the Enter key. You should see the path to your Tomcat installation.
Enter echo %LD_LIBRARY_PATH% and select the Enter key. You should see the path to the Futurex PKCS #11 module. 
Enter echo %FXPKCS11_CFG% and select the Enter key. You should see the path to the Futurex PKCS #11 configuration file. 
Enter echo %PATH% and select the Enter key. You should see the JAVA_HOME and CATALINA_HOME environment variables included in the PATH. 
Enter java -version to confirm that the system recognizes the Java installation. 
﻿
Updated 01 Oct 2024
Did this page help you?
Install Futurex Command Line Interface (FXCLI)
Configure SunPKCS11 to use the Futurex PKCS #11 module