This document contains information that is important to note when upgrading to iSymphony 3.3.2. 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 Distro will now package and redistribute the Open JDK instead of the Oracle JRE.
The following changes have been made to the FreePBX installation process in order to facilitate the move to the Open JDK, on FreePBX based systems. These changes only effect the iSymphony FreePBX RPM.
- On initial install, the iSymphony FreePBX RPM will now point to the OpenJDK by default, instead of the Oracle JRE.
- If upgrading iSymphony via yum, on a new FreePBX distro, the Open JDK will be installed and iSymphony will automatically be configured to use the Open JDK instead.
- If upgrading iSymphony manually, via the iSymphony FreePBX RPM, your original JRE path will be retained.
Reference the following document for more information on manually 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.