Betrieb — Überblick
Sammlung von Betriebsskripten, die ein Administrator (root) nach SSH-Zugriff auf den Gateway-Server ausführt. Für normale Anwender genügt die Web-UI, doch Betriebsaufgaben wie Starten / Stoppen / Backup / Upgrade / Fehlerdiagnose erfolgen über diese Skripte.
Ist systemctl is-active plantpulse-edge.service gleich active, liegt Container-Modus vor.
Verwenden Sie statt der nativen Skripte dieser Seite (z. B. bin/start.sh) die /opt/kopens/install/bin/*.sh-Befehle der Seite Container-Modus. Diese Seite gilt ausschließlich für native Deployment-Boxen.
Installationspfad (native):
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
Überblick
| Kategorie | Skript | Kurzbeschreibung | Dauer |
|---|---|---|---|
| Start | start.sh | Bootet den gesamten Stack des Gateway | ~90–120 s |
start-daemon.sh | start.sh im nohup-Hintergrund | sofort | |
| Stopp | stop.sh | Modulweises Herunterfahren (je Komponente max. 20 s, inkl. Cassandra drain) | ~60–90 s |
| Neustart | restart.sh | Startet nur Tomcat neu — unterbrechungsfrei, am häufigsten genutzt | ~6 s |
reboot.sh | OS-Neustart | — | |
| Backup | backup.sh | Sammelbackup aus Konfiguration + DB-Snapshot + Tool-Daten | Minuten |
| Upgrade | upgrade.sh | Backup → Download / Installation der neuen Version | 5–15 min |
firmware.sh | OS-Paketaktualisierung (dnf update) | Minuten | |
| Diagnose | log-viewer.sh | Konsolidiertes tail -f der Logs von 7 Komponenten | unbegrenzt |
ps.sh | Laufende plantpulse-Prozesse | sofort | |
node-info.sh | nodetool info (Cassandra-Status) | sofort | |
node-cql.sh | Cassandra cqlsh interaktiv | — | |
network-speed-test.sh | Messung der externen Netzgeschwindigkeit | Minuten | |
| Bereinigung | clean.sh | Logs / temporäre Dateien sammelweise löschen | sofort |
node-cleanup.sh | Cassandra-Speicherplatz zurückgewinnen | Minuten | |
| Szenarien | — | Runbooks für Deployment neuer Versionen / Fehlerdiagnose / Speichermangel / regelmäßige Backups / Disaster Recovery | — |
Im Entwicklungs- / Deployment-Zyklus wird nahezu jedes Mal restart.sh verwendet (nur Tomcat, 6 s). start.sh wird einmalig nach einem OS-Neustart benötigt, stop.sh nur unmittelbar vor Inspektion oder Backup.
Eigene start.sh / stop.sh der Sub-Komponenten
Die Gesamtskripte (start.sh, stop.sh) koordinieren lediglich die Reihenfolge; die eigentliche Implementierung liegt in den komponentenspezifischen Skripten. Wenn Sie nur eine Komponente neu starten wollen, rufen Sie diese direkt auf:
| Komponente | Start | Stopp |
|---|---|---|
| Redis (cache) | $PE_HOME/cache/bin/start.sh | $PE_HOME/cache/bin/stop.sh |
| Cassandra (DB) | $PE_HOME/db/bin/start.sh | $PE_HOME/db/bin/stop.sh |
| HiveMQ (MQTT) | $PE_HOME/mqtt/bin/start.sh | $PE_HOME/mqtt/bin/stop.sh |
| timeseries-engine | $PE_HOME/timeseries/engine/bin/start.sh | $PE_HOME/timeseries/engine/bin/stop.sh |
| timeseries-dashboard | $PE_HOME/timeseries/dashboard/bin/start.sh | $PE_HOME/timeseries/dashboard/bin/stop.sh |
| Tomcat (server) | $PE_HOME/server/bin/start.sh | $PE_HOME/server/bin/stop.sh |
| Node-RED | $PE_HOME/node/bin/start.sh | $PE_HOME/node/bin/stop.sh |
Beispiel — nur Node-RED neu starten:
$PE_HOME/node/bin/stop.sh
$PE_HOME/node/bin/start.sh
Hinweise zu Rechten / Pfaden
- Alle Skripte benötigen root-Rechte (Bindung an Port 80/443, systemctl, Schreibzugriff auf /opt/).
- Verzeichnisse:
| Zweck | Pfad |
|---|---|
| Gateway-Code / Artefakte | /opt/kopens/plantpulse-edge/ |
| Benutzerdaten (sparkplug bdSeq, grafana, node-red, hivemq, apm) | /data1/pp-data/ |
| Backup-Artefakte | /data1/pp-backup/ |
| Tomcat-Logs | $PE_HOME/server/logs/catalina.out |
| Cassandra-Logs | $PE_HOME/db/logs/system.log |
| HiveMQ-Logs | $PE_HOME/mqtt/log/hivemq.log |
| Node-RED-Logs | $PE_HOME/node/log/node-red.log |
- Achtung: Es wird empfohlen,
/opt/kopens/und/data1/pp-data/auf getrennten Datenträgern abzulegen. Damit sind Code-Aktualisierung und Datenhaltung getrennt, was das Risiko eines Datenverlusts beim Upgrade verringert.
Weiterführendes
- Detaillierte Abläufe je Kategorie finden Sie im linken Menü unter Start / Stopp / Neustart / Backup / Upgrade / Diagnose / Bereinigung / Szenarien.
- Zur Verwendung der einzelnen Skripte siehe
--helpoder die Kommentare am Skriptanfang.