General: Configuration of the Broker connection data and definition of a Last Will and Testament message type:
Connection Parameters: In this section are the parameter to configure the Broker connection:
First at all, a unique client ID for each client connected to the same Broker must be defined. It is recommended to use a clear ID to get an easier interpretation of the Broker log. The following two parameters are the host and access port of the Broker.
Optionally, a user and password identification can be configured, as part of the Broker configuration. It is recommended to configure several users to access to the Broker in a safe way.
Finally, it is possible to configure a connection to the server through a proxy defining a host and port.
Additional Parameters: In this section there are some additional parameters to configure the Broker connection:
Cuando se pierda la conexión con el Broker, o con el servidor que aloja al mismo, se entrará en un periodo de reconexión. Es muy importante poder recuperar la conexión sin perder la persistencia de datos, para no perder ningún mensaje publicado desde la última conexión; por lo que, este proceso se ejecuta de forma periódica hasta lograr la reconexión o hasta que el canal sea detenido por el administrador de forma manual.
El primer parámetro especifica el tiempo de espera entre cada intento de reconexión.
El segundo parámetro es propio del protocolo MQTT y especifica el intervalo de tiempo entre cada confirmación del estado de la conexión emitido por el Broker: cada X tiempo, definido por el Keep Alive Ratio, Broker y cliente intercambian un ping, si el Broker no obtuviera respuesta o no se produjera en el tiempo especificado, el Adaptador considera que se ha perdido la conexión entre Broker y Adaptador, y entra en estado de reconexión.
El tercer parámetro de este apartado representa una sesión limpia, sin persistencia de datos. La persistencia de datos de una conexión se utiliza para mantener el estado de la misma, más allá de la conexión al Broker; es decir, entre conexiones se almacena información acerca de los Topics suscritos: número de mensajes recibidos, ID de cliente, etc.
- Last Will and Testament Parameters: En este apartado se especifican los parámetros del LWT.
El proceso conocido como Last Will and Testament consiste en el envío de un mensaje al Broker cuando el Adaptador detecta una pérdida abrupta de la conexión. Este mensaje se debe haber almacenado en su memoria previamente, indicando el Topic específico que se quiere que reciba el mensaje y con un Quality of Service predefinido. Es un proceso opcional; de hecho, sólo se aconseja su uso en casos muy específicos como, por ejemplo, canales que sean susceptibles de presentar errores de conexión y que manejen datos sensibles.
Los parámetros que se deben configurar son: el Topic del Last Will and Testament, el Quality of Service con el que se enviará el mensaje y el Mensaje a enviar en caso de pérdida inesperada de la conexión.