Last modified by michelk on 2021/09/09 20:55
Hide last authors
michaely 1.1 1 {{layout}}
michelk 23.1 2 {{layout-section ac:type="single"}}
3 {{layout-cell}}
4 {{warning}}
5 Upgrading to iSymphony Version 3.4.2 or later will include the desktop module by default. Skip this document and proceed to [[doc:Adding New Desktop Client Installers]] if v3.4.2+ is installed.
6
7 Installing an old desktop client module on a 3.4.2 or later system will leave the desktop client functionally broken, please see:
8
9 [[doc:ISYMKB.Desktop Client V2 cannot connect to iSymphony server and cannot be downloaded from web interface]]
10 {{/warning}}
11 {{/layout-cell}}
12 {{/layout-section}}
13
michaely 1.1 14 {{layout-section ac:type="two_right_sidebar"}}
15 {{layout-cell}}
michelk 23.1 16
17
18
19
michaely 1.1 20 = Overview =
21
michaely 22.1 22 This document covers how to install the optional Desktop Client Module, on an existing iSymphony server installation. If you have not yet installed the iSymphony server see [[doc:Getting Started]].
michaely 1.1 23
michaely 22.1 24 The Desktop Client Module allows users to download and install the Desktop Client Application on their machines. The Desktop Client Application allows users to utilize the iSymphony client interface from within a native application that runs on the user's machine. This allows iSymphony to act as a native application, with its own window and shortcuts. The Desktop Client Application also allows for functionality like Global Hot Key focusing and application based CRM popups.
michaely 1.1 25
michelk 23.1 26
27
michaely 1.1 28 {{warning}}
29 The Desktop Client Module requires an iSymphony Server version of **3.2.1 or higher**.
30 {{/warning}}
michaely 22.1 31
michelk 23.1 32 {{warning}}
33 The Desktop Client Module 2.0.0 requires an iSymphony Server version of **3.4.1 or higher**.
34 {{/warning}}
michaely 1.1 35 {{/layout-cell}}
36
37 {{layout-cell}}
38 {{panel title="On this page:"}}
39
40
41 {{toc maxLevel="2" indent="1"/}}
42 {{/panel}}
43 {{/layout-cell}}
44 {{/layout-section}}
45
46 {{layout-section ac:type="single"}}
47 {{layout-cell}}
michelk 23.1 48 = (% style="color: rgb(0, 0, 0); font-size: 24px; line-height: 24px" %)1. Download The Desktop Client Module(%%) =
49
michaely 21.1 50 (((
michelk 23.1 51 The desktop client module downloads can be found in the [[doc:ISYMKB.Downloads Archive]]. You will want to download the Desktop Client Module package to the server that is running the iSymphony server.
michaely 21.1 52 )))
michelk 11.1 53
michaely 10.1 54 (((
michelk 23.1 55
56
57 {{note}}
58 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.
59
60 The URL should look like the following, with the exception of the version, which will be replaced with the version you are downloading:
61
62 [[http:~~/~~/www.getisymphony.com/files/builds/isymphony/desktop_modules/isymphony_desktop_version.tar.gz>>url:http://www.getisymphony.com/files/builds/isymphony/desktop_modules/isymphony_desktop_2_0_0.tar.gz||shape="rect"]]
63
64 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.
65 {{/note}}
66
67
michaely 10.1 68 )))
michaely 22.1 69
70 = 2. Extract The Desktop Client Module =
71
72 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.
73
74 {{code language="bash"}}
michelk 23.1 75 tar -zxf isymphony_desktop_<version>.tar.gz -C /opt/isymphony3/server/modules
michaely 22.1 76 {{/code}}
77
78 = 3. Set The File Ownership Of The Desktop Module =
79
80 The file ownership of the desktop module must match that of the rest of the iSymphony Server installation.
81
82 == Checking File Ownership Of The iSymphony Server Installation ==
83
84 To check the file ownership of the iSymphony Server installation you can run the following command, on the server command line:
85
86 {{code language="bash"}}
87 ls -la /opt
88 {{/code}}
89
90 The user that owns the iSymphony server installation will be the user that owns the **isymphony3** directory in the **opt **directory.
91
92 {{info title="Notes on FreePBX & AsteriskNow"}}
93 If your iSymphony server was installed from one of the following sources, the iSymphony server installation will be owned by the **asterisk** user.
94
95 * Came pre-installed with the FreePBX or AsteriskNow distros.
96 * Installed via the FreePBX Yum repositories.
97 * Installed via the iSymphony FreePBX RPM.
98 {{/info}}
99
100 == Setting The Ownership Of The Desktop Client Module ==
101
102 To set the ownership of the Desktop Client Module you can run the following command, on the server command line:
103
104 {{code language="bash"}}
105 chown -R <ownername>:<ownergroup> /opt/isymphony3/server/modules/desktop
106 {{/code}}
107
108 Replace **<ownername> **with the name of the user that owns the iSymphony installation and replace **<ownergroup>** with the group the user belongs to.
109
110 For example, if you are running on FreePBX installation of iSymphony, you will use the following command:
111
112 {{code language="bash"}}
113 chown -R asterisk:asterisk /opt/isymphony3/server/modules/desktop
114 {{/code}}
115
michelk 23.1 116 = 4. Restart The iSymphony Server =
michaely 22.1 117
michelk 23.1 118 Once the Desktop Client Module is installed, you will have to restart the iSymphony Server in order to activate the module. See [[doc:Starting And Stopping The iSymphony Server]].
michaely 22.1 119
michelk 23.1 120 = 5. Add The Desktop Client Installers =
michaely 22.1 121
michelk 23.1 122 The installers served by iSymphony can be added by downloading the .zip archive and moving it to the iSymphony installers directory:
michaely 22.1 123
michelk 23.1 124 {{code}}
125 cd ~/
126 wget http://www.getisymphony.com/files/builds/isymphony/desktop_client/isymphony_desktop_client_2_0_0.zip
127 mv ./isymphony_desktop_client_2_0_0.zip /opt/isymphony3/server/installers/
128 {{/code}}
129
michaely 22.1 130
131
michelk 23.1 132 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.
133
134 {{info}}
135 See [[Adding New Desktop Client Installers>>url:http://docs.getisymphony.com/display/ISYMDOCS/Adding+New+Desktop+Client+Installers||shape="rect"]] for more information.
136 {{/info}}
137
138 === (% style="color: rgb(0,0,0);" %)6. Install The Desktop Client On The Client Machines(%%) ===
139
140 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 [[doc:Desktop Client Installation v2\.0\.0]] or for legacy versions see [[Desktop Client Installation v1.0.1>>url:http://docs.getisymphony.com/display/ISYMDOCS/Desktop+Client+Installation+v1.0.1||shape="rect"]].
michaely 1.1 141 {{/layout-cell}}
142 {{/layout-section}}
143 {{/layout}}

Search

Navigation

iSymphony