Wiki source code of Updating iSymphony

Version 2.1 by colinw 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 Upgrading(%%) =
5
6 {{id name="notice"/}}
7
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.X 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 {{/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 = Prior to Upgrading =
25
26 Before performing an upgrade, please ensure you have read and understood the steps required.
27
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 [[Additional Upgrade Steps for Remote Agents>>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.
34
35 = Upgrading =
36
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 manual method failed. See the following pages for details on each method:
38
39 * [[Upgrading iSymphony with the Automatic Method>>doc:Upgrading iSymphony with the Automatic Method]]
40 * [[Upgrading iSymphony with the Manual Method>>doc:Upgrading iSymphony with the Manual Method]]
41
42
43
44 === **Automated** ===
45
46 1. Backup all files in** /opt/isymphony3/server/conf**
47 1. Log into the iSymphony Administration page. See [[doc:Connecting to the Administration Interface]] for more information.
48 1. Select **Global Configuration** in the top right hand corner of the administration window.
49 1. If an update is available for download you will see a button next to **System** under **Modules** that reads **Download Update <version>**.
50 1. Click on the **Download Update <version>** button to begin downloading the update.
51 1. Once the download and decompression is complete click the button again to install the update.
52
53 Once this is done the server will shutdown and apply the update. The server will then automatically restart.
54
55 === **Manual** ===
56
57 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.
58
59 {{info}}
60 If your installation method used the FreePBX RPM make sure you use the FreePBX RPM to upgrade. If not the upgrade will fail.
61 {{/info}}
62
63
64
65 ==== RPM ====
66
67 1. (((
68 Use the following command to stop your iSymphony Server:
69
70 {{code language="bash"}}
71 service iSymphonyServerV3 stop
72 {{/code}}
73 )))
74 1. Backup all files in** **/opt/isymphony3/server/conf**. **
75 1. (((
76 Once you have downloaded the new RPM to the server run the following command to apply the update.
77
78 {{code language="bash"}}
79 rpm -Uvh iSymphonyServerV3-<version>-1.noarch.rpm
80 {{/code}}
81 )))
82 1. (((
83 Restart your iSymphony Server using the following command:
84
85 {{code language="bash"}}
86 service iSymphonyServerV3 start
87 {{/code}}
88 )))
89
90 ==== Tarball ====
91
92 1. (((
93 Shutdown the server.
94
95 {{code language="bash"}}
96 /opt/isymphony3/server/shutdown.sh
97 {{/code}}
98 )))
99 1. Back up all files in /opt/isymphony3/server/conf.
100 1. (((
101 Once you have downloaded the iSymphony tarball to your server run the following commands to apply the update.
102
103 {{code language="bash"}}
104 tar xzf iSymphonyServerV3<version>.tar.gz
105 cd ./iSymphonyServerV3<version>
106 chmod +x install.sh
107 ./install.sh
108 {{/code}}
109
110 The install script will detect the installed instance of iSymphony and apply the upgrades.
111 )))
112 1. (((
113 Restart the server
114
115 {{code language="bash"}}
116 /opt/isymphony3/server/startup.sh
117 {{/code}}
118 )))
119 {{/layout-cell}}
120 {{/layout-section}}
121 {{/layout}}

Search

Navigation

iSymphony