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.
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
Copy PGX's WAR file into Tomcat's
cd $PGX_HOME cp lib/server/pgx-webapp-21.1.1.war $CATALINA_HOME/webapps/pgx.war
Start Tomcat (make sure port
8080 is not already in use):
cd $CATALINA_HOME ./bin/startup.sh
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.