Getting Started with tawonctl

The tawonctl is a command line utility to query the Tawon Controller.

Installation

Run the following to download and install the latest version of tawonctl.

curl https://tawonctl.xmantis.net | sh
You can run this command again to update tawonctl.

Configuration

We first need to log into the Tawon Controller by running:

tawonctl login

You will be asked the address of the Controller (including the scheme, http or http), your username and password.

If you are the first user connecting to the Controller, you will create the first Admin user instead of logging in. You will be asked a Full Name on top of you username and password.

First commands

Let’s start by checking out the machines in our deployment:

tawonctl machines

Then we can try listing all Directives with:

tawonctl directives

And let’s go ahead and subscribe to a temporary Directive that will collect, parse and publish DNS packets:

tawonctl directives sub -t "capture|filter:udp src port 53" -t "dns" -t "publish|topic:dnsdemo"

Next steps

From here, you can: