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