This documentation relates to iSymphony 3.5. You can view older documentation on the Older Documentation page

Skip to end of metadata
Go to start of metadata


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.

On this page:

Quick Steps

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.

  1. Stop the iSymphony server
  2. Backup the /opt/isymphony3/ directory and its contents.
  3. Uninstall the server and remove the /opt/isymphony3/ directory.
  4. Perform a clean installation of the iSymphony server, utilizing an installation package with same version as the original installation.
  5. Stop the iSymphony server, if running.
  6. Remove the current /opt/isymphony3/server/conf directory.
  7. Replace the conf directory with the version from the backup.
  8. If in a FreePBX environment run the following command:

    chown -R asterisk:asterisk /opt/isymphony3
  9. Start the iSymphony server.

Prior to Reinstalling

1. Determine The Version Of The Current Install

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:

  • Log into the iSymphony Client or Administrator interface. You will see the version in the footer.
  • The about page in the iSymphony Client.
  • The Admin->iSymphony V3 page, in the FreePBX web GUI.
  • By running the following command on the server command line:

    service iSymphonyServerV3 version

    The above command is only available in iSymphony 3.2+ RPM installations.

2. Determine The Required Installation Method

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.

To determine the correct installation method for your server see Determine the Installation Method. You will need to download the correct installer package to the server before you begin.

3. Backup The Current Install (IMPORTANT)

If you do not create a backup, you will loose your configuration during reinstallation.


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:



Follow the steps below to reinstall the iSymphony server.

  1. Stop the iSymphony server. See Starting And Stopping The iSymphony Server.
  2. Uninstall the iSymphony server. See Uninstalling iSymphony.
  3. Remove the /opt/isymphony3 directory to get rid of any residual files.
  4. Run the installation package. See Installing iSymphony for commands to run for each type of installation package.

Restore Configuration

If you wish to restore your configuration from the original installation, follow the steps below:

  1. Stop the iSymphony server, if it is running. See Starting And Stopping The iSymphony Server.
  2. Remove the following directory:


  3. Replace the conf directory, you just deleted, with the conf directory from the backup you made earlier.

  4. If you are in a FreePBX environment run the following comand to ensure proper ownership of the installation. 

    chown -R asterisk:asterisk /opt/isymphony3
  5. Restart the iSymphony server. See Starting And Stopping The iSymphony Server.