Deploying the Sync Engine in a multi-server environment

A multi-server environment is a Sage CRM configuration with more than one Sage CRM server. Users are load balanced onto different Sage CRM servers based on rules defined in a hardware or software load balancer.

In this type of environment, it’s important that the Sync Engine runs on only one of the Sage CRM servers. If there are multiple Sage CRM servers, with an individual exchange Sync Engine deployed on each, there would be issues with conflicting Exchange synchronization resources and there could also be performance issues if each Sync Engine tried to perform a synchronization every few minutes.

In multi-server environments, you should install only one Sync Engine instance on the primary server in a group. To ensure that installing subsequent servers won’t break the existing Exchange synchronization, do the following.

  1. Disable the integration from the Sage CRM UI on the first server.
  2. Install the next node.
  3. Remove the Replication Engine from the new node.
    1. Stop the Apache Tomcat 9.0 <SageCrmInstallName>Tomcat9 Windows service.
    2. Remove the file %ProgramFiles(x86)%\Sage\CRM\<InstallName>\
      tomcat\webapps\<InstallName>ExchangeSyncEngine.war
    3. Remove the folder %ProgramFiles(x86)%\Sage\CRM\<InstallName>\
      tomcat\webapps\<InstallName>ExchangeSyncEngine
    1. Start the Apache Tomcat 9.0 <SageCrmInstallName>Tomcat9 Windows service.
  4. Enable integration on the first node.