The native installation takes more time to set up, but it runs considerably faster than Docker. Docker takes about 3-4 times longer to execute. If you will use this project for a full semester (e.g. for a thesis or a practical course) you'll most likely want the native installation - it will save you time in the long run.
- Git (for checking out the project)
- Maven (for building the project); Alternatively, you can also use Gradle.
- Java 8 or 11 or 14 (other versions are not checked by the CI pipeline)
- NNG (for networking) (Please use version 1.3.0)
- GCC and CMake (For compiling the generated C++ code)
- Visual Studio Community (only necessary for Windows!)
- Docker (for executing generator tests)
- Mosquitto and mosquitto_clients (only for MQTT message broker)
- OpenDDS (only for DDS communication)
- Python 3, pip and paho-mqtt (only for Mqtt message broker)
Ubuntu Installation Instructions
On Ubuntu 20.04, you can use our script for installing everything except OpenDDS:
git clone <link to this Git repository> montithings
cd montithings
./installLinux.sh
macOS Installation Instructions
On macOS, you can also use our script for installing everything except OpenDDS. It will also install Java, Maven, and Gradle using SDKMAN. If you already have Java 8, 11, or 14 installed, you might want to remove these lines of the script before executing it. You will be asked several times for your password in the process. If you do not already have the XCode developer tools, they will be also installed; in this case there will be a popup from Apple right after starting the script.
git clone <link to this Git repository> montithings
cd montithings
./installMac.sh
Windows 10/11 Installation Instructions
On Windows, you can use our Powershell installer. In case you have never run Powershell scripts before, you first need to allow executing scripts:
Set-ExecutionPolicy remotesigned
When prompted whether you really want to change the policy, please answer with a.
You can reset the policy after running the installer using:
Set-ExecutionPolicy undefined
To install MontiThings, run the following:
git clone <link to this Git repository> montithings
cd montithings
.\installWindows.ps1
During the installation, you will be asked if you accept Microsoft's terms and conditions. Accepting their terms is required for the installer.