Install and Configure PoolParty GraphViews

We explain here how to install and configure PoolParty GraphViews with PoolParty.


  • Java 11 is installed (OpenJDK or Oracle Java).
  • PoolParty is running on the server configured in (pp.url).
  • A user with username and password is configured in (pp.username and pp.password) and it exists as a PoolParty user.
  • The PoolParty instance has the user role API admin setup.
  • At least one group is configured in and at least, one project is assigned to this group.

Installation Procedure

To install PoolParty GraphViews:

Configure the Application

Configure based on the PoolParty server:

pp.groups=Public # the groups for which projects will be shown in GraphViews
pp.username=graphviews # the username of the API admin user configured in PoolParty pp.password=poolparty # the password of the API admin user configured in PoolParty pp.url=http://localhost:8081 # the url of the server where PoolParty is running

If PoolParty GraphViews is deployed on the same Tomcat server as PoolParty, the URL provided should be the localhost. However, an external URL where PoolParty is running can also be provided.

The name of the application is configured by the property server.servlet.context-path in


To allow the Tomcat server to handle the Javascript files with UTF-8 encoding the following lines in are necessary.

# Charset of HTTP requests and responses. Added to the "Content-Type" header if not set explicitly.
# Enable http encoding support.
# Force the encoding to the configured charset on HTTP requests and responses.

The following properties define the logging level as well as the file where the logs are written:


Package and Install in Tomcat

To package and install PoolParty GraphViews in Tomcat:

  1. Download the GraphViews.war (external link) file,
  2. Copy it to the folder <PPAppDir>/tomcat/webapps (or if PoolParty is not installed to tomcat/webapps),
  3. Restart PoolParty (if PoolParty installed).

Overwrite the Default Properties

In order to overwrite the default properties:

  1. Copy to the corresponding config folder (e.g. /opt/poolparty/tomcat/conf).
  2. Edit the properties accordingly (see Application Configuration). This file will overwrite the properties of the .war application.
  3. Set a spring_config_location environment variable pointing to the folder that contains your file. In the case of Tomcat you can do this by adding the following line to your <TOMCAT_HOME>/bin/ file (create the file if missing):

export spring_config_location=<TOMCAT_HOME>/conf/