export

This topic describes the export command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to export configurations, data, logs, and stack-traces.

• export cluster-configuration

  Export a cluster configuration ZIP file that contains the cache.xml files, gemfire.properties files, and application JAR files needed to configure and operate a cluster.

• export config

  Export configuration properties for a member or members.

• export data

  Export user data from a region to a file.

• export logs

  Export logs to a given directory.

• export offline-disk-store

  Export region data from an offline disk store into gemfire snapshot files.

• export stack-traces

  Export the stack trace for a member or members.

export cluster-configuration

Exports a single XML file or a ZIP file with cluster configuration that contains the cache.xml files, gemfire.properties files, and application JAR files needed to configure and operate a cluster.

When neither a file name nor a ZIP file name is specified, the cluster configuration is written to standard output.

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

See Overview of the Cluster Configuration Service.

Syntax:

export cluster-configuration [--group(=value)?] [--xml-file=value]
 [--zip-file-name=value]

Export Cluster-Configuration Parameters:

Name	Description	Default Value
‑‑group	Export the configuration for the specified server group. When no group is specified, use the default cluster group.
‑‑xml-file	Filename to contain the exported cluster configuration. May also include an absolute or relative path. Only specify one of --xml-file or --zip-file-name.
‑‑zip-file-name	Filename of the ZIP file to contain the exported cluster configuration. May also include an absolute or relative path. Only specify one of --xml-file or --zip-file-name.

Example Commands:

gfsh>export cluster-configuration --zip-file-name=/group/shared-configs/devClusterConfig.zip
gfsh>export cluster-configuration --zip-file-name=my-configs/myConfig.zip
gfsh>export cluster-configuration --zip-file-name=myClusterConfig.zip
gfsh>export cluster-configuration --xml-file=Cluster3Config.xml

Sample Output:

gfsh>export cluster-configuration --zip-file-name=mySharedConfig.zip
Downloading cluster configuration : /home/username/gemfire/mySharedConfig.zip

export config

Export configuration properties for a member or members.

If you do not specify any parameters, all member configurations will be exported.

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

Syntax:

export config [--members=value(,value)*] [--groups=value(,value)*]
[--dir=value]

Export Config Parameters:

Name	Description
‑‑members	Name/Id of the members whose configuration will be exported.
‑‑groups	Groups of members whose configuration will be exported.
‑‑dir	Directory to which the exported configuration files will be written.

Example Commands:

export config
export config --members=member1

Sample Output:

gfsh>export config --members=member1
Downloading Cache XML file: c:\VMwareGemFire\Latest\.\member1-cache.xml
Downloading properties file: c:\VMwareGemFire\Latest\.\member1-gf.properties

export data

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

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

Syntax:

To export data from any region, replicated or partitioned, sequentially to a single file, use the --file option:

export data --region=value --member=value --file=value

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

In the case of partitioned regions, you can speed up the export process by using the --parallel option:

export data  --parallel --region=value --member=value --dir=value

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

• Parallel export applies only to partitioned regions.

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

Export Data Parameters:

Name	Description
‑‑region	Required. Region from which data is to be exported.
‑‑member	Required. Name/ID of a member that hosts the region. In a serial export, all data is exported to the specified file on the host where the member is running. In a parallel export, data from a partitioned region partially hosted on this member is exported for each partition to files on the nodes that host those partitions.
‑‑file	File to which the exported data is to be written. The file must have an extension of .gfd. Cannot be specified at the same time as ‑‑dir, cannot be used with ‑‑parallel.
‑‑dir	Directory to which the exported data is to be written. Required if ‑‑parallel is true. Cannot be specified at the same time as ‑‑file.
‑‑parallel	Export local data on each node to a directory on that machine. Available for partitioned regions only.

Example Commands:

export data --region=region2 --file=region2_20121001.gfd --member=server2

Sample Output:

 gfsh>export data --region=region2 --file=region2_20121001.gfd --member=server1
Data succesfully exported from region : region2 to file : C:\VMwareGemFire\
Latest\server1\region2_20121001.gfd on host : 192.0.2.0

export logs

Export logs to a given directory.

All files that have logs in the specified time range will be exported. If no time range is specified, all logs will be exported.

The --dir parameter specifies a local directory to which log files will be written. This is used only when you are exporting logs using an http connection. If executed over http, the zip archive will be saved in the specified directory on the user’s client machine. If not specified, logs are written to the location specified by the user.dir system property. When the command is executed over JMX, logs will be saved as exportedLogs_xxx.zip in the connected locator’s working directory.

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

Syntax:

export logs [--dir=value] [--groups=value(,value)*] [--members=value(,value)*] 
[--log-level=value] [--only-log-level=value] [--merge-log=value] 
[--start-time=value] [--end-time=value] [logs-only(=value)?] 
[--stats-only(=value)?] [--file-size-limit(=value)?]

Export Logs Parameters:

Name	Description	Default Value
‑‑dir	Local directory to which log files will be written when logs are exported using an http connection. Ignored when the command is executed over JMX.
‑‑groups	Groups of members whose log files will be exported.
‑‑members	Name/ID of the members whose log files will be exported.
‑‑log-level	Minimum level of log entries to export. Valid values are: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, and ALL.	INFO
‑‑only-log-level	Whether to only include only entries that exactly match the ‑‑log-level specified.	false
‑‑merge‑log	Whether to merge logs after exporting to the target directory (deprecated).	false
‑‑start-time	Log entries that occurred after this time will be exported. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd. When using the yyyy/MM/dd/HH/mm/ss/SSS/z format, the time zone, denoted z, should be specified as either a 3-letter time zone such as PST or as an offset to GMT/UTC such as GMT+08:00.	no limit
‑‑end-time	Log entries that occurred before this time will be exported. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd. When using the yyyy/MM/dd/HH/mm/ss/SSS/z format, the time zone, denoted z, should be specified as either a 3-letter time zone such as PST or as an offset to GMT/UTC such as GMT+08:00. An end time specified by only a date implements a time of 00:00. This exports logs written up until 23:59:59.999 on the date prior to the one specified.	no limit
‑‑logs-only	Whether to export only logs (not statistics)	If parameter not specified: false. If parameter specified without a value: true
‑‑stats-only	Whether to export only statistics (not logs)	If parameter not specified: false. If parameter specified without a value: true
‑‑file-size-limit	Limits total unzipped size of the exported files. Specify 0 (zero) for no limit. Value is in megabytes by default or [k,m,g,t] may be specified.	If parameter not specified: 100m. If parameter specified without a value: 0

Example commands, showing output:

gfsh>export logs --dir=data/logs
Logs exported to the connected member's file system: /my-locator/data/logs/exportedLogs_1489513007261.zip

gfsh>export logs --start-time=2020/12/14/12/00/00/000/GMT-08:00 --end-time=2020/12/27 --dir=data/logs
Start time parsed as 2020-12-14T12:00 PST
End time parsed as 2020-12-27T00:00 PST
Logs exported to the connected member's file system: /my-locator/data/logs/exportedLogs_1608165308676.zip

gfsh>export logs --dir=data/logs --file-size-limit=1k
Estimated exported logs expanded file size = 95599, file-size-limit = 1024.
To deactivate exported logs file size check use option "--file-size-limit=0".

gfsh>export logs --dir=data/logs --file-size-limit=99k
Logs exported to the connected member's file system: /my-locator/data/logs/exportedLogs_1489513007261.zip

export offline-disk-store

Export region data from an offline disk store into GemFire snapshot files.

Availability: Online or offline.

Syntax:

export offline-disk-store --name=value --disk-dirs=value(,value)* --dir=value

Export Offline-Disk-Store Parameters:

Name	Description
‑‑name	Required. Name of the disk store to be exported.
‑‑disk-dirs	Directories which contain the disk store files.
‑‑dir	Directory to export the snapshot files to.

Example Commands:

 export offline-disk-store --name= DiskStore1 \
--disk-dirs=/home/username/gemfire/mydiskStore1Dir --dir=/home/username/gemfire/export

export stack-traces

Export the stack trace for one or more cluster members (locators and servers).

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

Syntax:

export stack-traces [--members=value(,value)*] [--groups=value(,value)*]
[--file=value] [--abort-if-file-exists(=value)?]

Export Stack-Traces Parameters:

Name	Description
‑‑members	Name or ID of the members whose stack traces will be exported.
‑‑groups	Groups of members whose stack traces will be exported.
‑‑file	File name to which the stack traces will be written. When not specified, the file name will be the string “stacktrace_” followed by the current time in milliseconds.
‑‑abort-if-file-exists	When true, abort the command if the file already exists in the locator’s directory. If this option is not specified, the default value is false.

Example Commands:

export stack-traces --file=stack.txt --abort-if-file-exists=true

Sample Output:

gfsh>export stack-traces
stack-traces exported to file: /data/stacktrace_1612316330340
On host : cluster-locator-0.cluster-locator.system.svc.cluster.local