Skip to Content

Wiki source code of Desktop Client Installation

Version 2.1 by michaely 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 Desktop Client Application on your machine. 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.
7
8 {{note}}
9 In order to have access to the Desktop Client Application you must first install the Desktop Client Module. See [[doc:Desktop Client Module Installation]] for more information.
10 {{/note}}
11 {{/layout-cell}}
12
13 {{layout-cell}}
14 {{panel title="On this page:"}}
15
16
17 {{toc maxLevel="2" indent="1"/}}
18 {{/panel}}
19 {{/layout-cell}}
20 {{/layout-section}}
21
22 {{layout-section ac:type="single"}}
23 {{layout-cell}}
24 = (% style="color: rgb(0, 0, 0); font-size: 24px; line-height: 24px" %)1. Download The Desktop Client Installer(%%) =
25
26 (((
27 There are two methods to download the Desktop Client installer. Both methods will download the appropriate installer for your host OS.
28 )))
29
30 == Download From The Client Web Interface ==
31
32 1. Log into the iSymphony Client Interface. See [[doc:Connecting To The Client Interface]].
33 1. Open the user menu in the top right hand corner of the Client Interface.
34 1. Select **Desktop Client**.
35 1. Copy the URL that is specified in the dialog that is opened. We will need this URL later.
36 1. Select **Download Desktop Client**.
37
38 {{note}}
39 Some browsers may flag the download as un-trusted and show a warning. Simply ignore the warnings and proceed with the download.
40 {{/note}}
41
42 == Download Directly From The URL ==
43
44 You can enter the following URL in your browser to download the Desktop Client installer:
45
46 {{code}}
47 http://<ip or hostname of your iSymphony server>:58080/client/desktop
48 {{/code}}
49
50 = (% style="color: rgb(0,0,0);" %)2. Install The Desktop Client(%%) =
51
52 (% style="color: rgb(0,0,0);" %)The installation method will vary depending on the OS you are installing on.
53
54 == (% style="color: rgb(0,0,0);" %)Windows(%%) ==
55
56 (% style="color: rgb(0,0,0);" %)To execute the installer on Windows simply double click the downloaded installer package, and the installation process will commence.
57
58 {{note}}
59 Windows will open a warning mentioning that the installer is un-trusted. You can ignore this warning and proceed with the download.
60 {{/note}}
61
62 {{note}}
63 The installer will not provide a notification that the installation was complete. The installer will simply exit when completed.
64 {{/note}}
65
66 == (% style="color: rgb(0,0,0);" %)OS X(%%) ==
67
68 1. (% style="color: rgb(0,0,0);" %)Mount the downloaded dmg file by double clicking on it.
69
70 1. (% style="color: rgb(0,0,0);" %)Once mounted copy the iSymphony file to your Applications directory.(%%)
71
72 == Linux ==
73
74 1. (((
75 Make the installer executable:
76
77 {{code language="bash"}}
78 chmod +x isymphony_install_<version>.bsx
79 {{/code}}
80 )))
81 1. (((
82 Run the installer:
83
84 {{code language="bash"}}
85 ./isymphony_install_<version>.bsx
86 {{/code}}
87 )))
88
89 = Uninstalling The Desktop Client =
90
91 The uninstall procedure differs for each OS.
92
93 == Windows ==
94
95 1. Open your Start Menu and navigate to Control Panel->Programs and Features.
96 1. Right click on **iSymphony** and select uninstall.
97
98 == OS X ==
99
100 Simply delete the iSymphony.app file from your Applications directory.
101
102 == Linux ==
103
104 Delete the following directory and files:
105
106 {{code language="bash"}}
107 /home/<username>/iSymphony
108 /home/<username>/.local/share/applications/iSymphony.desktop
109 /home/<username>/.local/share/applications/iSymphony-app.desktop
110 {{/code}}
111
112
113
114
115
116
117 {{/layout-cell}}
118 {{/layout-section}}
119 {{/layout}}