This guide describes how to install PGX as a remote, shared-memory server. PGX 21.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
Two-way SSL/TLS is enabled by default. See the tutorial on configuring TLS/SSL certificates for details.
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.
See the PGX shared memory server configuration page for configuration options.
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
It might increase security risks on your system.
7007 is the port the PGX web server is listening on. You can change the port in the
PGX server configuration.
Connect to the PGX cluster using the PGX Shell. For example,
cd $PGX_HOME ./bin/pgx-jshell --base_url=http://hostname:7007
hostname is the host name of the machine running the server, and
7007 is the port the PGX web server is listening on.