How to Uninstall Riva On-Premise Server

  • Updated

There are several reasons to uninstall a Riva On-Premise server:

If a corporate decision is made to switch

  • to Riva Cloud, contact the Riva Success Team.
  • to a non-supported email system or CRM, we recommend contacting the Riva Success Team to discuss the possibility that we add support for the new email or CRM system.

To uninstall and decommission the Riva On-Premise server:

  1. Optional: Clear the Riva-synced data from the target user email accounts.
  2. Stop and remove the Riva CRM Agent service.
  3. Delete the Riva installation folders.

Step 1: (Optional.) Clear Riva-Synced Data

Warning: This is a destructive non-reversible optional procedure.
 

Some environments want to remove Riva synced data from the target user email accounts to prevent possible future data sync challenges with the CRM. This process removes all Riva-synced items from the user's email address book, calendar, and task items (including those originated in the email client), and AssignTo drop folders from target users

To clear Riva-synced data:

  1. Open the Riva On-Premise sync policy.

  2. Do one of the following:

    • For Exchange user accounts: Re-initialize all users, select the Clear re-init option, and select All modules. For a complete procedure, see Set the re-init options in Riva 2.4.40 or higher.

    • For GroupWise user accounts with a legacy connection: Select the Sync Start Time tab. Select Re-initialize All, and set the Sync Start Time to 10 years into the future. Save the policy.

    Result: The CRM Sync Service is restarted, which wipes the data that Riva synced from the CRM to the email account.

  3. Start the Riva Service Monitor application, and confirm that the "Clear" sync has been completed for all of the target users.

    reinit-user-clear-all-result.png

  4. Ask the users to remove the empty address books, categories, and the SmartConvert drop folders from their accounts in their email clients.

Step 2: Uninstall the CRM Agent Service

To remove the Riva CRM Agent Service from the host Windows system:

  1. Log in to the host Windows system as a local administrator account.

  2. On the source Riva server, start the Riva Service Monitor application, and stop the service.

  3. Start Windows Services, and confirm that the Omni Riva (CRM Agent for Exchange) or the Omni Riva (CRM Agent) status is blank. If the status is displaying "Stopping", see Riva service is "Stopping..." for instructions to force the service to stop.

  4. In Windows Services, do one of the following:

    • For an Exchange environment: Open the properties of the Riva CRM Agent service, and copy the path to the service to the Windows clipboard.

      transfer-1.jpg

    • For a GroupWise environment with a legacy connection: Open the properties of the Omni Riva (CRM Agent) service, and copy the path to the service to the Windows clipboard.

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

  6. Type CD \, and press ENTER. Type a " (double quotation mark), click in the CMD prompt window, right-click, and select Paste. After \Omni.Riva.CrmAgentEx.exe, type a " (double quotation mark), type a space, type --uninstall, and press ENTER.

    uninstall-CMD-Windows-7.png

  7. When Done! appears, press ENTER, and close the CMD prompt window.

  8. Refresh Windows Services, and confirm that the Riva CRM Agent service has been removed from the list of installed services.

  9. Close Windows Services.

Step 3: Delete the Riva Installation

The idea is to delete the Riva server folder structure.

To delete the Riva installation:

  1. In the Riva Manager application, in the top left corner, double-click the Riva logo.

  2. In the About Riva window that appears, in the top right corner, double-click the Riva version information.

    Result: Windows Explorer displays the contents of the Riva path where the "Riva.exe" file is located.

  3. Close all the open Riva application windows.

  4. Optional: In Windows Explorer, navigate up one folder, and make a .ZIP file that contains the contents of the Riva folder structure.

  5. In Windows Explorer, remove the Riva folder.

Applies to

  • Riva On-Premise for Exchange.
  • Riva On-Premise for GroupWise (legacy connection).

Was this article helpful?

/