====== 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.
* Please use a strong password for the MQTT user in a production environment.
===== Install Rdcore-API-Gateway =====
* 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**
{{:getting_started:mqtt_settings.png|}}
* 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';