Manage gateways

A gateway lets Fresco BI reach a data source inside your private network. This page covers managing gateways in the app. To install the agent on a machine, see Gateway.

Before you start

• You need the Owner or Admin role in the organization. Other members do not see Gateways.
• Gateways need the Pro or Enterprise plan. See Plans and limits.
• Turn on two-step verification on your account. You need a code to get an enrollment token.

Add a gateway

1. In the sidebar, under Workspace, click Gateways.
2. Click Add gateway.
3. Name & platform: enter a Gateway cluster name (1 to 64 characters, unique in the organization).
4. Pick the Machine that runs the agent: Ubuntu or Windows.
5. Install the agent: enter the code from your authenticator app and click Get token.
6. Follow the install steps on the page, on your machine. See Gateway.
7. Enroll & approve: when the machine connects, compare its fingerprint with the one the machine printed. Tick I have compared the fingerprint.
8. Click Approve. If the fingerprint does not match, click Reject.

When it is done, click Create a data source using this gateway or Open gateway.

Caution

The enrollment token works once and expires after 1 hour. The page shows the time left. If it expires, click Create a new token.

Gateway list

The Gateways page lists every gateway with its Status, Members (machines online out of total) and Sources (data sources that use it). Setup not finished marks a gateway that was never approved.

A gateway has one of three statuses:

Status	Meaning
Online	Every approved machine is online, or at least two are.
Degraded	Only one of several approved machines is online.
Offline	No machine is online. Queries through the gateway fail.

Each machine on the details page also has a status:

Status	Meaning
Online	The machine is connected.
Offline	The machine sends no heartbeat.
Draining	The machine finishes its current work and takes no new work.
Pending	The machine waits for approval.
Revoked	The machine was cut off for good.
Uninstalled	The agent was removed from the machine.

Gateway details

Click a gateway to open it. The page shows its policy, allowlist, minimum version, the data sources that use it, and one row per machine with Host, Version, Status, Heartbeat and In-flight tasks.

Warnings at the top tell you when a machine runs a version below the minimum, when no machine is online, or when a machine’s policy does not match.

Add a machine

Add a second machine to keep the gateway up when one machine stops.

1. Open the gateway.
2. Click Add member and follow the same steps as above.

Rename a gateway

1. Open the gateway.
2. Click Edit.
3. Enter the new name and click Save.

Drain or revoke a machine

• Drain: the machine finishes its work and takes no new work. Use it before maintenance.
• Revoke: cuts the machine off for good. You cannot undo it. To use that machine again, add it again.

Delete a gateway

You can delete a gateway when:

• its setup never finished, or every machine is uninstalled, revoked, or has sent no heartbeat for 24 hours, and
• no data source uses it.

1. Open the gateway.
2. Click Delete. Sign in again if Fresco BI asks.
3. Type the gateway name.
4. Click Move to Trash.

The gateway goes to the organization Trash. Its machines are revoked. If you restore it from the Trash, click Continue setup and add machines again.

Questions

Why can’t I see Gateways in the sidebar? Only organization Owners and Admins see it.

Delete is refused. Why? A data source still uses the gateway, or a machine is still connected. Move the data source to another gateway, or uninstall the agent first.

Can I delete the gateway for good from the Trash? Not while a data source in the Trash still points at it.