Graphdb Free Documentation Release 8.3
Total Page:16
File Type:pdf, Size:1020Kb
GraphDB Free Documentation Release 8.3 Ontotext Oct 16, 2017 CONTENTS 1 General 1 1.1 About GraphDB...........................................2 1.2 Architecture & components.....................................2 1.2.1 Architecture.........................................2 1.2.1.1 RDF4J.......................................3 1.2.1.2 The Sail API....................................4 1.2.2 Components.........................................4 1.2.2.1 Engine.......................................4 1.2.2.2 Connectors.....................................5 1.2.2.3 Workbench.....................................5 1.3 GraphDB Free............................................5 1.3.1 Comparison of GraphDB Free and GraphDB SE......................6 1.4 Connectors..............................................6 1.5 Workbench..............................................6 2 Quick start guide 9 2.1 Run GraphDB as a desktop installation...............................9 2.1.1 On Windows........................................ 10 2.1.2 On Mac OS......................................... 10 2.1.3 On Linux.......................................... 10 2.1.4 Configuring GraphDB................................... 10 2.1.5 Stopping GraphDB..................................... 11 2.2 Run GraphDB as a stand-alone server................................ 11 2.2.1 Running GraphDB..................................... 11 2.2.1.1 Options...................................... 11 2.2.2 Configuring GraphDB................................... 12 2.2.2.1 Paths and network settings............................ 12 2.2.2.2 Java virtual machine settings........................... 12 2.2.3 Stopping the database.................................... 12 2.3 Set up your license.......................................... 12 2.4 Create a repository.......................................... 12 2.5 Load your data............................................ 13 2.5.1 Load data through the GraphDB Workbench........................ 13 2.5.2 Load data through SPARQL or RDF4J API........................ 15 2.5.3 Load data through the GraphDB LoadRDF tool...................... 15 2.6 Explore your data and class relationships.............................. 15 2.6.1 Explore instances...................................... 15 2.6.2 Create your own visual graph................................ 18 2.6.3 Class hierarchy....................................... 19 2.6.4 Domain-Range graph.................................... 21 2.6.5 Class relationships..................................... 23 2.7 Query your data........................................... 26 2.7.1 Query data through the Workbench............................. 26 2.7.2 Query data programmatically................................ 30 i 2.8 Additional resources......................................... 30 3 Installation 33 3.1 Requirements............................................. 33 3.1.1 Minimum.......................................... 33 3.1.2 Hardware sizing....................................... 33 3.1.3 Licensing.......................................... 34 3.2 Running GraphDB.......................................... 34 3.2.1 Run GraphDB as a desktop installation........................... 34 3.2.1.1 On Windows.................................... 34 3.2.1.2 On Mac OS.................................... 35 3.2.1.3 On Linux...................................... 35 3.2.1.4 Configuring GraphDB............................... 35 3.2.1.5 Stopping GraphDB................................ 36 3.2.2 Run GraphDB as a stand-alone server........................... 36 3.2.2.1 Running GraphDB................................. 36 3.2.2.2 Configuring GraphDB............................... 36 3.2.2.3 Stopping the database............................... 37 3.3 Configuring GraphDB........................................ 37 3.3.1 Directories......................................... 37 3.3.1.1 GraphDB Home.................................. 37 3.3.1.2 Checking the configured directories........................ 39 3.3.2 Configuration........................................ 39 3.3.2.1 Config properties................................. 39 3.3.2.2 Configuring logging................................ 40 3.3.3 Best practices........................................ 40 3.3.3.1 Step by step guide................................. 40 3.4 Distribution package......................................... 40 3.5 Using Maven artifacts........................................ 41 3.5.1 Public Maven repository.................................. 41 3.5.2 Distribution......................................... 42 3.5.3 GraphDB JAR file for embedding the database or plugin development.......... 42 3.5.4 I want to proxy the repository in my nexus......................... 42 4 Administration 43 4.1 Administration tasks......................................... 43 4.2 Administration tools......................................... 43 4.2.1 Workbench......................................... 44 4.2.2 JMX interface........................................ 44 4.2.2.1 Configuring the JMX endpoint.......................... 44 4.3 Creating locations.......................................... 44 4.3.1 Active location....................................... 45 4.3.2 Inactive location...................................... 47 4.3.3 Connect to a remote location................................ 47 4.3.4 Configure a data location.................................. 48 4.4 Creating a repository......................................... 48 4.4.1 Create a repository..................................... 49 4.4.1.1 Using the Workbench............................... 49 4.4.1.2 Using the RDF4J console............................. 49 4.4.2 Manage repositories..................................... 50 4.4.2.1 Select a repository................................. 50 4.4.2.2 Make it a default repository............................ 50 4.4.2.3 Edit a repository.................................. 51 4.5 Configuring a repository....................................... 51 4.5.1 Plan a repository configuration............................... 51 4.5.2 Configure a repository through the GraphDB Workbench................. 52 4.5.3 Edit a repository...................................... 52 4.5.4 Configure a repository programmatically.......................... 53 ii 4.5.5 Configuration parameters.................................. 54 4.5.6 Configure GraphDB memory................................ 57 4.5.6.1 Configure Java heap memory........................... 57 4.5.6.2 Single global page cache............................. 57 4.5.6.3 Configure Entity pool memory.......................... 58 4.5.6.4 Sample memory configuration.......................... 58 4.5.7 Reconfigure a repository.................................. 58 4.5.7.1 Using the Workbench............................... 59 4.5.7.2 In the SYSTEM repository.............................. 59 4.5.7.3 Global overrides.................................. 59 4.5.8 Rename a repository.................................... 59 4.5.8.1 Using the workbench............................... 59 4.5.8.2 Editing of the SYSTEM repository......................... 59 4.6 Access rights and security...................................... 60 4.6.1 Managing users’ access................................... 60 4.6.1.1 User roles..................................... 61 4.6.1.2 Login and default credentials........................... 61 4.6.1.3 Free access..................................... 62 4.7 Backing up and restoring a repository................................ 62 4.7.1 Backup a repository..................................... 62 4.7.1.1 Export repository to an RDF file......................... 63 4.7.1.2 Backup GraphDB by copying the binary image.................. 64 4.7.2 Restore a repository..................................... 64 4.8 Query monitoring and termination.................................. 65 4.8.1 Query monitoring and termination using the workbench.................. 65 4.8.2 Query monitoring and termination using the JMX interface................ 66 4.8.2.1 Query monitoring................................. 66 4.8.2.2 Terminating a query................................ 67 4.8.3 Terminating a transaction.................................. 67 4.8.4 Automatically prevent long running queries........................ 68 4.9 Troubleshooting........................................... 68 4.9.1 Database health checks................................... 68 4.9.1.1 Possible values for health checks and their meaning............... 68 4.9.1.2 Default health checks for the different GraphDB editions............ 68 4.9.1.3 Running the health checks............................. 69 4.9.2 System metrics monitoring................................. 69 4.9.2.1 Page cache metrics................................. 70 4.9.2.2 Entity pool metrics................................ 70 4.9.3 Diagnosing and reporting critical errors.......................... 71 4.9.3.1 Logs........................................ 71 4.9.3.2 Report script.................................... 72 4.9.4 Storage tool......................................... 74 4.9.4.1 Options...................................... 74 4.9.4.2 Supported commands............................... 74 4.9.4.3 Examples..................................... 75 5 Usage 77 5.1 Loading data............................................. 77 5.1.1 Loading data using the workbench............................. 77 5.1.1.1 Import settings................................... 78 5.1.1.2 Importing local files...............................