Skip to main content

Data Servers

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:

ColumnsDescription
StateWhether 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.
TitleTitle of the data server.
Max. connectionsMaximum number of simultaneous connections to the server. The default setting is 10 connections.
Agent versionVersion of the Brinqa Agent.
Last connectedLast time the agent connected to the Brinqa Platform.
Last disconnectedLast time the agent disconnected from the Brinqa Platform.
Updated byBy whom the data server was last updated (individual or the system).
Last updatedWhen 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:

  1. Download the latest version of Brinqa Agent from https://connectors.brinqa.io/#/downloads.

  2. Install the Brinqa Agent on your server by unzipping the downloaded file to any directory on the server.

  3. Log in to your Brinqa Platform, and navigate to Integrations > Data servers.

  4. Click Create.

  5. 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.

  6. Click Create. The page reloads and you should see your data server listed.

  7. Hold your pointer over the data server entry and click Download config to download the configuration file.

  8. Place this file in the /conf folder of your Brinqa Agent installation.

  9. Make sure that both the bin/agent and bin/pm.sh files are executable:

    • $ chmod +x bin/agent bin/pm.sh
  10. Start the Brinqa Agent:

    • $ ./bin/agent start
  11. Check the /logs directory 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.