update mosquitto

server/mosquitto/README.md

@@ -1,8 +1,51 @@
 # Eclipse Mosquitto
 
-[Eclipse Mosquitto](https://mosquitto.org/) es
+[Eclipse Mosquitto](https://mosquitto.org/) es un *message broker* de código abierto que implementa las versiones 3.1, 3.1.1 y 5.0 del protocolo MQTT. El proyecto Mosquitto también proporciona una biblioteca C para implementar clientes MQTT y los muy populares clientes MQTT de línea de comandos mosquitto_pub y mosquitto_sub.
 
-- `How to Install and Secure the Mosquitto MQTT.pdf` Documentación sobre instalación
+El protocolo MQTT proporciona un método ligero para enviar mensajes utilizando un modelo de publicación/suscripción. Esto lo hace adecuado para mensajería de IoT, como sensores de baja potencia o dispositivos móviles como teléfonos, computadoras integradas o microcontroladores.
+
+## Instalar Mosquitto
+
+Para instalar Mosquitto, desde el terminal:
+
+```bash
+sudo apt install mosquitto mosquitto-clients
+```
+
+La configuración se almacena en el archivo `default.conf`. Para editarlo:
+
+```bash
+sudo nano /etc/mosquitto/conf.d/default.conf
+```
+
+En el caso de utilizar el broker sin seguridad, debemos escuchar el puerto `1883` y permitir logins anónimos. Agregar al archivo de configuración las siguientes líneas:
+
+```bash
+listener 1883
+allow_anonymous true
+```
+
+Luego, reiniciar el servicio para que los cambios surtan efecto:
+
+```bash
+sudo systemctl restart mosquitto
+```
+
+Para securizar Mosquitto, consultar el archivo `How to Install and Secure the Mosquitto MQTT.pdf`.
+
+## Probar Mosquitto
+
+Para probar Mosquitto, abrir un terminal y lanzar `mosquitto_sub`:
+
+```bash
+mosquitto_sub -h localhost -t test_topic
+```
+
+Luego enviar un mensaje mediante `mosquitto_pub`:
+
+```bash
+mosquitto_pub -h localhost -t test_topic -m "Hello world!"
+```
 
 ## Mosquitto desde Python
 
@@ -14,4 +57,4 @@ Para trabajar con mosquitto desde Python, hay que satisfacer la siguiente depend
 pip install paho-mqtt
 ```
 
-Es recomendable leer la documentación que se encuentra en el sitio oficial.
+Es recomendable leer la documentación que se encuentra en el sitio oficial.