Running DiskFileConverter

The DiskFileConverter tool is provided in the GemFire product installation DiskConverter/bin directory in a Linux shell script, DiskFileConverter.sh.

DiskFileConverter takes input and output cache.xml files, with disk persistence specifications, and old and new GemFire version specifications.

At an operating system prompt, enter this command line:

./DiskFileConverter.sh  [OLD_CACHE_XML=old_version_cache_XML_file] [CACHE_XML=new_version_cache_XML_file] [OLD_GEMFIRE=old_version_gemfire_product_location] [GEMFIRE=new_version_gemfire_product_location] [CLASSPATH=classpath_specification]
Example, run from the product's DiskConverter directory:
bin/DiskFileConverter.sh OLD_CACHE_XML=examples/e2_601.xml
   NEW_CACHE_XML=examples/e2_65.xml OLD_GEMFIRE=/export/GemFire/gemfire601
   NEW_GEMFIRE=/export/GemFire/gemfire6511

Provide the cache.xml files and GemFire versions at the command line, or set them as environment variables. For example, you could set the environment variable OLD_CACHE_XML and not explicitly provide the OLD_CACHE_XML specification at the command line.

The disk file converter only uses the elements of your cache.xml files that pertain to disk persistence. For example, cache writer and listener specifications are not relevant and are ignored. So you could provide partial files to the converter tool. If you provide partial files, make sure to provide specifications for all information that was persisted to disk in the older version. This includes any persisted WAN gateway event queue contents and the regions with WAN gateway communication enabled. The most simple way to run the tool is with the complete old version and new version cache.xml files.

For more information on the DiskFileConverter, including examples, see the README.txt file in the DiskConverter directory.