PGX 21.1.1

Deploying PGX into Tomcat

This guide will show you step by step how to deploy PGX as a web application with Apache Tomcat. If you want to use Oracle Weblogic instead, check out the corresponding guide.

For evaluation only

Below steps are meant for testing out PGX only. For any serious deployment, you should configure Tomcat to enforce proper authentication and authorization, store the credentials securely and only allow connections over HTTPS (see Tomcat's TLS/SSL howto)

The following steps explain how to install Tomcat 7 and deploy PGX to Tomcat.

  1. Download the latest Tomcat 7 tarball from Tomcat 7 Software Downloads, unpack the tarball into a directory of your choice, and set the CATALINE_HOME environment variable to point to this directory:

    tar xvf apache-tomcat-7.0.65.tar.gz -C /opt
    export CATALINA_HOME=/opt/apache-tomcat-7.0.65
  2. Copy PGX's WAR file into Tomcat's webapps directory:

    cd $PGX_HOME
    cp lib/server/pgx-webapp-21.1.1.war $CATALINA_HOME/webapps/pgx.war
  3. Start Tomcat (make sure port 8080 is not already in use):

  4. Verify that PGX is running:

    cd $PGX_HOME
    ./bin/pgx-jshell -b http://localhost:8080/pgx -u scott -p tiger

You have successfully deployed PGX as a web application into Tomcat. Please refer to the Tomcat documentation for further information about Tomcat and the various configuration options it provides.