Pivotal GemFire® v8.1

Exporting and Importing Cluster Configurations

Exporting and Importing Cluster Configurations

The cluster configuration service exports and imports configurations created using gfsh for an entire Pivotal GemFire cluster.

The cluster configuration service saves the cluster configuration as you create a 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 file and then import this configuration to create a new cluster.

Exporting a Cluster Configuration

You issue the gfsh export cluster-configuration command to save the configuration data for you cluster in a zip file. 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 export cluster-configuration gfsh command while connected to a Pivotal GemFire cluster. For example:

export cluster-configuration --dir=/home/username/configs

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.

Importing a Cluster Configuration

You can import a cluster configuration to a running locator. After importing the configuration, any servers you start receive this cluster configuration.

To import a cluster configuration, start one or more locators and then run the import cluster-configuration gfsh command. For example:

import cluster-configuration --zip-file-name=/home/username/configs/

See import cluster-configuration.

Note: You cannot import a cluster configuration to a cluster where cache servers are already running.