Overview
This document describes how customize M-Files desktop client installation package. Using customized installation package, you can include settings, vault connections, registry entries and M-Files admin server connections into installation package so that these are configured during M-Files installation.
Solution
Download required latest VBS script from our knowledge base and save it into folder like C:\Temp\CustomInstaller.
Download M-Files installation package. Three options are available. Full installation package (includes server, desktop client and admin tool), desktop only package and desktop and server tools package. Save installation package into same folder where you saved VBS script.
Create customization XLM file and save it same folder with VBS script and installation package. This file includes your customized options. At end of this document, there is example XML file which can be used.
Example XML contains four sections, common settings, vault connections, registry entries and admin tool connections. You can add or remove any of these sections. For example, if you would like to add additional vault connection, copy rows starting "<Vault Name="Sample Vault"> and select all rows including "</Vault>". Paste into rows under "</Vault>".
Once your XML file is ready, it is time to create custom installation package. Open your favorite command shell (cmd/powershell/Windows terminal) with administrative rights and paste following command into it:
cscript "C:\Temp\CustomInstaller\CustomizeInstaller2.3.vbs" xml "C:\Temp\CustomInstaller\M-Files_Online_x64_eng_cvpro_21_12_10943_6_EV.msi" "C:\Temp\CustomInstaller\CustomizeInstaller.xml" "C:\Temp\CustomInstaller\M-Files_Online_x64_eng_cvpro_21_12_10943_6_EV_MyCompany.msi" False False
Change file versions and folder paths based on your environment.
If XML file is correctly filled, you should see all your modifications listed in script report:
Once your modifications are ready, you are ready to deploy your customized installation package. There are different ways to run installer.
- If you would like run installer so that you see installation progress, run following command:
msiexec /package M-Files_Online_x64_eng_cvpro_21_12_10943_6_EV_MyCompany.msi /qb!
- If you would like run installer silently, run following command:
msiexec /package M-Files_Online_x64_eng_cvpro_21_12_10943_6_EV_MyCompany.msi /quiet
- If you would like run installer so that you see installation progress and install both desktop client and admin tool, run following command:
msiexec /package M-Files_Online_x64_eng_cvpro_21_12_10943_6_EV_MyCompany.msi /qb! INSTALLLEVEL=20
Customised.xml
<root>
<VaultConnections>True</VaultConnections>
<Client>
<Vaults>
<Vault Name="Sample Vault">
<ServerVaultName>SampleVault</ServerVaultName>
<ServerVaultGUID>{CD77CAF8-D62D-4860-AF45-DBE9CA7128AC}</ServerVaultGUID>
<ProtocolSequence>ncacn_ip_tcp</ProtocolSequence>
<NetworkAddress>mfiles.local</NetworkAddress>
<Endpoint>2266</Endpoint>
<AuthType>#1</AuthType>
<AutoLogin>#1</AutoLogin>
<SPN></SPN>
<MinimumAuthenticationLevel>#6</MinimumAuthenticationLevel>
<HTTPProxy></HTTPProxy>
</Vault>
</Vaults>
</Client>
<Client>
<RegistryEntries>
<RegistryEntry>
<KeyName>SOFTWARE\Motive\M-Files\[MVERSIONSTRING]\Client\MFClient</KeyName>
<ValueName>AutomaticLogoutTimeoutInMinutes</ValueName>
<ValueData>#60</ValueData>
</RegistryEntry>
</RegistryEntries>
</Client>
<ServerConnections>True</ServerConnections>
<ServerTools>
<Servers>
<Server Name="My Server">
<ProtocolSequence>ncacn_ip_tcp</ProtocolSequence>
<NetworkAddress>mfiles.local</NetworkAddress>
<Endpoint>2266</Endpoint>
<Authentication>#3</Authentication>
<MinimumAuthenticationLevel>#1</MinimumAuthenticationLevel>
<HTTPProxy></HTTPProxy>
</Server>
<Server Name="Another Server">
<ProtocolSequence>ncacn_ip_tcp</ProtocolSequence>
<NetworkAddress>server.somewhere.com</NetworkAddress>
<Endpoint>2266</Endpoint>
<Authentication>#3</Authentication>
<MinimumAuthenticationLevel>#1</MinimumAuthenticationLevel>
<HTTPProxy></HTTPProxy>
</Server>
</Servers>
</ServerTools>
</root>
Reference Documents
KB.cloudvault.m-files.com - Installing M-Files Desktop, M-Files Server, and M-Files Admin with Advanced Options
