Wiki source code of Reinstalling iSymphony
Version 3.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}} | ||
| |
2.1 | 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 | |||
| |
1.1 | 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}} | ||
| |
3.1 | 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.** |
| |
1.1 | 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}} |