Linux Binary

Prerequisites

• A Linux system with the appropriate architecture (x86_64 or arm64)

• (For cloud-connected mode) Registration Token: Valid registration token from app.qpoint.io

• (For local mode) Configuration Files: Prepare your Qtap YAML config file

Get Tapping

Download the Binary

For Linux x86_64 architecture:

curl -L https://downloads.qpoint.io/qpoint/qpoint-v0.6.4-linux-amd64.tgz -o qpoint.tgz

For Linux arm64 architecture:

curl -L https://downloads.qpoint.io/qpoint/qpoint-v0.6.4-linux-arm64.tgz -o qpoint.tgz

Extract the Binary

tar -xzf qpoint.tgz && mv qpoint-* qpoint && chmod +x qpoint

This will extract a binary named qpoint and make it executable.

Running Qtap Binary

You can run the binary by issuing the following commands.

Cloud Connected Mode

To run Qtap in cloud-connected mode:

sudo ./qpoint tap \
  --log-level=info \
  --log-encoding=console \
  --registration-token=$TOKEN

Replace $TOKEN with your actual registration token from app.qpoint.io.

Local YAML Mode

To run Qtap in local mode:

sudo ./qpoint tap \
  --log-level=info \
  --log-encoding=console \
  --qpoint-config=/path/to/your/qpoint.yaml

Replace /path/to/your/qpoint.yaml with the actual path to your YAML configuration file.

Running Qtap as a Service

After downloading and verifying the Qpoint binary, you'll likely want to run it as a systemd service for production environments.

Service Configuration

1. Create Environment File

First, create a secure environment file to store sensitive environment variables:

sudo mkdir -p /etc/qpoint
sudo touch /etc/qpoint/environment
sudo chmod 600 /etc/qpoint/environment

Add your registration token to the environment file:

echo "QPOINT_TOKEN=your_registration_token_here" | sudo tee /etc/qpoint/environment

2. Create Service File

Create a systemd service file:

sudo nano /etc/systemd/system/qpoint.service

Add the following content:

[Unit]
Description=Qpoint Traffic Analysis Service
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
User=root
EnvironmentFile=/etc/qpoint/environment
ExecStart=/usr/local/bin/qpoint tap --log-level=info --log-encoding=console --registration-token=${QPOINT_TOKEN}
Restart=always
RestartSec=1

[Install]
WantedBy=multi-user.target

Installing the Service

Move the Qpoint binary to a system directory:

sudo mv qpoint /usr/local/bin/
sudo chmod +x /usr/local/bin/qpoint

Managing the Service

1. Reload systemd to recognize the new service:

sudo systemctl daemon-reload

1. Start the service:

sudo systemctl start qpoint

1. Enable the service to start on boot:

sudo systemctl enable qpoint

1. Check the service status:

sudo systemctl status qpoint

1. View service logs:

sudo journalctl -u qpoint -f

Updating the Service

1. Stop the service:

sudo systemctl stop qpoint

1. Replace the binary:

sudo mv new-qpoint /usr/local/bin/qpoint
sudo chmod +x /usr/local/bin/qpoint

1. Restart the service:

sudo systemctl start qpoint

1. Verify the update:

sudo systemctl status qpoint
/usr/local/bin/qpoint --version