- PoolParty Semantic Suite Documentation
- PoolParty GraphViews
- Install and Configure PoolParty GraphViews
Install and Configure PoolParty GraphViews
21/08/2025
This guide explains how to install and configure GraphViews, a tool that helps you visualize your PoolParty taxonomies.
To deploy GraphViews, ensure you meet the following prerequisites:
Java 21 or higher must be installed on both the build machine and the server.
A PoolParty server must be running and accessible from the server where GraphViews will be hosted.
A dedicated PoolParty user for GraphViews must exist. This user must meet the following criteria:
The user must have an API admin role.
The user must be assigned to at least one PoolParty group with at least one project assigned to this group.
GraphViews can be configured by creating a graphviews.properties
file. The application checks for this file in the following locations:
The same directory as the
.jar
file.A subdirectory named
config
within the same directory as the.jar
file.A directory or file specified by the
spring.config.additional-location
startup option.
The following properties must be configured in your graphviews.properties
file:
pp.username
: The username of the API admin user.pp.password
: The password for the API admin user.pp.url
: The URL of the PoolParty server. Usehttp://localhost:8081
if GraphViews is on the same server as PoolParty.
You can also configure optional properties to customize the application's behavior:
graphviews.languages.allowed
: A comma-separated list specifying allowed languages (for example:en, de
).logging.level.root
: Sets the logging level (default isINFO
).logging.file
: Specifies the path for log file output (logs are written to the console by default).server.port
: The port number for GraphViews (defaults to8080
).
Note
You can find a complete list of configurable properties in the Spring Boot Common Application Properties documentation.
Instead of a properties file, you can use environment variables to configure GraphViews. These are the environment variables corresponding to the properties mentioned above:
Property | Environment Variable |
---|---|
|
|
|
|
|
|
|
|
Acquire the GraphViews
.jar
file from your Graphwise representative.Move the
.jar
file to a location of your choice on the server.Create the
graphviews.properties
file as described in the Application Configuration section.Set up a server daemon (e.g., a
systemd
service) to run the.jar
file.