Installation der Plattform und der Dienste

Installationsdateien herunterladen

Sie können die Installations-Images der IIoT-Plattform auf zwei Arten herunterladen.

Installationsschritte

• Das erforderliche Datenpaket kopieren

  Kopieren Sie das Installationspaket auf den Server (Administratorrechte sind erforderlich):

  • Kopieren Sie das heruntergeladene Archiv unicloud.tgz und den Ordner images (das eigenständige Installationspaket mit den archivierten Images) in das Benutzer-Homeverzeichnis. Das Archiv enthält außerdem die Konfigurationsdateien docker-compose.yml und .env (.env ist versteckt, aktivieren Sie daher die Anzeige versteckter Dateien).
  • images

    • vadtel-nginx-latest.tar.gz
    • vadtel-app-latest.tar.gz
    • anytelemetry-latest.tar.gz
    • pgbouncer-latest.tar.gz
    • vadteljsondaemon-latest.tar.gz
    • logrotate-latest.tar.gz
    • postgres-15.1-alpine.tar.gz
    • redis-6.0.16-alpine.tar.gz
    • vector-latest.tar.gz

  • Kopieren Sie die Konfigurationsdateien nach /opt/vadtelnewweb/.

  • Legen Sie die Systembenutzernamen und -kennwörter in der Datei .env fest:

  .env

  #key
  SECRET_KEY_BASE=0356080kcn0ejgk4lwekrf
  
  #DB PGSQL login
  PG_APP_USER=ppppp
  
  #DB PGSQL password
  PG_APP_PASSWORD= ppppp
  
  #WEB interface login
  VADTEL_SUPER_ADMIN_EMAIL=NEED_USERNAME
  
  #WEB interface password
  VADTEL_SUPER_ADMIN_PASSWORD=NEED_PASSWORD
  
  #DB PGSQL unicloud login
  VADTEL_UNICLOUD_TEST_USERNAME=NEED_USERNAME
  
  #DB PGSQL unicloud password
  VADTEL_UNICLOUD_TEST_PASSWORD=NEED_PASSWORD

  code

• Docker und Docker Compose installieren

  Auf einer CentOS-basierten Distribution

  Installieren Sie Docker und Docker Compose:

  bash

  sudo dnf install docker-ce docker-compose

  Starten Sie Docker und aktivieren Sie den Start beim Booten:

  bash

  sudo systemctl enable --now docker && systemctl start docker

  Auf einer Debian-basierten Distribution

  Installieren Sie Docker und Docker Compose:

  bash

  sudo apt update
  sudo apt install docker docker-compose

• Das System installieren

  Die übrigen Schritte sind auf jedem Betriebssystem identisch. Fügen Sie den Benutzer, der die Anwendung ausführen wird, der Gruppe docker hinzu:

  bash

  sudo usermod -aG docker ${USER}

  Entpacken Sie das Archiv unicloud.tgz im Benutzer-Homeverzeichnis:

  bash

  tar -xf unicloud.tgz

  • unicloud

    • run

      • db-unicloud
    • remote_install.sh
    • init-db

      • create_tables.sql
    • script_conf.sh
    • docker-compose.yml
    • logs

      • crontab
      • vadteljsondaemon
      • anytelemetry
    • backups
    • data

      • db-unicloud
    • local-images

      • pgbouncer.tar.gz
      • postgres.tar.gz
      • vadteljsondaemon.tar.gz
      • anytelemetry.tar.gz
      • logrotate.tar.gz
    • unicloud.service

  Öffnen Sie den entpackten Ordner unicloud im Benutzer-Homeverzeichnis und führen Sie das Installationsskript aus:

  bash

  sudo ./remote_install.sh

  Öffnen Sie nach der Installation des Pakets /var/lib/unicloud mit Administratorrechten und ändern Sie Eigentümer und Gruppe der Datei .env auf den aktuellen Benutzer.

  Das Skript erzeugt Benutzernamen und Kennwort für die Datenbank in /var/lib/unicloud/.env. Kopieren Sie diese Werte nach /opt/vadtelnewweb/.env:

  bash

  VADTEL_UNICLOUD_TEST_USERNAME=NEED_USERNAME
  
  VADTEL_UNICLOUD_TEST_PASSWORD=NEED_PASSWORD

• Die Images extrahieren und laden

  Entpacken Sie die Image-Dateien im zuvor kopierten Ordner images:

  bash

  gunzip vadtel-nginx-latest.tar.gz
  gunzip vadtel-app-latest.tar.gz
  gunzip anytelemetry-latest.tar.gz
  gunzip pgbouncer-latest.tar.gz
  gunzip vadteljsondaemon-latest.tar.gz
  gunzip logrotate-latest.tar.gz
  gunzip postgres-15.1-alpine.tar.gz
  gunzip redis-6.0.16-alpine.tar.gz
  gunzip vector-latest.tar.gz

  Laden Sie die Images in Docker:

  bash

  docker load -i vadtel-nginx-latest.tar
  docker load -i vadtel-app-latest.tar
  docker load -i anytelemetry-latest.tar
  docker load -i pgbouncer-latest.tar
  docker load -i vadteljsondaemon-latest.tar
  docker load -i logrotate-latest.tar
  docker load -i postgres-15.1-alpine.tar
  docker load -i redis-6.0.16-alpine.tar
  docker load -i vector-latest.tar.gz

  Prüfen Sie, ob die Images verfügbar sind:

  bash

  docker images

  Alle neun geladenen Images sollten in der Liste erscheinen.

  Wenn die Images fehlerfrei geladen wurden, führen Sie den folgenden Befehl aus dem Ordner /var/lib/unicloud aus:

  bash

  docker-compose up -d

  Erstellen Sie unter /opt ein Verzeichnis für die Anwendung vadtelnewweb:

  bash

  sudo mkdir /opt/vadtelnewweb
  cd /opt/vadtelnewweb

  Kopieren Sie anschließend die Dateien docker-compose.yml und .env (falls Sie sie nicht bereits zuvor für eine Neuinstallation kopiert haben) nach /opt/vadtelnewweb.

  Erstellen Sie beim ersten Start die Datenbank:

  bash

  docker-compose run app bundle exec rails db:create

  Starten Sie nun die Anwendung:

  bash

  docker-compose up -d

  Fehlerbehebung

  Wenn die Anwendung nach dem Start den folgenden Fehler meldet:

  bash

  network unicloud_unicloud-net declared as external, but could not be found

  wurde das externe Netzwerk während der Installation nicht erstellt. Führen Sie die Erstinstallation aus dem Archiv unicloud.tar.tgz wie unter Das System installieren beschrieben durch und starten Sie die Anwendung anschließend erneut:

  bash

  docker-compose up -d

  Prüfen Sie die laufenden Container:

  bash

  docker ps

  Alle Container sollten mit dem Status Up aufgeführt sein.

• Das System überprüfen

  Öffnen Sie nach dem Start der Anwendung die IP-Adresse des Servers, auf dem sie läuft, in Ihrem Browser, um zu bestätigen, dass das System läuft:

  bash

  http://127.0.0.1/auth/users/sign_in

  

  E-Mail-Adresse und Kennwort für die Anmeldung werden in /opt/vadtelnewweb/.env festgelegt:

  .env

  VADTEL_SUPER_ADMIN_EMAIL= (login)
  VADTEL_SUPER_ADMIN_PASSWORD= (password)

Nächste Schritte

Nachdem die Plattform installiert ist und läuft, richten Sie sie so ein, dass sie sauber aktualisiert wird und gemeinsam mit dem Server automatisch neu startet.