The Brinqa connector agent (data server) is a secure and high-performance gateway to connectivity between on-premise data and the Brinqa cloud server. The connector agent opens several secure channels to the Brinqa cloud to sync data and perform various actions. The connector agent establishes an outbound connection to the Brinqa cloud, and upon the first data sync will download any requred connector framework data.

The Brinqa system can have multiple data servers, dependent on the number of on-premise data sources that need to be synced.

Navigating to Administration > Data Integration > Data Servers will take you to the Manage Data Servers page, which displays a list view of servers and allows for the creation of new ones.

Table 1: List view contents

Columns

Description

State

Whether the server is online or offline. The connector server/agent sends a ping message to the cloud based on a configurable frequency. If the ping is not received within the expected window of time, the data server/agent is considered to be offline.

Title

Title of the data server

Interval (secs)

Frequency at which the data server/agent sends a ping message to Brinqa cloud

Max. Connections

Maximum number of simultaneous connections to the server. Default is 10 connections.

Data servers are created for each on-premise location that will sync data to Brinqa cloud. Creating a new data server instance within Brinqa generates a configuration file that is used by actual data server to associate it with the Brinqa system. Upon establishing an connection to the Brinqa system, a connection tunnel is made to allow for two-way data transfer.

Procedure

Navigate to Administration > Data Integration > Data Servers

Click Create Data Server

Fill in the properties below and click Create.

Upon successfull creation, click the Actions button that appears to the right on mouseover of the entry on the list view and download the
configuration file.

Table 2: New data server properties

Field

Description

Title

Title of the data server. The title will be displayed wherever the data server appears in the UI.

Name

Reference name for queries and scripts. The name can contain only letters, numbers, and underscores.

Data servers are created in Brinqa applications in order to generate a config file that can be placed on the on-premise connector agent server, which passes on-premise data securely to the Brinqa cloud. The presence of the config file on this server associates it to the Brinqa system. This tutorial will cover installing the connector agent, creating a data server, and placing the config file. For more information on getting data into the system, see the Getting Data In article.

Procedure

Install the Brinqa Connector Agent on an on-premise server by unzipping the connector agent file to any directory on the server. The connector agent file can be obtained from Brinqa.

Enter a Title for the data server. The reference name for the data server will be automatically populated, but must be unique.

Enter a Description for the data server, e.g. a list of the service or file data it will provide

(Optional) Modify the Interval and Max. Connections properties. The interval determines how frequently the data server will ping the Brinqa cloud and max. connections determines how many connections the data server maintains in a pool. The default settings should be adequate for most situations.

(Optional) Check the Skip SSL verification box. This setting should be used only when initially testing connections.

Click Create

Navigate to Administration > Data Integration > Data Servers

Mouse over the entry for the data server you created and click the Actions button that appears to the far right

Select "Download conf"

Place this file in the /conf folder in the directory where you installed the Brinqa Connector Agent, replacing the existing "agent.conf" file