Install Multiple Instances of Riva Server on the Same Windows Host System

Article ID: 914
Last updated: 07 Jan, 2019

When working with Riva Professional Services, customers may be advised to install two instances of Riva on to the same Windows host system.

WARNING: Do not follow these instructions unless advised to do so by the Riva Professional Services.


  • Primary Riva Instance: The first instance of Riva sync service being installed. By default, Riva is installed in C:\Riva.

  • Secondary Riva Instance: The second instance of the Riva sync service that will be created after the primary Riva Instance has been installed. Customers can install this instance to any folder location on a local drive to the Windows system.


WARNING: Take EXTREME care to ensure the two instances do not have conflicting options, or ensure that the sets of users are different.
  1. Create the Primary Riva Instance in the desired location, by default C:\Riva.

  2. When creating the new (Secondary Riva Instance), extract Riva to a folder of your choice on a local system drive.


    • C:\Program Files (x86)\Omni\RivaQA

    • D:\RivaQA

    In the following steps, each instance is going to be uniquely identified in a configuration file.

  3. Create two App.Setting files:

    • Omni.Riva.CrmAgentEx.exe.config

    • RivaApp.exe.config

  4. In each of the two files, insert the following XML content.

    Note: If the files already exist, ensure that the <add ... /> portion of the content is merged with the current value.

    <?xml version="1.0" encoding="utf-8"?>
        <add key="Service.ExecutionPod" value="RivaQA" />

  5. Open a CMD prompt with elevated privileges ("Run as administrator").

  6. Change the directory to the directory where the .config files were created of the Secondary Riva Instance,

    Example: CD D:\Omni\RivaQA\Application\Base [enter]

  7. Manually install the Riva sync service by typing

    Omni.Riva.CrmAgentEx.exe --install [enter]

  8. In Windows services, confirm that there are two Omni Riva (CRM Agent for Exchange) services installed. One service must point to the path for the primary Riva instance, and the other must point to the path for the secondary Riva instance.


  • Using the Riva Service Monitor. The Riva Service Monitor application will monitor sync activity for both Riva instances, but the Stop , Start, and Restart buttons will work only against the primary Riva instance.

  • Controlling the Secondary Riva Instance. To stop, start, or restart the secondary Riva instance, admins need to use the Windows Services applet (services.msc).

  • WARNING. Do Not Add the Same User to Multiple Sync Policies. Ensure that the same target user is not synced by both instances; otherwise, duplicate data or data loss could result. 

Applies to

  • Riva On-Premise 2.4.33 or higher for Exchange or Notes.

Article ID: 914
Last updated: 07 Jan, 2019
Revision: 3
Views: 4036
Also listed in
folder Riva On-Premise - CRM Sync -> Manage Riva On-Premise (Admin Guides) -> Manage the Riva Server -> Manage Server Configuration -> How to

Prev     Next
Move Riva to a Different Folder on the same Windows System       Upgrade Riva On-Premise

Back to Top