Manta Manager

This guide will walk you through the installation process of the Manta Manager, covering all the required dependencies and steps to set up your environment.

Dependencies

To successfully install and run Manta Manager, you need to have the following dependencies installed:

MongoDB

MongoDB is used as the database by Manta Manager to store essential information such as swarms, nodes, tasks, logs, and results.

Installation on Linux

  1. Import the MongoDB public GPG Key:

wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -

  1. Create a list file for MongoDB:

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list

  1. Reload the local package database:

sudo apt-get update

  1. Install MongoDB:

sudo apt-get install -y mongodb-org

  1. Start MongoDB:

sudo systemctl start mongod

Installation on Windows and MacOS

For Windows and macOS, please refer to the official MongoDB documentation for installation instructions:

Mosquitto Broker

Mosquitto is an MQTT broker used by Manta Manager to facilitate communication between nodes and the manager.

MQTT (Message Queuing Telemetry Transport) is a lightweight messaging protocol designed for connections with remote locations where a small code footprint is required or network bandwidth is limited.

Installation on Linux

  1. Update your package list:

sudo apt-get update

  1. Install Mosquitto:

sudo apt-get install -y mosquitto mosquitto-clients

  1. Start Mosquitto:

sudo systemctl start mosquitto

Installation on Windows and macOS

For Windows and macOS, please refer to the official Mosquitto documentation for installation instructions: Mosquitto Installation Guide

Note

While the Mosquitto broker doesn’t need to be deployed on the same machine as the Manta Manager, it must be accessible by both the nodes and the manager. The simplest setup is to deploy the broker on the same machine as the manager.

Installing Manta Manager

The recommended way to install Manta Manager is by using pre-built packages, which simplify the setup process and ensure all dependencies are correctly configured.

  1. Download the Wheel File: Obtain the pre-built wheel file for the Manta Manager from the official release repository.

  2. Install the Wheel File: Use pip to install the downloaded wheel file. Run the following command in your terminal:

pip install manta_manager-<version>-py3-none-any.whl

This installation method minimizes compatibility issues and is ideal for most users.