InfraSonar QStar Agent

Documentation: https://docs.infrasonar.com/collectors/agents/qstar/

Environment variables

Environment	Default	Description
STORAGE_PATH	HOME/.infrasonar/	Path where files are stored (not used when ASSET_ID is set).
TOKEN	required	Token used for authentication (This MUST be a container token).
ASSET_NAME	none	Initial Asset Name. This will only be used at the announce. Once the asset is created, ASSET_NAME will be ignored.
ASSET_ID	none	Asset Id (If not given, the asset Id will be stored and loaded from file).
API_URI	https://api.infrasonar.com	InfraSonar API.
SKIP_VERIFY	none	Set to 1 or something else to skip certificate validation.
CHECK_QSTAR_INTERVAL	300	Interval in seconds for the qstar check.

Build

CGO_ENABLED=0 go build -o qstar-agent

Installation

Download the latest release:

$ wget https://github.com/infrasonar/qstar-agent/releases/download/v0.1.0/qstar-agent

Ensure the binary is executable:

chmod +x qstar-agent

Copy the binary to /usr/sbin/infrasonar-qstar-agent

$ sudo cp qstar-agent /usr/sbin/infrasonar-qstar-agent

Using Systemd

$ sudo touch /etc/systemd/system/infrasonar-qstar-agent.service
$ sudo chmod 664 /etc/systemd/system/infrasonar-qstar-agent.service

Using you favorite editor, add the content below to the file created:

[Unit]
Description=InfraSonar QStar Agent
Wants=network.target

[Service]
Environment="TOKEN=<YOUR TOKEN HERE>"
# Environment="ASSET_ID=<YOUR ASSET ID>"
# Environment="STORAGE_PATH=<PATH_TO_STORE_ASSET_FILE>"
ExecStart=/usr/sbin/infrasonar-qstar-agent
User=root

[Install]
WantedBy=multi-user.target

Note that the QStar agents needs root privileges to execute the mmparam command.

It might be required to have the mmparam in /usr/sbin, for example:

$ ln -s /opt/QStar/bin/mmparam /usr/sbin/mmparam

Reload systemd

$ sudo systemctl daemon-reload

Install the service

$ sudo systemctl enable infrasonar-qstar-agent

You may want to start/stop or view the status

$ sudo systemctl start infrasonar-qstar-agent
$ sudo systemctl stop infrasonar-qstar-agent
$ sudo systemctl status infrasonar-qstar-agent

View logging:

$ journalctl -u infrasonar-qstar-agent