Administration Tools

GraphDB can be administered through the Workbench, the JMX interface, or programmatically.

Workbench

The Workbench is the web-based administration interface to GraphDB. It lets you administer GraphDB, as well as load, explore, manage, query and export data. To use it, start GraphDB in a workbench mode and open http://localhost:7200/ in your browser.

JMX interface

GraphDB offers a number of management and control functions using the JMX interface. GraphDB uses this interface to provide information about its internal state and behavior, including trend information, as well as operations for intervening in certain database activities.

After initialization, GraphDB registers a number of JMX MBeans for each repository, each providing a different set of information and functions for specific features.

Configuring the JMX endpoint

Configure the JMX endpoint using special system properties when starting the Java virtual machine (JVM), in which GraphDB is running. For example, the following command line parameters set the JMX server endpoint to listen on port 2815 without authentication and a secure socket layer:

  • Linux/Mac - add the following configuration in <graphdb_distribution>/bin/graphdb.in.sh.
JAVA_OPTS_ARRAY+=("-Djava.rmi.server.hostname=`hostname`")
JAVA_OPTS_ARRAY+=("-Dcom.sun.management.jmxremote")
JAVA_OPTS_ARRAY+=("-Dcom.sun.management.jmxremote.port=2815")
JAVA_OPTS_ARRAY+=("-Dcom.sun.management.jmxremote.ssl=false")
JAVA_OPTS_ARRAY+=("-Dcom.sun.management.jmxremote.authenticate=false")
  • Windows - add the following configuration in <graphdb_distribution>/bin/graphdb.in.cmd.
set JAVA_OPTS=%JAVA_OPTS% -Djava.rmi.server.hostname=`hostname`
set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote
set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=2815
set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.ssl=false
set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.authenticate=false

Once GraphDB is loaded, use any compliant JMX client, e.g., JConsole that is part of the Java development kit, to access the JMX interface on the configured port.