Request and Activate a License for Riva On-Premise

Article ID: 268
Last updated: 24 Jan, 2017

This article discusses how to request and implement licenses for the Riva On-Premise server.

Riva License Modes

Riva On-Premise supports the following license modes and types of licences:

  • Demo: This is deployed as soon as you open Riva the first time. You can create connections between Riva and your email system, as well as between Riva and your CRM, but you cannot synchronize. In demo mode, you can request a synchronization and the sync log displays the same sorts of entries that Riva would output during a sync, but the sync is not being performed. The demo mode is intended only to give an idea of what Riva On-Premise does.

  • Trial License: Allows full CRM synchronization functionality for the period that the license is issued for. When the license expires, data is no longer synced between the email system and the CRM system. Trial licenses are usually limited to 5 users for 15 days.

  • Purchase License: Allows full CRM synchronization functionality for the period that the license is issued for. When the license expires, data is no longer synced between the email system and the CRM system. Purchase licenses are for an annual term for the desired number of users that Riva can sync.

  • Sandbox/Testing License: Allows for full Riva functionality in a dedicated testing environment. For more information, contact the Riva Success Team.

When to Request a Licence

  • Trial license: Request a license after configuring and testing the mail server and CRM connections, but before creating a CRM synchronization policy.
  • Purchase license: Request at any time before your trial license expires. You can also request a purchase license even if you have not had a trial license, for example if a partner of Riva International, Inc. has done all the testing for you and provided you with the connection and configuration files that you need to request your license and to sync with.

How Is the Riva On-Premise Server Licensed

The Riva On-Premise server is licensed as per a subscription model based on the number of email users and the number of CRM users which Riva will sync data for. If more email users are to be synced than there are CRM users to be synced, the cost of the Riva licence is increased according to the extra number of email users being synced; likewise, if there are more CRM users to be synced than there are email users to be synced, the licensing cost is increased according to the extra number of CRM users to be synced.

Riva supports multiple internet email domains, provided that every domain is identified in the licence request.

How to Request a Licence

To request a Riva On-Premise licence:

  1. Start the Riva Manager application. On the menu bar, select Request License.

  2. On the Welcome to the Riva Licence Wizard page, select Next.

  3. On the Choose Licensing page, under CRM Integration, select the email platform, and select Next.

    Riva Licensing does not license CRM systems based on an IP address. The CRM must be licensed against a fully qualified domain name. If your CRM is listed as an IP address, you need to recreate your CRM connection in Riva and submit a new licence request.

  4. On the CRM Licensing page, ensure that the desired CRM connection is displayed, and select Next.

  5. On the Select the Domain(s) to License page, if the desired email domain is on the list and you are licensing only that email domain, select Next.

    If the list is empty or you need to include more than one email domain, select add >> to the right of the box. Only email addresses in these domains will be authorized to sync.

    In the Select Entities window, type the email address of a user with a different email domain name, and select check name >>.

    If the Mailbox account resolves through the mail server connection, the Mailbox name becomes underlined. Select add >> to add the email address and domain to the list.

    For each different email domain that needs to be licensed through this connection, repeat this process.

    Select OK to add the domain names to the domains to license.

  6. On the Select the Domain(s) to License page, below the list box, select a Trial or Purchase license, and specify the number of accounts to license.



    Select Next.

  7. On the Contact Information page, fill in the information, and select Next.

    The Riva Licence Request wizard creates two request files:

    • A .request file located in the \Riva\LicenseRequests folder.

    • A .license file located in the \Riva\License folder. This is an unsigned license file.
       

  8. On the Submit Request Electronically? page, do as follows:

    • If you want Riva to attempt to upload the license request to the Riva Licence Request server, select Yes, and see Electronic submission; or

    • If you have already selected Yes earlier and the automatic submission has failed, select No, and see Request a license manually.
       

    Electronic submission:

    • If the licence request upload was successful, Riva displays a successful Completed message box.

      1. Close the Completed message box.
      2. Close the Riva Manager application.
      3. Wait to receive an email with an activation key or a licence file.
         
    • If the licence request upload was not successful, Riva displays a Completed window to prompt you to email us the file that was created, but follow these instructions first:

      1. Jot down the path to the .request file, because you will need it to request the license manually. The path should point to the \Riva\LicenseRequests folder.
      2. Close the Completed message box.
      3. Close the Riva Manager application.
      4. Request a licence manually.
         

    Request a licence manually:

    (This is the bottom of step 8 of How to request a license.)

    If the Licence Request wizard fails or if you selected No on the Submit Request Electronically? page, the Riva wizard displays a Completed window that prompts you to email us the file that was created.

    1. Create an email to send to licensing@omni-ts.com.
    2. Attach the .request file that is described at step 7.
    3. Send the email.
    4. Wait to receive an email with an activation key or a licence file.

How to Activate a Licence

For trial licence requests, you will receive an email with an activation key and a corresponding license file.

How to apply a licence activation key

If you receive an email with a licence activation key:

  1. Start the Riva Manager application. In the Home tab, note the text box for pasting the activation key.

  2. From the email, copy and paste the activation key into the text box.

    IMPORTANT: All the equal signs (=) at the top and bottom of the activation key ARE PART AND PARCEL of the activation key.

  3. Select Activate.

  4. In the Activation Success! message box, select OK.

If the activation key is not successful

Under certain conditions, applying the activation key may fail. If that occurs, follow the steps in How to manually apply a licence file, using the licence file attached to the email that delivered the trial licence activation key.

How to manually apply an original or additional license file

In some circumstances, the license activation key does not work. In some circumstances, you may need to apply more than one licence file to a Riva server.

Note: This procedure is not used to apply a replacement license file, that is, a license file that replaces an existing license file that has expired or for which additional connections have been added. For the correct instructions, see How to apply a replacement license file.

To manually apply an original or additional licence file:

  1. In the CRM Service Monitor application, or in Windows services, stop the CRM Agent service.

  2. In the top left of the Riva Manager application, double-click the Riva logo.

  3. In the About Riva window that appears, double-click the Riva version number.

    Windows Explorer displays the contents of the \Riva folder, which is the root folder of the Riva server installation.

  4. Navigate to the \Riva\Licenses folder. Remove the existing [guid_crmex].licensees file and any .license file. Copy the new .license file that you received, and paste it into the \Riva\Licenses folder.

  5. Close and restart the Riva Manager application.

  6. On the menu or in the Policies tab, right-click the applicable sync policy, and select License Details.

  7. In the License Details window, confirm that the licence details are correct.

    • If the licence details are not correct, email your licence file to the Riva Success Team at support@omni-ts.com, and explain the issue.

    • If the licence details are correct, close the Licence Details window.

  8. In the Riva CRM Service Monitor application, start the service, and confirm that there are no licence errors in any of the Activity Monitor panes.

  9. If you encounter any errors, contact the Riva Success Team.

How to manually apply a replacement licence file

To manually apply a replacement licence file received from the Riva Licence services:

  1. In the CRM Service Monitor application, or in Windows services, stop the CRM Agent service.

  2. In the top left of the Riva Manager application, double-click the Riva logo.

  3. In the About Riva window that appears, double-click the Riva version number.

    Windows Explorer displays the contents of the \Riva folder, which is the root folder of the Riva server installation.

  4. If this is the first licence file being applied, navigate to the \Riva\Licenses folder, and remove the existing files.

    If this is to replace an existing Riva licence file, rename the \Riva\Licenses folder to \Riva\Licenses.old, and create an empty \Riva\Licenses folder. This saves the existing licence files in case you have to roll back to a previous licence. In subsequent attempts to replace an existing licence, move the existing licence files to the \Riva\Licenses.old folder.

  5. Copy the replacement licence file you have received, and paste it into the \Riva\Licenses folder.

  6. Close and restart the Riva Manager application.

  7. On the menu or in the Policies tab, right-click the applicable sync policy, and select Licence Details.

  8. In the Licence Details window, confirm that the licence details are correct.

    • If the licence details are not correct, email your licence file to the Riva Success Team at support@omni-ts.com, and explain the issue.

    • If the licence details are correct, close the Licence Details window.

  9. In the Riva CRM Service Monitor application, start the service, and confirm that there are no license errors in any of the Activity Monitor panes.

  10. If you encounter any errors, contact the Riva Success Team.

How to Request a Licence Extension or Purchase a Licence

If you need a trial licence extension or would like to purchase a licence, contact the Riva Success Team to request the correct licence file. Licence extensions and purchase licences are delivered as a licence file attached to an email and are always manually applied to Riva.

This article was:   Helpful | Not helpful Report an issue


Article ID: 268
Last updated: 24 Jan, 2017
Revision: 10
Views: 18156
Comments: 0
Also read
item User is Unlicensed - Actual License Count Not Exceeded
item Request and Activate a License: Riva On-Premise for GroupWise
item Resolving "Policy has EXPIRED. Execution Aborted!" Error

Also listed in
folder Riva On-Premise - CRM Sync -> Manage Riva On-Premise (Admin Guides) -> Manage the Riva Server -> Manage Server Licensing

Prev     Next
Licensing       Request and Activate a License: Riva On-Premise for IBM Notes


Back to Top