Apache Geode快速入门
原文地址：http://geode.apache.org/docs/guide/getting_started/15_minute_quickstart_gfsh.html
Step1 安装Apache Geode
官网提供binary和source两个版本，可以下载source版本然后自己编译，也可以直接下载编译好的binaries。但在此之前，需要安装配置jdk1.8或更高版本。
windows下source版安装
1.安装配置Gradle 2.3 或更高版
2.下载源码（source project）并解压。点击下载
3 在解压好的文件夹中，按shift+右键，在此处打开命令行窗口。 输入如下命令编译项目。
$ gradle build
4 . 添加geode的path路径
path变量后添加： geode安装目录\bin
5 . 验证
$ gfsh version
v1.0.0-incubating
windows下binaries安装
不需要使用gradle进行编译，直接将下载好的binary文件解压，配置geode的path路径即可。
Unix下source安装
1.下载源码（source project）并解压。点击下载
2.进入解压目录，输入一下命令进行编译
$ ./gradlew build
3.验证
cd geode-assembly/build/install/apache-geode
bin/gfsh version
v1.0.0-incubating
Step2 使用gfsh启动定位器（Locator）
在终端窗口中，使用gfsh命令启动定位器。 Apache Geode gfsh（发音为“jee-fish”）提供了一个单一的，直观的命令行界面，您可以从中启动，管理和监视Apache Geode进程，数据和应用程序。参考gfsh（Geode SHell）。
定位器是一个Geode进程，它告诉新的连接成员正在运行的成员的位置，并为服务器的使用提供负载均衡。默认情况下，定位器启动JMX Manager，该JMX Manager用于监视和管理Geode集群。集群配置服务使用定位器来保持集群配置并将配置分配给集群成员。参考Running Geode Locator Processes和Overview of the Cluster Configuration Service
1.创建一个工作目录。gfsh将在这里保存locator和server的工作目录和日志文件。
2.在该目录下打开命令行窗口。输入命令”gfsh”来启动gfsh（需要预先添加geode的path路径）。结果如下。
3.在gfsh提示符后，输入：
Step3 启动Pulse
启动基于浏览器的脉冲监测工具。 Pulse是一个Web应用程序，它提供了一个图形仪表板，用于监控Geode集群，成员和regions的重要的实时健康和性能。参考Geode Pulse
gfsh>start pulse
此命令启动Pulse并自动连接到在定位器中运行的JMX Manager。在Pulse登录页面上，输入默认用户名admin和密码admin。
Pulse应用程序显示刚刚启动的定位器（locator1）：
Step4 启动服务器
Geode服务器是一个作为集群（也称为分布式系统）长期可配置成员运行的进程。 Geode服务器主要用于托管长期数据区域和运行标准Geode进程，例如客户端/服务器配置中的服务器。参考Running Geode Server Processes.
启动一个缓存服务器：
gfsh>start server –name=server1 –server-port=40411
此命令在40411的指定端口上启动名为“server1”的缓存服务器。
在Pulse中观察变化（新成员和服务器）。尝试扩展分布式系统图标，以图形方式查看定位器和缓存服务器。
Step5 创建一个复制的（replicated），持久（persistent）的region
在此步骤中，使用gfsh命令创建一个region。region是Geode集群的核心构建块，并提供了组织数据的方法。在此次练习中创建的region在集群成员之间复制数据（replicated），并利用持久性将数据保存到磁盘（persistent）。参考Data Regions
1.创建一个被复制的持久的region：
注意该region被server1托管。
2.使用gfsh命令查看集群上的region列表
3.查看集群的成员列表。启动的定位器和缓存服务器都在该列表中。
4.查看该region的详细信息：
5.在Pulse中，点击绿色的集群图标，查看刚刚添加的新成员和新regions。
Note：保持此gfsh提示打开以供后续步骤使用。
Step6 操作region中数据，展示持久性
Apache Geode以键/值对形式对数据进行管理。在大多数应用程序中，Java程序添加，删除和修改存储的数据。同时也可以使用gfsh命令添加和检索数据。参考Data Commands。
1.运行put命令向region中添加数据。
2.查询region中数据。
注意到结果是刚刚使用put命令添加的两条数据条目（entries）。
参考Data Entries。
3.关闭缓存服务器：
gfsh>stop server –name=server1
4.重新启动缓存服务器：
gfsh>start server –name=server1 –server-port=40411
5.再次查询region中数据，注意到数据仍然可用：
因为regionA有持久性，它将数据的副本写入磁盘。当托管regionA的服务器启动时，数据将被填充到高速缓存中。请注意，结果显示停止服务器之前使用put命令添加的两个数据条目的值。
参考Data Entries
参考Data Regions
Step 7 测试副本（replication）的影响
在此步骤中，启动第二个缓存服务器。因为regionA已复制，所以该数据将在托管该区域的任何服务器上可用。
1.启动第二台服务器：
gfsh>start server –name=server2 –server-port=40412
2.查看regionA的详细信息：
gfsh>describe region –name=regionA
请注意，不需要再为server2创建regionA。命令的输出显示regionA托管在server1和server2上。当gfsh启动服务器时，它会从群集配置服务请求配置，集群配置服务会将共享配置分发到加入群集的任何新服务器。
3.增加第三条数据条目：
gfsh>put –region=regionA –key=’3’ –value=’three’
4.打开Pulse应用程序（在Web浏览器中）并观察集群拓扑。应该可以看到一个有两个服务器连接的定位器。单击“data”选项卡以查看有关regionA的信息。
5.关闭第一个缓存服务器：
gfsh>stop server –name=server1
6.在其余的缓存服务器中查询数据：
7.添加第四条条目
只有server2正在运行。因为数据被复制和持久化，所有数据仍然可用。但是，新的数据条目当前仅在服务器2上可用。
8.关闭Server2
gfsh>stop server –name=server2
Step8 并行重启缓存服务器
在此步骤中，并行重新启动缓存服务器。由于数据是持久的，因此在服务器重新启动时数据可用。由于数据在多个服务器上存在副本，因此必须并行启动服务器，以便可以在启动之前同步其数据。
1.启动server1。因为regionA是复制和持久的，它需要同步其他服务器的数据才能启动，因此需要等待其他服务器启动：
此时如果在server1.log日志文件中查找重新启动服务器的相关信息，将看到类似于以下内容的日志消息：
2.在同一工作目录下打开第二个终端窗口，启动gfsh：
3.连接集群：
4.启动server2：
gfsh>start server –name=server2 –server-port=40412
当server2启动时，注意server1在第一个gfsh窗口中完成启动：
5.验证定位器和两个服务器在运行：
6.查询以验证使用put命令添加的所有数据是否可用：
7.关闭server2
gfsh>stop server –dir=server2
8.再次查询以验证使用put命令添加的所有数据是否可用：
Step 9 关闭包括定位器在内的整个系统
关闭集群有以下步骤：
1.在当前gfsh会话中，关闭集群：
gfsh>shutdown –include-locators=ture
2.出现提示时，键入“Y”以确认集群关闭。
3.输入 exit 推出gfsh shell.