Google Git
Sign in
apache / geode / d573de2ba5bc98c452699a6654861bcf748745cf
commitd573de2ba5bc98c452699a6654861bcf748745cf[log] [tgz]
authorJoey McAllister <jmcallister@pivotal.io>Thu Oct 13 20:47:50 2016 -0700
committerKaren Miller <kmiller@pivotal.io>Fri Oct 14 14:51:04 2016 -0700
tree47120949ff6f26d3df548c1ab74f18448c1fa985
parente9669d6123725e12cbd2b0c5a145fc36b615c292 [diff]
GEODE-1952 Add output, final_app dirs to rat exclusions
1 file changed
tree: 47120949ff6f26d3df548c1ab74f18448c1fa985
  1. buildSrc/
  2. dev-tools/
  3. docker/
  4. etc/
  5. extensions/
  6. geode-assembly/
  7. geode-book/
  8. geode-common/
  9. geode-core/
  10. geode-cq/
  11. geode-docs/
  12. geode-examples/
  13. geode-json/
  14. geode-junit/
  15. geode-lucene/
  16. geode-old-client-support/
  17. geode-pulse/
  18. geode-rebalancer/
  19. geode-site/
  20. geode-spark-connector/
  21. geode-wan/
  22. geode-web/
  23. geode-web-api/
  24. gradle/
  25. .gitignore
  26. .travis.yml
  27. build.gradle
  28. BUILDING.md
  29. DISCLAIMER
  30. gradle.properties
  31. gradlew
  32. gradlew.bat
  33. KEYS
  34. LICENSE
  35. NOTICE
  36. README.md
  37. settings.gradle
README.md

Overview
Main Concepts and Components
Location of Directions for Building from Source
Geode in 5 minutes
Application Development
Documentation
wiki
Continuous Integration Build Status

Overview

[Apache Geode] (http://geode.incubator.apache.org/) is a data management platform that provides real-time, consistent access to data-intensive applications throughout widely distributed cloud architectures.

Apache Geode pools memory, CPU, network resources, and optionally local disk across multiple processes to manage application objects and behavior. It uses dynamic replication and data partitioning techniques to implement high availability, improved performance, scalability, and fault tolerance. In addition to being a distributed data container, Apache Geode is an in-memory data management system that provides reliable asynchronous event notifications and guaranteed message delivery.

Apache Geode is a mature, robust technology originally developed by GemStone Systems in Beaverton, Oregon. Commercially available as GemFire™, the technology was first deployed in the financial sector as the transactional, low-latency data engine used in Wall Street trading platforms. Today Apache Geode is used by over 600 enterprise customers for high-scale business applications that must meet low latency and 24x7 availability requirements. An example deployment includes China National Railways that uses Geode to run railway ticketing for the entire country of China with a 10 node cluster that manages 2 terabytes of “hot data” in memory, and 10 backup nodes for high availability and elastic scale.

Main Concepts and Components

Caches are an abstraction that describe a node in an Apache Geode distributed system.

Within each cache, you define data regions. Data regions are analogous to tables in a relational database and manage data in a distributed fashion as name/value pairs. A replicated region stores identical copies of the data on each cache member of a distributed system. A partitioned region spreads the data among cache members. After the system is configured, client applications can access the distributed data in regions without knowledge of the underlying system architecture. You can define listeners to receive notifications when data has changed, and you can define expiration criteria to delete obsolete data in a region.

Locators provide clients with both discovery and server load balancing services. Clients are configured with locator information, and the locators maintain a dynamic list of member servers. The locators provide clients with connection information to a server.

Apache Geode includes the following features:

  • Combines redundancy, replication, and a “shared nothing” persistence architecture to deliver fail-safe reliability and performance.
  • Horizontally scalable to thousands of cache members, with multiple cache topologies to meet different enterprise needs. The cache can be distributed across multiple computers.
  • Asynchronous and synchronous cache update propagation.
  • Delta propagation distributes only the difference between old and new versions of an object (delta) instead of the entire object, resulting in significant distribution cost savings.
  • Reliable asynchronous event notifications and guaranteed message delivery through optimized, low latency distribution layer.
  • Applications run 4 to 40 times faster with no additional hardware.
  • Data awareness and real-time business intelligence. If data changes as you retrieve it, you see the changes immediately.
  • Integration with Spring Framework to speed and simplify the development of scalable, transactional enterprise applications.
  • JTA compliant transaction support.
  • Cluster-wide configurations that can be persisted and exported to other clusters.
  • Remote cluster management through HTTP.
  • REST APIs for REST-enabled application development.
  • Rolling upgrades may be possible, but they will be subject to any limitations imposed by new features.

Building this Release from Source

Directions to build Apache Geode (incubating) from source are in the source distribution, file BUILDING.md.

Geode in 5 minutes

With a JDK version 1.8 or a more recent version installed, start a locator and server:

$ gfsh
gfsh> start locator --name=locator
gfsh> start server --name=server

Create a region:

gfsh> create region --name=region --type=REPLICATE

Write a client application:

HelloWorld.java

import java.util.Map;
import org.apache.geode.cache.Region;
import org.apache.geode.cache.client.*;

public class HelloWorld {
  public static void main(String[] args) throws Exception {
    ClientCache cache = new ClientCacheFactory()
      .addPoolLocator("localhost", 10334)
      .create();
    Region<String, String> region = cache
      .<String, String>createClientRegionFactory(ClientRegionShortcut.CACHING_PROXY)
      .create("region");

    region.put("1", "Hello");
    region.put("2", "World");

    for (Map.Entry<String, String>  entry : region.entrySet()) {
      System.out.format("key = %s, value = %s\n", entry.getKey(), entry.getValue());
    }
    cache.close();
  }
}

Compile and run HelloWorld.java. The classpath should include geode-dependencies.jar.

javac -cp /some/path/geode/geode-assembly/build/install/apache-geode/lib/geode-dependencies.jar HelloWorld.java
java -cp .:/some/path/geode/geode-assembly/build/install/apache-geode/lib/geode-dependencies.jar HelloWorld

Application Development

Apache Geode applications can be written in these client technologies: