Geode 创建并使用集群配置

创建集群配置

1. 创建一个工作目录，并进入该目录，该目录将会保存集群的配置

2. 进gfsh命令行

$ gfsh

3. 启动一个locator，该命令会返回消息，提示集群配置服务已经启动并在运行，如果有错误信息就去查看locator日志，日志文件目录在返回消息中的Log File: /path…./locator*.log

gfsh> start locator --name=locator1

4. 启动servers,其中server1和server2指定在group1组中，server3没有指定分组

gfsh>start server --name=server1 --group=group1 --server-port=40404
gfsh>start server --name=server2 --group=group1 --server-port=40405
gfsh>start server --name=server3 --server-port=40406

5. 创建regions，其中region1在group1分组的所有server中,group2没有指定分组，会存在于所有的cache server中

gfsh>create region --name=region1 --group=group1 --type=REPLICATE
Member  | Status
------- | --------------------------------------
server2 | Region "/region1" created on "server2"
server1 | Region "/region1" created on "server1"

gfsh>create region --name=region2 --type=REPLICATE
Member  | Status
------- | --------------------------------------
server1 | Region "/region2" created on "server1"
server2 | Region "/region2" created on "server2"
server3 | Region "/region2" created on "server3"

6. 导出集群配置

gfsh>export cluster-configuration --zip-file-name=/root/ClusterConfig.zip

7. 关闭集群中所有locators,并退出gfsh命令行

gfsh>shutdown --include-locators=true
gfsh>quit

使用配置

1. 创建一个新的工作目录并进入该目录

2. 进gfsh命令行

$ gfsh

3. 开启一个新的locator

gfsh>start locator --name=locator2 --port=10335

4. 导入前面的集群配置

gfsh>import cluster-configuration --zip-file-name=/root/ClusterConfig.zip

5. 开启新server4，不指定分组

gfsh>start server --name=server4 --server-port=40414

6. 开启新的server5并指定到group1分组

gfsh>start server --name=server5 --group=group1 --server-port=40415

7. 查看locator2的mebers和regions信息可以看到前面的region1和region2已经被采用了。

gfsh>list members
Name   | Id
-------- | ---------------------------------------------------
locator2 | 192.168.79.137(locator2:17013:locator)<ec><v0>:1024
server4  | 192.168.79.137(server4:17126)<v1>:1025
server5  | 192.168.79.137(server5:17216)<v2>:1026

gfsh>list regions
List of regions
---------------
region1
region2

gfsh>describe region --name=region1
..........................................................
Name            : region1
Data Policy     : replicate
Hosting Members : server5

Non-Default Attributes Shared By Hosting Members

Type  |    Name     | Value
------ | ----------- | ---------------
Region | data-policy | REPLICATE
| size        | 0
| scope       | distributed-ack

gfsh>describe region --name=region2
..........................................................
Name            : region2
Data Policy     : replicate
Hosting Members : server5
server4

Non-Default Attributes Shared By Hosting Members

Type  |    Name     | Value
------ | ----------- | ---------------
Region | data-policy | REPLICATE
| size        | 0
| scope       | distributed-ack

加载已有的集群配置文件到集群

1. 解压前面导出的ZIP文件，得到cluster目录包含cluster.properties和cluster.xml配置文件，和group1目录包含group1.properties和group1.xml两个配置文件（这里是从上面导出来的配置，实际上的配置文件会有cluster配置＋[gorup配置]，分组可有可无，并且目录名也会以实际的分组名命名，这里也可以看到cluster保存的配置是以集群和分组维度来存放的。）

[root@dn2 ~]# ls cluster
cluster.properties  cluster.xml
[root@dn2 ~]# ls group1
group1.properties  group1.xml
[root@dn2 ~]#

2. 在/root目录下创建子目录cluster_config

3. 拷贝cluster和group1到cluster_config目录下。

4. 进入gfsh

$ gfsh

5. 启动一个locator,并且加载已有的集群配置，–cluster-config-dir=<value>指定集群配置cluster_config存放的目录

start locator --name=locator03 --load-cluster-configuration-from-dir=true --cluster-config-dir=/root

返回的消息最后应该包含“Cluster configuration service is up and running.”，否则可能就是失败了，

6. 查看集群配置状态

gfsh>status cluster-config-service
Status of shared configuration on locators

Name    | Status
--------- | -------
locator03 | RUNNING

7. 配置导入成功后，所有加入集群的server都将会采纳该配置

8. 如果修改了配置需要使用–load-cluster-configuration-from-dir=true –cluster-config-dir=/root重启locator。

*不能导入集群配置到一个servers已经在运行的集群。 

*可以导入集群配置到一个运行中的locator。导入后，所有的新开启的servers将会采用该集群配置。 

*集群配置服务导出和导入用gfsh命令为整个Apache Geode 集群创建的配置。用Management API创建的配置不会保存在集群配置中。