Last modified by teamwire001 on 2024/12/12 14:44

From version 1.4
edited by teamwire001
on 2023/11/07 11:37
Change comment: Update document after refactoring.
To version 2.1
edited by teamwire001
on 2023/11/07 11:38
Change comment: DOC-248

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Windows-Install-Options
1 +4. Windows Install Options
Content
... ... @@ -1,9 +1,106 @@
1 -(% class="box warningmessage" %)
2 -(((
3 -These features are available on Teamwire for Windows only.
4 -)))
1 += Desktop 4.0.0 or newer =
5 5  
6 6  
4 +Microsoft Windows Installer is an installation and configuration service provided with Windows. It allows to run processes with the Windows command {{code}}msiexec{{/code}}.
5 +
6 +This command can be used, for example, to install Teamwire without any user interaction in [[quiet mode>>doc:||anchor="4-quietinstall"]]. Or to define the [[installation contexts>>doc:||anchor="4-installcontext"]].
7 +
8 +
9 +{{id name="4-quietinstall"/}}
10 +
11 +== Quiet installation ==
12 +
13 +The {{code}}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"]]
14 +
15 +
16 +To install the Teamwire app quietly, use the following command and parameters:
17 +
18 +{{code language="shell"}}
19 +msiexec.exe /i <path_to_package> /qn
20 +{{/code}}
21 +
22 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
23 +
24 +
25 +{{id name="4-quietdeinstall"/}}
26 +
27 +== Quiet deinstallation ==
28 +
29 +The {{code}}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"]]
30 +
31 +
32 +To deinstall the Teamwire app quietly, use the following command and parameters:
33 +
34 +{{code language="shell"}}
35 +msiexec.exe /x <path_to_package> /qn
36 +{{/code}}
37 +
38 +The MSI file path required for the deinstallation depends on your data management.
39 +
40 +
41 +Example A: {{code language="shell"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
42 +The file which was also used during the installation has remained in its directory.
43 +
44 +Example B: {{code language="shell"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
45 +You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##.
46 +
47 +
48 +{{id name="4-installcontext"/}}
49 +
50 +== Installation context ==
51 +
52 +Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
53 +
54 +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"]]
55 +
56 +
57 +{{id name="4-context-user"/}}
58 +
59 +=== Per user ===
60 +
61 +By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
62 +
63 +{{code language="shell"}}
64 +msiexec.exe /i <path_to_package>
65 +{{/code}}
66 +
67 +Teamwire will be installed to the following directory: ##%LOCALAPPDATA%\Programs\Teamwire##
68 +
69 +
70 +{{id name="4-context-machine"/}}
71 +
72 +=== Per machine ===
73 +
74 +To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation:
75 +
76 +{{code language="shell"}}
77 +msiexec.exe /i <path_to_package> ALLUSERS=1
78 +{{/code}}
79 +
80 +Teamwire will be installed to the following directory: ##C:\Program Files\Teamwire##
81 +
82 +
83 +{{id name="4-context-custom"/}}
84 +
85 +=== Custom installation directory ===
86 +
87 +You can define a custom directory for the Teamwire app installation with the following parameters:
88 +
89 +{{code language="shell"}}
90 +msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
91 +{{/code}}
92 +
93 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
94 +
95 +
96 +
97 +----
98 +
99 +{{id name="desktop-previous"/}}
100 +
101 += Until Desktop 3.4.2 =
102 +
103 +
7 7  You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
8 8  
9 9  Therefore the command syntax is