Installation guide

Upgrading to the latest version

Starting with MFT Outlook Plugin 13.4, the installer correctly preserves user and system configuration settings during upgrades and silent installations. This guide covers how configuration preservation works in each installation scenario and how to control it in enterprise deployments.

The following settings are preserved during an upgrade:

• Server URL and connection settings
• Authentication mode (including Okta and Azure AD SSO configuration)
• Proxy settings
• Attachment handling policies
• All other custom configuration set by the user or IT administrator

Interactive upgrade

To upgrade from a previous version of the MFT Outlook Plugin, you can run the installer directly:

1. Close Outlook before running the installer. If Outlook is open, the installer will prompt you to close it before continuing.

2. Run the new installer.

   The installer detects your existing installation and enters upgrade mode.

3. Proceed through the installation wizard. When you reach the Configuration step, there are two options:

   • Use the previous configuration - Keeps all your existing settings intact
   • Update configuration - Resets settings to the new defaults

   Select your preferred option and complete the wizard.

4. After the upgrade completes, launch Outlook or Transfer Manager. Your selected configuration will be in effect wiht no additional setup required.

Silent installation (Enterprise/SCCM/Group Policy)

Silent installation is supported for enterprise deployments via SCCM, Group Policy, or other software distribution systems.

Default behavior: configuration is preserved

When upgrading silently without any extra parameters, the installer automatically detects an existing installation and preserves the user's configuration:

msiexec /i ThruOutlookPlugin.msi /quiet

No additional parameters are required for configuration preservation. This is the recommended command for enterprise upgrade deployments.

Resetting configuration on upgrade

If you want to reset all settings to defaults during a silent upgrade, run the following command:

msiexec /i ThruOutlookPlugin.msi /quiet THRU_CONFIG_UPDATE_MODE=2

Diagnostic logging

If you need to troubleshoot an installation, you can enable two levels of logging:

1. MSI verbose log - Logs install actions and property values

   msiexec /i ThruOutlookPlugin.msi /quiet /l*v C:\ThruInstallLog.txt

2. Configuration preservation log - Logs detailed backup/restore trace

   set THRU_SETUP_LOG=C:\ThruSetupHelpers.log
   msiexec /i ThruOutlookPlugin.msi /quiet

   The configuration preservation log captures the exact path used for each backup and restore operation and is especially useful for diagnosing cases where settings appear not to have been retained after upgrade.

Installing MFT Add-in for Outlook

The installation package Setup.exe installs the required version of the MFT Outlook Add-In according to the version and 32/64bits build of Windows and MS Office.

The installation package automatically detects the version of the Windows operating system and Microsoft Office and installs required components.

Interactive installation

Download the installation file Setup.exe. For Interactive Install/Repair process, the installer performs the following actions:

1. Detect the version of OS and MS Office
2. An attempt is made to detect if previous configuration of MFT Desktop exists in the registry.
3. If previous configuration was not found in the registry, the installer proceeds with new configuration setup
4. If a previous configuration is found in the registry, the installer will ask user if existing configuration should be preserved or reset.
5. If a user selects to reset configuration, new configuration files are installed, otherwise existing configuration files are preserved. If the new add-in build requires configuration file update, configuration is always reset.

Scripted installation

The following command options are supported for the package installation:

Setup.exe msiexec [/log LogFile] /I msi [msiexec options]

where:

• ‘/log LogFile’ optional parameter records a log file with name LogFile.

  If the parameter is not used or LogFile cannot be created in designated folder, log file will be recorded in %TEMP%\THRU\log.txt file.

• ‘[msiexec options]’ are standard command line options for Msiexec Windows installation utility.

  String ‘msi’ is a placeholder that will be replaced by actual MSI installation package file name once it is extracted from the EXE package.

Silent installation

For example, MFTOutlook_2.69.23055.exe” msiexec /i msi /q /l “c:\temp\log.text is equivalent to the following installation command:

msiexec /log C:\Temp\Install.log /i setup.msi /qn

This command runs silent installation of the file setup.msi and records the log to C:\Temp\log.txt.

File setup.msi is extracted from the package Setup.exe based on the version of OS and Microsoft Outlook.

Setup.exe returns the following status codes:

Status Code	Value	Description
ERROR_SUCCESS	0×00000000	The action completed successfully.
MSI_ERROR_SUCCESS_REBOOT	0×20000001	The installation completed successfully but reboot is required to complete the installation operation
MSI_ERROR	0×20000002	msiexec returned error (error details may be discovered in log)
MSI_NO_EXITCODE	0×20000003	msiexec is executed but couldn’t return exit code
CMD_LINE_PARSING_ERROR	0×20080001	Package command line parsing error
UNDEFINED_MSI_BITNESS	0×20080002	Bitness of the MFT Outlook add-in cannot be determined
UNDEFINED_MSI_VERSION	0×20080003	Version of the MFT Outlook add-in cannot be determined
UNDEFINED_OS_VERSION	0×20080004	Windows version cannot be determined
UNKNOWING_OS_VERSION	0×20080005	Unknown Windows version
DEFAULT_UTILITY_ERROR	0×20080006	Unknown error

info

Any Win32 API error code can be returned.

Msiexec standard options

You can use the following standard options for the msiexec command:

msiexec /Option <Required Parameter> [Optional Parameter]

Install options

• </package | /i> <Product.msi> - Installs or configures a product

• /a <Product.msi> - Administrative install – Installs a product on the network

• /j<u|m> <Product.msi> [/t <Transform List>] [/g <Language ID>] - Advertises a product – m to all users, u to current user

• </uninstall | /x> <Product.msi | ProductCode> - Uninstalls the product

Display options

• /quiet - Quiet mode, no user interaction

• /passive - Unattended mode – progress bar only

• /q[n|b|r|f] - Sets user interface level

  n – No UI
  b – Basic UI
  r – Reduced UI
  f – Full UI (default)

• /help - Help information

Restart options

• /norestart - Do not restart after the installation is complete

• /promptrestart - Prompts the user for restart if necessary

• /forcerestart - Always restart the computer after installation

Logging options

• /l[i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] <LogFile>

  • i – Status messages
  • w – Nonfatal warnings
  • e – All error messages
  • a – Start up of actions
  • r – Action-specific records
  • u – User requests
  • c – Initial UI parameters
  • m – Out-of-memory or fatal exit information
  • o – Out-of-disk-space messages
  • p – Terminal properties
  • v – Verbose output
  • x – Extra debugging information
  • + – Append to existing log file
  • ! – Flush each line to the log
  • * – Log all information, except for v and x options

• /log <LogFile> - Equivalent of /l* <LogFile>

Update options

• /update <Update1.msp>[;Update2.msp] - Applies update(s)

• /uninstall <PatchCodeGuid>[;Update2.msp] /package <Product.msi | ProductCode> - Remove update(s) for a product

Repair options

• /f[p|e|c|m|s|o|d|a|u|v] <Product.msi | ProductCode> - Repairs a product

  • p – only if file is missing
  • o – if file is missing or an older version is installed (default)
  • e – if file is missing or an equal or older version is installed
  • d – if file is missing or a different version is installed
  • c – if file is missing or checksum does not match the calculated value
  • a – forces all files to be reinstalled
  • u – all required user-specific registry entries (default)
  • m – all required computer-specific registry entries (default)
  • s – all existing shortcuts (default)
  • v – runs from source and recaches local package

Setting public properties

• [PROPERTY=PropertyValue]

Uninstall Add-in for Outlook

You can use the following command options for the package removal:

Setup.exe msiexec [/log LogFile] /x msi [msiexec options]

• ‘/log LogFile’ optional parameter records a log file with name LogFile. If the parameter is not used or LogFile cannot be created in designated folder, log file will be recorded in %TEMP%\THRU\log.txt file.

• ‘msiexec options’ are standard command line options for Msiexec Windows installation utility. String ‘msi’ is a placeholder that will be replaced by actual MSI installation package file name once it is extracted from the EXE package.

Example of silent uninstallation:

Setup.exe msiexec /log C:\Temp\Uninstall.log /x msi /qn

is equivalent to the following installation options:

msiexec /log C:\Temp\Uninstall.log /x setup.msi /qn

The command runs silent uninstallation according to the version of OS and Microsoft Office and records the log to C:\Temp\Uninstall.log.