When you use the cluster configuration service in GemFire, you can examine the generated configuration. The gfsh export cluster-configuration command outputs configured properties, the configuration on a per-group basis or for the entire cluster, and the list of deployed JAR files.
If the output is written to either a ZIP file or an XML file, you can import this configuration to a new cluster. See Exporting and Importing Cluster Configurations.
Upon the deploy of a JAR file, the JAR file is added to a created directory called
cluster_config within the locator’s directory of files. Within
cluster_config will be another directory named for the member group that has the configuration. For configurations that apply to all members of a cluster, the directory is named either
cluster or the name specified when starting up the locator with the
When you start a locator using
gfsh, you should see the following message:
Cluster configuration service is up and running.
If you do not see this message, there may be a problem with the cluster configuration service. Use the
status cluster-config-service command to check the status of the cluster configuration.
status locatorcommand. The output of this command returns the cause of the WAITING status.
cache.xmlfile for configuration, there is a specific order to the application of the configuration in these files. GemFire applies the cluster-wide configuration files first. Group-level configurations follow. Last will be the configuration in a member’s own configuration files (
ClusterConfigurationNotAvailableException, the cluster configuration service may not be in the RUNNING state. Because the server requests the cluster configuration from the locator, which is not available, the
start servercommand fails.
start servercommand specifies a cache.xml file that conflicts with the existing cluster configuration, the server startup may fail.
gfsh command fails because the cluster configuration cannot be saved, the following message displays:
Failed to persist the configuration changes due to this command, Revert the command to maintain consistency. Please use "status cluster-config-service" to determine whether Cluster configuration service is RUNNING."
There are some types of configurations that cannot be made using
gfsh. See gfsh Limitations.