Active Topics          Search          Help
            Register          Login
Riva for GroupWise ~ Managed Policies, Applications, Reports
 Omni Web Forum : GroupWise Collaboration Integration Engine (Riva) : Riva for GroupWise ~ Managed Policies, Applications, Reports
Subject Topic: Riva Enterprise for Linux Admin Guide Post ReplyPost New Topic
Author
Message
Gordon Welling
Admin Group
Admin Group

Manager Technnical Support Services

Joined: 11-December-2003
Location: Canada
Posts: 550
Posted: 04-September-2008 at 3:20pm
Riva Enterprise for Linux:  Admin Guide

This document includes:

  - Steps to install Riva Enterprise on Linux
  - Managing the Riva CRM Agent Service
  - Uninstall the Riva CRM Agent Service
  - Uninstall and Remove Riva Enterprise
  - Upgrade Riva Enterprise

NOTE - before proceeding, read How-to Install Riva Enterprise on Linux

STEPS TO INSTALL RIVA ON LINUX

Phase 1:  Create Users and Groups
  1. Open Yast > User and Group Management
  2. Create a group called 'omni'
  3. Create a user called 'riva' and make sure it is a member of the 'users' and 'omni' groups
  4. Close Yast.
  5. Logout
  6. Login as user riva

Phase 2: Install Mono 1.9.1 or 2.0 (if required)

Installing Mono 1.9.1 (or 2.0)

For Mono 1.9.1 visit http://www.go-mono.com/mono-downloads/download.html and download the package for either openSUSE or SLES/SLED as appropriate.  Add the 'Mono' package repository to Yast appropriate for your system.

Ensure the following packages are installed on your system:
* mono-extras
* mono-core
* mono-locale-extras
* mono-winforms
* mono-web

Phase 3: Install Riva (note # and > shows the prompt)

  1. Open terminal
  2. > su (login with root password)
  3. # cd /opt
  4. # mkdir omni
  5. Using file browser or at the terminal, copy the riva-latest.zip file into the /opt/omni folder
  6. # cd omni
  7. # unzip riva-latest.zip
  8. # chown -R riva:omni Riva
  9. # chmod -R ug+rwxs,o-w,o+rx Riva
  10. # exit
  11. > cd /opt/omni/Riva/Resources/Linux
  12. > sudo ./riva-install.sh
    NOTE:  Ensure that you:
            - use the user name that you created in Phase 1.
            - answer NO for running Mono 2.0 or higher
    You should see the following prompt on the console:

    Quote:
    Run the CRM service under what user? riva
    Are you running Mono 2.0 or greater? (y or n) : n
    Configuring for Mono 1.9.1
    To change your settings, edit /etc/riva.conf


  13. > sudo ./riva-service-install.sh
    You should see the following text on the console:

    Quote:
    Riva CrmAgent will now automatically start on system startup.


  14. IMPORTANT - If you have received a license file, save a copy of the Riva .license file to the /opt/omni/Riva/Licenses folder
  15. > cd ../.. -or- cd /opt/omni/Riva
  16. > ./runriva.sh (this will open the Riva application)
        
Phase 4: Create and configure connections as per your requirements. 

Refer to:
Phase 5: Create and configure policies as per your requirements. 

Refer to:
Phase 6: Run Riva CRM Agent
  1. > su
  2. # cd /opt/omni/Riva
  3. # rcriva start
    Note - you should see the following on the console:
    service is Crm Agent

    Quote:
    path is /opt/omni/Riva/Application/Base/Omni.Riva.CrmAgent.exe
    dir is /opt/omni/Riva/Application/Base
    filename is Omni.Riva.CrmAgent.exe
    user is riva
    disable is NO
    Starting Crm Agent       done


  4. # exit
You can check the logs Riva created:
  1. > cd /opt/omni/Riva/Logs
  2. > l
    Note - you should see something like the following on the console:

    Quote:
    total 40
    drwsrwsr-x  2 riva omni  4096 2008-08-21 12:24 ./
    drwsrwxr-x 10 riva omni  4096 2008-08-21 12:24 ../
    -rw-r--r--  1 riva omni 15549 2008-08-21 12:24 log  (2008-8-21)-1.txt
    -rw-r--r--  1 riva omni 14576 2008-08-21 12:18 log  (2008-8-21).txt


  3. > gedit "log (2008-8-21)-1.txt"
Phase 7: Run Riva Monitor

  1. Ensure that you are in /opt/omni/Riva folder
  2. > ./monitor.sh
    Note - you should see the following on the console:

    Quote:
    Initializing Logger
    Omni Riva Collaboration Integration Engine (Enterprise Edition) [Version: ]
    Copyright (c) 2008 Omni Technologies Solutions, Inc.   All rights reserved.
You should see the Riva Monitor interface open and it will dynamically refresh each time the Riva CRM Agent Service performs a synchronization.

MANAGING THE RIVA CRM AGENT SERVICE:

After being run the first time, the Riva CRM Agent (rcriva) will autostart as a service.

To manage the service, open a new terminal window:
  1. > su
  2. # cd /opt/omni/Riva
  • # rcriva stop (stops the service)
  • # rcriva start (starts the service)
  • # rcriva restart (restarts the service)

UNINSTALL THE RIVA CRM AGENT SERVICE:

You can uninstall the CRM Agent service which disables the Riva CRM Agent service from running at system startup.  This does not uninstall Riva.  You can still run the Riva application to manage the Riva policies.

To uninstall the Riva CRM Agent service, open a new terminal window:

  1. > su
  2. # cd /opt/omni/Riva
  3. # rcriva stop
  4. # ./riva-service-uninstall.sh
    NOTE: You should see the following in your console: (Answer 'y' to uninstall the service)

    Quote:
    You are about to uninstall the Riva Service. This will
    prevent the CrmAgent from automatically starting at
    system startup.  

    Are you sure you want to continue?  (y or n) : y


  5. # exit
UNINSTALL AND REMOVE RIVA ENTERPRISE:

You can uninstall Riva which disables the Riva CRM Agent service from running at system startup.  This removes  all Riva and all files associated with it.

To uninstall, open a new terminal window:

  1. > su
  2. # cd /opt/omni/Riva
  3. # rcriva stop
  4. # ./riva-uninstall.sh
    NOTE: You should see the following in your console: (Answer 'y' to uninstall Riva)

    Quote:
    You are about to uninstall Riva. This will deactivate
    all services and remove them from the system. All Riva
    application files will also be removed.

    Are you sure you want to continue?  (y or n) : y


  5. # exit
UPGRADE RIVA ENTERPRISE:

Riva on Linux does not include a "Check for Updates" feature.  You need to:
  • stop the Riva CRM Agent service
  • uninstall the Riva CRM Agent service ONLY
NOTE:  Do not run the riva-uninstall.sh file as this will remove the /opt/omni/Riva folder and you will lose all your connection settings,  CRM Integration policy and license files.
            
You have to manually perform the following steps to upgrade Riva to a new release:

  1. Close any open Riva or Monitor application interfaces
  2. Download and save the latest riva-latest.zip to /opt/omni
  3. > su
  4. # cd /opt/omni/Riva
  5. # rcriva stop
  6. IMPORTANT - Make a backup copy of the /opt/omni/riva folder
  7. # ./riva-service-uninstall.sh
  8. # cd /opt/omni
  9. # unzip -o riva-latest.zip
  10. # chown -R riva:omni Riva
  11. # chmod -R ug+rwxs,o-w,o+rx Riva
  12. # exit
  13. > cd /opt/omni/Riva/Resources/Linux 
  14. > sudo ./riva-install.sh
    You should see the following on the console:

    Quote:
    Run the CRM service under what user? riva
    Are you running Mono 2.0 or greater? (y or n) : n
    Configuring for Mono 1.9.1
    ln: creating symbolic link `/sbin/rcriva': File exists
    To change your settings, edit /etc/riva.conf


  15. > sudo ./riva-service-install.sh
    You should see the following on the console:

    Quote:
    Riva CrmAgent will now automatically start on system startup.


  16. > cd /opt/omni/Riva
  17. > su
  18. # rcriva start
  19. # exit
  20. > ./runriva.sh
  21. > ./monitor.sh
  22. > su
  23. # rcriva restart
  24. Watch the Riva Monitor application and confirm that the CRM synchronization occurs.


Edited by Aldo Zanoni on 10-November-2008 at 6:02pm
Back to Top
 

If you wish to post a reply to this topic you must first login
If you are not already registered you must first register

  Post ReplyPost New Topic
Printable version Printable version

Forum Jump
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot delete your posts in this forum
You cannot edit your posts in this forum
You cannot create polls in this forum
You cannot vote in polls in this forum



This page was generated in 0.2969 seconds.