mtconnect/agent repository overview

The C++ Agent provides the reference implementation of the REST service required by the MTConnect standard. The agent provides the protocol and data collection framework to work as a standalone HTTP server with optional MQTT built-in support. Change the configuration as described below to run the agent with your local configuration.

To run the agent in this container with the local conf directory holding the configuration files and the log directory containing the logs. The local port 5001 maps to port 5000 in the container.

    docker run --rm --name mtcagent -it -p 5001:5000/tcp \
       -v ./conf:/mtconnect/config \
       -v ./log:/mtconnect/log \
       mtconnect/agent:latest

In the latest version, the MTConnect Agent support both XML and JSON representations and publishes data to an MQTT Broker if configured. The agent is extensible the following mechanisms:

• Embedded Ruby for scripted transformations
• Plugins in C++ that extend the sources, sinks, and transforms

This docker images allow for easy configuration using the following three directories:

• /mtconnect/config: Configuration directory with agent.cfg and Device.xml
• /mtconnect/data: Stylesheets and XML Schema files.
• /mtconnect/log: agent.log files

The agent executable (mtcagent) is placed in /usr/bin/

Third party plugins are also available for protocols like OPC UA (MTConnect Companion Spec) and the umati VDMA Machine Tool specification. Sparkplug B and NC-Link are also available desired.

The default command is: /usr/bin/mtcagent run /mtconnect/config/agent.cfg

Mount the volume /mtconnect/config/ to some other location to override the configuration.