Changes for page 4. Windows Install Options
Last modified by teamwire001 on 2026/07/08 06:34
To version 3.1
edited by teamwire001
on 2024/12/12 14:44
on 2024/12/12 14:44
Change comment:
DOC-390 + heading hierarchy fixes
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,27 +1,54 @@ 1 - {{idname="4-quietinstall"/}}1 += Desktop 4.0.0 or newer = 2 2 3 -= Quiet installation = 4 4 5 -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.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}}. 6 6 7 -Th e{{codelanguage="none"}}msiexec{{/code}}**displayoptions**allow a quiet installation.All availableparameterscanbefound here:[[Microsoft~>msiexec ~>Displayoptions>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer"target="_blank"]]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"]]. 8 8 9 9 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 + 10 10 To install the Teamwire app quietly, use the following command and parameters: 11 11 12 -{{code language=" none"}}18 +{{code language="shell"}} 13 13 msiexec.exe /i <path_to_package> /qn 14 14 {{/code}} 15 15 16 -Example: {{code language=" none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}22 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}} 17 17 18 18 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 + 19 19 {{id name="4-installcontext"/}} 20 20 21 21 == Installation context == 22 22 23 -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. 24 - 25 25 Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user. 26 26 27 27 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"]] ... ... @@ -29,11 +29,11 @@ 29 29 30 30 {{id name="4-context-user"/}} 31 31 32 - (% class="numbox" %)A(%%) (% class="numbox-title"%)Per userinstallation59 +=== Per user === 33 33 34 34 By default, the package is installed in the per-user installation context. The following command performs the per-user installation: 35 35 36 -{{code language=" none"}}63 +{{code language="shell"}} 37 37 msiexec.exe /i <path_to_package> 38 38 {{/code}} 39 39 ... ... @@ -42,11 +42,11 @@ 42 42 43 43 {{id name="4-context-machine"/}} 44 44 45 - (% class="numbox" %)B(%%) (% class="numbox-title"%)Per machineinstallation72 +=== Per machine === 46 46 47 47 To install the package in the per-machine installation context, the ##ALLUSERS## parameter is required. The following command performs the per-machine installation: 48 48 49 -{{code language=" none"}}76 +{{code language="shell"}} 50 50 msiexec.exe /i <path_to_package> ALLUSERS=1 51 51 {{/code}} 52 52 ... ... @@ -55,41 +55,139 @@ 55 55 56 56 {{id name="4-context-custom"/}} 57 57 58 - (% class="numbox" %)C(%%) (% class="numbox-title"%)Custom installation directory85 +=== Custom installation directory === 59 59 60 60 You can define a custom directory for the Teamwire app installation with the following parameters: 61 61 62 -{{code language=" none"}}89 +{{code language="shell"}} 63 63 msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path> 64 64 {{/code}} 65 65 66 -Example: {{code language=" none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}93 +Example: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}} 67 67 68 68 69 -{{id name="4-quietdeinstall"/}} 70 70 71 - = Quiet deinstallation =97 +---- 72 72 73 - Microsoft WindowsInstaller is an installation andconfiguration service provided with Windows. Itallows to runprocesses with the Windows command {{code language="none"}}msiexec{{/code}}without any user interaction.99 +{{id name="desktop-previous"/}} 74 74 75 - The {{code language="none"}}msiexec{{/code}}**display options** allow a quiet deinstallation.Allavailable parameters canbe foundhere: [[Microsoft ~> msiexec ~> Display options>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopenernoreferrer" target="_blank"]]101 += Desktop 3.4.3 and previous versions = 76 76 77 77 78 - To deinstall the Teamwireappquietly, usethe following command and parameters:104 +{{id name="quietinstall"/}} 79 79 80 -{{code language="none"}} 81 -msiexec.exe /x <path_to_package> /qn 106 +== Quiet installation == 107 + 108 +You can install Teamwire in silent mode from a command line to avoid user interaction during the process. 109 + 110 +Therefore the command syntax is 111 + 112 +{{code language="plain"}} 113 +start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path> 82 82 {{/code}} 83 83 84 - TheMSIfile path requiredforthe deinstallationdepends onyourdatamanagement.116 +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. 85 85 118 +Example: 86 86 87 -**Example A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}} 88 -The file which was also used during the installation has remained in its directory. 120 +{{code language="plain"}} 121 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\ 122 +{{/code}} 89 89 124 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 90 90 91 -**Example B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}} 92 -You use the MSI file cached by the system. By default, it's stored under ##%SystemRoot%\Installer##. 126 +The shortcut's target for the default installation is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}} 93 93 128 +(% class="box infomessage" %) 129 +((( 130 +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. 131 +))) 94 94 133 + 134 +{{id name="roamingdir"/}} 135 + 136 +=== Roaming user directory === 137 + 138 +{{code language="plain"}}/APPDATA=TRUE{{/code}} ## ## 139 + 140 +This is an optional parameter. 141 + 142 +By default, the user's data is written to the ##%LOCALAPPDATA%## directory ( ##..\AppData\Local\## ). 143 + 144 +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. 145 + 146 +Example: 147 + 148 +{{code language="plain"}} 149 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\ 150 +{{/code}} 151 + 152 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 153 + 154 +The shortcut's target incl. the roaming directory is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}} 155 + 156 + 157 +{{id name="customdir"/}} 158 + 159 +=== Custom user directory === 160 + 161 +{{code language="plain"}}/USERDATADIR=<path>{{/code}} ## ## 162 + 163 +This is an optional parameter. 164 + 165 +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.** 166 + 167 +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. 168 + 169 +Example: 170 + 171 +{{code language="plain"}} 172 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\ 173 +{{/code}} 174 + 175 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 176 + 177 +The shortcut's target incl. the customised directory is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}} 178 + 179 + 180 +{{id name="runonstartup"/}} 181 + 182 +=== Run on startup === 183 + 184 +{{code language="plain"}}/STARTUP=TRUE{{/code}} ## ## 185 + 186 +This is an optional parameter. 187 + 188 +With this parameter you enable the feature to run Teamwire on Windows startup. 189 + 190 +Example: 191 + 192 +{{code language="plain"}} 193 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\ 194 +{{/code}} 195 + 95 95 ## ## 197 + 198 +{{id name="silentdeinstall"/}} 199 + 200 +== Silent deinstallation == 201 + 202 +You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process. 203 + 204 +Therefore the command syntax is 205 + 206 +{{code language="plain"}} 207 +start "" /WAIT "<path>\uninstall.exe" /S 208 +{{/code}} 209 + 210 +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.** 211 + 212 +Example: {{code language="plain"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}} 213 + 214 + 215 +(% class="box infomessage" %) 216 +((( 217 +Please note, the user data is not being removed for all users but the user performing the local deinstallation. 218 +))) 219 + 220 +## ##