administration.adoc

Administration

Pre-requisites

• JSON Schemas must be defined before the server can start

• Persistence Providers has their own bespoke configurations. Please refer to specific providers for configuration

⚠️	Memory provider should only used for testing purposes

Schema

LDS uses JSON Schema draft04. The schemas define the data model and uses directives to express links between json resources. Further during startup the schemas configures all REST APIs.

Directives

The (linked_property(resource)) directive defines how two data entities are connected. This allows you connect data from one property to another.

Configuration

The persistence providers share a common configuration located at linked-data-store-core/src/main/resources/application-defaults.properties, whereas specific configurations are located in each Docker Provider project.

Table 1. Configuration properties

Key	Default value	Description
graphql.enabled	false	Enables the GraphQL API
graphql.search.enabled	false	Enables search capability in the GraphQL schema. This requires search.index.provider to be set.
http.host	0.0.0.0	Binds default loopback and private IP
http.port	9090	Binds default IP port
http.prefix	/	Path prefix
http.request.dump	false	Prints requests on the INFO log
http.cors.allow.origin	*	Constrain what hosts should have access to the web server
namespace.default	ns	Default URI namespace prefix
specification.schema	(empty)	Location of where LDS reads its schemas. Inside docker images the default is /schema

Memory Persistence Provider

Table 2. Configuration properties

Key	Default value	Description
persistence.mem.wait.min	0	Min wait random-throttle time in millis to sleeps during write
persistence.mem.wait.max	0	Max wait random-throttle time in millis to sleeps during write
specification.schema	/schemas	Default used by docker

Neo4j Persistence Provider

Table 3. Configuration properties

Key	Default value	Description
persistence.initialization.max-wait-seconds	10	Time to wait in seconds before Neo4j is available for connection
neo4j.driver.url	bolt://db-neo4j:7687	Default docker-compose connection url
neo4j.driver.username	neo4j	Default Neo4j username
neo4j.driver.password	PasSW0rd	Default Neo4j password
neo4j.cypher.show	false	Verbose CypherQL logging
specification.schema	/schemas	Default used by docker

PostgreSQL Persistence Provider

Table 4. Configuration properties

Key	Default value	Description
persistence.initialization.max-wait-seconds	2	Time to wait in seconds before Neo4j is available for connection
postgres.driver.host	postgresdb	Default host
postgres.driver.port	5432	Default port
postgres.driver.user	lds	Default database user
postgres.driver.password	lds	Default database password
postgres.driver.database	lds	Default database
specification.schema	/schemas	Default used by docker

Solr Search Index Provider

Table 5. Configuration properties

Key	Example value	Description
search.index.url	http://localhost:8983/solr/lds_index	Full url to Solr index