Skip to Content
Version 5.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 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}}
michelk 5.1 47 http://<ip or hostname of your iSymphony server>:58080/client/desktop/client
michaely 1.1 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
michelk 5.1 58 (% style="color: rgb(0,0,0);" %)Alternatively the installer can be called from the command line with the following options:
michaely 1.1 59
michelk 5.1 60 * (% style="color: rgb(0,0,0);" %)/S - makes the installer silent
61 * (% style="color: rgb(0,0,0);" %)/D=<directory name> - forces the desktop client to be installed into a certain directory
62 ** (% style="color: rgb(0,0,0);" %)Default directory for depends on the install mode (AllUsers or CurrentUser)
63 * (% style="color: rgb(0,0,0);" %)/AllUsers - Installs the desktop client for all users (administration privileges required)
michaely 1.1 64
michelk 5.1 65 ** (% style="color: rgb(0,0,0);" %)Default install directory is ~{~{(% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)program files}}
66 * (% style="color: rgb(0,0,0);" %)/CurrentUser - Installs the desktop client for the current user only (default is (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)CurrentUser)(% style="color: rgb(0,0,0);" %)
67
68 ** (% style="color: rgb(0,0,0);" %)Default install directory is ~{~{~~/AppData}}(%%)
69 (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)\\
70
michaely 1.1 71 == (% style="color: rgb(0,0,0);" %)OS X(%%) ==
72
73 1. (% style="color: rgb(0,0,0);" %)Mount the downloaded dmg file by double clicking on it.
74
75 1. (% style="color: rgb(0,0,0);" %)Once mounted copy the iSymphony file to your Applications directory.(%%)
michaely 3.1 76 1. Unmount the dmg.
michaely 1.1 77
78 == Linux ==
79
80 1. (((
michelk 5.1 81 Extract the desktop client:
michaely 1.1 82
michelk 5.1 83 {{code}}
84 tar xvf isymphony_desktop_client_2_0_0.tar.gz -C installation_location
michaely 1.1 85 {{/code}}
86 )))
87 1. (((
michelk 5.1 88 Run the program:
michaely 1.1 89
90 {{code language="bash"}}
michelk 5.1 91 ./installation_location/isymphonydesktop
michaely 1.1 92 {{/code}}
93 )))
94
95 = Uninstalling The Desktop Client =
96
97 The uninstall procedure differs for each OS.
98
michaely 3.1 99 == (% style="color: rgb(0,0,0);" %)Windows(%%) ==
michaely 1.1 100
michelk 5.1 101 1. Open your **Start Menu** and navigate to **Control Panel->Programs and Features**.
102 1. Right click on **iSymphony** and select **uninstall**.
michaely 1.1 103
104 == OS X ==
105
michelk 5.1 106 Simply delete the** iSymphony.app** file from your Applications directory.
michaely 1.1 107
108 == Linux ==
109
michelk 5.1 110 Delete the directory the .tar.gz was extracted to.
michaely 1.1 111
michelk 5.1 112 = Using The Desktop Client Application =
michaely 1.1 113
michelk 5.1 114 For information on how to use the Desktop Client Application see [[doc:Desktop Client]].
michaely 1.1 115
116
117
118
119 {{/layout-cell}}
120 {{/layout-section}}
121 {{/layout}}