Skip to content

Latest commit

 

History

History
115 lines (65 loc) · 3.38 KB

Configuration.md

File metadata and controls

115 lines (65 loc) · 3.38 KB
Raw

Configuration File

Overview

Cayley expects, in the usual case, to be run with a configuration file, though it can also be run purely through configuration flags. The configuration file contains a JSON object with any of the documented parameters.

Cayley looks in the following locations for the configuration file

  • Command line flag
  • The environment variable $CAYLEY_CFG
  • /etc/cayley.cfg

All command line flags take precedence over the configuration file.

Main Options

database

  • Type: String
  • Default: "mem"

Determines the type of the underlying database. Options include:

  • mem: An in-memory store, based on an initial N-Quads file. Loses all changes when the process exits.
  • leveldb: A persistent on-disk store backed by LevelDB.
  • mongodb: Stores the graph data and indices in a MongoDB instance. Slower, as it incurs network traffic, but multiple Cayley instances can disappear and reconnect at will, across a potentially horizontally-scaled store.

db_path

  • Type: String
  • Default: "/tmp/testdb"

Where does the database actually live? Dependent on the type of database. For each datastore:

  • mem: Path to a triple file to automatically load
  • leveldb: Directory to hold the LevelDB database files
  • mongodb: "hostname:port" of the desired MongoDB server.

listen_host

  • Type: String
  • Default: "0.0.0.0"

The hostname or IP address for Cayley's HTTP server to listen on. Defaults to all interfaces.

listen_port

  • Type: String
  • Default: "64210"

The port for Cayley's HTTP server to listen on.

read_only

  • Type: Boolean
  • Default: false

If true, disables the ability to write to the database using the HTTP API (will return a 400 for any write request). Useful for testing or instances that shouldn't change.

load_size

  • Type: Integer
  • Default: 10000

The number of triples to buffer from a loaded file before writing a block of triples to the database. Larger numbers are good for larger loads.

db_options

  • Type: Object

See Per-Database Options, below.

Language Options

timeout

  • Type: Integer or String
  • Default: 30

The maximum length of time the Javascript runtime should run until cancelling the query and returning a 408 Timeout. When timeout is an integer is is interpretted as seconds, when it is a string it is parsed as a Go time.Duration. A negative duration means no limit.

Per-Database Options

The db_options object in the main configuration file contains any of these following options that change the behavior of the datastore.

Memory

No special options.

LevelDB

write_buffer_mb

  • Type: Integer
  • Default: 20

The size in MiB of the LevelDB write cache. Increasing this number allows for more/faster writes before syncing to disk. Default is 20, for large loads, a recommended value is 200+.

cache_size_mb

  • Type: Integer
  • Default: 2

The size in MiB of the LevelDB block cache. Increasing this number uses more memory to maintain a bigger cache of triple blocks for better performance.

MongoDB

database_name

  • Type: String
  • Default: "cayley"

The name of the database within MongoDB to connect to. Manages its own collections and indicies therein.