Regions

In the VMware GemFire® Management Console™, the Regions tab provides details about existing regions on the running cluster and allows users to create new regions on the cluster.

Create a Region

To create a new region, click CREATE REGION in the upper right corner of the Regions tab. This opens a “Create Region” interface that requires you to provide information such as Region Name and Region Type (Partition or Replicate). After entering the information for the new region, click Create Region.

Regions Table

The Regions table provides a view of all regions. Initially, the table shows five regions. Click the arrow on the bottom right of the table to see the next page of regions. At your discretion, you can set the number of regions per page to a number higher than five.

The regions are sorted in alphabetical order by default. The table contains high-level information for each region such as:

  • Name: The name of the region.
  • Data Policy: The data policy of the region. For example, Partition, Replicate, or Persistent Replicate. For more information about data policies, see Region Data Policies in the VMware GemFire product documentation.
  • Total Number of Entries: The total number of entries currently in the region.
  • Total Size of Entries: The size of the entries currently in the region. This is measured and displayed in bytes, KB, MB, GB, or TB.
  • Persistence: If the region was created with persistence, this column lists the Disk Store that the region is associated with.
  • Redundancy (GemFire 10.1+): Displays if the region’s redundancy requirements have been satisfied or not.

Available Region Actions

Actions available from the Actions menu:

  • Edit: Editing the region allows the user to:

    • Add Cache Listeners
    • Add a Cache Loader
    • Add a Cache Writer
    • Assign the region to gateway senders

    Note: Non-colocated regions cannot have the same parallel gateway sender configured.

  • Import Data: Import Data into the region. Data files must have a .gfd extension. Note that the file name or directory name are relative to the selected member.

    For more information about importing data into region, see Importing Cache and Region Snapshots in the GemFire product documentation.

  • Export Data: Allows the user to save region data to a snapshot that you can later load into another cluster or region. By default, the Management Console saves a single .gfd file to the file directory where GemFire is running. These settings can be changed by expanding the Advanced Configuration menu.

    After clicking Export, a confirmation dialogue appears that displays the region name, the file path to where the data was exported, and the host on which the was data exported.

    For more information about exporting data into regions, see Exporting Cache and Region Snapshots in the GemFire product documentation.

  • Delete: Deletes the region and all data in the region. All region data being persisted is lost.

Region Details

To see more information about an individual region, click on the region name in the Name column. The information displayed at the top of region details will be different depending on the type of region (Persistent or Replicate).

Partition Regions

Regions that are of type Partition display:

  • Type: The type of the region. For example, Partition or Persistent Partition.

  • Total Number of Entries: The number of entries in the region.

  • Hosting Members: On which servers the region is present.

  • Statistics: If statistics have been enabled for the region or not. If statistics have not been enabled for the region, then the user cannot enable expiration.

  • Redundant Copies Configured: This number displays how many redundant copies are configured for the region. This will be from 0 to 3, with 0 being no copies of the data beyond the primary copy, and 3 being three copies of the data beyond the primary copy.

  • Number of Buckets Configured: The number of buckets that a user configured for the region. If a number was not set while creating the region the label will show Not Configured, and GemFire will default to 113 buckets. Note: Buckets are not created until they are needed.

  • Total Primary Buckets: The number of primary buckets across the hosting members. Note: Buckets are not created until they are needed. For example, if a region is configured with 128 buckets but there is no data in the region, this would show 0.

  • Total Bucket Count (Primary + Redundant): The total number of buckets across hosting members. For example, if a region is configured with 128 buckets and 1 redundant copy, this would show 256 buckets.

  • Region Data Distribution: This graph allows users to see how the data is currently distributed across the region hosting members. Users can choose to display this information based on Number of Entries, Entries in Bytes, Buckets per Server, or Values in Memory vs Values Only On Disk (GemFire 10.1+). If the data needs to be rebalanced, click on Rebalance Region at the top of the graph. Note: Rebalancing takes longer in regions with a large amount of data.

Replicate Regions

Regions that are of type Replicate display:

  • Type: The type of the region. For example, Replicate.

  • Total Number of Entries: The number of entries in the region.

  • Hosting Members: On which servers the region is present.

  • Statistics: If statistics have been enabled for the region or not. If statistics have not been enabled for the region, then the user cannot enable expiration.

  • Total Size of Entries: The size of the entries currently in the region. This is measured and displayed in bytes, KB, MB, GB, or TB.

  • Scope: The scope as configured for the replicate region.

Persistence, Expiration, Eviction

This section displays information about the configuration of persistence, expiration, and eviction, when configured. If these settings have not been configured, no information will be displayed.

Indexes

This table displays indexes that have been created for the region. It will not show indexes created by GemFire Search (formerly Lucene).

To create a new index, click Create Index, enter the required information, then click Create Index.

Cache Listeners, Loaders, and Writers

This section displays information about the configuration of cache listeners, loaders, and writers, if configured. If these have not been configured, no information will be displayed in this section.

Advanced Configurations

This section displays information for any advanced configuration settings that have been configured. If these have not been configured, no information will be displayed in this section.

Advanced configurations include settings such as:

  • Configured Gateway Senders
  • Colocated With Regions
  • Recovery Delay (ms)
  • Startup Recovery Delay (ms)
  • Eviction Object Sizer
  • Optimize Subscription Updates
  • Partition Resolvers
check-circle-line exclamation-circle-line close-line
Scroll to top icon