README.md

mqtt-kura-utils

This repository have some basic utility scripts for testing MQTT messages between Kura and Kapua.

The connection to the broker is not with TLS, it may will be added in feature developments.

Setup

To execute the scripts in an identical environment:

1. Download the repo

   git clone https://github.com/marcomatteo/mqtt-kura-utils.git 
   

2. Install Miniconda from the online documentation.

3. Access the folder of the repo and create the mqtt environment from a linux-64 only machine:

   conda create --name mqtt --file requirements.txt
   

   Or from a generic machine with:

   conda env create -f conda_mqtt_env.yml
   

4. Activate the environment created:

   conda activate mqtt
   

MQTT credentials

The MQTT credentials must be stored locally in a config.ini file:

Create a config.ini file with the following properties:

[MQTTSection]
mqtt.url=broker-sbx.test.io
mqtt.clientid=clientid
mqtt.user=user
mqtt.password=password
mqtt.topic=account/clientid/test

Usage

The publish.py script is intended to be used only for testing the MQTT broker endpoint publishing auto generated messages every second.

Run the script with the following properties to send ten unique text messages:

python publish.py --metric test_string --msg "Test" --num 10

Messages:

Test-0
Test-1
Test-2
Test-3
Test-4
Test-5
Test-6
Test-7
Test-8
Test-9