PGX 20.1.1
Documentation

Shared Memory Server Installation

This guide describes how to install PGX as a remote, shared-memory server. PGX 20.1.1 bundles a pre-configured version of Apache Tomcat which allows you to start the PGX shared memory server in a few simple steps.

Deploying the web archive directly

If you prefer your own Tomcat installation or other web containers, you can also deploy the PGX .war file yourself. We provide deployment instructions for Tomcat and Weblogic.

Prerequisite

Make sure you install PGX on the machine, by following the system requirements and the basic installation. No additional steps are required.

Configure SSL/TLS Security Certificates

Two-way SSL/TLS is enabled by default. See the tutorial on configuring TLS/SSL certificates for details.

Disabling SSL/TLS

You need to properly configure SSL/TLS to start the server (See the web server configuration page for SSL/TLS options). Even though it is possible to turn SSL/TLS off, we strongly recommend to leave SSL/TLS turned on for any production deployment.

Configuration

See the PGX shared memory server configuration page for configuration options.

Start the Shared-Memory Server

To start the PGX shared memory server, run

cd $PGX_HOME
./bin/start-server

If the server started successfully, you will see something like the following printed on the console:

INFO: Starting ProtocolHandler ["http-nio-7007"]

Do not run with admin permissions

We strongly recommend not to execute the PGX server with admin permissions (e.g., as the root user). It might increase security risks on your system.

Where 7007 is the port the PGX web server is listening on. You can change the port in the PGX server configuration.

Test the Connection

Connect to the PGX cluster using the PGX Shell. For example,

cd $PGX_HOME
./bin/pgx-jshell --base_url=http://hostname:7007

Where hostname is the host name of the machine running the server, and 7007 is the port the PGX web server is listening on.