User Guide

Setup Ouvvi Dependency Agent

Ouvvi Agents can be installed on multiple machines, these agents can then be defined as a dependency agent so only Ouvvi steps with the same dependency name will run on this agent. Dependency agents allow you to run projects on specific machines, with specific credentials, just make sure to give the agent a unique name.

You can also add additional agents to a machine that already has an agent. For example you might do this if you need a project to run under specific credentials.

System Requirements

  • .NET Framework v4.7.2
  • Windows Server 2016 or Higher
  • 2 GB RAM
  • 1 CPU Core
  • 50 GB Disk Space
  • Data Synchronisation Studio
  • Ouvvi Server with firewall open to Ouvvi Site URL.

Important your Ouvvi Server Web Application must be accessible from the network. If you open the Ouvvi Server Web Application to the network consider the use of TLS/SSL for the site.

Install Ouvvi Agent

Follow the steps below to manually install and configure the Ouvvi Agent on this machine.

Step 1

Create a folder on this machine to hold your Agent Service and copy the Service folder from C:\Program Files\Simego\Data Synchronisation Studio 3.0\Ouvvi\Service to this folder.

New Service Agent

Step 2

Copy or edit the Simego.Console.Service.exe.config file to match the configuration in your Ouvvi Tenant.

The MessageSignatureKey and OuvviServiceUrl must match your Ouvvi Tenant configuration, and you must define an AgentName.

The AgentName must be unique and different to the machine name.

Edit Service Agent Configuration

Step 3

In Ouvvi go to Services->System Services->Add Service Agent to register this machine in Ouvvi to run the Ouvvi Service Agent.

Enter in the agent name that you defined in the config file into the Agent Name field. The Service Type should be set to Agent Service and the Dependency Name should be the name you want to use for this dependency agent.

The Agent will run a processing thread for each registered agent in services so create Service Agents as required.

New Service Agent

Step 4

Use the windows sc.exe utility to Install the Ouvvi Service into Windows Service Control Manager

sc.exe create OuvviAgent binpath="C:\Ouvvi\Service\Simego.Console.Service.exe" type=own start=delayed-auto DisplayName="Ouvvi Processing Service (OuvviAgent)"

Edit the Ouvvi Agent Windows Service and set the Windows Account to run this Service.

Ouvvi Service Setup Ouvvi Service Setup

This Windows Account must also be added as a user in Ouvvi under the User Profiles with Admin+Agent permissions.

Step Configuration

To configure a step in Ouvvi to run on this agent only set the Execute On parameter to the Dependency name you defined for the service.

Configure Ouvvi Step