Troubleshooting errors while upgrading Syncrify

Syncrify Server is designed to upgrade itself without needing to install it again. Upgrading is a two step process:

  1. Download necessary files from Synametrics' web site
  2. Restarting Syncrify
Restarting Syncrify
Even though restarting Syncrify occurs at the second step, it is required in order for upgrade to work. Therefore, try restarting Syncrify from the web interface by clicking Restart under Quick Links to ensure it works. Refer to Troubleshooting restart problem with Syncrify for steps on how to solve this problem.
Downloading Files
Your copy of Syncrify server downloads several files from Synametrics' web server during the upgrade process. Once the files are downloaded, the MD5 signatures are matched to ensure data integrity. If the MD5 signatures don't match, the upgrade won't occur and you will see errors in the Syncrify.log file.

Most of the time errors occur due to network problems, which are usually solved by simply retrying. However, before retrying we recommend you clean up the patches folder on the disk. Following steps demonstrate how to clean up:

  • Locate the patches folder on the disk. The path is usually set to C:\Syncrify\patches on Windows and /opt/Syncrify/pathces on Linux.
  • Delete every file but AppLancher.jar. It is very important you leave AppLauncher.jar in this folder. Failure to do so will break the upgrading process for good.
  • If you cannot delete a file because it is in use, try restarting Syncrify server.
  • Once the patches folder is clean, try upgrading Syncrify again.

Repeated errors

If you run into this problem repeatedly, consider the following reasons:

  • Older versions of the JRE may not trust the SSL certificate used on Synametrics' website. This could result in a communication errors. Refer to Upgrading JRE page to see if you need to upgrade your JRE.
  • Network traffic to the Internet is either blocked or not available. During upgrade, you copy of Syncrify contacts our web server on port 80 and/or 443. Ensure out-bound traffic on port 80 and 443 is not blocked.
  • Your firewall blocks .JAR files. Often .jar files are associated with applets and some firewalls may block them. Configure your firewall not to block .jar files.


Social Media

Powered by