Wiki source code of 4. Windows Install Options
Last modified by teamwire001 on 2025/09/11 14:59
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 | ## ## |