Installation process

CodeTwo Exchange Rules is designed for adding signatures to emails sent from mailboxes hosted on Microsoft Exchange Servers 2007, 2010, 2013 or 2016. If you seek signatures / disclaimer management tool for Exchange Server 2003 environment, check CodeTwo Exchange Rules 2003.

Warning

If you are running Exchange 2013 SP1, please consult this KB article before installing the program.

The fundamental requirement for the program to work is that Exchange Rules Service needs to be installed on each Microsoft Exchange Server machine equipped with Microsoft Exchange Hub Transport (Exchange 2007/2010) or with Mailbox role (Exchange 2013/2016).

Tip

Before you move on with the installation, read about the program's architecture, system requirements and licensing in multi-server environment.

This article comprises the below-listed sections:

Installation in multi-server environment

If you are installing CodeTwo Exchange Rules in a multi-server environment, you need to perform the installation of Exchange Rules Service (set of components responsible for processing mail) individually on each server processing mail. Otherwise, not all the message traffic will be processed by the program yet configured rules along the actions will not be applied to all messages within the organization. Therefore, install the Service on:

  • Each Exchange Server 2007 with Hub Transport role
  • Each Exchange Server 2010 with Hub Transport role
  • Each Exchange Server 2013 with Mailbox role
  • Each Exchange Server 2016 with Mailbox role

To perform the installation, please follow the steps below.

Important

If you are updating from any previous version of the Exchange Rules family, make sure to run the installer on each server equipped with the previous version of the software. Refer to the section below to learn about the update steps.

Installation in hybrid environment

Installation in hybrid environments is not any different from installation in standard Exchange on-premises environments. The software's Engine must be installed on the on-premises Exchange Server(s) with the appropriate role. The success of the deployment depends on how the hybrid itself is configured. The principle here is that inbound and outbound mail flow should be always routed through servers with CodeTwo software installed. Find out more on how CodeTwo Exchange Rules works in hybrid environments in this article.

Installation process

Info

Note that we do not recommend installing the program on a shared or mapped disk - it must be installed on a local drive. Furthermore, you cannot install the program using GPO. The installation has to be performed manually on each machine

The installation of the software is simple and takes up to 60 seconds. After the installation wizard starts, all you need to do is accepting the license agreement (Fig. 1.)

ER Family - Accepting license agreement.
Fig. 1. Accepting the License Agreement.

Next, you will be asked to specify the location where the program will be installed. By default, the program is installed to C:\Program Files\CodeTwo\CodeTwo Exchange Rules, however, it may be changed if necessary (Fig. 2.).

ER Family - Program's default installation path.
Fig. 2. Choosing the installation path.

Once the wizard is initiated, it copies data files to your system and installs any required components. Depending on your environment, the installation of .NET 3.5 or .NET 4.0 (or higher) might be required.

In the following step, you will have to decide which components of the program will be installed (Fig. 3.)

ER Family - Choosing program's features.
Fig. 3. Choosing which components of the program will be installed.

Warning

Please note that you must install the program on the local drive.

By default, if it is Server installation equipped with Hub Transport or Mailbox role (depending on the server's version) both Exchange Rules Administration Panel and Exchange Rules Service will be marked or in case of the desktop installation only Exchange Rules Administration Panel will be checked.

Managing the installation

You may install, repair and uninstall the program and its components at any time via the Control Panel. Just open it up, go to Programs, and choose Programs and Features. Right-click CodeTwo Exchange Rules and from the context menu click Change. The first screen of the installation wizard will open and once you hit Next the program's setup window will show (Fig. 4.) where you will be able to install / repair or remove the whole installation.

ER Family - Changing program's components.
Fig. 4. Managing the program's components.

First steps

Once the installation is finished, CodeTwo Exchange Rules starts automatically along the Quick Tour slides showing the main features of the program (Fig. 5.).

ER Family - Quick tour 1st screen.
Fig. 5. Quick Tour.

Note that straight after the installation, the Administration Panel tries to automatically connect to the Exchange Rules Service. However, in specific multi-server and multi-domain environments with many instances of CodeTwo Exchange Rules, Administration Panels may not be able to properly connect to the Service what results in the following error (Fig. 6.):

InstallationProcess-SOAP
Fig. 6. Incorrect address or SOAP action error.

This error is likely to appear if the Administration Panel is installed on a machine from a sub-domain and tries to connect to the Service hosted on a machine from a primary domain. To resolve this issue, you need to configure the Service connection manually. Click Configure within the connection error notification. In the resulting window (Connection tab in Settings), mark the Connect to Exchange Rules Service hosted on this Exchange Server radio button. Next, enter the name or the IP address of a server hosting the Exchange Rules Service (Fig. 7.) and click OK. Last but not least, restart the Administration Panel and the connection should be established.

Exchange Rules - Manual connection
Fig. 7. Configuring the Service connection manually.

Last but not least, after fresh installation, the Administration Panel will open along the Critical notifications window (Fig. 8.).

Exchange Rules - Notifications
Fig. 8. The Critical notifications window opened.

Here, you can select email addresses of users (specific email address, AD user, AD group) who will receive important information concerning the program's licensing:

  • information on the licenses used once they reach 95% of the whole pool
  • information once the license limit has been reached
  • information on the days left for the trial version to expire (7, 3 and 1 day prior to trial period expiration)
  • information once the trial version expires (on that day, 3, 10 and 17 days after trial period expiration and later on once a month)

You may also choose which particular mailbox (the Administrator one is selected by default) should be used in order to send these messages. After initial configuration, the critical notifications' recipients as well as the sender's mailbox may be adjusted at any point via the Help's context menu located within the Administration Panel's ribbon (Fig. 9.).

Exchange Rules - Notifications
Fig. 9. Opening the Critical notifications window.

Important

After the installation, each Active Directory user operating the Administration Panel of the program, will have full access rights to managing rules. That is why we strongly recommend configuring the access rights straight after the initial installation before moving to other configuration steps.

Upgrading from previous versions of Exchange Rules family

Before you move on with the upgrade, learn more about the new architecture of the program as the installation of its components will have a direct impact on the software's operation.

Info

As the upgrade is provided at additional costs, please refer to the buy section of the chosen product version to get info about the upgrading pricing.

Warning

Be aware that settings conversion is supported only from the following or newer versions of CodeTwo Exchange Rules: 2007 - 2.2.8.3, 2010 - 1.1.11.3, 2013 - 1.0.0.11. If you are upgrading from older release of the software, including CodeTwo Exchange Rules 2003 please consult with CodeTwo Customer Support first.

To upgrade CodeTwo Exchange Rules from any previous version please follow the steps below:

  1. Purchase the upgrade license pack first with the number of licenses corresponding to the ones you already have
  2. Export settings from your current version of CodeTwo Exchange Rules family product and store them locally.
  3. Run the setup of the newest version of Exchange Rules and install Exchange Rules Service on top of the previous version of the program on each machine equipped with Hub Transport or Mailbox role. Furthermore, install Administration Panel on any machine within your domain.
  4. Once the installation is completed, the next step is to import your rules definitions. The settings file generated by CodeTwo Exchange Rules Family of versions prior to 2007 4.x, 2010 3.x and 2013 2.x needs to be open up by the Settings Importer tool, which is available either via Import / Export button from Administration Panel or the list of programs. Just follow the wizard to convert and import settings from the previous version of the program.

    Important

    Import settings only on the first updated or a new instance of the program within your multi-server environment. Thanks to the real-time replication of settings, they will be propagated to other instances of the program once they are installed and opened. Therefore, if you run the Importer and import settings on other machines equipped with the program, you will end up with duplicated rules.

  5. Activate the program on the server equipped in Exchange Rules Service with the license key provided.

Tip

If you have more than one server processing mail within your organization equipped in the previous version of the CodeTwo Exchange Rules, you need to run the installer on each server the program was installed on. Otherwise, not all the mailboxes will be processed by the program after upgrade. To get more info on how to install the program in multi-server environment, please refer to this information.

Migrating from other version of Exchange Rules family

Before you move on with migrating from other versions of Exchange Rules family, learn more about the new architecture of the program as the installation of its components will have a direct impact on the software's operation.

Info

As the migration is provided at additional costs, please refer to the buy section of the chosen product version to get info about the migration pricing.

Warning

Be aware that settings conversion is supported only from the following or newer versions of CodeTwo Exchange Rules: 2007 - 2.2.8.3, 2010 - 1.1.11.3, 2013 - 1.0.0.11. If you are migrating from older release of the software, including CodeTwo Exchange Rules 2003 please consult with CodeTwo Customer Support first.

To migrate CodeTwo Exchange Rules from any other version, please follow the steps below:

  1. Purchase the migration license pack first with the number of licenses corresponding to the ones you already have.
  2. Export settings from your current version of Exchange Rules family product and store them on the machine where a new installation will be performed.
  3. Run the setup of the newest version of CodeTwo Exchange Rules and install Exchange Rules Service on each machine equipped with Hub Transport or Mailbox role. Furthermore, install Administration Panel on any machine within your domain.
  4. Once the installation is completed, the next step is to import your rules definitions - to do so, use the Import settings... command, available under the Import / Export button in the Administration Panel. Finally, restart the whole application to see the changes.

    Important

    Import settings only on the first updated or a new instance of the program within your multi-server environment. Thanks to the real-time replication of settings, they will be propagated on other instances of the program once they are installed and opened. Therefore, if you run the Importer and import settings on other machines equipped with the program, you will end up with duplicated rules.

  5. Activate the program on the server equipped in Exchange Rules Service with the license key provided.

Tip

If you have more than one server processing mail within your organization equipped in the previous version of the CodeTwo Exchange Rules, you need to run the installer on each server the program was installed on. Otherwise, not all the mailboxes will be processed by the program after update. To get more info on how to install the program in multi-server environment, please refer to this information.

Upgrading to Exchange Rules Pro

Before you move on with the upgrade, learn more about the new architecture of the program as the installation of its components will have a direct impact on the software's operation.

Info

Please note that the upgrade of the software is provided at additional costs.

Warning

Be aware that settings conversion is supported only from the following or newer versions of CodeTwo Exchange Rules: 2007 - 2.2.8.3, 2010 - 1.1.11.3, 2013 - 1.0.0.11. If you are upgrading from older release of the software, including CodeTwo Exchange Rules 2003 please consult with CodeTwo Customer Support first.

To upgrade to CodeTwo Exchange Rules Pro please follow the steps below:

  1. Purchase the migration license pack first with the number of licenses equivalent to the ones that you already have.
  2. Export settings from the previous version of Exchange Rules family and store it locally to the machine where Exchange Rules Pro will be installed.
  3. Uninstall any previous version of Exchange Rules family from each machine equipped with the program.
  4. Run the setup of CodeTwo Exchange Rules Pro 2.x and install Exchange Rules Pro Service on each machine equipped with Hub Transport or Mailbox role. Furthermore, install Administration Panel on any machine within your domain.
  5. Once the installation is completed, the next step is to import your rules definitions.

    The settings file generated by CodeTwo Exchange Rules Family of versions prior to 2007 4.x, 2010 3.x and 2013 2.x needs to be open up by the Settings Importer tool, which is available either via Import / Export button from Administration Panel or the list of programs. Just follow the wizard to convert and import settings from the previous version of the program.

    On the other hand, if you have a settings file generated by newer release of CodeTwo Exchange Rules family, import it using the Import settings... command, available under the Import / Export button in the Administration Panel. Finally, restart the whole application to see the changes.

    Important

    Import settings only on the first updated or a new instance of the program within your multi-server environment. Thanks to the real-time replication of settings, they will be propagated on other instances of the program once they are installed and opened. Therefore, if you run the Importer and import settings on other machines equipped with the program, you will end up with duplicated rules.

  6. Activate the program on the server equipped in Exchange Rules Pro Service with the license key provided.

Tip

If you have more than one server processing mail within your organization equipped in the previous version of the CodeTwo Exchange Rules, you need to run the installer on each server the program was installed on. Otherwise, not all the mailboxes will be processed by the program after update. To get more info on how to install the program in multi-server environment, please refer to this information.

See also

Hints to getting started - this article describes information useful while starting work with the program.

Was this information useful?