Remote Agent

Introduction

DBSync Remote Agent is a lightweight service that enables secure communication between your on-premise systems and the DBSync Cloud Workflow (CW) platform. It acts as a bridge that facilitates the movement of data between internal systems (like databases or ERPs) and cloud-based applications, even if the internal systems are behind a firewall.

Remote Agents are especially useful for:

• Integrating on-premise databases, file systems, or other services with cloud applications.

• Ensuring secure communication through encrypted protocols.

• Handling scenarios where direct internet access is not feasible.

Note: You only need the Remote Agent if you're connecting an on-premise system. For cloud integrations, no installation is required.

Access Remote Agent

1. To access Remote Agent , click from the top panel. This opens the left menu panel.

2. Click Remote Agent to see the list of remote agents created.

System Requirements

If you are utilizing the DBSync Remote Agent for on-premise integrations, please ensure your system meets the following requirements:

Supported Operating Systems

• Windows:

  • Windows 10 or later

  • Windows Server 2016 or later

• MacOS:

  • MacOS Monterey (12) or later

• Linux:

  • Ubuntu 20.04 LTS or later

  • Red Hat Enterprise Linux 8 or later

  • CentOS 8 or later

Software Requirements

Java: Oracle Java JDK 1.8 or higher (32-bit or 64-bit, based on server configuration).

Hardware Requirements

• CPU: 1 GHz or better processor

• RAM: 1 GB free RAM

• Disk Space:

  • Installation: 150 MB free space

  • Map/Process Store: 5 MB per map

  • Operational: 1 GB (for log files, event queues, etc.)

Note: Windows 7, Windows Vista, and Windows 2003 Server are no longer supported.

Remote Agent Dashboard Overview

The Remote Agents dashboard has the following fields displayed;

Group Name: The name provided for the group of users pertaining to the same agent.

Status: Displays the status (active or inactive) of the Agent using color code (red - inactive, green - active).

• Warning (For select iterations): This will be displayed if the group has mixed agent status, such as Running and Stopped. If group A has 2 agents, where one of the agents is currently running and the other agent is stopped, the group status indicates.

• Running: indicates that the agent is running without any issues.

• Stopped: will indicate when the agent is stopped due to various issues.

Last Ping: Displays the timestamp of the last active session that occurred in the user's time zone.

Actions: Displays Edit and Delete options where the user can either delete the group or edit the configurations of the group.

Create New Group

Create a new group by following the steps given below.

Step 1: Click +Group to add a new agent group.

Step 2: Enter the following information in the popup window.

1. Name: Provide a name for the group.

2. Owner: Assign an owner of the group by selecting the user name from the dropdown list.

3. Receive Notifications: Select or deselect the checkbox to receive notifications regarding the agent's start and stop.

NOTE:

1. Every time a new group is created, a non-editable Group ID will be generated by the system.

2. An Owner is a user in your DBSync instance.

Step 3: Click Save to confirm the creation of the new group.

Download and Install

Download and install the Remote Agent as per the instructions provided in the UI.

Step 1: Download the Remote Agent

Download the Remote Agent package for your operating system from the Download link provided in the UI in Steps 1. Refer screenshot below.

Step 2: Install the Remote Agent as per instructions provided in the UI.

To run the Remote Agent as a service, the recommended method is to launch it by clicking the remoteagent.bat file located in the bin folder.

Configuration

After installation, configure the Remote Agent to connect securely with the DBSync Cloud Workflow.

1. In your browser navigate to the local configuration URL: http://localhost:8080/cw/api/v2/agent/configuration

   
2. On the configuration page, provide the following details:

• Group ID (from the group you created in Cloud Workflow)

• Agent Name (a unique identifier for the agent)

• User Name: Enter the same username you use to log in to DBSync

• Password: Enter your DBSync login password

1. Click Submit to complete the registration. If there is an error and you are unable to submit, contact DBSync Support.

2. Navigate to the required flow page and choose the appropriate remote agent from the dropdown menu.

   

Agent Notification Emails

When an Agent starts or stops, the owner is alerted about that event through an email.

The following information is listed in the email that the owner receives.

Start

• Subject: Remote Agent Started

• Body: DBSync CloudWorkflow Remote Agent: <name> Started at Time: <time in UTC> UTC

Stop

Subject: Remote Agent unreachable

Body: DBSync CloudWorkflow Remote Agent: <name> is unreachable since: <time in UTC> UTC