This topic explains how to manage a peer or server cache in VMware GemFire.

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

VMware GemFire peers are members of a VMware GemFire cluster that do not act as clients to another VMware GemFire cluster. VMware 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 VMware GemFire cacheserver process, it automatically creates the cache and connection at startup and closes both when it exits.

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

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

check-circle-line exclamation-circle-line close-line
Scroll to top icon