Changes for page Upgrading iSymphony

Last modified by Sean Hetherington on 2021/09/09 20:55

<
From version < 7.1 >
edited by colinw
on 2021/09/09 18:01
To version < 8.1 >
edited by michaely
on 2021/09/09 18:01
>
Change comment: Import

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Updating iSymphony
1 +Upgrading iSymphony
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.colinw
1 +XWiki.michaely
Content
... ... @@ -1,12 +1,12 @@
1 1  {{layout}}
2 2  {{layout-section ac:type="two_right_sidebar"}}
3 3  {{layout-cell}}
4 -= (% style="color: rgb(0,0,0);" %)Important - Please Read Before Updating(%%) =
4 += (% style="color: rgb(0,0,0);" %)Important - Please Read Before Upgrading(%%) =
5 5  
6 6  {{id name="notice"/}}
7 7  
8 -{{info title="Important Notes on upgrading from version 2.x.x to version 3.0.0"}}
9 -iSymphony 3.0.0 is a complete ground up rewrite of the iSymphony system. Because iSymphony 3.0.0 utilizes many new technologies and implements features and configuration in a completely new way, there is currently no direct upgrade path from iSymphony 2.x.x to iSymphony 3.0.0. If you are upgrading from a 2.x.x iSymphony install, you will have to deploy iSymphony 3.0.0 as a new installation and configure it from scratch. Please see [[doc:Installing iSymphony]] for details on how to perform a new installation. iSymphony 3.0.0 can be run along side iSymphony 2.x.x without issue.
8 +{{info title="Important Notes on upgrading from version 2.X to version 3.X"}}
9 +iSymphony 3 is a complete ground up rewrite of the iSymphony system. Because iSymphony 3 utilizes many new technologies and implements features and configuration in a completely new way, there is currently no direct upgrade path from iSymphony 2 to any version of iSymphony 3 or higher. If you are upgrading from iSymphony 2, you will have to deploy iSymphony 3 as a new installation and configure it from scratch. Please see [[doc:Installing iSymphony]] for details on how to perform a new installation. iSymphony versions 2 and 3 can be run simultaneously on the same system without issue.
10 10  {{/info}}
11 11  {{/layout-cell}}
12 12  
... ... @@ -21,96 +21,23 @@
21 21  
22 22  {{layout-section ac:type="single"}}
23 23  {{layout-cell}}
24 -= Updating =
24 += Prior to Upgrading =
25 25  
26 -{{warning}}
27 -Before upgrading your iSymphony 3 server make sure that your license supports the version that you are upgrading to.
26 +Before performing an upgrade, please ensure you have read and understood the steps required.
28 28  
29 -**If your license is out of maintenance and you are upgrading to a version that was released after your maintenance expired your __license will not work with the upgraded version__.**
28 +1. **Check to ensure that your licenses are compatible**.
29 +iSymphony 3 licenses are valid for any version that is released prior to the maintenance and support expiration date for that license. If you upgrade iSymphony to a version that is not supported by your license, your license will be removed and iSymphony will run in Lite mode. You can determine the mainenance and support expiration date for your license by navigating to //Settings//, then //Licensing// in the iSymphony administration interface. See the following pages for more information:
30 +1*. [[doc:Licensing]]
31 +1*. [[doc:LIC.Licensing and Purchasing FAQ]]
32 +1. **If you are using Remote Agents**, see the [[doc:Additional Upgrade Steps for Remote Agents]] page and ensure you follow the directions there as well.
33 +1. **If you are using the FreePBX module**, ensure that you have installed all updates to the FreePBX module. New features in iSymphony may require changes to the FreePBX module, so it's important that you upgrade the FreePBX module when upgrading iSymphony itself.
30 30  
31 -You can check your license's maintenance expiration date by navigating to **Settings -> Licensing** in the iSymphony Administration interface. See the following articles for more information:
35 += Upgrading =
32 32  
33 -* [[doc:Licensing]]
34 -* [[doc:LIC.Licensing and Purchasing FAQ]]
35 -{{/warning}}
37 +There are several methods of upgrading iSymphony. In general, we recommend using the automated update method, unless you have a specific reason to use the manual method, or the automatic method failed. See the following pages for details on each method:
36 36  
37 -
38 -
39 -You have two different options for updating your server to the latest version of iSymphony. Upgrades should be performed at a time when the system is not in use to reduce down time. We recommend that the manual update procedure only be used if the automated procedure fails or an automated update is not an option.
40 -
41 -{{info}}
42 -If using the FreePBX Module make sure to update it to the latest version.
43 -{{/info}}
44 -
45 -=== **Automated** ===
46 -
47 -1. Backup all files in** /opt/isymphony3/server/conf**
48 -1. Log into the iSymphony Administration page. See [[doc:Connecting to the Administration Interface]] for more information.
49 -1. Select **Global Configuration** in the top right hand corner of the administration window.
50 -1. If an update is available for download you will see a button next to **System** under **Modules** that reads **Download Update <version>**.
51 -1. Click on the **Download Update <version>** button to begin downloading the update.
52 -1. Once the download and decompression is complete click the button again to install the update.
53 -
54 -Once this is done the server will shutdown and apply the update. The server will then automatically restart.
55 -
56 -=== **Manual** ===
57 -
58 -The manual upgrade instructions will differ depending on the type of install you have:
59 -
60 -==== RPM ====
61 -
62 -1. Backup all files in** /opt/isymphony3/server/conf**
63 -1. (((
64 -Use the following command to stop your iSymphony Server:
65 -
66 -{{code language="bash"}}
67 -service iSymphonyServerV3 stop
68 -{{/code}}
69 -)))
70 -1. (((
71 -Once you have downloaded the new RPM to the server run the following command to apply the update.
72 -
73 -{{code language="bash"}}
74 -rpm -Uvh iSymphonyServerV3-<version>-1.noarch.rpm
75 -{{/code}}
76 -)))
77 -1. (((
78 -Restart your iSymphony Server using the following command:
79 -
80 -{{code language="bash"}}
81 -service iSymphonyServerV3 start
82 -{{/code}}
83 -)))
84 -
85 -==== Tarball ====
86 -
87 -1. Back up all files in **/opt/isymphony3/server/conf**.
88 -1. (((
89 -Shutdown the server.
90 -
91 -{{code language="bash"}}
92 -/opt/isymphony3/server/shutdown.sh
93 -{{/code}}
94 -)))
95 -1. (((
96 -Once you have downloaded the iSymphony tarball to your server run the following commands to apply the update.
97 -
98 -{{code language="bash"}}
99 -tar xzf iSymphonyServerV3<version>.tar.gz
100 -cd ./iSymphonyServerV3<version>
101 -chmod +x install.sh
102 -./install.sh
103 -{{/code}}
104 -
105 -The install script will detect the installed instance of iSymphony and apply the upgrades.
106 -)))
107 -1. (((
108 -Restart the server
109 -
110 -{{code language="bash"}}
111 -/opt/isymphony3/server/startup.sh
112 -{{/code}}
113 -)))
39 +* [[doc:Upgrading iSymphony with the Automatic Method]]
40 +* [[doc:Upgrading iSymphony with the Manual Method]]
114 114  {{/layout-cell}}
115 115  {{/layout-section}}
116 116  {{/layout}}
iSymphony