The cluster configuration service exports and imports configurations created using gfsh
for an entire VMware GemFire cluster.
The cluster configuration service saves the cluster configuration as you create regions, disk-stores and other objects using gfsh
commands. You can export this configuration as well as any jar files that contain application files to a ZIP archive and then import this configuration to create a new cluster.
Issue the gfsh
export cluster-configuration
command to save the configuration data for your cluster in a ZIP archive. This ZIP file contains subdirectories for cluster-level configurations and a directory for each group specified in the cluster. The contents of these directories are described in Cluster Configuration Files and Troubleshooting.
To export a cluster configuration, run the gfsh
export cluster-configuration
command while connected to a GemFire cluster. For example:
export cluster-configuration --zip-file-name=/home/username/configs/myClusterConfig.zip
See export cluster-configuration.
Note: gfsh
only saves cluster configuration values for configurations specified using gfsh
. Configurations created by the management API are not saved with the cluster configurations.
Use the gfsh
import cluster-configuration
command to configure a new cluster based on a configuration exported from another system. You can import a cluster configuration only into a new cluster, or into a running cluster that has not yet been configured and contains no defined regions. That is, when:
or
After you have imported the configuration, any servers you start receive this cluster configuration.
To import a cluster configuration, start one or more locators and then run the gfsh
import cluster-configuration
command. For example:
import cluster-configuration --zip-file-name=/home/username/configs/myClusterConfig.zip