Skip to Content
Version 13.1 by michelk on 2021/09/09 18:01
Hide last authors
michaely 1.1 1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 = Overview =
5
6 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]].
7
8 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.
9
10 {{warning}}
11 The Desktop Client Module requires an iSymphony Server version of **3.2.1 or higher**.
12 {{/warning}}
13
michelk 12.1 14 {{info}}
15 Due to the size of the Desktop Client Module, it is provided as a separate download from the main iSymphony Server.
16 {{/info}}
michaely 1.1 17 {{/layout-cell}}
18
19 {{layout-cell}}
20 {{panel title="On this page:"}}
21
22
23 {{toc maxLevel="2" indent="1"/}}
24 {{/panel}}
25 {{/layout-cell}}
26 {{/layout-section}}
27
28 {{layout-section ac:type="single"}}
29 {{layout-cell}}
michelk 11.1 30 = (% style="color: rgb(0, 0, 0); font-size: 24px; line-height: 24px" %)1. Download The Desktop Client Module(%%) =
31
michaely 10.1 32 (((
michelk 11.1 33 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 10.1 34 )))
michaely 1.1 35
36 = 2. Extract The Desktop Client Module =
37
38 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.
39
40 {{code language="bash"}}
michelk 11.1 41 tar -zxf isymphony_desktop_<version>.tar.gz -C /opt/isymphony3/server/modules
michaely 1.1 42 {{/code}}
43
44 = 3. Set The File Ownership Of The Desktop Module =
45
46 The file ownership of the desktop module must match that of the rest of the iSymphony Server installation.
47
48 == Checking File Ownership Of The iSymphony Server Installation ==
49
50 To check the file ownership of the iSymphony Server installation you can run the following command, on the server command line:
51
52 {{code language="bash"}}
53 ls -la /opt
54 {{/code}}
55
56 The user that owns the iSymphony server installation will be the user that owns the **isymphony3** directory in the **opt **directory.
57
58 {{info title="Notes on FreePBX & AsteriskNow"}}
59 If your iSymphony server was installed from one of the following sources, the iSymphony server installation will be owned by the **asterisk** user.
60
61 * Came pre-installed with the FreePBX or AsteriskNow distros.
62 * Installed via the FreePBX Yum repositories.
63 * Installed via the iSymphony FreePBX RPM.
64 {{/info}}
65
66 == Setting The Ownership Of The Desktop Client Module ==
67
68 To set the ownership of the Desktop Client Module you can run the following command, on the server command line:
69
70 {{code language="bash"}}
71 chown -R <ownername>:<ownergroup> /opt/isymphony3/server/modules/desktop
72 {{/code}}
73
74 Replace **<ownername> **with the name of the user that owns the iSymphony installation and replace **<ownergroup>** with the group the user belongs to.
75
76 For example, if you are running on FreePBX installation of iSymphony, you will use the following command:
77
78 {{code language="bash"}}
79 chown -R asterisk:asterisk /opt/isymphony3/server/modules/desktop
80 {{/code}}
81
82 = 4. Restart The iSymphony Server =
83
84 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]].
85
michelk 11.1 86 = 5. Add The Desktop Client Installers =
michaely 1.1 87
michelk 13.1 88 Download the .zip archive you wish to serve:
michelk 11.1 89
90 {{code}}
michelk 13.1 91 http://www.getisymphony.com/files/builds/isymphony/desktop_client/isymphony_desktop_client_2_0_0.zip
92 {{/code}}
93
94 Move the .zip archive to the installers directory created by the desktop client module:
95
96 {{code}}
97 mv ./isymphony_desktop_client_2_0_0.zip /opt/isymphony3/server/installers/
98 {{/code}}
99
100 Alternatively it can be directly download into the installers directory on the iSymphony server:
101
102 {{code}}
michelk 11.1 103 cd ~/
104 wget http://www.getisymphony.com/files/builds/isymphony/desktop_client/isymphony_desktop_client_2_0_0.zip
michelk 13.1 105 mv isymphony_desktop_client_2_0_0.zip /opt/isymphony3/server/installers/
michelk 11.1 106 {{/code}}
107
108
109
michelk 13.1 110
111
michelk 11.1 112 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.
113
114 {{info}}
115 See [[Adding New Desktop Client Installers>>url:http://docs.getisymphony.com/display/ISYMDOCS/Adding+New+Desktop+Client+Installers||shape="rect"]] for more information.
116 {{/info}}
117
118 === (% style="color: rgb(0,0,0);" %)6. Install The Desktop Client On The Client Machines(%%) ===
119
120 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 121 {{/layout-cell}}
122 {{/layout-section}}
123 {{/layout}}