Pivotal GemFire® v8.2

Managing a Peer or Server Cache

Managing a Peer or Server Cache

You start your peer or server cache using a combination of XML declarations and API calls. Close the cache when you are done.

GemFire peers are members of a GemFire distributed system that do not act as clients to another GemFire distributed system. GemFire servers are peers that also listen for and process client requests.
  1. Create your cache:
    1. Start up a cluster and the cluster configuration service:
      1. Start a locator with --enable-cluster-configuration set to true. (It is set true by default.)
        gfsh>start locator --name=locator1
      2. Start up member processes that use the cluster configuration service (enabled by default):
        gfsh>start server --name=server1 --server-port=40404
      3. Create regions:
        gfsh>create region --name=customerRegion --type=REPLICATE
        gfsh>create region --name=ordersRegion --type=PARTITION
    2. Or if you are not using the cluster configuration service, directly configure cache.xml in each member of your cluster. In your cache.xml, use the cache DOCTYPE and configure your cache inside a <cache> element. Example:
      <?xml version="1.0" encoding="UTF-8"?>
      	// NOTE: Use this <cache-server> element only for server processes 
      	<cache-server port="40404"/>
      	<region name="customerRegion" refid="REPLICATE" />
      	<region name="ordersRegion" refid="PARTITION" />
    3. To programmatically create the Cache instance:
      • In your Java application, use the CacheFactory create method:
        Cache cache = new CacheFactory().create();
      • If you are running a server using the GemFire cacheserver process, it automatically creates the cache and connection at startup and closes both when it exits.

      The system creates the distributed system connection and initializes the cache according to your and cache.xml specifications.

  2. Close your cache when you are done using the close method of your Cache instance: