Geode集群配置服务

集群配置服务概述

使用集群配置服务能能做什么?

1.保存整个集群的配置 
2.使用先前保存的配置重新启动成员 
3.从开发环境导出配置，并迁移该配置以创建测试或生产系统 
4.启动其它服务器，而不必单独配置每个服务器 
5.指定不同的服务管理不同的Regions 

如何开启集群配置服务

集群中的每一个设置了—enable-cluster-configuratino=true的locator会保存一份配置记录，该记录是以locator和group级别的配置。当修改集群配置，locator会分发配置到集群中所有的locators。当启动一个新server将会从当前locator引用当前的集群配置，如果新server有指定分组，则会引用该组的配置。

集群配置服务工作方式

1.使用命令行创建server,region,disk-stores,index,deploy jar … 
2.集群配置服务保存配置到每一个集群中的locator。如果定义一个group,将会为该分组产生一个独立的配置，该配置仅适用于该分组成员 
3.用命令行创建新的server 
4.新成员向locator请求集群配置 
5.locator将会分发配置给新加入的server.如果是指定了分组，该server将会收到对应的group集群配置。所以可以使用group配置覆盖locator的配置 

gfsh命令行创建集群配置

下列操作命令会写入到所有的集群locators中，locator会把配置写入磁盘。(配置region,index,disk-store,jar….)

    configure pdx  ####该合令必须在启动data members之前。不会影响到当前正在运行的members ,在这之后启动会采用新的PDX 配置    alter runtime    create region    alter region    destroy region    create index    destroy index    create disk-store    destroy disk-store    create async-event-queue    deploy jar    undeploy jar

下列网关配置命令使用集群配置服务，并且配置会被locators保存 

    create gateway-sender     create gateway-receiver 

cache.xml或API方式创建集群配置

下列配置没法用GFSH，必须用cache.xml或API来配置

  1.客户端的缓存配置 （Client cache configuration）   2.不能为下列java classes定义参数和值     function    custom-load-probe    cache-listener    cache-loader    cache-writer    compressor    serializer    instantiantor    pdx-serializer ###configure pdx命令指定org.apache.geode.pdx.ReflectionBaseAutoSerializer class, 不能在GFSH中自定义PDX serializer     custom-expiry    initializer    declarable    lru-heap-percentage    lru-memory-size    partition-resolver    partition-listener    transaction-listener    transaction-writer  3.添加或移除事务监听器 （Adding or removing a TransactionListener）   4.添加JNDI （Adding JNDI bindings）   5.删除异步事务队列 （Deleting an AsyncEventQueue） 

下列网关配置命令必须用cache.xml或API来配置 

  1.Configuring a GatewayConflictResolver   2.不能为下列java classes定义参数和值     gateway-listener    gateway-conflict-resolver    gateway-event-filter    gateway-transport-filter    gateway-event-substitution-filter

*–enable-cluster-configuration=true默为为true。在启动locator的时候可以修改该参数为false，表示禁用集群配置服务。

集群配置文件

在Geode中使用集群配置服务时，会在cluster_config目当中生成对应的Cluster-lever和Group-level配置文件。（但1.1.1版本好像有Bug，该目录及相关配置并不存在，应该会在下一个版本中修复该问题吧！）

Cluster-level 配置

locator会在 <locator_name>/clustername/“目录或在–cluster-config-dir=value 参数指定的目录下创建一个cluster_config的文件目录。该配置对所有成面生效，当在命令行启动servers将会引用该配置。 
该目录包含以下文件： 
1.cluster.xml –配置所有成员基本配置的cache.xml文件 
2.cluster.properties –配置所有成员基本properties属性的gemfire.properties文件 
3.部署到所有成员的JAR文件 

Group-level 配置

当在gfsh命令中指定group，locator将为每一个group创建一个配置目录，该目录与group名相同，当创建一个server并且同时指定一个或多个group。该server会收到cluster-lever的配置和所有分组的配置。 
该目录包含以下文件： 
1.<group-name>.xml –配置该分组所有成员基本配置的cache.xml文件 
2.<group-name>.properties –配置该分组所有成员基本properties属性的gemfire.properties文件 
3.部署到该分组所有成员的JAR文件 

*Geode首先应用集群范围的配置文件，然后再应用组级配置文件。如果一个成员有自己的配置文件定义（cache.xml和gemfire.properties文件），最后应用这些配置。