Installation process

CodeTwo Exchange Rules PRO is designed for machines hosting Microsoft Exchange Server 2007, 2010, 2013 or 2016 responsible for processing mail in an organization. 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 the Exchange Rules Pro 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.

Installation in multi-server environment

If you are installing CodeTwo Exchange Rules Pro in a multi-server environment, you need to perform the installation of Exchange Rules Pro Service (set of components responsible for processing mail) individually on each server processing mail. Otherwise, not all 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 upgrading the program from either CodeTwo Exchange Rules PRO of version 1.x or CodeTwo Exchange Rules Family, make sure to run the installer on each server equipped with the previous version of the software. Please refer to Upgrading from version 1.x to 2.x or Upgrading from Exchange Rules Family section to learn more.

Installation in hybrid environment

Installation in hybrid environments is not any different from installation in standard Exchange on-premises environments. The software's Exchange Rules Pro Service 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 Pro 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.)

Pro 2.x - accept 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 PRO however it may be changed if necessary (Fig. 2.).

Pro 2.x - installation path
Fig. 2. Choosing the installation path.

Warning

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

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.)

Pro 2.x - choosing program's components
Fig. 3. Choosing which components of the program will be installed.

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

Info

Note that you need to install Exchange Rules Pro Service on each server equipped with the role responsible for processing mail. On the other hand, the installation of the Administration Panel can be performed on any machine within your environment including Servers and desktop clients. Check the recommended server and desktop installation practices

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 Pro 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.

Pro 2.x - change program's components
Fig. 4. Managing the program's components.

First steps

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

ER Pro 2.x - 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 Pro, Administration Panels may not be able to properly connect to the Service what results in the following error (Fig. 6.):

Pro - Unable to connect
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. Finally, restart the Administration Panel, the connection should be established.

ExchangeRulesPRO-Installation_fixed
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 Pro - 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.).

Pro - 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's why, we strongly recommend configuring the access rights straight after the initial installation before moving to other configuration steps.

Upgrading from version 1.x to 2.x

Before you move on with the upgrade, learn more about the architecture of the program as the installation of its components will have the 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 version 1.2.1.8 or newer. If you are upgrading from older release of CodeTwo Exchange Rules Pro please consult with CodeTwo Customer Support first.

To upgrade CodeTwo Exchange Rules Pro from version 1.x, please follow the steps below:

  1. Purchase the upgrade license pack first with the number of licenses equivalent to the ones you already have.
  2. Export your settings and store them locally.
  3. Run the setup of CodeTwo Exchange Rules Pro 2.x and install Exchange Rules Pro Service on top of the previous version. Furthermore, install Administration Panel on any machine within your domain.
  4. Once the installation is completed, open up the Settings Importer tool and follow the wizard to convert and import settings from the previous version of the program. Settings Importer can be opened either via Import / Export button from Administration Panel or from the list of programs.

    Important

    Import settings only on the first upgraded 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're 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. Note that after the upgrade the program will work for 30 days as a fully functional trial. Therefore, please activate it on each server equipped with Exchange Rules Pro Service until the end of this period, otherwise it will cease to work yet no rules will be processed.

Tip

If you have more than one server processing mail within your organization equipped in the previous version of the CodeTwo Exchange Rules Pro, you need to follow the upgrade steps above on each server the program was installed on (you may start from point 2 once you purchase the license). 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.

Upgrading from 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

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 from CodeTwo Exchange Rules Family 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. Otherwise, the program will work for 30 days as a fully functional trial.

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 next

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

Was this information useful?