Edge Forwarder Service

From Datonis
Jump to: navigation, search

Introduction

Forwarder Engine allows forwarding of *.datonis.io URL requests via Edge Machine. Once enabled, Edge can act as a forwarder/Proxy for all Datonis browser requests. An integrated Proxy Server runs inside a docker container in the Edge Machine which can be configured in Datonis Edge.

Forwarder Service.jpg

Prerequisites - Docker

For Linux

  • Install Docker

For Windows

Expose Docker on TCP

Windows (Docker Desktop)

DockerExposeTCP.png

Starting Docker Service at startup (For Windows)

For windows, at the startup we have to manually click on start docker service prompt. To avoid this we can add this powershell script to run at start up by doing the following:

  • Create a startup file: E.g. in C:\Altizon\docker-startup.ps1
  • Add this in the script
start-service -Name com.docker.service
start "C:\Program Files\Docker\Docker\Docker Desktop.exe"
  • To start it automatically when the server boot create ScheduledJob with New-JobTrigger – like here: Open PowerShell as an Administrator and do:
$trigger = New-JobTrigger -AtStartup -RandomDelay 00:00:30
Register-ScheduledJob -Trigger $trigger -FilePath C:\tmp\bloom_onPrem\startup.ps1 -Name BloomOnPrem
  • Display Scheduled Job using Get-ScheduledJob or Get-ScheduledJob|Get-JobTrigger
  • Or it can be viewed in the Task Scheduler of Windows.

Linux

Add tcp://0.0.0.0.2375 in the hosts of Docker Engine.

Edit /lib/systemd/system/docker.service on Ubuntu system to modify the line

ExecStart=/usr/bin/docker daemon -H fd:// -H tcp://0.0.0.0:2375

then

sudo systemctl daemon-reload
sudo systemctl restart docker.service

Edge Forwarder Service

Configuration

  • enable-forwarder-service: This creates and runs the Proxy Server Docker Container on the Edge Machine with listening on the specified Port.
  • docker-daemon-server-url: URL of the docker daemon host URL.
  • exposed-port-for-forwarding: Port at which the Edge Forwarder Proxy Server will be listening.ForwarderService.png

Status

Status of the Forwarder Engine Container can be seen in the Status Tab of Edge.

FS-Status.png

Monitoring and Datonis Alerts

Datonis Alerts are sent for the Edge thing-key if the ForwarderService stops running.