Zum Hauptinhalt springen

Installation — von der Auswahl bis zur Verifizierung

Die Installation von PlantPulse Edge beginnt mit der Wahl des Bereitstellungsmodus. Standard für Neuinstallationen ab 2026.05 ist ein einzelner Docker-Container + install.sh. Die bisherige Dokumentation zur nativen Installation bleibt erhalten, wird für neue Boxen jedoch nicht mehr standardmäßig empfohlen.

Native und Container nicht mischen

Der Container-Modus verwendet plantpulse-edge.service, der Legacy-Native-Modus plantpulse.service. Werden beide Dienste gleichzeitig auf derselben Box gestartet, kollidieren Ports wie 80/443/1880/9042 sowie die Datenpfade.

1. Welche Installation wählen?​

SituationAuswahlBegründung
Einzelnes Gateway Vor-Ort, Internetzugang vorhandenSchnellinstallation (install.sh)OS-Pakete, Docker, sysctl, firewall, chrony, SSL, systemd und Image-Pull in einem Durchgang
Wiederholte Installation von 100+ Geräten in der SerienfertigungSerienfertigung (factory.sh)Prompt-gesteuerte Verarbeitung von EDGE_ID/hostname/Zugangsdaten/Labels/Inventar
Kein Internet, Sicherheitsstandort, Einbringung per USBOffline- / Air-Gap-Netzwerk-InstallationInstall-Bundle und Container-Image tar.zst extern vorbereiten
VMware / Hyper-V / KVM / Cloud-VMVM- / Cloud-InstallationBasis ist install.sh, lediglich VM-Netzwerk und Ressourcenunterschiede werden angepasst
PLC-Netz / WAN-Netz / VLAN-Design muss zuerst stehenLeitfaden NetzwerkkonfigurationNIC-Rollen, statische IP, Routing, Firewall vorab klären
Abnahmekriterien für das Betriebsteam nach Abschluss der InstallationProduktions-AbnahmekriterienGo/No-Go-Entscheidung inkl. Health, Backup, Neustart, Sicherheit und Nachweisdateien
Wartung nativer Boxen älter als 2026.05(Legacy) Komplette H/W-InstallationErhält die frühere native Installationsprozedur auf Basis von tools/setup.sh
Auch bei neuer Hardware zuerst die Schnellinstallation ansehen

Das tools/setup.sh aus der alten Dokumentation ist das Komplettinstallationswerkzeug der nativen Ära. Neue Boxen ab 2026.05 werden nach dem Linux-Boot gemäß Schnellinstallation eingerichtet; falls eine statische NIC-Konfiguration nötig ist, wird sie über die env-Variablen LAN1_* / LAN2_* an install.sh übergeben.

2. Was die Standardinstallation leistet​

Das install.sh der Schnellinstallation richtet folgende Punkte idempotent ein.

BereichInhalt
OS-VorbereitungPflichtpakete, Docker, chrony, firewall, sysctl/limits
NetzwerkOptionale statische IP-Konfiguration nmcli, WAN/PLC-NIC-env-Override
SicherheitPro Box zufällige admin/MQTT/OPC-UA/API-Keys, TLS-Material auf Basis von CERT_PASS
Laufzeit/etc/kopens/app.properties, /data1/pp-data, Container-Image pull/load
systemdplantpulse-edge.service, OTA-Path/-Service, Host-Action-Path/-Service
Verifizierung/api/v1/system/version, /api/v1/system/health, werkzeuggestützte Statusprüfung

Die initialen Zugangsdaten werden nach der Installation einmalig in /etc/kopens/credentials.txt gespeichert. Bewahren Sie diese Datei ausschließlich für root zugänglich auf und übergeben Sie sie bei Auslieferung/Abnahme sicher.

3. Prüfungen vor der Installation​

PunktKriterium
OSLinux. Empfohlen RHEL/Fedora/Rocky/CentOS-Familie, VM ebenfalls möglich
Rechteroot oder sudo -i
Netzwerkproduct.kopens.io / product.kopens.io erreichbar
Festplatte/opt/kopens 3 GB+, für /data1-Daten 100 GB+ empfohlen
Arbeitsspeicher8 GB minimum, 16 GB oder mehr empfohlen
BetriebsmodusNeubetrieb/Serienfertigung im Container-Modus. Legacy-native nur zur Wartung bestehender Boxen

Im Air-Gap-Netzwerk entfällt die Internetprüfung; stattdessen werden Bundle und Image tar.zst gemäß Offline- / Air-Gap-Netzwerk-Installation vorbereitet.

4. Standardinstallation in Kürze​

sudo -i
curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh | bash

Wenn Sie die Ausführung in einer Zeile bevorzugen:

sudo -i
bash < <(curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh)

Detaillierte Optionen, env-Overrides und erwartete Ausgaben finden Sie unter Schnellinstallation.

5. Sollzustand nach der Installation​

# 한 줄 상태 점검
sudo bash /opt/kopens/install/bin/status.sh

# 버전 / 컨테이너 모드 확인
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool

# 전체 컴포넌트 health
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

Sollkriterien:

  • plantpulse-edge.service ist active
  • container_mode=true von /api/v1/system/version
  • /api/v1/system/health HTTP 200, wichtige Komponenten UP
  • Go-/No-Go-Punkte der Produktions-Abnahmekriterien bestanden
  • Web-UI: https://<gateway-ip>/ui/main
  • Node-RED: https://<gateway-ip>/ui/flow/

Bei Problemen zuerst Installations-Troubleshooting oder den Betriebsleitfaden Container-Modus prüfen.

6. Weiterführende Dokumente​