Apache Geode Examples

This is a Spring Cloud based microservices examples backed by Apache Geode data management platform.

Install Apache Geode

You can find detailed Geode installation here. Below are are the main steps for installation.

1. Make sure JAVA_HOME environment variable ia set up in your computer.
2. Download the .zip or .tar file from here.
3. Uncompress the file to a folder of your choice.
4. Open a console/terminal and navigate to bin directory under the newly installed folder.
5. Geode provides a command line tool (shell) called gfsh (pronounced “jee-fish”). Verify Geode installation by typing the gfsh version command on your terminal:

$ gfsh version
1.1.0

Start gfsh (Geode shell)

Start gfsh by typing the following on your terminal:

$ gfsh
    _________________________     __
   / _____/ ______/ ______/ /____/ /
  / /  __/ /___  /_____  / _____  / 
 / /__/ / ____/  _____/ / /    / /  
/______/_/      /______/_/    /_/    1.1.0

Monitor and Manage Apache Geode
gfsh>

Start a Geode Locator

A Geode locator provides location service and load balacing functionalities. It tells the connecting members where the running members are located.
To start a locator named locator, execute the following command at thegfsh prompt:

gfsh>start locator --name=locator
Starting a Geode Locator in /Users/indra.basak/Software/apache-geode-1.1.0/bin/locator...
.......................
Locator in /Users/indra.basak/Software/apache-geode-1.1.0/bin/locator on ibasa-mb-20824.ib.com[10334] as locator is currently online.
Process ID: 55991
Uptime: 12 seconds
Geode Version: 1.1.0
Java Version: 1.8.0_92
Log File: /Users/indra.basak/Software/apache-geode-1.1.0/bin/locator/locator.log
JVM Arguments: -Dgemfire.enable-cluster-configuration=true -Dgemfire.load-cluster-configuration-from-dir=false 
 -Dgemfire.launcher.registerSignalHandlers=true -Djava.awt.headless=true 
 -Dsun.rmi.dgc.server.gcInterval=9223372036854775806
Class-Path: /Users/indra.basak/Software/apache-geode-1.1.0/lib/geode-core-1.1.0.jar
  :/Users/indra.basak/Software/apache-geode-1.1.0/lib/geode-dependencies.jar

Successfully connected to: JMX Manager [host=ibasa-mb-20824.ib.com, port=1099]

Cluster configuration service is up and running.

The locator starts up at the default port 1099

Start a Geode Server

A Geode server is a long running configurable process (member of a cluster). To start a server named server, execute the following command at thegfsh prompt:

gfsh>start server --name=server
Starting a Geode Server in /Users/indra.basak/Software/apache-geode-1.1.0/bin/server...
.......
Server in /Users/indra.basak/Software/apache-geode-1.1.0/bin/server on ibasa-mb-20824.ib.com[40404] as server 
  is currently online.
Process ID: 56298
Uptime: 3 seconds
Geode Version: 1.1.0
Java Version: 1.8.0_92
Log File: /Users/indra.basak/Software/apache-geode-1.1.0/bin/server/server.log
JVM Arguments: -Dgemfire.default.locators=10.16.32.57[10334] -Dgemfire.use-cluster-configuration=true 
  -Dgemfire.start-dev-rest-api=false -XX:OnOutOfMemoryError=kill -KILL %p -Dgemfire.launcher.registerSignalHandlers=true 
  -Djava.awt.headless=true -Dsun.rmi.dgc.server.gcInterval=9223372036854775806
Class-Path: /Users/indra.basak/Software/apache-geode-1.1.0/lib/geode-core-1.1.0.jar
  :/Users/indra.basak/Software/apache-geode-1.1.0/lib/geode-dependencies.jar

The server starts up at the default port 40404

Modules

The project consist of multiple modules and can be classified into following categories:

1. Services
   1. geode-spring-model - contains all the models used in our examples
   2. geode-spring-service - example Spring cloud project which uses Spring Boot and Spring Data to connect to Geode. Please see project specific README to find more about the project.

Build

Execute the following command from the parent directory:

mvn clean install