PGX 1.2.0


The following instructions will allow you to get started quickly with PGX and to analyze graphs directly on your local machine. More advanced usage models, which include running PGX as a server, can be found at the end of this section.

System Requirements

  • Java SE 7 Development Kit (JDK7)
  • [Optional] PGX also supports dynamic compilation of Green-Marl code at runtime. To use that feature, you'll need a Linux x86 (kernel >= 2.6) or Mac OS X operating system with clang installed. Examples of such systems include, but are not limited to:
    • Oracle Linux Server (x86) Release 6.5
    • Ubuntu (x86) LTS
    • Ubuntu (x86) 14.04.1 LTS
    • Mint (x86) 17.1
    • ArchLinux (x86) 2011.08.19
    • Mac OS X (x86) 10.10.5

Basic Installation

  1. Install the Oracle JDK 7, if it is not already on your system. Refer to your system administrator, or follow these instructions to install:

    • Download Java SE 7 Development Kit (JDK7) from here .
    • Follow the installation instructions located above.
    • Make sure the JAVA_HOME environment variable points to the JDK7 home directory, e.g. export JAVA_HOME=/usr/lib/jvm/java-7-oracle.
  2. Download the PGX package for your platform from our OTN download page.

  3. Unpack the downloaded zip file into a directory of your choice. For example, unzip -d /opt.

  4. cd into the installation directory. Verify PGX boots up by starting the PGX Shell:

    cd $PGX_HOME

See our troubleshooting section if you encounter problems.

Directory Structure

  • bin - PGX shell executable
  • conf - PGX shell configuration files
  • doc - Documentation
  • examples - Example code (Java, Green-Marl) and example graph data
  • lib - PGX libraries
  • third-party - third party dependencies. Refer to THIRDPARTYLICENSESREADME for license details.

Advanced use cases

PGX as Web Application

You can also run PGX inside of a web-application. PGX ships with a WAR-file which can be deployed directly into your favorite servlet container:

Deploy PGX into Weblogic Deploy PGX into Jetty Deploy PGX into Tomcat

PGX Client

Do you already have a PGX server running? Refer to this tutorial to learn how to connect to a server:

Connect to a running PGX server

PGX on Hadoop

PGX also supports HDFS and runs on YARN. Details for these can be found in these tutorials:

Load from and store to HDFS Run PGX as YARN application