Prior to Upgrading

Before performing an upgrade, please ensure you have read and understood the steps required. 

1. Check to ensure that your licenses are compatible.
   iSymphony 3 licenses are valid for any version that is released prior to the maintenance and support expiration date for that license. If you upgrade iSymphony to a version that is not supported by your license, your license will be removed and iSymphony will run in Lite mode. You can determine the mainenance and support expiration date for your license by navigating to Settings, then Licensing in the iSymphony administration interface. See the following pages for more information:
   • Licensing
   • Licensing and Purchasing FAQ
2. If you are using Remote Agents, see the Additional Upgrade Steps for Remote Agents page and ensure you follow the directions there as well. 
3. If you are using the FreePBX module, ensure that you have installed all updates to the FreePBX module. New features in iSymphony may require changes to the FreePBX module, so it's important that you upgrade the FreePBX module when upgrading iSymphony itself. 

Upgrading

There are several methods of upgrading iSymphony. In general, we recommend using the automated update method, unless you have a specific reason to use the manual method, or the manual method failed. See the following pages for details on each method: 

• Upgrading iSymphony with the Automatic Method
• Upgrading iSymphony with the Manual Method

Automated

1. Backup all files in /opt/isymphony3/server/conf
2. Log into the iSymphony Administration page. See Connecting to the Administration Interface for more information.
3. Select Global Configuration in the top right hand corner of the administration window.
4. If an update is available for download you will see a button next to System under Modules that reads Download Update <version>.
5. Click on the Download Update <version> button to begin downloading the update.
6. Once the download and decompression is complete click the button again to install the update.

Once this is done the server will shutdown and apply the update. The server will then automatically restart. 

Manual

The manual upgrade instructions will differ depending on the type of install you have. See Determine the Installation Method for more information on how to determine your installation type.

RPM

1. Use the following command to stop your iSymphony Server:

   service iSymphonyServerV3 stop
2. Backup all files in /opt/isymphony3/server/conf. 

3. Once you have downloaded the new RPM to the server run the following command to apply the update.

   rpm -Uvh iSymphonyServerV3-<version>-1.noarch.rpm

4. Restart your iSymphony Server using the following command:

   service iSymphonyServerV3 start

Tarball

1. Shutdown the server.

   /opt/isymphony3/server/shutdown.sh
2. Back up all files in /opt/isymphony3/server/conf.

3. Once you have downloaded the iSymphony tarball to your server run the following commands to apply the update.

   tar xzf iSymphonyServerV3<version>.tar.gz
   cd ./iSymphonyServerV3<version>
   chmod +x install.sh
   ./install.sh

   The install script will detect the installed instance of iSymphony and apply the upgrades.

4. Restart the server

   /opt/isymphony3/server/startup.sh