Tomcat 7 installation instructions - ndexbio/ndex-rest GitHub Wiki

This document has been superseded by: Installing Tomcat 10


This document describes the installation of Tomcat 7 into the default NDEx installation directory on a unix system.

Developers may wish to use a local NDEx installation for testing and debugging. For that purpose, Tomcat must be linked to the development environment. See Developers: Tomcat 7 and Eclipse for notes on configuring Eclipse to use a local instance of Tomcat 7 to run the NDEx REST server.


Download the tomcat 7 release from:

Copy the ZIP archive to /opt/ndex

Use tar to extract it:

sudo tar -zxvf apache-tomcat-7.0.55.tar.gz 

sudo chown -R <username> apache-tomcat-7.0.55

For convenience, setup a symbolic link to the extracted directory

sudo ln -s apache-tomcat-7.0.55 tomcat

Given that you have extracted the files as the ndex user, tomcat should be ready to run. Test it with:

> cd /opt/ndex/tomcat/bin
> bash run

Check the output to make sure that no errors are reported for:

  • Unable to find Java
    • check $JAVA_HOME
  • Unable to access files
    • check that the tar process worked
    • check file permissions. Make sure you are executing as an appropriate user, such as the owner of the ndex directory.

You should then be able to point your browser to localhost:8080 - Tomcat's default port is 8080 - and see the Tomcat welcome page.

> curl localhost:8080 | more

You can then control-c the catalina process to kill it. We will start it again after the WAR file containing the NDEx REST server application is installed.

⚠️ ** Fallback** ⚠️