Install Outlook Add-In

Two versions of the Outlook add-in are available:

  • EASY for Exchange Add-In for Outlook 32 bit

  • EASY for Exchange Add-In for Outlook 64 bit

Performing an installation requires administrator rights.

Only version 1.1 or higher supports updates. You have to uninstall the program version 1.0 via Control Panel first.

The installation program will launch after you confirm the corresponding prompts. Select the language of the installation dialogs first: English or German .

Setup Wizard

After selecting the language, the Setup Wizard automatically launches, e.g.:

images/download/attachments/95835381/AddIn_Willkommen_en.png

The Next button will take you to the next respective installation step.

License agreement

Get information about the license terms for installing EASY for Exchange.

I accept the agreement
After familiarizing yourself with the license terms and if you want to accept them, choose the I accept the agreement option .

I do not accept the agreement
If you do not accept the agreement, the installation will not be performed.

Installation folder

The next step is that you specify the installation folder.

Select
To select a folder other than the default one, select it via the field-related button.

Server settings

The next step is that you specify the address of the Client Communication Server. Moreover, the location of a log file as well as the log level can be set.

images/download/attachments/95835381/AddIn_CCServer_en.png

Hostname or IP
 Specify the name or IP address of the server on which the Client Communication Server ( CCS ) was installed.

Port
 Specify the port used for the CCS .

Test connection
 The connection to the database can be checked via the Test button.

Path to log file
 Specify the folder that is available for saving the log file.

Log level
 Select the desired step via the field's selection list.

The settings for logging are saved in the program folder in XML file format; you can always alter them there, e.g.:

C:\<Program folder name>\EASY SOFTWARE\EASY for Exchange\Outlook x86 Add-In\logging\log4net.xml

Perform installation

This dialog starts installing the files.

images/download/attachments/95835381/AddIn_Installieren_en.png

Install
 After activating the installation process, the installer starts transferring the data. The Wizard will notify you about the progress of the installation and tell you when the process is finished.

Finish
 Click Finish to exit the Setup Wizard .

MSI files

For the add-in versions, the installation medium provides installation files for automated software distribution in the respective MSI folder:

images/download/attachments/95835381/AddIn7_CMD_en.png

Command line parameters of the setup files

  • Setup (E4E Outlook x* Add-In).exe /?
    Lists the parameters of the Advanced Installer.

  • EASY for Exchange Outlook x* Add-In Setup.msi /h
    Lists the parameters of the Microsoft Windows Installer.

Language selection

  • /exelang <langID>
    By default, a language selection dialog that allows you to select the setup language (English or German) appears when starting Setup. The /exelang parameter can be used to set the language; the language selection dialog will then not be displayed:
    /exelang 1031 (=> english)
    /exelang 1033 (=> English)

Silent Setup

  • /q
    You should start setup as setup without user interaction only in combination with all required parameters (see below).

Installation parameters

You need to specify other parameters in the form of Property=Value and enclose them in quotation marks, if necessary:

Property

Default value
Description

APPDIR

"C:\Program Files (x86)\EASY SOFTWARE\EASY for Exchange\"
Folder in which the installation folder is created, e.g.: "\Outlook x86 Add-In"

E4ECCS_HOST

(empty)
Host name or IP address of the server on which the EASY for Exchange Client Communication Server (CCS) is installed.

E4ECCS_PORT

8601
Port used by the CCS.

EZLOGPATH

"C:\ProgramData\EASY SOFTWARE\EASY for Exchange\Log"
Path to log file.

EZLOGLEVEL

WARN
Log level to be used:
ALL, DEBUG, ERROR, FATAL, INFO, OFF or WARN

/l*v <Name of log file>

When you specify this parameter, a detailed log file is created and the Setup program uses the debug channel for additional outputs. These events can, for example, be displayed using the DebugView program (see chapter "Log and debug outputs").

Example
"Setup (E4E Outlook x86 Add-In).exe" /exelang 1031 E4ECCS_HOST=Server_3 EZLOGLEVEL=ALL /l*v "C:\TEMP\Setup_Log.txt"

The settings for the add-in's log output – log file and log level – are managed in the installation folder of the log4net.xml file, e.g.:

C:\<Program folder name>\EASY SOFTWARE\EASY for Exchange\Outlook x86 Add-In\logging\log4net.xml

Uninstall Microsoft Outlook add-in

The uninstall process is either via system control or via re-starting the setup file. In doing so, the following query appears:

Do you want to remove the user-specific settings for the add-in?

When you confirm this, the values of this registry key will be deleted:

HKCU\Software\EASY SOFTWARE AG\E4E

However, the key is only deleted for the user who uninstalls the add-in. When an administrator performs the uninstall process, the user-specific settings of other users are retained.