加载Pivotal Gemfire配置文件

加载Pivotal Gemfire配置文件

你可以部署Pivotal Gemfire配置文件到系统目录结构或者jars文件中，你确定你想要部署的文件，并且对它们进行相应的配置。

注意：如果你使用Gemfire集群配置服务来新建和管理Gemfire集群配置，因为gemfire自动的管理集群成员中的分布式的配置文件和jar文件，所以这一节也就没有必要详细描述程序。

你可以使用本节描述的程序来分配成员特定的或者不想使用集群配置服务的状态时候的配置。

部署配置文件的主要步骤

1.确定那个配置文件是你在安装的时候需要的。

2.将这个配置文件放到目录下或者jar中。

3.对于任何一个默认名字或者位置的文件，在系统配置文件或者成员的CLASSPATH中提供文档说明。

Gemfire配置文件

Gemfire.properties：包含着分布式系统成员需要的配置信息。这些配置信息包括，授权，系统成员发现，通讯参数，日志，统计。985页有详细介绍。

Gfsecurity.properties：一个包含与安全相关的设置（否则定义在Gemfire.properties中）可选择的配置文件，将这些成员的属性放到一个分离文件中，可以约束用户访问这些指定的配置。（在985页有详细说明）

Cache.xml：描述cache的配置文件，这个文件包含cache，region和region条目的xml说明。也可以使用这个文件去配置磁盘存储，数据库登陆凭证，服务器，远程站点地址信息和套接字信息。1002页有详细介绍。

 

默认的文件规范和搜索位置

每一个文件都有一个默认的名字，一组文件搜索位置，和一个你可以覆盖默认的系统属性。

使用默认的规范，放置在目录的最高级或者jar文件中，规格标准化文件系统属性可以有绝对或者相对的路径名和文件名。

注意：如果没有指定绝对路径和名字，那么将会搜索所有文件的索索位置。

默认文件说明

相对文件规范的搜索位置

文件说明的有效属性

gemfire.properties

1.当前工作路径

2.Home目录

3.CLASSPATH

使用gemfire.properties作为一个java系统属性

cache.xml

1.当前路径

2.CLASSPATH

在gemfire.properties中使用cache-xml-file属性

有效的gemfirePropertyFile规范的例子：

• /zippy/users/jpearson/gemfiretest/gemfire.properties

• c:\gemfiretest\gemfire.prp

• myGF.properties

• test1/gfprops

对test1/gfprops的说明，如果在unix文件系统中的/textDir中启动Gemfire系统成员，在这条命令下Gemfire将会寻找这个文件，知道找到这个文件或者消耗了所有的locator。

1. /testDir/test1/gfprops

2. <yourHomeDir>/test1/gfprops

3.test1/gfprops中 CLASSPATH每一个位置下。

 

改变文件规范

你可以在Gemfire.properties文件中和命令行下改变所有的默认文件规范。

注意：Gemfire应用可以使用API通过java.lang.System属性传递到分布式系统连接。这个在文件命令行和Gemfire.properties文件中改变文件规范。你可以验证在应用启动的时候记录的配置文件中的应用配置信息。这个配置信息列出了Gemfire.properties文件中log-level属性被设置成config或者lower。

这个应用程序的调用，testApplication.TestApp1，没有为cache.xml和gemfire.properties提供默认的规范：

java -Dgemfire.cache-xml-file=

/gemfireSamples/examples/dist/cacheRunner/queryPortfolios.xml

-DgemfirePropertyFile=defaultConfigs/gemfire.properties

testApplication.TestApp1

Gfsh的start server命令可以使用相同的规范。

gfsh>server start

-J-Dgemfire.cache-xml-file=/gemfireSamples/examples/dist/cacheRunner/

queryPortfolios.xml

-J-DgemfirePropertyFile=defaultConfigs/gemfire.properties

你可以在gemfire.properties文件中改变cache.xml文件的规范。

注意：gemfire.properties文件中的规范不能使用环境变量。

没有使用默认cache.xml规范的Gemfire.properties文件的例子：

#Tue May 09 17:53:54 PDT 2006

mcast-address=224.0.0.250

mcast-port=10333

locators=cache-xml-file=/gemfireSamples/examples/dist/cacheRunner/queryPortfolios.xml

    

在JAR文件中部署配置文件

这一节提供了一个步骤和一个例子来演示在JAR文件中部署配置文件。

步骤：

1.jar这个文件

2.将Pivotal Gemfire的系统属性指向常驻在jar文件中的文件。

3.在CLASSPATH中包括jar文件。

4.对正在运行的应用验证jar文件的副本是唯一可见的。Gemfire在搜索完其他位置之后搜索CLASSPATH，所以这个文件在其他搜索区域内是无效的。

5.启动应用，这个配置文件从jar文件中加载

例子：

下面的例子将cache配置文件myCahce.xml部署到my.Jar中，下面显示了my.jar的内容：

% jar -tf my.jar

META-INF

META-INF/MANIFEST.MF

myConfig/

myConfig/myCache.xml

     在这个例子中，执行下面的步骤来部署配置文件

     1.设置系统属性，gemfire.properties中的cache-xml-file改成myConfig/myCache.xml

     2.将my.jar加入到CLASSPATH中

     3.检验在当前这个文件的目录中没有以myCache.xml命名的文件。

     当启动一个应用的时候，配置文件将会从jar文件中加载。