Cray® Graph Engine User Guide (3.2.UP02) S-3014 Contents Contents 1 About the Cray® Graph Engine User Guide........................................................................................................... 6 2 About the Cray Graph Engine (CGE)..................................................................................................................... 8 2.1 CGE Features............................................................................................................................................8 2.2 Concepts of Operation...............................................................................................................................8 2.2.1 What the Cray Graph Engine (CGE) is Not: a Relational Database............................................ 9 2.2.2 Differences Between CGE and Relational Database................................................................... 9 2.3 About SPARQL .......................................................................................................................................11 2.4 System Architecture Overview................................................................................................................ 11 2.5 RDF and SPARQL Resources.................................................................................................................12 3 The CGE Database Build Process....................................................................................................................... 13 3.1 About Rules Files ................................................................................................................................... 15 3.2 About Inference Rules Files.................................................................................................................... 15 3.3 Sample RDFS Rules File ........................................................................................................................19 3.4 Limitations to Jena Rules Syntax ........................................................................................................... 20 4 Launch the CGE Server Using the cge-launch Command............................................................................... 22 5 Mechanisms to Interact with the Cray Graph Engine (CGE) Database................................................................24 5.1 CGE CLI.................................................................................................................................................. 24 5.1.1 Cray Graph Engine (CGE) Command Output............................................................................ 26 5.1.2 CGE CLI Common Options........................................................................................................ 26 5.1.3 SSH Identities.............................................................................................................................32 5.1.4 CGE Hadoop HDFS Configuration.............................................................................................32 5.1.5 Cray Graph Engine (CGE) Properties File................................................................................. 33 5.1.6 Create Checkpoints Using the CGE checkpoint Command...................................................36 5.1.7 Compile SPARQL Commands Using the CGE compile Command.........................................37 5.1.8 Check the Database State Using the CGE echo Command..................................................... 38 5.1.9 Launch the CGE Web Server Using the fe Command............................................................... 39 5.1.10 Search Configuration File Locations Using the get-configuration Command.................39 5.1.11 Display keyword ID and User Friendly Keyword Name Mappings Using the keyword- lookup Command....................................................................................................................40 5.1.12 Retrieve Default Server Logging Information Using the log-info Command....................... 41 5.1.13 Lookup Mappings Between Log level Values and User Friendly Log Level Names Using the log-lookup Command..................................................................................................... 41 5.1.14 Change the Default Logging Configuration of the CGE Server Using the log- reconfigure Command.........................................................................................................42 5.1.15 Retrieve the Default NVP Configurations Using the CGE nvp-info Command.................... 43 S3014 2 Contents 5.1.16 Change Default NVP Configurations Using the CGE nvp-reconfigure Command............43 5.1.17 Display Server Output Directory Information Using the output-info Command ................ 43 5.1.18 Change the Server's Output Directory Using the CGE output-reconfigure Command .................................................................................................................................43 5.1.19 Execute Queries Using the CGE query Command................................................................ 44 5.1.20 Cray Graph Engine (CGE) Optimizer Configuration ................................................................46 5.1.21 Shutdown the CGE Server Using the shutdown Command...................................................46 5.1.22 Execute Sparql Queries and Updates Using the sparql Command...................................... 47 5.1.23 Execute Updates on a Database Using the CGE update Command..................................... 47 5.1.24 Create or Inspect a Java Keystore File Using the CGE generate keystore Command............48 5.1.25 Generate a Shiro Configuration Template Using the generate shiro Command............... 49 5.1.26 Create a Properties File Using the CGE generate properties Command.......................50 5.2 CGE GUI................................................................................................................................................. 52 5.2.1 Launch the CGE Web Server ....................................................................................................56 5.2.2 Execute SPARQL Queries Using the CGE UI............................................................................56 5.2.3 Execute SPARQL Updates Using the CGE Update Interface.................................................... 59 5.2.4 Create a Checkpoint Using the CGE UI..................................................................................... 61 5.2.5 Cray Graph Engine (CGE) Advanced Options .......................................................................... 63 5.2.6 View Server Configurations Using the CGE UI.......................................................................... 64 5.2.7 Edit Server Configurations Using the CGE UI............................................................................66 5.2.8 Control Options.......................................................................................................................... 68 5.3 SPARQL Endpoints................................................................................................................................. 70 5.4 Create and Use a Database.................................................................................................................... 73 6 Query Cancellation............................................................................................................................................... 75 6.1 Cancel a Query Using the CGE Web UI..................................................................................................76 6.2 Cancel a Request Running Under a CGE CLI Query..............................................................................80 7 CGE Security........................................................................................................................................................ 81 7.1 Cray Graph Engine (CGE) Security Mechanisms................................................................................... 83 7.1.1 Create a CGE Specific RSA/DSA Host Key...............................................................................83 7.2 Setup CGE Security................................................................................................................................ 84 7.2.1 Configure Server Side Identification and Authentication............................................................ 84 7.2.2 Configure the ACL File User Permissions..................................................................................86 7.2.3 Configure Web UI Identification, Authentication and Encryption................................................91 7.2.4 Configure LDAP for CGE........................................................................................................... 92 7.2.5 Configure Private Authentication for CGE..................................................................................93 7.2.6 Configure SSL for CGE.............................................................................................................. 94 7.2.7 Launch a Secured Web UI......................................................................................................... 96 7.3 Endpoint Security.................................................................................................................................... 96 S3014 3 Contents 7.4 CGE User Authentication.......................................................................................................................