Wiki source code of Updating iSymphony

Version 6.1 by michaely on 2021/09/09 18:01

Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 = (% style="color: rgb(0,0,0);" %)Important - Please Read Before Updating(%%) =
5
6 {{id name="notice"/}}
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.
10 {{/info}}
11 {{/layout-cell}}
12
13 {{layout-cell}}
14 {{panel title="On this page:"}}
15
16
17 {{toc/}}
18 {{/panel}}
19 {{/layout-cell}}
20 {{/layout-section}}
21
22 {{layout-section ac:type="single"}}
23 {{layout-cell}}
24 = Updating =
25
26 {{warning}}
27 Before upgrading your iSymphony 3 server make sure that your license supports the version that you are upgrading to.
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__.**
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:
32
33 * [[doc:Licensing]]
34 * [[doc:LIC.Licensing and Purchasing FAQ]]
35 {{/warning}}
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. See [[doc:Determine the Installation Method]] for more information on how to determine your installation type.
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 )))
114 {{/layout-cell}}
115 {{/layout-section}}
116 {{/layout}}
iSymphony