Set Up Cribl Outpost

Create a Cribl Outpost to relay communication between Edge Nodes and the Leader.

Preview Feature

​

This Preview feature is still being developed. We do not recommend using it in a production environment, because the feature might not be fully tested or optimized for performance, and related documentation could be incomplete.

Please continue to submit feedback through normal Cribl support channels, but assistance might be limited while the feature remains in Preview.

Prerequisites

​

Cribl Outpost requires an Enterprise plan or Enterprise license. For details, see Pricing.

You can install Cribl Outpost on Linux only.

Create an Outpost

​

To create a new Outpost:

1. Go to the Cribl Download page and set the Software drop-down to Cribl Suite (Edge and Stream) for your processor architecture.

2. Select Download now to get the .tgz archive.

3. Un-tar the install package in your directory of choice:

   cd /opt/ 
   tar xvzf cribl-<version>-<build>-<arch>.tgz

   Copy

4. Set the installation mode to mode-outpost to connect the Outpost to the designated Leader and allow Edge Nodes to connect to it in turn:

   /opt/cribl/bin/cribl mode-outpost /
      -H <leader-hostname-or-IP> /
      -p <port> /
      -u <token> /
      -S 1 /
      -O <outpost-listener-url>

   Copy

   <token> must match the Leader token, to ensure a connection with the Leader. Get the Leader token from Settings > Global > System > Distributed Settings > Leader Settings > Auth token.

   <outpost-listener-url> is the URL on which Edge Nodes will connect to the Outpost.

5. Configure the installation as a service and start it:

   /opt/cribl/bin/cribl boot-start enable -m systemd -u cribl
   sudo systemctl restart cribl.service

   Copy

At this point your Cribl Outpost is ready for use and you can start configuring Edge Nodes to connect to it.

Connect Nodes to an Outpost

​

Edge Nodes see Outpost in the same way as a Leader Node. This means that, to connect a Node to an Outpost, you only need to provide the Outpost listener URL that you defined with the -O parameter, and the Leader auth token.

The Outpost doesn’t have a separate auth token. When configuring Node connection, use the auth token of the Leader.

Configure the connection either from Settings (Global > Distributed Settings > Leader Settings), or by setting the CRIBL_DIST_LEADER_URL environment variable:

CRIBL_DIST_LEADER_URL=tcp://<leader-token>@m<outpost-hostname>:<outpost-port>