Changes for page 4. Windows Install Options
Last modified by teamwire001 on 2026/07/08 06:34
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,39 +1,66 @@ 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 -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"]]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"]] 28 28 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,148 @@ 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 quietdeinstallation.All availableparameterscan be found here: [[Microsoft~> msiexec ~> Displayoptions>>url:https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec#display-options||rel="noopenernoreferrer" target="_blank"]]101 += Until Desktop 3.4.2 = 76 76 77 77 78 - TodeinstalltheTeamwireappquietly,usethefollowingcommandandparameters:104 +You can install Teamwire in silent mode from a command line to avoid user interaction during the process. 79 79 80 -{{code language="none"}} 81 -msiexec.exe /x <path_to_package> /qn 106 +Therefore the command syntax is 107 + 108 +{{code language="plain"}} 109 +start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path> 82 82 {{/code}} 83 83 84 - TheMSI file path required for the deinstallation depends on your data management.112 +## ## 85 85 114 +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. 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. 116 +Example: 89 89 118 +{{code language="plain"}} 119 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\ 120 +{{/code}} 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##. 122 +## ## 93 93 124 +(% class="box infomessage" %) 125 +((( 126 +Please note, ##/D## must be the **last parameter used** in the command line and **must not contain any quotation marks** even if the path contains spaces. 127 +))) 94 94 95 95 ## ## 130 + 131 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 132 + 133 +The shortcut's target for the default installation is {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}} 134 + 135 + 136 +{{id name="optional"/}} 137 + 138 += Optional parameters = 139 + 140 +The following parameters are optional and support additional settings to be enabled during the installation. 141 + 142 +Furthermore, please note that 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. 143 + 144 + 145 +{{id name="roamingdir"/}} 146 + 147 +== Roaming User Directory == 148 + 149 +{{code language="plain"}}/APPDATA=TRUE{{/code}} ## ## 150 + 151 +By default, the user's data is written to the ##%LOCALAPPDATA%## directory ( ##..\AppData\Local\## ). 152 + 153 +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. 154 + 155 +Example: 156 + 157 +{{code language="plain"}} 158 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\ 159 +{{/code}} 160 + 161 +## ## 162 + 163 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 164 + 165 +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}} 166 + 167 + 168 +{{id name="customdir"/}} 169 + 170 +== Custom User Directory == 171 + 172 +{{code language="plain"}}/USERDATADIR=<path>{{/code}} ## ## 173 + 174 +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.** 175 + 176 +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. 177 + 178 +Example: 179 + 180 +{{code language="plain"}} 181 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\ 182 +{{/code}} 183 + 184 +## ## 185 + 186 +An app shortcut will be created automatically and can be found in the Teamwire software directory. 187 + 188 +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}} 189 + 190 + 191 +{{id name="runonstartup"/}} 192 + 193 +== Run on Startup == 194 + 195 +{{code language="plain"}}/STARTUP=TRUE{{/code}} ## ## 196 + 197 +With this parameter you enable the feature to run Teamwire on Windows startup. 198 + 199 +Example: 200 + 201 +{{code language="plain"}} 202 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\ 203 +{{/code}} 204 + 205 +## ## 206 + 207 +{{id name="silentdeinstall"/}} 208 + 209 += Silent Deinstallation = 210 + 211 +You can deinstall Teamwire in silent mode from a command line to avoid user interaction during the process. 212 + 213 +Therefore the command syntax is 214 + 215 +{{code language="plain"}} 216 +start "" /WAIT "<path>\uninstall.exe" /S 217 +{{/code}} 218 + 219 +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.** 220 + 221 +Example: {{code language="plain"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}} 222 + 223 + 224 +(% class="box infomessage" %) 225 +((( 226 +Please note, the user data is not being removed for all users but the user performing the local deinstallation. 227 +))) 228 + 229 +## ##