pqMessenger is interposed between pqChecker and a Java application. The application must act as a JMS server to which pqMessenger connects. It ensures communication between pqChecker and this application that can manage the setting of password content and their broadcast.
pqMessenger requires prior installation Java JRE on the system. The single jar file pqmessenger-xxxx.jar must be installed in a dedicated folder to be specified in the launch script. Other parameters, such as the location of pqchecker.so or the configuration file must be set at launch time. The launch script pqmessenger.boot and the configuration file that contains the command line parameters pqmessenger.params are supplied in the sources from the Git repository (pqmessenger/sys-resources/).
When pqMessenger starts, it tries to connect to the JMS service using settings in the configuration file pqmessenger-config.properties: host and port parameters. If the connection fails, it waits for a configurable time and tries to connect again. The retry time is set at launch (pqmessenger.params file).
If JMS server is running, connection success and pqMessenger continues running normally. It is able to adapt its behavior according to the availability of the JMS server.