Wiki source code of Reinstalling iSymphony

Last modified by michaely on 2021/09/09 20:55
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 = Overview =
5
6 In some cases you may need to perform a reinstallation of the iSymphony server application files, while keeping your configuration intact. This document takes you step by step on how to perform a reinstallation of the iSymphony server, if the need arises.
7 {{/layout-cell}}
8
9 {{layout-cell}}
10 {{panel title="On this page:"}}
11
12
13 {{toc/}}
14 {{/panel}}
15 {{/layout-cell}}
16 {{/layout-section}}
17
18 {{layout-section ac:type="single"}}
19 {{layout-cell}}
20 = Quick Steps =
21
22 {{info}}
23 The following is a list of summarized steps of the reinstallation process. **These steps should only be used by those that are familiar with details of administering an iSymphony server. **If you are not familiar with the iSymphony server installation process, follow the detailed steps in the subsequent sections.
24 {{/info}}
25
26 1. Stop the iSymphony server
27 1. Backup the /opt/isymphony3/ directory and its contents.
28 1. Uninstall the server and remove the /opt/isymphony3/ directory.
29 1. Perform a clean installation of the iSymphony server, utilizing an installation package with same version as the original installation.
30 1. Stop the iSymphony server, if running.
31 1. Remove the current /opt/isymphony3/server/conf directory.
32 1. Replace the conf directory with the version from the backup.
33 1. (((
34 If in a FreePBX environment run the following command:
35
36 {{code language="bash"}}
37 chown -R asterisk:asterisk /opt/isymphony3
38 {{/code}}
39 )))
40 1. Start the iSymphony server.
41
42 = Prior to Reinstalling =
43
44 == 1. Determine The Version Of The Current Install ==
45
46 You will need to use the same version of the current iSymphony installation for the reinstall. You can check the current version of the server via the following methods:
47
48 * Log into the iSymphony Client or Administrator interface. You will see the version in the footer.
49 * The about page in the iSymphony Client.
50 * The **Admin->iSymphony V3 **page, in the FreePBX web GUI.
51 * (((
52 By running the following command on the server command line:
53
54 {{code language="bash"}}
55 service iSymphonyServerV3 version
56 {{/code}}
57
58 {{info}}
59 The above command is only available in iSymphony 3.2+ RPM installations.
60 {{/info}}
61 )))
62
63 == 2. Determine The Required Installation Method ==
64
65 {{info}}
66 You can change the installation method during a reinstall. **Just ensure that the version of the installer is the same as the current install and you are using the correct installer for your environment.**
67 {{/info}}
68
69 To determine the correct installation method for your server see [[doc:Determine the Installation Method]]. You will need to download the correct installer package to the server before you begin.
70
71 == 3. Backup The Current Install (IMPORTANT) ==
72
73 {{warning}}
74 **If you do not create a backup, you will loose your configuration during reinstallation.**
75 {{/warning}}
76
77
78
79 We will need to backup the server configuration so that we can restore it later. To do this simply make a backup of the following directory and all its contents:
80
81 {{code language="bash"}}
82 /opt/isymphony3/
83 {{/code}}
84
85 = Reinstallation =
86
87 Follow the steps below to reinstall the iSymphony server.
88
89 1. Stop the iSymphony server. See [[doc:Starting And Stopping The iSymphony Server]].
90 1. Uninstall the iSymphony server. See [[doc:Uninstalling iSymphony]].
91 1. Remove the /opt/isymphony3 directory to get rid of any residual files.
92 1. (((
93 Run the installation package. See [[doc:Installing iSymphony]] for commands to run for each type of installation package.
94 )))
95
96 = Restore Configuration =
97
98 If you wish to restore your configuration from the original installation, follow the steps below:
99
100 1. Stop the iSymphony server, if it is running. See [[doc:Starting And Stopping The iSymphony Server]].
101 1. (((
102 Remove the following directory:
103
104 {{code}}
105 /opt/isymphony3/server/conf
106 {{/code}}
107
108 \\
109 )))
110 1. (((
111 Replace the conf directory, you just deleted, with the conf directory from the backup you made earlier.
112 )))
113 1. (((
114 **If you are in a FreePBX environment run the following comand **to ensure proper ownership of the installation.
115
116 {{code language="bash"}}
117 chown -R asterisk:asterisk /opt/isymphony3
118 {{/code}}
119 )))
120 1. Restart the iSymphony server. See [[doc:Starting And Stopping The iSymphony Server]].
121 {{/layout-cell}}
122 {{/layout-section}}
123 {{/layout}}

Search

Navigation

iSymphony