Apache Geode

import

You can import an exported cluster configuration to create a new cluster or import data into a region.

• import cluster-configuration

  Import a cluster configuration.

• import data

  Import user data from a file to a region.

import cluster-configuration

Imports a previously exported cluster configuration from a zip file. This command is useful when spinning up a new cluster.

• In a given cluster, only one locator needs to perform the import. That locator shares the imported configuration with all other connected locators in the distributed system.
• Locators share the imported configuration with data members (servers) when the servers start, or if the servers have been recently started, have no regions defined in them, and have been given no other configuration changes since they started.

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

Availability: Online. You must be connected in gfsh to a locator to use this command.

Syntax:

import cluster-configuration --zip-file-name=value

Import Cluster-Configuration Parameters:

Example Commands:

gfsh>import cluster-configuration --zip-file-name=/home/username/myClusterConfig.zip

Sample Output:

gfsh>import cluster-configuration --zip-file-name=/home/username/myClusterConfig.zip
Cluster configuration successfully imported

import data

Import user data from a file or files to a region.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

If the data was exported sequentially to a single file, use the serial form of the import command to import the data:

import data --region=value --file=value --member=value [--invoke-callbacks=value]

In this scenario, data from replicated and partitioned regions is imported sequentially from a single file on the specified member.

See export data for an explanation of the difference between serial and parallel data exports.

If the data was exported from a partitioned region in parallel format, use the --parallel option to import the data:

import data --parallel --region=value --member=value --dir=value
  [--invoke-callbacks=value]

In this scenario, partitioned region data is imported simultaneously on all hosting nodes from directories local to those respective nodes.

• Parallel import applies only to partitioned regions exported in parallel mode.

• The --file and --dir options are mutually exclusive; --file can be used only for serial import, --dir can be used for both serial and parallel imports.

Import Data Parameters:

Example Commands:

import data --region=region2 --file=/mnt5/region2_20121001.gfd --member=server1