Running DiskConverterPre65to65

Use the DiskConverterPre65to65 to convert disks used in GemFire versions earlier than 6.5 to Pivotal GemFire 6.5.

Note: The DiskConverterPre65to65 tool described in this topic converts files from GemFire versions earlier than 6.5 to a format that is compatible with Pivotal GemFire 6.5. If you are upgrading to Pivotal GemFire 7.0, you need to perform an additional disk upgrade using the upgrade offline-disk-store command in gfsh to convert Pivotal GemFire 6.5 compatible disks to GemFire 7.0.

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

DiskConverterPre65to65 tool 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 gateway sender event queue contents and the regions that use the gateway sender for WAN distribution. 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 DiskConverterPre65to65, including examples, see the README.txt file in the DiskConverterPre65to65 directory.