Upgrade an Existing eControl 3 Installation to the Latest Release

Upgrading of an existing eControl installation requires the manual uninstall of agent services and applications and installation of the latest release. Here is an outline of the steps:

Table of contents

• Confirm the eControl Installation
• Backup System Files
• Uninstall Agents on Riva Server and Exchange Server
• Uninstall eControl
• Reinstall eControl
• Reinstall Agents on the eControl and Exchange Servers
• Confirm Connections and Licenses
• Restore the eControl Target System Connections and Licenses Folders

Confirm the eControl Installation

It is important to upgrade all related installations of eControl. Confirm the following information:

• On the eControl host server:
  • Is the Omni Connection Service Agent installed?
    • Open Windows Manage > Services and confirm if there is an Omni eControl Connection Agent installed and "Started".
    • View the properties of this agent and under "Log On" confirm how the agent is configured to log on as. If the "Local System account" is not selected, record the account being used as this will have to be reconfigured after the agent is reinstalled (see below).
• On the Exchange server hosting the Omni Connection Agent:
  • Open Windows Manage > Services and confirm if there is an Omni eControl Connection Agent installed and "Started".
  • View the properties of this agent and under "Log On" confirm how the agent is configured to log on as. If the "Local System account" is not selected, record the account being used as this will have to be reconfigured after the agent is reinstalled (see below).

Backup System Files

Using windows explorer on the eControl server, make a backup of the following files and folders:

• C:\Program Files\Omni\Riva\Configuration folder
• C:\Program Files\Omni\Riva\Licenses folder

Uninstall Agents on Riva Server and Exchange Server

Run the UninstallAgent.bat file on the eControl server and on the Exchange server where the Omni Services Connection Agent is installed (Note: the path will vary depending on the release of eControl currently installed):

• Run the C:\Program Files\Omni\eControl\Agents\Omni.Interop.Agent\UninstallAgent.bat file OR
• Run the C:\Program Files\Omni\eControl\Agents\Omni.Services.Connection\UninstallAgent.bat file OR
• Run the C:\Program Files\Omni\eControl\Agents\Omni.Services.Connection.Agent\UninstallAgent.bat file

Uninstall eControl

This can be done in one of two ways:

• Use Windows Control Panel > Add or Remove Programs to remove "Omni eControl" OR
• Run the eControl setup.exe installer for the version of eControl currently installed and select "Remove Omni eControl"

Reinstall eControl

1. Download and extract the latest release of eControl
2. Run the setup.exe file and install eControl in the same manner and in the same locations that it was previously installed.
   • on the eControl server first
   • on the Exchange servers

Reinstall Agents on the eControl and Exchange Servers

1. Run the InstallAgent.bat file on the eControl server and on the Exchange servers where the Omni Services Connection Agent is installed:
   • Run the C:\Program Files\Omni\eControl\Agents\Omni.Services.Connection.Agent\InstallAgent.bat file
     • Answer Y to the question to start the service.
   • Using Windows Manage > Services configure the Log On properties of the Omni Services Connection Agent and restart the agent service.
2. Run iisreset /restart

Confirm Connections and Licenses

Start the eControl Connections (Riva) application and confirm that the connections and licenses are correct.

Restore the eControl Target System Connections and Licenses Folders

(Optional) If the eControl connections and/or licenses do not appear correct, restore the backup copies of the following files or folders to their corresponding location on the eControl server:

1. Close the Riva application.
2. Using Windows Task Manager, end the process for the Omni.Services.Connection.exe process.
3. Restore the backup files as required:
   • Copy the backup \Licenses folder to C:\Program Files\Omni\Riva\Licenses
   • Copy the backup \Configuration folder to C:\Program Files\Omni\Riva\Configuration
4. Run iisreset /restart
5. Open a browser and login into the eControl portal. A new Omni.Services.Connection.exe process should launch in Windows Task Manager.

---