Wiki source code of 4. Windows Install Options

Last modified by teamwire001 on 2025/09/11 14:59

Show last authors
1 {{id name="4-quietinstall"/}}
2
3 = Quiet installation =
4
5 {{tabs idsToLabels="install1=Desktop 4, install2=Until Desktop 3.4.3"/}}
6
7 (% id="install1" %)
8 (((
9 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
10
11 The {{code language="none"}}msiexec{{/code}} **display options** allow a quiet installation. All available parameters can be found here: [[Microsoft ~> msiexec ~> Display options>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
12
13
14 To install the Teamwire app quietly, use the following command and parameters:
15
16 {{code language="none"}}
17 msiexec.exe /i <path_to_package> /qn
18 {{/code}}
19
20 Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
21 )))
22
23 (% id="install2" %)
24 (((
25 You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
26
27 Therefore the command syntax is
28
29 {{code language="none"}}
30 start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
31 {{/code}}
32
33 Please enter the path to the Teamwire setup file and use the option ##/D## to define a directory in which Teamwire is going to install its further contents.
34
35 Example:
36
37 {{code language="none"}}
38 start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
39 {{/code}}
40
41 An app shortcut will be created automatically and can be found in the Teamwire software directory.
42
43 The shortcut's target for the default installation is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
44
45 {{info}}
46 Please note, the ##/D## option must be the **last parameter used** in the command line and **must not contain any quotation marks** even if the path contains spaces.
47 {{/info}}
48 )))
49
50 (% style="border-color:var(--gili_blue_300)" %)
51 ----
52
53
54 {{id name="4-installcontext"/}}
55
56 == Installation context ==
57
58 {{tabs idsToLabels="context1=Desktop 4, context2=Until Desktop 3.4.3"/}}
59
60 (% id="context1" %)
61 (((
62 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
63
64 Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
65
66 A per-machine installation of the package is required to enable **all users** of the computer to access and use the application. Because a per-machine installation makes changes to the system that affect all users, administrative permissions are required. Further information available here: [[Microsoft ~> Windows Installer ~> Installation context>>https://learn.microsoft.com/en-us/windows/win32/msi/installation-context||rel="noopener noreferrer" target="_blank"]]
67
68
69 {{id name="4-context-user"/}}
70
71 (% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
72
73 By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
74
75 {{code language="none"}}
76 msiexec.exe /i <path_to_package>
77 {{/code}}
78
79 Teamwire will be installed to the following directory: ##%LOCALAPPDATA%\Programs\Teamwire##
80
81
82 {{id name="4-context-machine"/}}
83
84 (% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
85
86 To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
87
88 {{code language="none"}}
89 msiexec.exe /i <path_to_package> ALLUSERS=1
90 {{/code}}
91
92 Teamwire will be installed to the following directory: ##C:\Program Files\Teamwire##
93
94
95 {{id name="4-context-custom"/}}
96
97 (% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
98
99 You can define a custom directory for the Teamwire app installation with the following parameters:
100
101 {{code language="none"}}
102 msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
103 {{/code}}
104
105 Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
106 )))
107
108 (% id="context2" %)
109 (((
110 {{id name="roamingdir"/}}
111
112 (% class="numbox" %)A(%%) (% class="numbox-title" %)Roaming user data directory
113
114 {{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
115
116 This is an optional parameter.
117
118 By default, the user's data is written to the ##%LOCALAPPDATA%## directory (##..\AppData\Local\##).
119
120 In some corporate and virtual environments, a folder's content is deleted when the session is closed. In order to write into ##%APPDATA%## directory (##..\AppData\Roaming\##), please add the ##/APPDATA=TRUE## argument to your command.
121
122 Example:
123
124 {{code language="none"}}
125 start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
126 {{/code}}
127
128 An app shortcut will be created automatically and can be found in the Teamwire software directory.
129
130 The shortcut's target incl. the roaming directory is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}}
131
132
133 {{id name="customdir"/}}
134
135 (% class="numbox" %)B(%%) (% class="numbox-title" %)Custom user data directory
136
137 {{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
138
139 This is an optional parameter.
140
141 In case you need to store your user data to a different location due to your network environment or retention policies for local data, you are able to define a custom path (e.g. mapped home directory for your users) with the parameter ##/USERDATADIR##. **You will have to put the path in quotation marks.**
142
143 The customised directories will not be created until the first run and registration. Please note, that despite the custom path of user data the original directories (##%LOCALAPPDATA%\Teamwire\User Data\Default\##) will still be created but do not contain any data.
144
145 Example:
146
147 {{code language="none"}}
148 start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
149 {{/code}}
150
151 An app shortcut will be created automatically and can be found in the Teamwire software directory.
152
153 The shortcut's target incl. the customised directory is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}}
154
155
156
157 {{id name="runonstartup"/}}
158
159 (% class="numbox" %)C(%%) (% class="numbox-title" %)Run on startup
160
161 {{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
162
163 This is an optional parameter.
164
165 With this parameter you enable the feature to run Teamwire on Windows startup.
166
167 Example:
168
169 {{code language="none"}}
170 start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
171 {{/code}}
172 )))
173
174 (% style="border-color:var(--gili_blue_300)" %)
175 ----
176
177
178 {{id name="4-quietdeinstall"/}}
179
180 = Quiet deinstallation =
181
182 {{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Until Desktop 3.4.3"/}}
183
184 (% id="deinstall1" %)
185 (((
186 Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code language="none"}}msiexec{{/code}} without any user interaction.
187
188 The {{code language="none"}}msiexec{{/code}} **display options** allow a quiet deinstallation. All available parameters can be found here: [[Microsoft ~> msiexec ~> Display options>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
189
190
191 To deinstall the Teamwire app quietly, use the following command and parameters:
192
193 {{code language="none"}}
194 msiexec.exe /x <path_to_package> /qn
195 {{/code}}
196
197 The MSI file path required for the deinstallation depends on your data management.
198
199
200 **Example A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
201 The file which was also used during the installation has remained in its directory.
202
203
204 **Example B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
205 You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
206 )))
207
208 (% id="deinstall2" %)
209 (((
210 You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process.
211
212 Therefore the command syntax is
213
214 {{code language="none"}}
215 start "" /WAIT "<path>\uninstall.exe" /S
216 {{/code}}
217
218 Enter the path to the uninstalling file, which is located in the Teamwire root directory. **You will have to put the path in quotation marks.**
219
220 Example: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
221
222 {{info}}
223 Please note, the user data is not being removed for all users but the user performing the local deinstallation.
224 {{/info}}
225 )))
226
227 (% style="border-color:var(--gili_blue_300)" %)
228 ----
229
230 ## ##