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.
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.
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:
Partition
, Replicate
, or Persistent Replicate
. For more information about data policies, see Region Data Policies in the VMware GemFire product documentation.Actions available from the Actions menu:
Edit: Editing the region allows the user to:
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.
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).
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.
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.
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.
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.
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.
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: