This article details the Brinqa Agent, data servers, and how to create, edit, or delete data servers.
What is a data server?
A data server is a record you create in the Brinqa Platform to denote a server associated with your on-premises resources. Your Brinqa Platform comes with one pre-configured data server, named local server, to collect data from your cloud resources. But to transfer data securely from your on-premises servers to the Brinqa Cloud, you must install a Brinqa Agent on each of your servers. A Brinqa Agent is a secure and high-performance gateway to the Brinqa Cloud. Then you must create a data server in your Brinqa Platform to represent the agent and select that data server when configuring your data integration.
Navigate to Integrations > Data servers. This page displays a list view of the existing data servers and allows for the creation of new ones. The following table details the columns on the Data servers page:
|State||Whether the server is online or offline. The Brinqa Agent sends a ping message to the Brinqa Platform based on a configurable frequency. If a response is not received within the expected time, the data server is considered offline.|
|Title||Title of the data server.|
|Max. connections||Maximum number of simultaneous connections to the server. The default setting is 10 connections.|
|Agent version||Version of the Brinqa Agent.|
|Last connected||Last time the agent connected to the Brinqa Platform.|
|Last disconnected||Last time the agent disconnected from the Brinqa Platform.|
|Updated by||By whom the data server was last updated (individual or the system).|
|Last updated||When the data server was last updated.|
Install Brinqa Agent and create a new data server
If you want to sync data from your on-premises servers to the Brinqa Platform, you must install a Brinqa Agent on each of your servers, create a data server in your Brinqa Platform to generate a configuration file, and place the file on your server to associate it with your Brinqa Platform. Upon establishing a connection to the Brinqa Platform, a secure tunnel is made to allow for two-way data transfer.
To install Brinqa Agent and create a new data server, follow these steps:
Download the latest version of Brinqa Agent from https://connectors.brinqa.io/#/downloads.
Install the Brinqa Agent on your server by unzipping the downloaded file to any directory on the server.
Log in to your Brinqa Platform, and navigate to Integrations > Data servers.
Fill in the data server properties:
Title: Title of the data server.
Name: Referenced name of the data server for queries and scripts.
Description: Description of the data server.
Max. Connections: Maximum number of simultaneous connections to the server. The default setting is 10 connections.
Skip SSL Verification: When selected, skip Secure Socket Layer (SSL) verification between the data server and the Brinqa Platform.
Click Create. The page reloads and you should see your data server listed.
Hold your pointer over the data server entry and click Download config to download the configuration file.
Place this file in the
/conffolder of your Brinqa Agent installation.
Make sure that both the
bin/pm.shfiles are executable:
$ chmod +x bin/agent bin/pm.sh
Start the Brinqa Agent:
$ ./bin/agent start
/logsdirectory to see if there are any errors.
Refer to the
README.txt file from your agent installation for more details about system requirements, memory defaults, permissions, troubleshooting tips, and more.
Edit or delete a data server
You can edit or delete existing data servers. Hold the pointer over the data server until you see a few options appear on the right-hand side. These options are Download config, Restart, Edit, and a kebab (three vertical dots) menu. The kebab menu contains the Delete option and the Clear working data option.
The Clear working data option deletes the data generated by Brinqa Agent during a sync. This option can be useful for the following reasons:
If the stored data is incorrect or outdated, you want to clear it and sync new data.
If the stored data is no longer needed, you want to remove it to free up disk space.