Wiki source code of Reinstalling iSymphony
Version 4.1 by michaely on 2021/09/09 18:02
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
1.1 | 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 | = Prior to Reinstalling = | ||
21 | |||
22 | == 1. Determine The Version Of The Current Install == | ||
23 | |||
24 | 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: | ||
25 | |||
26 | * Log into the iSymphony Client or Administrator interface. You will see the version in the footer. | ||
27 | * The about page in the iSymphony Client. | ||
28 | * The **Admin->iSymphony V3 **page, in the FreePBX web GUI. | ||
29 | * ((( | ||
30 | By running the following command on the server command line: | ||
31 | |||
32 | {{code language="bash"}} | ||
33 | service iSymphonyServerV3 version | ||
34 | {{/code}} | ||
35 | |||
36 | {{info}} | ||
37 | The above command is only available in iSymphony 3.2+ RPM installations. | ||
38 | {{/info}} | ||
39 | ))) | ||
40 | |||
41 | == 2. Determine The Required Installation Method == | ||
42 | |||
43 | {{info}} | ||
![]() |
3.1 | 44 | You can change the installation method during a reinstall. **Just ensure that the version of the installer is the same as the current install.** |
![]() |
1.1 | 45 | {{/info}} |
46 | |||
47 | 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. | ||
48 | |||
49 | == 3. Backup The Current Install (IMPORTANT) == | ||
50 | |||
51 | {{warning}} | ||
52 | **If you do not create a backup, you will loose your configuration during reinstallation.** | ||
53 | {{/warning}} | ||
54 | |||
55 | |||
56 | |||
57 | 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: | ||
58 | |||
59 | {{code language="bash"}} | ||
60 | /opt/isymphony3/ | ||
61 | {{/code}} | ||
62 | |||
63 | = Reinstallation = | ||
64 | |||
65 | Follow the steps below to reinstall the iSymphony server. | ||
66 | |||
67 | 1. Stop the iSymphony server. See [[doc:Starting And Stopping The iSymphony Server]]. | ||
68 | 1. Uninstall the iSymphony server. See [[doc:Uninstalling iSymphony]]. | ||
69 | 1. Remove the /opt/isymphony3 directory to get rid of any residual files. | ||
70 | 1. ((( | ||
71 | Run the installation package. See [[doc:Installing iSymphony]] for commands to run for each type of installation package. | ||
72 | ))) | ||
73 | |||
74 | = Restore Configuration = | ||
75 | |||
76 | If you wish to restore your configuration from the original installation, follow the steps below: | ||
77 | |||
78 | 1. Stop the iSymphony server, if it is running. See [[doc:Starting And Stopping The iSymphony Server]]. | ||
79 | 1. ((( | ||
80 | Remove the following directory: | ||
81 | |||
82 | {{code}} | ||
83 | /opt/isymphony3/server/conf | ||
84 | {{/code}} | ||
85 | |||
86 | \\ | ||
87 | ))) | ||
88 | 1. ((( | ||
89 | Replace the conf directory, you just deleted, with the conf directory from the backup you made earlier. | ||
90 | ))) | ||
![]() |
4.1 | 91 | 1. **If you are in a FreePBX environment run the following comand **to ensure proper ownership of the installation. |
![]() |
1.1 | 92 | |
![]() |
4.1 | 93 | |
94 | |||
95 | |||
96 | |||
97 | |||
98 | |||
99 | |||
![]() |
1.1 | 100 | {{/layout-cell}} |
101 | {{/layout-section}} | ||
102 | {{/layout}} |