Wiki source code of iSymphony 3.3.2 Upgrade Notes

Last modified by superadmin on 2021/09/09 20:56

Show last authors
1 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.
2
3 {{info}}
4 (% class="confluence-information-macro-body" %)
5 (((
6 (% class="confluence-information-macro-body" %)
7 (((
8 If you are upgrading from a 3.1.x system, make sure to read the [[doc:iSymphony 3\.2\.2 Upgrade Notes]][[ >>url:http://docs.getisymphony.com/display/ISYM33/iSymphony+3.2.2+Ugrade+Notes||shape="rect"]]as well.
9 )))
10 )))
11 {{/info}}
12
13 == Notes For Users Who Have Made Custom Modifications To The jvm.args File (Including Remote Voicemail/Recording Agent Installations) ==
14
15 {{info}}
16 This issue only effects RPM upgrades. Upgrades performed via the Administration Interface or via the tarball are not effected.
17 {{/info}}
18
19 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:
20
21 {{code}}
22 iSymphonyServerV3 warning: /opt/isymphony3/server/jvm.args saved as /opt/isymphony3/server/jvm.args.rpmsave
23 {{/code}}
24
25 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.
26
27 == Support Announcements ==
28
29 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.
30
31 {{note}}
32 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.
33
34 * On initial install, the iSymphony FreePBX RPM will now point to the OpenJDK by default, instead of the Oracle JRE.
35 * 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.
36 * If upgrading iSymphony manually, via the iSymphony FreePBX RPM, your original JRE path will be retained.
37 {{/note}}
38
39 Reference the following document for more information on manually setting up the Open JDK: [[doc:iSymphony 3\.5 Documentation.iSymphony Installation and Update Guide.Installing iSymphony.Advanced Installation Topics.Using The Open JDK.WebHome]]
40
41 == End of Support Announcements ==
42
43 Support is being dropped for Asterisk version 1.8, 10, and 12. iSymphony will continue to officially support Asterisk version 11 and 13.
44
45 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>>url:http://docs.getisymphony.com/display/ISYM33/Supported+Platforms||shape="rect"]] page for more details.
46
47 {{warning title="JRE Upgrade"}}
48 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:
49
50 {{code}}
51 Failed to start: The server requires a Java (JRE) version of 1.8, or higher
52 {{/code}}
53
54 You can download the latest version of the JRE from the following page: [[http:~~/~~/www.java.com/en/download/linux_manual.jsp>>url:http://www.java.com/en/download/linux_manual.jsp||shape="rect"]]
55
56 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.
57
58 [[If you are not sure which architecture your server is running (64-bit vs 32-bit), you can run the following command:>>url:http://www.java.com/en/download/linux_manual.jsp||shape="rect"]]
59
60 {{code}}
61 uname -a
62 {{/code}}
63
64 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.
65
66 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.
67
68 {{code}}
69 /opt/isymphony3/server/config.sh
70 {{/code}}
71 {{/warning}}
72
73 == Upgrade Steps ==
74
75 Follow the standard upgrade instructions found in the [[doc:iSymphony 3\.5 Documentation.iSymphony Installation and Update Guide.Upgrading iSymphony.WebHome]] document for all upgrades.
76
77 {{note}}
78 You will also need to upgrade any voicemail and recording agent installations, as the protocol has changed.
79 {{/note}}
iSymphony