Upgrade vFabric GemFire from a JAR File

For non-RHEL users, upgrade vFabric GemFire on every virtual and physical machine that will run GemFire.

Note: Thoroughly test your development systems with the new version before moving into production.
Procedure
  1. Review the items listed in Before You Upgradeand make any appropriate preparations.
  2. Install the latest version of GemFire in a different directory than the existing version. See Install vFabric GemFire from a JAR File.
    Note: GemFire is installed as a complete product, rather than as a modification to a prior version. The Java JRE runtime environment is not bundled with GemFire, so you need to have an appropriate JDK or JRE installed and configured to comply with GemFire requirements and your unique system needs.
  3. Review the changes and upgrade notes that are documented in the vFabric GemFire Release Notes.
    • Review the vFabric GemFire 6.6.2 Release Notes. Make any changes to your applications that are required for you to migrate to this version. See Upgrading to GemFire 6.6.2 for a complete list of upgrade considerations.
    • If you are upgrading from a version earlier than GemFire 6.6, review all changes documented in the vFabric GemFire 6.6 Release Notes. Make any changes to your programs required for you to migrate to this version. In particular, you must update your licensing and licensing configuration to upgrade to GemFire 6.6.
  4. Recompile your Java applications against the gemfire.jar in this version of the product. After you have recompiled your Java applications, the location where you place the updated JARs will vary depending on your configuration. You may put them in the GemFire product tree or you could directly copy in the gemfire.jar file to a location appropriate for your application.
  5. Stop all members of the system running with the prior version. For example, using the shut-down-all command:
    gemfire –J-DgemfirePropertyFile=mygemfire.properties shut-down-all 
    In the sample command, substitute mygemfire.properties with the location of the previous vFabric GemFire's gemfire.properties file for the distributed system you are shutting down. See Shutting Down the System for more details.
  6. Stop all members of the system running with the prior version.
    • Shut down all members running a cache by using the gemfire shut-down-all command: Using the command:
      gemfire –J-DgemfirePropertyFile=mygemfire.properties shut-down-all 
      In the sample command, substitute mygemfire.properties with the location of the previous vFabric GemFire's gemfire.properties file for the distributed system you are shutting down. See Shutting Down the System for more details.
    • Shut down any locators. To shut down a locator in 6.x.x deployments, issue the following command:
      gemfire stop-locator -port=port -address=ipAddr -dir=locatorDir
      Replace port, ipAddr and locatorDir with the appropriate values.
  7. Point all member sessions to the new installation of GemFire. For example, you may need to do one of the following tasks depending on your application's configuration:
    • Modify your applications to point to the new GemFire product tree location.
    • Copy the gemfire.jar file out of the new GemFire product tree location and replace the existing gemfire.jar file in your application.
  8. Restart all system members according to your usual procedures. See Starting Up Your System for more information.
What to do next