Upgrading to iSymphony Version 3.4.2 or later will include the desktop module by default. Skip this document and proceed to Adding New Desktop Client Installers if v3.4.2+ is installed.
Installing an old desktop client module on a 3.4.2 or later system will leave the desktop client functionally broken, please see:
1. Download The Desktop Client Module
You need to download the Desktop Module for this step, not the desktop installers. The downloaded file should be a .tar.gz, not a .zip.
The URL should look like the following, with the exception of the version, which will be replaced with the version you are downloading:
After step 2 you should have extracted a directory named "desktop", if that is not the case, you used the wrong url. To recover, remove the directory you just extracted from the module directory, and then return to step 1.
2. Extract The Desktop Client Module
Run the following command to extract the module to the iSymphony Server installation. You need to be in the same directory as the downloaded Desktop Client Module package when running this command.
3. Set The File Ownership Of The Desktop Module
The file ownership of the desktop module must match that of the rest of the iSymphony Server installation.
Checking File Ownership Of The iSymphony Server Installation
To check the file ownership of the iSymphony Server installation you can run the following command, on the server command line:
The user that owns the iSymphony server installation will be the user that owns the isymphony3 directory in the opt directory.
Notes on FreePBX & AsteriskNow
If your iSymphony server was installed from one of the following sources, the iSymphony server installation will be owned by the asterisk user.
- Came pre-installed with the FreePBX or AsteriskNow distros.
- Installed via the FreePBX Yum repositories.
- Installed via the iSymphony FreePBX RPM.
Setting The Ownership Of The Desktop Client Module
To set the ownership of the Desktop Client Module you can run the following command, on the server command line:
Replace <ownername> with the name of the user that owns the iSymphony installation and replace <ownergroup> with the group the user belongs to.
For example, if you are running on FreePBX installation of iSymphony, you will use the following command:
4. Restart The iSymphony Server
Once the Desktop Client Module is installed, you will have to restart the iSymphony Server in order to activate the module. See Starting And Stopping The iSymphony Server.
5. Add The Desktop Client Installers
The installers served by iSymphony can be added by downloading the .zip archive and moving it to the iSymphony installers directory:
The latest version of the desktop client will be served. If no installers are added to the installers directory then the legacy installers (version < 2.0.0) will be served instead.
See Adding New Desktop Client Installers for more information.
6. Install The Desktop Client On The Client Machines
Once the Desktop Client Module is installed, your users will now be able to download and install the Desktop Client Application on their machines. See Desktop Client Installation v2.0.0 or for legacy versions see Desktop Client Installation v1.0.1.