JanusGraph基础1：配置

JanusGraph图形数据库集群由一个或多个JanusGraph实例组成。要打开JanusGraph实例，必须提供一个配置，该配置指定应如何设置JanusGraph。

JanusGraph配置可以指定JanusGraph使用哪些组件，控制JanusGraph部署的所有可选内容，并提供许多调整选项以使得JanusGraph集群达到最佳性能。

JanusGraph配置至少需要定义一个持久引擎，JanusGraph会将其用作存储后端。存储后端页面列出了所有可支持的持久引擎以及如何分别配置它们。如果需要高级图形查询支持（例如，全文搜索，地理位置信息搜索或范围查询），则必须配置其他索引后端。有关详细信息，请参见索引后端如果需要考虑查询性能，则应启用缓存。缓存配置和调整在JanusGraph缓存中进行了描述。

配置的栗子

以下是一些示例配置文件，以演示如何配置最常用的存储后端，索引系统和性能组件。这仅涵盖了可用配置选项的一小部分。
参考配置参考以了解全部的可选项。

Cassandra+Elasticsearch

将JanusGraph设置为使用本地运行的Cassandra持久引擎和远程ES索引系统：

storage.backend=cql
storage.hostname=localhost

index.search.backend=elasticsearch
index.search.hostname=100.100.101.1, 100.100.101.2
index.search.elasticsearch.client-only=true

HBase+Caching

将JanusGraph设置为使用远程运行的HBase持久引擎，并使用JanusGraph的缓存组件以提高性能。


storage.backend=hbase
storage.hostname=100.100.101.1
storage.port=2181

cache.db-cache = true
cache.db-cache-clean-wait = 20
cache.db-cache-time = 180000
cache.db-cache-size = 0.5

BerkeleyDB

将JanusGraph设置为用BerkeleyDB作为嵌入式持久性引擎，并将Elasticsearch用作嵌入式索引系统。

storage.backend=berkeleyje
storage.directory=/tmp/graph

index.search.backend=elasticsearch
index.search.directory=/tmp/searchindex
index.search.elasticsearch.client-only=false
index.search.elasticsearch.local-mode=true

配置参考详细描述了所有这些配置选项。 JanusGraph发行版的conf目录包含其他配置示例。

使用配置

根据不同的实例化模式有几种不同的方式用于配置JanusGraph。

JanusGraphFactory

Gremlin Console

JanusGraph发行版包含一个命令行工具Gremlin Console，可以用来与JanusGraph进行交互，并且很容易上手。调用bin/gremlin.sh（Unix / Linux）或bin/gremlin.bat（Windows）来启动控制台，然后使用存储在可访问的属性配置文件中的默认配置打开JanusGraph：

graph = JanusGraphFactory.open('path/to/configuration.properties')

JanusGraph Embedded

我们还可以在基于JVM的用户应用程序中通过调用JanusGraphFactory类来启动一个嵌入的JanusGraph图实例。在这样的情况下，JanusGraph是这个应用程序的一部分，而且这个应用程序可以通过公共API接口方便的调用JanusGraph。

Short Codes

如果先前已经配置了JanusGraph图集群和/或仅需要定义存储后端，则JanusGraphFactory可以接收以冒号分隔的字符串表示形式，用来传递存储后端名称和主机名或目录，如下所示。

graph = JanusGraphFactory.open('cql:localhost')
graph = JanusGraphFactory.open('berkeleyje:/tmp/graph')

JanusGraph Server

JanusGraph本身也可以认为是一组没有执行线程的jar文件。有两种连接和使用JanusGraph数据库的基本模式：

一个程序的可执行线程可以通过调用嵌入的JanusGraph方式来使用JanusGraph。
JanusGraph打包了一个可长期运行的服务器进程，启动该进程后，它允许远程客户端或运行在单独程序中的逻辑调用JanusGraph。这个长期运行的服务器进程称为** JanusGraph Server **。

JanusGraph Server 使用Apache TinkerPop 的 Gremlin Server 堆栈来处理客户端请求。JanusGraph提供了开箱即用的配置，可快速启动JanusGraph Server，但可以更改配置以提供更多功能。

通过位于JanusGraph发行版./conf/gremlin-server目录中的JanusGraph Server yaml配置文件来配置JanusGraph Server。要使用JanusGraph Server配置一个图实例（JanusGraph`），JanusGraph Server配置文件需要以下设置：

...
graphs: {
  graph: conf/janusgraph-berkeleyje.properties
}
scriptEngines: {
  gremlin-groovy: {
    plugins: { org.janusgraph.graphdb.tinkerpop.plugin.JanusGraphGremlinPlugin: {},
               org.apache.tinkerpop.gremlin.server.jsr223.GremlinServerGremlinPlugin: {},
               org.apache.tinkerpop.gremlin.tinkergraph.jsr223.TinkerGraphGremlinPlugin: {},
               org.apache.tinkerpop.gremlin.jsr223.ImportGremlinPlugin: {classImports: [java.lang.Math], methodImports: [java.lang.Math#*]},
               org.apache.tinkerpop.gremlin.jsr223.ScriptFileGremlinPlugin: {files: [scripts/empty-sample.groovy]}}}}
...

graphs这一个条目中定义了‘捆绑物bindings’来明确JanusGraph的配置。在上面的栗子中，把 graph绑定到了conf/janusgraph-berkeleyje.properties这个配置文件上。plugins这个条目启用了JanusGraph Gremlin Plugin，这样可以自动导入JanusGraph类，以便可以在远程提交的脚本中引用它们。

想了解更多关于JanusGraph Server 的配置和使用方法可参见 JanusGraph Server.

服务器分配

JanusGraph zip文件包含一个快速启动服务器组件，该组件有助于简化和快速启动Gremlin Server和JanusGraph。调用bin/janusgraph.sh start来启动Gremlin Server,并使用Cassandra和Elasticsearch做后端。

- 注意事项
为了安全起见， Elasticsearch 和 `janusgraph.sh` 应该使用非root账户启动。

全局配置

JanusGraph的配置选项区分为本地配置选项和全局配置选项。本地配置选项适用于单个JanusGraph实例。全局配置选项适用于集群中的所有实例。更具体地说，JanusGraph为配置选项区分了以下五个级别：

LOCAL: 这些选项仅适用于单个JanusGraph实例，并在初始化JanusGraph实例时提供的配置文件中指定。
MASKABLE: 本地配置文件可以为单个JanusGraph实例覆盖这些配置选项。如果本地配置文件未指定该选项，则从全局JanusGraph群集配置中读取其值。
GLOBAL: 这些选项始终从集群配置中读取，不能基于实例进行覆盖。
GLOBAL_OFFLINE: 类似于 GLOBAL, 但是可以更改，更改这些选项需要重新启动群集，以确保整个群集中的值相同。

FIXED: 类似于 GLOBAL, 但是一旦JanusGraph集群初始化，就无法更改该值。

当第一个集群中的JanusGraph实例启动时，将从提供的本地配置文件中初始化全局配置选项。随后，通过JanusGraph的管理API更改全局配置选项。要访问管理API，请在打开的JanusGraph实例句柄g上调用g.getManagementSystem()。例如，要更改JanusGraph群集上的默认缓存行为可以使用下面的栗子：

mgmt = graph.openManagement()
mgmt.get('cache.db-cache')
// Prints the current config setting 输出当前配置
mgmt.set('cache.db-cache', true)
// Changes option 修改配置
mgmt.get('cache.db-cache')
// Prints 'true'输出 
mgmt.commit()
// Changes take effect

修改离线配置

更改配置选项不会影响正在运行的实例，仅会在新启动的实例上生效。更改 GLOBAL_OFFLINE 配置选项需要重新启动群集，以便更改对所有实例立即生效。要更改 GLOBAL_OFFLINE 选项，请按照以下步骤操作：

只保留一个集群中的实例，其他所有实例全部关掉
连接到该实例
确认所有事务都已经关闭
确认不会有新的事务启动 (i.e. 集群必须是下线模式)
启动管理API
修改配置选项
提交配置，该调用会自动关闭实例
重启全部实例

要了解全部配置详情请参考配置说明包括配置选项和选项的配置范围。