MQTT Real-time Support for MESHdesk and APdesk

Install Mosquitto

• Install the Mosquitto MQTT Broker as per these fine instructions:
  • https://www.vultr.com/docs/install-mosquitto-mqtt-broker-on-ubuntu-20-04-server/
• Make sure you do Step 3 to secure the it with usernames and passwords.
• In this document we use username and password of openwrt. Please change according to your preference.

Install Rdcore-API-Gateway

• The Rdcore-API-Gateway is a Node.js application. We will start off by installing Node.js and npm.

sudo apt install nodejs
sudo apt install npm

• Go to /opt directory

cd /opt

• Clone Rdcore API Gateway from Github

sudo git clone https://github.com/RADIUSdesk/Rdcore-API-Gateway.git

• Go to newly cloned directory

cd /opt/Rdcore-API-Gateway

• Install NPM Dependencies

sudo npm install

• Rename .env.sample to .env and edit

sudo mv .env.sample .env
sudo vi .env
 
PORT=8001
#FQDN of your installed server
MESH_CONTROLLER="http://cloud.mesh-manager.com"
MQTT_BROKER="127.0.0.1"
MQTT_PORT=1883
MQTT_USER=openwrt
MQTT_PASS=openwrt

• The Rdcore API Gateway Systemd Startup File

sudo cp /opt/Rdcore-API-Gateway/rdcore-api-gateway.service /lib/systemd/system/

• Enable the Rdcore API Gateway

sudo systemctl enable rdcore-api-gateway.service

• Start the Rdcore API Gateway

sudo systemctl start rdcore-api-gateway.service
sudo systemctl status rdcore-api-gateway.service

• Confirm the service is running by visiting the FQDN:8001
• e.g http://cloud.radiusdesk.com:8001/

MQTT Settings in RADIUSdesk

• To enable MQTT on RADIUSdesk there are two places where it has to be configured.
• For the devices managed by MESHdesk and APdesk there is this GUI under Settings → MQTT

• Command topic is always /RD/NODE/COMMAND/RESPONSE
• Then for the server to use MQTT instead of the heartbeat system you have to edit the following config file.
• Edit /var/www/html/cake4/rd_cake/config/MESHdesk.php
• Look for this sections and adapt to your server's values.

$config['mqtt_settings']['enable_realtime']	= true;
$config['mqtt_settings']['api_gateway_url']	= 'http://164.160.89.129:8001';