Installation
Eclipse Mosquitto, Eclipse Streamsheets and the Cedalo Management Center are all available for Windows, Linux and macOS. In addition it also can be installed on a Raspberry Pi.
Installation with Cedalo Platform
The easiest way to install any of Cedalos products and connected Eclipse project software individually, as a bundle or the whole platform is to use the official Docker based installer image cedalo/installer
, which is available at Docker Hub.
The installer will guide you through the installation process and will allow you to select which components you want to install: Eclipse Mosquitto, Eclipse Streamsheets, the Management Center or combinations of it.
The following sections describe how to do the Docker based installation on Windows, Linux and macOS.
Windows
This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under Windows.
Step 1: Install Docker
If you have not yet, install Docker for Windows (see installation instructions here).
Step 2: Use the installer
For an installation under Windows use the installer image tagged with 2-win
:
docker run -it -v C:\cedalo_platform:/cedalo cedalo/installer:2-win
In the following dialog you can select (using the space bar) which components should be installed:
? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6
When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:
C:\cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.bat # Start script
├── stop.bat # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.bat # Update script
Step 3: Start everything
To start everything you installed, just use the start.bat
file.
cd C:\cedalo_platform
start.bat
If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.
Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.
Step 4: Open the applications
When everything is installed and started correctly the applications should be available under the following URLs:
Eclipse Mosquitto: mqtt://localhost:1883
Eclipse Streamsheets Web UI: http://localhost:8081
Default Credentials: User:
admin
Password:1234
. Change your password in the administration menu.Management Center Web UI: http://localhost:8088
Default Credentials: User:
cedalo
Password:mmcisawesome
. Change the password in the docker-compose.yml file. Find and change this entry:
CEDALO_MC_USERNAME: cedalo
CEDALO_MC_PASSWORD: mmcisawesome
Linux
This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under Linux.
Step 1: Install Docker
If you have not yet, install Docker for your Linux platform (see installation instructions here). For example, Docker is available for Centos, Debian, Fedora or Ubuntu.
Step 2: Use the installer
For an installation under Linux use the installer image tagged with 2-linux
:
docker run -it -v ~/cedalo_platform:/cedalo cedalo/installer:2-linux
In the following dialog you can select (using the space bar) which components should be installed:
? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6
When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:
~/cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.sh # Start script
├── stop.sh # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.sh # Update script
Step 3: Start everything
To start everything you installed, just use the start.sh
file.
cd ~/cedalo_platform
sh start.sh
If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.
Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.
Step 4: Open the applications
When everything is installed and started correctly the applications should be available under the following URLs:
Eclipse Mosquitto: mqtt://localhost:1883
Eclipse Streamsheets Web UI: http://localhost:8081
Default Credentials: User:
admin
Password:1234
. Change your password in the administration menu.Management Center Web UI: http://localhost:8088
Default Credentials: User:
cedalo
Password:mmcisawesome
. Change the password in the docker-compose.yml file. Find and change this entry:
CEDALO_MC_USERNAME: cedalo
CEDALO_MC_PASSWORD: mmcisawesome
macOS
This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under macOS.
Step 1: Install Docker
If you have not yet, install Docker for macOS (see installation instructions here).
Step 2: Use the installer
For an installation under macOS use the installer image tagged with 2-macos
:
docker run -it -v ~/cedalo_platform:/cedalo cedalo/installer:2-macos
In the following dialog you can select (using the space bar) which components should be installed:
? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6
When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:
~/cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.sh # Start script
├── stop.sh # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.sh # Update script
Step 3: Start everything
To start everything you installed, just use the start.sh
file.
cd ~/cedalo_platform
sh start.sh
If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.
Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.
Step 4: Open the applications
When everything is installed and started correctly the applications should be available under the following URLs:
Eclipse Mosquitto: mqtt://localhost:1883
Eclipse Streamsheets Web UI: http://localhost:8081
Default Credentials: User:
admin
Password:1234
. Change your password in the administration menu.Management Center Web UI: http://localhost:8088
Default Credentials: User:
cedalo
Password:mmcisawesome
. Change the password in the docker-compose.yml file. Find and change this entry:
CEDALO_MC_USERNAME: cedalo
CEDALO_MC_PASSWORD: mmcisawesome
Raspberry Pi
This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center on a Raspberry Pi under Raspbian. You can either manually work through all the steps below or use the script we prepared for you.
Fast Installation
Open your shell and enter the following command to start the installation process:
curl -fsSL raw.githubusercontent.com/cedalo/streamsheets-installer/master/pi-installer.sh -o get-streamsheets.sh && sh get-streamsheets.sh
This installs and starts the Cedalo platform.
Starting & Stopping
Starting Cedalo platform:
The Fast Install automatically starts the applications for the first time. To start after the Manual Install use the following commands.
Navigate into the folder “~/cedalo_platform” with your shell and enter sudo sh start.sh
.
cd ~/cedalo_platform
sudo sh start.sh
Now you are able to access your applications here:
- Eclipse Mosquitto: mqtt://localhost:1883
- Eclipse Streamsheets Web UI: http://localhost:8081
- Management Center Web UI: http://localhost:8088
You are able to access the applications from anywhere in your network, by typing in the IP-adress/hostname of your Pi together with the port 8081. The standard Raspberry Pi hostname is “raspberrypi”, which results in:
Standard hostname adress: raspberrypi:8081
; raspberrypi:8088
Open a browser on another computer in the same local network and type the address.
Eclipse Mosquitto: mqtt://localhost:1883
Eclipse Streamsheets Web UI: http://localhost:8081
Default Credentials: User:
admin
Password:1234
. Change your password in the administration menu.Management Center Web UI: http://localhost:8088
Default Credentials: User:
cedalo
Password:mmcisawesome
. Change the password in the docker-compose.yml file. Find and change this entry:
CEDALO_MC_USERNAME: cedalo
CEDALO_MC_PASSWORD: mmcisawesome
Stopping Cedalo platform:
Navigate to your shell where the application is running and simply press ctrl + c or navigate into the folder “~/cedalo_platform” with your shell and enter sudo sh stop.sh
.
cd ~/cedalo_platform
sudo sh stop.sh
Manual Installation
Step 1: Install Docker
If you have not yet, install Docker for Raspbian (see installation instructions here and here) and install Docker Compose.
Step 2: Use the installer
For an installation under Raspbian use the installer image tagged with 2-rpi
:
docker run -it -v ~/cedalo_platform:/cedalo cedalo/installer:2-rpi
In the following dialog you can select (using the space bar) which components should be installed:
? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6
When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:
~/cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.sh # Start script
├── stop.sh # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.sh # Update script
Step 4: Open the applications
When everything is installed and started correctly the applications should be available under the following URLs:
- Eclipse Mosquitto: mqtt://localhost:1883
- Eclipse Streamsheets Web UI: http://localhost:8081
- Management Center Web UI: http://localhost:8088
If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.
Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.
Solo Installation
To add the management center to an already existing installation of mosquitto 2.0 use the following command.
docker run --name management-center \
-p 8088:8088 \
--env CEDALO_MC_BROKER_ID=mosquitto \
--env CEDALO_MC_BROKER_NAME=Mosquitto \
--env CEDALO_MC_BROKER_URL=mqtt://mqttbrokerhost:1883 \
--env CEDALO_MC_BROKER_USERNAME=username \
--env CEDALO_MC_BROKER_PASSWORD=password \
--env CEDALO_MC_USERNAME=usernamemc \
--env CEDALO_MC_PASSWORD=passwordmc \
--detach \
cedalo/management-center:2
Adjust the environment variables to your personal needs. Another way to add the management center would be via a docker-compose file.
Use the following as content for the compose file and change the variables accordingly:
management-center:
image: cedalo/management-center:2
ports:
- 8088:8088
environment:
CEDALO_MC_BROKER_ID: mosquitto
CEDALO_MC_BROKER_NAME: Mosquitto
CEDALO_MC_BROKER_URL: mqtt://mqttbrokerhost:1883
CEDALO_MC_BROKER_USERNAME: username
CEDALO_MC_BROKER_PASSWORD: password
Environment Vairables
- CEDALO_MC_BROKER_ID:
- CEDALO_MC_BROKER_NAME:
- CEDALO_MC_BROKER_URL: URL of the mosquitto instance.
- CEDALO_MC_BROKER_USERNAME: Username of the client with full dynamic security rights.
- CEDALO_MC_BROKER_PASSWORD: Password of that client
- CEDALO_MC_USERNAME: Set a username for the management center
- CEDALO_MC_PASSWORD: Set a password for the management center