This document contains information that is important to note when upgrading to iSymphony 3.3.1. Please be sure to completely read the information before upgrading.
Notes For Users Who Have Made Custom Modifications To The jvm.args File (Including Remote Voicemail/Recording Agent Installations)
This issue only effects RPM upgrades. Upgrades performed via the Administration Interface or via the tarball are not effected.
This version of iSymphony contains a modification to the jvm.args file. If you have made modifications to the jvm.args file in the installation (i.e. to set the broker path for a remote voicemail/recording), and you are upgrading with the RPM, you may see a message like the following when running the RPM upgrade:
This means that your original
jvm.args file has been overwritten with the new default version, and your original file has been saved as
jvm.args.rpmsave. To retain your custom modifications, simply re-add the modifications in the new
jvm.args file, using the
jvm.args.rpmsave file as reference. Once the
jvm.args file is configured to your liking, restart the iSymphony server for the changes to take effect.
Support has been added for the Open JDK version 1.8 and higher. New versions of the FreePBX Module will now package and redistribute the Open JDK instead of the Oracle JRE. The module is configued by default to point to the Open JDK.
Reference the following document for more information on setting up the Open JDK: Using The Open JDK
End of Support Announcements
Support is being dropped for Asterisk version 1.8, 10, and 12. iSymphony will continue to officially support Asterisk version 11 and 13.
Support for the Oracle JRE v1.7 is being dropped. If you are running Java 7, you will need to upgrade to Oracle Java 8 or above. See the Supported Platforms page for more details.
If you are currently running a JRE version of 1.7 or lower and you do not upgrade your JRE to version 1.8 or higher, iSymphony will fail to start with the following message:
You can download the latest version of the JRE from the following page: http://www.java.com/en/download/linux_manual.jsp
Verify that you are downloading the correct RPM for your system. For example if you are running a 64-bit FreePBX disto installation you will want to download the Linux x64 RPM. Installation instructions are provided on the page.
If you see X86_64 or amd64 you are running a 64-bit system. If you see i386 you are running a 32-bit architecture.
When starting the iSymphony service if you are still receiving a Java error after installing JRE 1.8 or higher then you need to update where iSymphony is looking for the JRE. You can do this buy running the following script and specifying the path to the v1.8+ JRE.
Follow the standard upgrade instructions found in the Upgrading iSymphony document for all upgrades.
You will also need to upgrade any voicemail and recording agent installations, as the protocol has changed.