MTCL: A C++ repository from ParaGroup (UNIPI)

Multi Transport Communication Library (MTCL)

The MTCL library aims to provide a common (and simple enough) interface for several back-end communication libraries. Currently we support TCP/IP, MPI, MPIP2P (i.e., dynamic MPI), UCX, MQTT. The Shared Memory (SHM) support is still experimental.

Dependencies

** MPI ** (OPTIONAL) :

OpenMPI is required for using the MPI library as transport protocol. By default, it is disabled. It can be enabled by defining the environmental variable TPROTOCOL=MPI and by properly setting MPI_HOME to point to the OpenMPI install dir.
** MQTT ** (OPTIONAL) :

For using the MQTT protocol as transport layer, Paho MQTT Cpp and a MQTT broker/server are needed. By default, MQTT is disabled. It can be enabled by defining the environmental variable TPROTOCOL=MQTT and by properly setting MQTT_HOME to point to the Paho MQTT Cpp install dir. As MQTT broker/server Mosquitto is one of the options. Under Linux Ubuntu it can be installed using 'sudo apt install mosquitto'.

--- How to compile and install Paho MQTT Cpp ----

Download Paho MQTT C from github: https://github.com/eclipse/paho.mqtt.c
```
  export MQTT_HOME=<where-you-want-to-install-paho>
  cd paho.mqtt.c
  prefix=${MQTT_HOME} make install
```
Download Paho MQTT Cpp from github: https://github.com/eclipse/paho.mqtt.cpp
```
  cd paho.mqtt.cpp
  cmake -Bbuild -H. -DCMAKE_INSTALL_PREFIX=${MQTT_HOME} \
                    -DCMAKE_PREFIX_PATH=${MQTT_HOME}
  cd build
  make install
```

** UCX ** (OPTIONAL) :

Download UCX from github: https://github.com/openucx/ucx

--- How to compile and install UCX ---

$ export UCX_HOME=<ucx-install-path>
$ ./autogen.sh
$ ./contrib/configure-release --prefix=${UCX_HOME} --enable-mt
$ make -j8
$ make install

** UCC ** (OPTIONAL, requires UCX):

Download UCC from github: https://github.com/openucx/ucc

--- How to compile and install UCC ---

$ export UCC_HOME=<ucc-install-path>
$ ./autogen.sh
$ ./configure --prefix=${UCC_HOME} --with-ucx=<ucx-install-path> [--with-rocm=no --with-ibverbs=no --with-cuda=no]
$ make

** RapidJSON **

We use RapidJSON to parse configuration files. If you do not want to use the config file you don't need to install it.

ParaGroup/MTCL

Multi Transport Communication Library (MTCL)

Dependencies