Riva CRM Integration - Documentation and Knowledge Base

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

Article ID: 914
Last updated: 11 Sep, 2019

Riva Professional Services may advise installing two instances of Riva on the same Windows host system.

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

Definitions

  • Primary Riva Instance: The first instance of the 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. This instance can be installed in any folder location on a local drive in the Windows system.

Instructions

WARNING: Take EXTREME care to ensure that 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.

    Examples:

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

    WARNING: In the following code, 'value="RivaQA"' is only an example. The actual value must be different for each instance of Riva. If the value is the same, the service location is replaced upon installation.

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

  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.

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.

Notes:

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

Applies to

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

Article ID: 914
Last updated: 11 Sep, 2019
Revision: 4
Views: 5865
Also listed in