Modulares Detailhandbuch
Die PlantPulse Platform besteht aus mehreren unabhängigen Modulen. Module und Container haben kein 1:1-Verhältnis — sechs Anwendungen haben jeweils ihren eigenen Container, während die Datalake-Familie plantpulse-datalake Container gemeinsam nutzt.
Die Datalake-Familie ist in einem separaten Top-Level-Abschnitt Datalake zusammengefasst — Pfade · Konfigurationsdateien · Passwortänderung · Admin-Konsole · pd CLI · Betrieb · Komponenten (storage · messaging · analytics · timeseries · cep · workflow · data-gateway) · FAQ.
Modulklassifizierung
Modulkategorien
| Kategorie | Modul | Beschreibung |
|---|---|---|
| Anwendungen | server | Web-Konsole, IIoT-Engine, REST API |
| batch | Geplante Batch-Verarbeitung | |
| data-gateway | REST-basiertes Daten-Gateway | |
| sql | Veraltet (2026-09-07) — SQL-Konsole wurde in data-gateway zusammengeführt | |
| datalake-admin-api | Admin-Konsole Backend + Health API (4950 / 4949) | |
| warehouse | Iceberg-basiertes Data Warehouse | |
| Verarbeitung | cep | Complex Event Processing (Esper) |
| plugin | OPC-UA / AAS Industrie-Standard-Plugins | |
| timeseries | Zeitreihen-Engine + Visualisierungs-UI | |
| Messaging | messaging | Kafka + MQTT (HiveMQ). STOMP (ActiveMQ) ist veraltet |
| Speicher | storage | Cassandra + PostgreSQL + Valkey + MinIO |
| Analytik | analytics | Spark + Hive + Kyuubi + Gravitino + Hadoop |
| Workflow | workflow | Temporal + Kestra |
| Datalake-Betrieb | pd CLI | Einstiegspunkt für Starten/Stoppen/Neustarten · Konfiguration · Knotenverwaltung |
| Datalake-Betrieb | Admin-Konsole | Browser-Betriebskonsole (4950 / 4949) |
| utilities | setup, backup, recovery, exporter, migrator, mirror-maker, simulator, api, lab |
Gemeinsame Modulstruktur
Jedes Service-Modul folgt einer gemeinsamen Verzeichnisstruktur und Betriebsschnittstelle.
plantpulse-<module>/
├── app/ # 애플리케이션 WAR / JAR
├── bin/
│ ├── start.sh # 포그라운드 시작
│ ├── stop.sh # 정지
│ └── log-viewer.sh # 실시간 로그 (tail -F)
├── server/ 또는 lib/ # 내장 Tomcat 서버 또는 JAR
├── logs/ # system.log (메인 로그)
└── conf/ 또는 config/ # 설정 파일
Allgemeine Betriebsbefehle
Auf dem Host — verwaltet den gesamten Stack (/opt/kopens/plantpulse-platform-docker/bin/).
| Aufgabe | Befehl | Hinweise |
|---|---|---|
| Alle starten | up.sh | Warten bis bereit. 0 = einsatzfähig |
| Alle stoppen | down.sh | Reihenfolge umgekehrt, Zustand erhalten |
| Alle neu starten | restart.sh | drain → Stopp → Start → Bereitschaft abwarten |
| Eine App neu starten | docker compose -f compose/docker-compose.yml restart <서비스> | Apps haben jeweils eigenen Container |
| Status prüfen | status.sh | 0 = OK / 2 = Fehler |
| Einheitliche Protokolle | logs.sh | Ohne Argumente alle Container. Mit -f folgen |
Innerhalb des Datalake-Containers — verwaltet Infrastruktur-Komponenten einzeln (mit ./shell.sh eintreten).
| Aufgabe | Befehl |
|---|---|
| Service-Status | ./pd status [서비스] |
| Service neu starten | ./pd restart <서비스> |
| Konfiguration rendern | ./pd config render |
| Cassandra-Knoten | ./pd node status · ./pd node repair … |
| Diagnose | ./pd doctor |
Modulabhängigkeiten
PlantPulse startet abhängigkeitsstufig. Bei Modulneustarts muss die Abhängigkeitsordnung berücksichtigt werden.
Neustartvorsicht: Ein Neustart von Infrastruktur-Modulen (storage / messaging / analytics) erfordert einen Neustart aller abhängigen Anwendungen. Der sichere Weg ist, den gesamten Stack vom Host mit
bin/restart.shneu zu starten.
Port-Zuordnungsübersicht
| Bereich | Port | Modul |
|---|---|---|
| Extern offengelegt | 80 / 443 | server (HTTP / HTTPS) |
| Extern offengelegt | 7443 | server (Admin-Konsole HTTPS) |
| Extern offengelegt | 4950 | monitor (Health Check, HTTPS) |
| Messaging | 9092 / 9093 / 9094 | messaging (Kafka) |
| Messaging | 1883 / 1884 | messaging (MQTT) |
| Speicher | 9042 | storage (Cassandra) |
| Speicher | 5432 | storage (PostgreSQL) |
| Speicher | 6379 | storage (Valkey) |
| Speicher | 9000 / 9001 | storage (MinIO) |
| Analytik | 7077 / 4440 | analytics (Spark Master / UI) |
| Analytik | 10000 | analytics (Kyuubi) |
| Analytik | 19001 | analytics (Gravitino) |
| Analytik | 9083 | analytics (Hive Metastore) |
| Zeitreihen | 7800 / 7801 | timeseries (Engine) |
| Zeitreihen | 3000 | timeseries (UI) |
| Workflow | 7233 / 8233 | workflow (Temporal) |
| Workflow | 8380 | workflow (Kestra) |
| Verarbeitung | 7400 / 7401 | cep |
| Verarbeitung | 5500 | data-gateway |
| Verarbeitung | 11004 / 11005 | plugin (OPC-UA) |
| Verarbeitung | 8007 / 8090 | plugin (AAS V2 / V3) |
| Anwendung | 9500 | batch |
| Anwendung | 9600 | warehouse |
| Anwendung | 4000 | sql |
Die vollständige Portliste finden Sie auf der Seite Portkonfiguration.
Technischer Support
Für Fragen zum Betrieb einzelner Module kontaktieren Sie bitte webmaster@kopens.com.