Wiki source code of 4. Windows Install Options

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

version	line-number	content
4.1	1	{{id name="4-quietinstall"/}}
1.1	2
4.1	3	= Quiet installation =
1.1	4
4.1	5	{{tabs idsToLabels="install1=Desktop 4, install2=Until Desktop 3.4.3"/}}
2.1	6
4.1	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.
2.1	10
4.1	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"]]
2.1	12
	13
	14	To install the Teamwire app quietly, use the following command and parameters:
	15
4.1	16	{{code language="none"}}
2.1	17	msiexec.exe /i <path_to_package> /qn
	18	{{/code}}
	19
4.1	20	Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
	21	)))
2.1	22
4.1	23	(% id="install2" %)
	24	(((
	25	You can install Teamwire in silent mode from a command line to avoid user interaction during the process.
2.1	26
4.1	27	Therefore the command syntax is
2.1	28
4.1	29	{{code language="none"}}
	30	start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
	31	{{/code}}
2.1	32
4.1	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.
2.1	34
4.1	35	Example:
2.1	36
4.1	37	{{code language="none"}}
	38	start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
2.1	39	{{/code}}
	40
4.1	41	An app shortcut will be created automatically and can be found in the Teamwire software directory.
2.1	42
4.1	43	The shortcut's target for the default installation is {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
2.1	44
4.1	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	)))
2.1	49
4.2	50	(% style="border-color:var(--gili_blue_300)" %)
	51	----
2.1	52
4.2	53
2.1	54	{{id name="4-installcontext"/}}
	55
	56	== Installation context ==
	57
4.1	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
2.1	64	Windows Installer can install a package on a computer into two installation contexts: per-machine and per-user.
	65
2.2	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"]]
2.1	67
	68
	69	{{id name="4-context-user"/}}
	70
4.1	71	(% class="numbox" %)A(%%) (% class="numbox-title" %)Per user installation
2.1	72
	73	By default, the package is installed in the per-user installation context. The following command performs the per-user installation:
	74
4.1	75	{{code language="none"}}
2.1	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
4.1	84	(% class="numbox" %)B(%%) (% class="numbox-title" %)Per machine installation
2.1	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
4.1	88	{{code language="none"}}
2.1	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
4.1	97	(% class="numbox" %)C(%%) (% class="numbox-title" %)Custom installation directory
2.1	98
	99	You can define a custom directory for the Teamwire app installation with the following parameters:
	100
4.1	101	{{code language="none"}}
2.1	102	msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
	103	{{/code}}
	104
4.1	105	Example: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
	106	)))
2.1	107
4.1	108	(% id="context2" %)
	109	(((
	110	{{id name="roamingdir"/}}
2.1	111
4.1	112	(% class="numbox" %)A(%%) (% class="numbox-title" %)Roaming user data directory
2.1	113
4.1	114	{{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
2.1	115
4.1	116	This is an optional parameter.
2.1	117
4.1	118	By default, the user's data is written to the ##%LOCALAPPDATA%## directory (##..\AppData\Local\##).
2.1	119
4.1	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.
2.1	121
1.1	122	Example:
	123
4.1	124	{{code language="none"}}
	125	start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
1.1	126	{{/code}}
	127
3.1	128	An app shortcut will be created automatically and can be found in the Teamwire software directory.
1.1	129
4.1	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}}
3.1	131
1.1	132
4.1	133	{{id name="customdir"/}}
1.1	134
4.1	135	(% class="numbox" %)B(%%) (% class="numbox-title" %)Custom user data directory
1.1	136
4.1	137	{{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
1.1	138
3.1	139	This is an optional parameter.
	140
4.1	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.
1.1	142
4.1	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.
1.1	144
	145	Example:
	146
4.1	147	{{code language="none"}}
	148	start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
1.1	149	{{/code}}
	150
	151	An app shortcut will be created automatically and can be found in the Teamwire software directory.
	152
4.1	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}}
1.1	154
	155
	156
4.1	157	{{id name="runonstartup"/}}
1.1	158
4.1	159	(% class="numbox" %)C(%%) (% class="numbox-title" %)Run on startup
1.1	160
4.1	161	{{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
	162
3.1	163	This is an optional parameter.
	164
4.1	165	With this parameter you enable the feature to run Teamwire on Windows startup.
1.1	166
	167	Example:
	168
4.1	169	{{code language="none"}}
	170	start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
1.1	171	{{/code}}
4.1	172	)))
1.1	173
4.2	174	(% style="border-color:var(--gili_blue_300)" %)
	175	----
1.1	176
4.2	177
4.1	178	{{id name="4-quietdeinstall"/}}
1.1	179
4.1	180	= Quiet deinstallation =
1.1	181
4.1	182	{{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Until Desktop 3.4.3"/}}
1.1	183
4.1	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.
1.1	187
4.1	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"]]
1.1	189
3.1	190
4.1	191	To deinstall the Teamwire app quietly, use the following command and parameters:
1.1	192
4.1	193	{{code language="none"}}
	194	msiexec.exe /x <path_to_package> /qn
1.1	195	{{/code}}
	196
4.1	197	The MSI file path required for the deinstallation depends on your data management.
1.1	198
1.2	199
4.1	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.
1.1	202
4.1	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	(((
1.1	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
4.1	214	{{code language="none"}}
1.1	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
4.1	220	Example: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
1.1	221
4.1	222	{{info}}
1.1	223	Please note, the user data is not being removed for all users but the user performing the local deinstallation.
4.1	224	{{/info}}
1.1	225	)))
	226
4.2	227	(% style="border-color:var(--gili_blue_300)" %)
	228	----
	229
1.1	230	## ##