HowTo: Change the Java Runtime Environment of Tomcat
When working with Debian the default repositories often only provide software versions of older age. That’s why as of today the Tomcat server will be only distributed with Java 7. And if you are required to use a more recent version of this programming language, you’ll need to tell Tomcat which binary to use.
For a recently upgraded Java project (spatial election) I needed Tomcat to run a newer version of the Java runtime environment and development kit. I used the following upgrade routine…
Java
- First of all, let’s check the currently installed version of Java in the execution path.
java -version
javac -version
- If it is not giving the desired version, check the available binaries.
ls -dl /usr/lib/jvm/java-*
- If this is not listing the desired version to run, a manual download and installation of the required binary is needed, e.g. Oracle Java 8 for Debian/Ubuntu.
echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" > /etc/apt/sources.list.d/java-8-debian.list
echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" >> /etc/apt/sources.list.d/java-8-debian.list
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EEA14886
apt-get update
apt-get install oracle-java8-installer
Usually the repository packages hosted on the Canonical launchpad platform would not support Debian hosts, because they are built against Ubuntu libraries. But this package distributed by the WebUpd8 team only contains an installer, making it conveniently work on Debian too.
Tomcat
- Check the active Java runtime environment on the Tomcat server manager status page:
http://localhost:8080/manager/status
(zoom)
- If the displayed version does not suffice, the following changes are needed in
/etc/default/tomcat7
to set a different binary path.
vim /etc/default/tomcat7
#JAVA_HOME=/usr/lib/jvm/openjdk-6-jdk
JAVA_HOME=/usr/lib/jvm/java-8-oracle
- Restart the Tomcat server
service tomcat7 restart
- A follow up check on the Tomcat server manager status page should finally yield the correct JVM version.
(zoom)