Commit 285204f6 authored by Rostislav Spinar's avatar Rostislav Spinar

Install using linux image

- not fully ready, work in progress
parent 41c5e51c
# Installation guide for having IQRF GW in Docker container
## IoT Starter Kit - Part 2: IQRF GW
### Step 1 - Insert IQRF Coordinator
![IQRF SPI board](docs/iqrf-spi-board.png)
* Attach [IQRF SPI board](http://www.iqrf.org/weben/downloads.php?id=412)
* Insert prepared IQRF Coordinator to the IQRF SPI board
### Step 2 - Install OS Linux
* Install [UbiLinux 4.0](https://up-community.org/downloads/download/44-ubilinux/90-ubilinux-installer-4-0)
* Post-install tips
```bash
sudo apt update && sudo apt full-upgrade -y
```
### Step 3 - Install Docker CE
* Install [Docker for Debian 9.0 Stretch](https://github.com/iqrfsdk/iqrf-daemon/blob/master/docker/INSTALL.md)
### Step 4 - Run Docker image
* Ready IQRF GW [image](https://hub.docker.com/r/iqrfsdk/iqrf-gateway-debian/)
```bash
docker container run -d -p 80:80 -p 1883:1883 -p 8080:8080 -p 9001:9001 --device /dev/spidev2.0:/dev/spidev2.0 --privileged --name iqrf-gateway --restart=always iqrfsdk/iqrf-gateway:latest
```
#### Check Node-RED Dashboard
```bash
http://localhost/ui
```
![IQRF App Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/nodered-dashboard.png "IQRF App Dashboard")
#### Check IQRF WebAPP Dashboard
```bash
http://localhost:8080
```
![IQRF WebAPP Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/iqrf-daemon-webapp.png "IQRF WebAPP Dashboard")
#### Check Supervisor Service Dashboard
```bash
http://localhost:9001
```
![IQRF Supervisor Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/supervisor-dashboard.png "IQRF Supervisor Dashboard")
### Optional - Stop Docker image
```bash
docker container stop iqrf-gateway
```
......@@ -11,58 +11,81 @@
## IoT Starter Kit - Part 2: IQRF GW
### Step 1 - Insert IQRF Coordinator
### Step 1 - Download IoT Starter Kit installer image
* Attach [IQRF SPI board](http://www.iqrf.org/weben/downloads.php?id=412)
* Insert prepared IQRF Coordinator to the IQRF SPI board
[IoT Starter Kit installer](https://dl.iqrfsdk.org/iot-starter-kit-v080-installer.img.bz2)
### Step 2 - Install OS Linux
Installer burns complete image right after the boot without any user interaction, just wait:
* Install [UbiLinux](https://up-community.org/wiki/Ubilinux)
* Post-install tips
* Ubilinux 4.0
* IQRF daemon
* IQRF daemon webapp
* Mosquitto broker
* Nodejs
* Node-RED
* Node-RED IoT Starter Kit dashboard
* Gparted
```bash
sudo apt update && sudo apt full-upgrade -y
```
Burning is signalled by blinking of the GREEN led on the UP board. When we are done blinking stops.
### Step 3 - Install Docker CE
### Step 2 - Install 7-Zip and Rufus tools
* Install [Docker](https://github.com/iqrfsdk/iqrf-daemon/blob/master/docker/INSTALL.md) for Debian
* Download and install [7-Zip](http://www.7-zip.org/)
* Download and install [Rufus](https://rufus.akeo.ie/)
### Step 4 - Run Docker image
### Step 3 - Extract image and burn it to 8G(16G) USB disk
* Ready IQRF GW [image](https://hub.docker.com/r/iqrfsdk/iqrf-gateway-debian/)
* Extract image using 7-Zip
* Burn image to USB disk using Rufus
```bash
docker container run -d -p 80:80 -p 1883:1883 -p 8080:8080 -p 9001:9001 --device /dev/spidev2.0:/dev/spidev2.0 --privileged --name iqrf-gateway --restart=always iqrfsdk/iqrf-gateway:latest
```
![Burn installer to 8G(16G) USB disk](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/rufus-burn-installer.png)
#### Check Node-RED Dashboard
### Step 4 - Plug 8G(16G) USB installer to the UP board
```bash
http://localhost/ui
```
![IQRF App Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/nodered-dashboard.png "IQRF App Dashboard")
* Plug 8G(16G) USB installer to the UP board
* Let the UP board boot from USB (Press F7 and select UEFI disk to boot from)
* Wait till blinking of GREEN led is stopped
* Power-off the UP board
* Unplug USB installer
### Step 5 - Insert IQRF Coordinator
#### Check IQRF WebAPP Dashboard
![IQRF SPI board](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/iqrf-spi-board.png)
* Attach [IQRF SPI board](http://www.iqrf.org/weben/downloads.php?id=412)
* Insert prepared IQRF Coordinator to the IQRF SPI board
### Step 6 - Boot installed image
* Power-on the UP board and boot normally
* Login using: user=ubilinux; pass=ubilinux
* Run Gparted and extend UP flash to 32GB
Enjoy, your are done!
Now, check all is fine!
### Step 7 - Check Node-RED dashboard
```bash
http://localhost:8080
http://localhost:1880/ui
```
![IQRF WebAPP Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/iqrf-daemon-webapp.png "IQRF WebAPP Dashboard")
![IQRF App Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/node-red-ui.png "IQRF App Dashboard")
#### Check Supervisor Service Dashboard
### Step 8 - Check Node-RED flow
```bash
http://localhost:9001
http://localhost:1880
```
![IQRF Supervisor Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/supervisor-dashboard.png "IQRF Supervisor Dashboard")
![IQRF App Flow](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/node-red-flows.png "IQRF App Flow")
### Optional - Stop Docker image
### Step 9 - Check IQRF daemon WebAPP dashboard
```bash
docker container stop iqrf-gateway
http://localhost
```
![IQRF daemon WebAPP Dashboard](https://github.com/iqrfsdk/iot-starter-kit/blob/master/docs/iqrf-daemon-webapp-gateway.png "IQRF daemon WebAPP Dashboard")
* Login using: user=admin; pass=iqrf
## IoT Starter Kit - Part 3: Possible extensions
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment