GMS User’s Guide

GMS is an acronym for Group Management Service

Description

The Group Management Service (GMS) a MQTT Client, is an application that manages the by-group topic ucl/by-group/. It acts as a lookup entity that provides protocol controllers or other MQTT clients information about the interactions between groups, endpoints, and supported commands. It does not handle the topics that are used to execute group commands, for example ucl/by-group/<group-id>/<Command>, which is done by protocol controllers.

The GMS application does not persist any collected information. Instead, it collects and publishes its data over the MQTT Framework.

Protocol controllers can run without the GMS application, which results in limited functionality.

Installation

For installing please refer to the general installation method in Getting started.

Running the GMS

Using Systemd Service

The best way to run the GMS is using the Systemd service that is installed with the Debian installer. For more information, see the Unify Framework User guide.

Using Command Line

Alternatively, the GMS may be run by executing uic-gms. It is possible to configure the MQTT server, database path, through command line options. For more details, run uic-gms --help.