Betriebsübersicht
Was möchten Sie tun
| Vorhaben | Wo nachlesen |
|---|---|
| Ein-/Ausschalten · Neustart | Start · Stopp · Neustart |
| Status ansehen · Überwachen | Monitoring |
| Sichern · Wiederherstellen | Backup |
| Passwörter · Schlüssel ändern | Credentials |
| Fehlersuche bei Problemen | Diagnose |
| Situationsbezogenes Vorgehen | Betriebsszenarien |
| Direkter Umgang mit Containern | Container-Betrieb |
| Tabellen · Schema | Datenbankmodell |
| Redundanz | HA |
| Version aktualisieren | Upgrade |
| Datenträger bereinigen | Bereinigung |
Dies ist eine Sammlung von Betriebsskripten, die vom Administrator (root) ausgeführt werden, der sich per SSH mit dem Gateway-Server verbindet. Für normale Benutzer reicht die Web-UI aus, aber Betriebsaufgaben wie Start / Stopp / Backup / Upgrade / Fehlerdiagnose werden über diese Skripte durchgeführt.
Wenn systemctl is-active plantpulse-edge.service active ist, handelt es sich um den Container-Modus.
Verwenden Sie anstelle der nativen Skripte dieser Seite (z. B. bin/start.sh) die /opt/kopens/install/bin/*.sh-Befehle auf der Seite Container-Modus-Betrieb. Diese Seite gilt ausschließlich für native Deployment-Boxen.
Installationspfad (native):
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
Auf einen Blick
| Kategorie | Skript | Kurzbeschreibung | Dauer |
|---|---|---|---|
| Start | start.sh | Bootet den gesamten Gateway-Stack | ~90–120 Sekunden |
start-daemon.sh | Startet start.sh als nohup-Hintergrundprozess | sofort | |
| Stopp | stop.sh | Beendet alle Module vollständig (jede Komponente max. 20 Sekunden, inkl. Cassandra drain) | ~60–90 Sekunden |
| Neustart | restart.sh | stop.sh + start.sh in einem einzigen Prozess — gesamter Stack | ~150–210 Sekunden |
restart-app.sh | Neustart nur von Tomcat (App) — das ist der „App-Neustart" in der Oberfläche | 30–90 Sekunden | |
reboot.sh | OS-Neustart | — | |
| Backup | backup.sh | Sammelbackup aus Konfiguration + DB-Snapshot + Tool-Daten | im Minutenbereich |
| Upgrade | upgrade.sh | Backup → Download / Installation der neuen Version | 5–15 Minuten |
firmware.sh | Aktualisierung der OS-Pakete (dnf update) | im Minutenbereich | |
| Diagnose | log-viewer.sh | Zusammengeführte Logs von 7 Komponenten tail -f | unbegrenzt |
ps.sh | Laufende plantpulse-Prozesse | sofort | |
node-info.sh | nodetool info (Cassandra-Status) | sofort | |
node-cql.sh | Interaktiver Cassandra-cqlsh | — | |
network-speed-test.sh | Messung der externen Netzwerkgeschwindigkeit | im Minutenbereich | |
| Bereinigung | clean.sh | Sammellöschung von Logs / temporären Dateien | sofort |
node-cleanup.sh | Freigabe von Cassandra-Datenträgerspeicher | im Minutenbereich | |
| Szenarien | — | Runbooks für Deployment neuer Versionen / Fehlerdiagnose / Speicherplatzmangel / regelmäßige Backups / Disaster Recovery | — |
Im Entwicklungs-/Deployment-Zyklus wird fast immer restart-app.sh (nur App, 30–90 Sekunden) verwendet. start.sh wird einmal nach einem OS-Neustart eingesetzt, stop.sh nur unmittelbar vor Inspektion · Backup.
Eigene start.sh / stop.sh der Sub-Komponenten
Die Gesamt-Skripte (start.sh, stop.sh) übernehmen nur die Reihenfolgenkoordination, die interne Umsetzung liegt bei den komponentenspezifischen Skripten. Wenn Sie nur eine Komponente neu starten möchten, 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 Berechtigungen / Pfaden
- Alle Skripte benötigen root-Rechte (Bindung an Port 80/443, systemctl, Schreibzugriff auf /opt/).
- Verzeichnisse:
| Zweck | Pfad |
|---|---|
| Gateway-Code / Build-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 zu platzieren. Dadurch werden Code-Aktualisierung und Datenerhaltung getrennt, was das Risiko von Datenverlust beim Upgrade verringert.
Weiterführende Informationen
- Detaillierte Vorgehensweisen zu den einzelnen Kategorien finden Sie auf den Seiten Start / Stopp / Neustart / Backup / Upgrade / Diagnose / Bereinigung / Szenarien im linken Menü.
- Zur Verwendung der einzelnen Skripte siehe
--helpoder die Kommentare am Anfang des jeweiligen Skripts.