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}} |