Wiki source code of Desktop Client Installation v2.0.0
Version 10.2 by michelk on 2021/09/09 18:13
Show last authors
author | version | line-number | content |
---|---|---|---|
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/client | ||
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 | (% 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 | |||
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.(%%) | ||
84 | 1. Unmount the dmg. | ||
85 | |||
86 | == Linux == | ||
87 | |||
88 | 1. ((( | ||
89 | Extract the desktop client: | ||
90 | |||
91 | {{code}} | ||
92 | tar xvf isymphony_desktop_client_2_0_0.tar.gz -C installation_location | ||
93 | {{/code}} | ||
94 | ))) | ||
95 | 1. ((( | ||
96 | Run the program: | ||
97 | |||
98 | {{code language="bash"}} | ||
99 | ./installation_location/isymphonydesktop | ||
100 | {{/code}} | ||
101 | ))) | ||
102 | |||
103 | = Uninstalling The Desktop Client = | ||
104 | |||
105 | The uninstall procedure differs for each OS. | ||
106 | |||
107 | == (% style="color: rgb(0,0,0);" %)Windows(%%) == | ||
108 | |||
109 | 1. Open your **Start Menu** and navigate to **Control Panel->Programs and Features**. | ||
110 | 1. Right click on **iSymphony** and select **uninstall**. | ||
111 | |||
112 | == OS X == | ||
113 | |||
114 | Simply delete the** iSymphony.app** file from your Applications directory. | ||
115 | |||
116 | == Linux == | ||
117 | |||
118 | Delete the directory the .tar.gz was extracted to. | ||
119 | |||
120 | = Using The Desktop Client Application = | ||
121 | |||
122 | For information on how to use the Desktop Client Application see [[doc:Desktop Client]]. | ||
123 | |||
124 | |||
125 | |||
126 | |||
127 | {{/layout-cell}} | ||
128 | {{/layout-section}} | ||
129 | {{/layout}} |