Installation and Removal

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

Installation package will automatically detect the version of Windows operating system and Microsoft Office and install required components.

Interactive Installation

Run installation file Setup.exe.

For Interactive Install/Repair process the Installer will perform the following actions:

  1. Detect the version of OS and MS Office

  2. An attempt is made to detect if previous configuration of Thru 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

Example:

ThruOutlook_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

The 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
(has initiated) 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 Thru Outlook add-in cannot be determined

UNDEFINED_MSI_VERSION

0×20080003

Version of the Thru 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

Note that any Win32 API error code can be returned as well.

Msiexec Standard Options

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]

Scripted Removal

The following command options are supported for the package removal:

Setup.exe msiexec [/log LogFile] /x 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.

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.