Zum Hauptinhalt springen

Häufig gestellte Fragen (FAQ)

Suchen Sie nach Symptom oder Frage. Die Antworten sind kurz; detaillierte Verfahren finden Sie unter Links.

Konfiguration​

Ich habe die Sidecar bearbeitet, aber die Änderungen werden nicht angewendet​

Der Container enthält keine Sidecar-Datei. Werte werden als Umgebungsvariablen eingefügt, wenn compose den Container neu erstellt. docker restart startet nur mit denselben Umgebungsvariablen neu.

cd /opt/kopens/plantpulse-platform-docker/bin
./restart-datalake.sh

Wenn das nicht funktioniert, prüfen Sie ① mit bin/env.sh --print welche Datei gewinnt und ② ob compose den Namen an den Data Lake übergibt → Änderungen werden nicht angewendet

Ich habe die Konfigurationsdatei im Container bearbeitet, aber die Änderungen wurden rückgängig gemacht​

Das ist normal. PP_HOME Alles unter conf/ sind generierte Dateien, und pd start schreibt diese bei jedem Durchgang aus der Vorlage neu. Der richtige Ort zum Bearbeiten ist /etc/kopens/conf/<파일>.template auf dem Host → Vorlage bearbeiten

export PP_PG_PASSWORD=… bin/up.sh wird stillschweigend ignoriert​

Wenn die Sidecar bereits diesen Namen hat, gewinnt die Sidecar. Die einzige Möglichkeit, Werte auf einem installierten Knoten zu ändern, ist bin/passwd.sh → Passwörter · API-Schlüssel ändern

Ich habe das Image hochgeladen, aber die neuen Konfigurationsstandardwerte wurden nicht übernommen​

/etc/kopens/conf ist eine Host-Datei und ändert sich nicht von selbst. Das Bereitstellungstool führt bei jeder Bereitstellung einen 3-Way-Abgleich durch, behält aber Dateien bei, die vom Administrator bearbeitet wurden, und meldet diese mit [WARN] operator edit kept, but THE IMAGE DEFAULT CHANGED. Diese Datei muss manuell zusammengeführt werden.

docker exec plantpulse-datalake pd config diff --templates     # differs / missing 인 파일
TEMPLATE_FORCE_SEED=1 ./restart-datalake.sh                    # 통째로 이미지 기본값으로 (백업은 도구가 남긴다)

Andere Boxen (Edge · AI · Worker) können sich nicht mit diesem Data Lake verbinden​

Prüfen Sie, ob Sie die LAN-Adresse dieses Hosts in der Knotendatei eingetragen haben. Falls leer, wird die Compose-Netzwerkadresse verwendet (10.99.0.100), was nur innerhalb derselben Box funktioniert.

sudo vi /etc/kopens/platform.node.env      # PP_MASTER_IP=<이 호스트의 LAN IP>
./restart-datalake.sh

Wenn nur Kafka nicht verbunden ist, ist es die Werbungsadresse → Knotendatei

Render lehnt mit exit 8 ab​

Die Werbungsadresse ist 127.0.0.1. Geben Sie die tatsächlichen Adressen in PP_HOST_IP · PP_MASTER_IP · PP_KAFKA_ADVERTISED_HOST der Knotendatei an. Die Fehlermeldung nennt den Namen zum Korrigieren.

Render stoppt bei exit 3 oder exit 4​

  • exit 3 — ein erforderlicher Secret ist leer. Die Nachricht enthält den Namen. In die Sidecar einfügen und neu erstellen.
  • exit 4 — ${PP_*} in der Vorlage hat keinen Wert. Die Nachricht zeigt 이름@템플릿:줄. Geben Sie den Wert in der Knotendatei an oder bearbeiten Sie die Vorlage.

Kann ich eine einzelne Komponente (z. B. Hive) ausschalten?​

pd hat einen PD_OPTIONS='{"enable-hive": false}' -Schalter, aber der aktuelle Compose-Stack übergibt diese Variable derzeit nicht an den Container. Wenn Sie sie in der Sidecar oder Knotendatei angeben, erreicht sie den Container nicht, also wird nichts ausgeschaltet. Dies wurde als Produktverbesserung dokumentiert. Der alte Name PP_OPTIONS wird nirgends gelesen.

Um die Sprache auf Deutsch zu ändern​

Geben Sie PP_LANG=ko in die Sidecar ein und verwenden Sie restart.sh (dieser Wert gilt auch für die App, daher vollständiger Neustart). Die Admin-Konsole ist separat — fügen Sie ?lang=ko am Ende der Adresse an.

Passwort · Konto​

Ich habe das Passwort geändert und die Plattform startet nicht​

Der Zustand, in dem nur der Server oder nur die Sidecar geändert wurde. Überprüfen Sie zunächst, welcher Wert gültig ist.

docker exec plantpulse-datalake bash -c 'PGPASSWORD="<구값>" psql -U plantpulse -h 127.0.0.1 -c "SELECT 1;"'
docker exec plantpulse-datalake bash -c 'PGPASSWORD="<신값>" psql -U plantpulse -h 127.0.0.1 -c "SELECT 1;"'

Wenn Sie sich mit dem alten Wert verbinden können, wurde die Serverseite nicht geändert. Wenn Sie sich mit dem neuen Wert verbinden können, müssen Sie nur die Sidecar aktualisieren. In Zukunft verwenden Sie passwd.sh → Passwörter · API-Schlüssel ändern

passwd.sh lehnt mit «variable not in the registry» ab​

Dieser Schlüssel kann nicht rotiert werden. Nur die 11 in --list aufgeführten können rotiert werden. Der Rest erfolgt über manuelles Verfahren. Bei Tippfehlern werden ähnliche Schlüssel vorgeschlagen.

Die Rotation ist fehlgeschlagen​

Führen Sie denselben Befehl erneut aus. Das Journal weiß, wie weit es gekommen ist, und setzt von dort fort. Es gibt kein Rollback. Wenn probe=NEITHER oder verify 실패 angezeigt werden, muss jemand direkt auf diese Komponente zugreifen und den Zustand überprüfen.

Ich habe Worker-Knoten, aber passwd.sh lehnt ab​

Das ist beabsichtigt. Wenn Sie nur den Master rotieren, bleiben die Worker mit den alten Werten und der Cluster ist halbtot. Ändern Sie mit manuellem Verfahren und wiederholen Sie die Sidecar-Aktualisierung + Neustart für jeden Worker.

Der Admin-Konsolen-Login-Bildschirm zeigt «nicht konfiguriert» an​

PP_DATALAKE_ADMIN_PASSWORD ist leer. Das ist kein Fehler.

bin/passwd.sh PP_DATALAKE_ADMIN_PASSWORD     # --list 에 이 키가 있으면
# 없으면 (2026-09-05 이전 패키지) 사이드카에 줄을 적고 ./restart-datalake.sh

→ Web-Konsolen-Anmeldekonto

Data Gateway · CEP-Konsolen-Login funktioniert nicht​

PP_DATA_GATEWAY_WEB_PASSWORD · PP_CEP_WEB_PASSWORD haben keine Standardwerte, also sind sie leer und nur diese Konsole wird geschlossen. Geben Sie sie in die Sidecar ein und verwenden Sie restart-datalake.sh → Abfrage-Konsolen

Ich habe das Grafana-Passwort geändert und beim Neuerstellen des Containers ist es zurückgesetzt worden​

Dies ist ein bekannter Fehler. Das Datenverzeichnis von Grafana ist nicht auf einem Volume, sondern im Image-Baum → Grafana

Die SQL-Tools-Karte ist verschwunden​

plantpulse-sql wurde am 2026-09-07 eingestellt. SQL wird jetzt in der Data Gateway-Konsole ausgeführt (https://<server-ip>:5501/). Der Bildschirm Werkzeuge der Admin-Konsole hat eine Data Gateway-Karte.

Start · Status​

Es gibt STOPPED bei pd status, aber ich bin gerade hochgefahren​

Das ist das Start-Fenster. analytics Kyuubi startet zuletzt; von spark-master an dauert es etwa 54 Sekunden. Schauen Sie sich in einer Minute noch mal um. Wenn es andauert, siehe pd logs --lines 100 <서비스>.

docker ps ist Up, aber alle Services sind tot​

Verdacht auf OOM. PID 1 ist systemd, daher nur Java stirbt, der Container läuft weiter.

dmesg -T | grep -i "memory cgroup"
docker inspect plantpulse-datalake --format '{{.State.OOMKilled}}'

→ Speicherlimit erhöhen

pd stop endete mit STILL RUNNING (exit 7)​

Starten Sie nicht sofort pd start neu. Sehen Sie sich das Verbleibende mit pd kill --dry-run an und verwenden Sie pd kill → überprüfen Sie mit pd status dass es leer ist → pd start.

pd start lehnt mit «already running» ab​

Es läuft bereits. Um es neu zu starten, beginnen Sie mit pd stop. Verwenden Sie FORCE=1 nicht — es versucht, einen anderen Prozess mit demselben Port zu starten.

Der erste Start dauert über 10 Minuten​

Der erste Start erstellt das Cassandra-Schema; der Speicher allein kann bis zu 500 Sekunden dauern. Deshalb beträgt die Container-Startverzögerung 900 Sekunden. Sehen Sie sich den Fortschritt mit bin/logs.sh -f plantpulse-datalake an.

Die Konsole zeigt «Another job is already running on this node»​

Das ist ein Symptom der admin-api-Images vor 2026-09-04. Schauen Sie sich pd env an und wenn es alt ist, verwenden Sie IMAGE_BUILT_AT → update.sh. Auch in neuen Images akzeptiert die Schaltfläche «Inspektion ausführen» immer nur eine gleichzeitig — versuchen Sie es in einer Weile erneut.

Wenn ich pd auf dem Host ausführe, erhalte ich «command not found»​

pd existiert nur im Container. Geben Sie es mit docker exec plantpulse-datalake pd … oder bin/shell.sh ein.

Daten​

Es kommen keine Daten herein​

Verwenden Sie pd flow, um zu sehen, wo die MQTT → Kafka → Consumer-Kette blockiert ist.

docker exec plantpulse-datalake pd flow

Wenn LAG groß ist, sind die Consumer (Server · CEP · Batch) langsam oder gestoppt; NA bedeutet «noch nie gelesen». Wenn MEMB 0 ist, läuft der Consumer nicht; wenn er größer als 0 ist und das Thema leer, ist es normal. Der Bildschirm Topologie der Admin-Konsole zeigt dasselbe als Diagramm.

Festplatte ist voll / schrumpft nicht​

docker exec plantpulse-datalake pd storage        # 얼마나 있나 — 볼륨 · WAL · 슬롯 · 스냅샷
docker exec plantpulse-datalake pd retention      # 언제 사라지나 — TTL · 토픽 보존 · 콜드 티어
  • Wenn Cassandra snapshots groß ist, verwenden Sie pd node cleanup (Snapshots löschen — destruktiv).
  • Wenn slot.orphan angezeigt wird, hält ein Replikationsslot eines entfernten Workers WAL fest — siehe Host ops-check.sh --reclaim.
  • Wenn Protokolle eines gestoppten Moduls die Ursache sind, verwenden Sie pd clean.
  • pd retention von TTL none ist nicht «kein Verfallsdatum», sondern «Tabelle hat keinen Standard». Tabellen mit TTL pro Zeile (ts_data_points) verfallen ordnungsgemäß.
  • Wenn cold_tier von last advance länger als 48 Stunden nicht vorrückt, ist der Archiv-Job gestoppt — dies ist oft der echte Grund für volle Hot-Disks.

Kafka zeigt «advertises 127.0.0.1» DOWN​

Die Adresse in der Knotendatei ist leer → Knotendatei. broker.properties · server.properties im Container sind Beispieldateien aus der Kafka-Distribution — erschrecken Sie nicht — der Broker liest nur kafka.properties.

Zeitreihendaten verschwinden nach ein paar Tagen​

Die Lebensdauer eines Zeitreihenpunkts ist PP_TSE_DATAPOINT_TTL (Standard 365 Tage). Vor 2026-09-05 war es ein 31-Tage-Literal. Der Wert wird zur Schreibzeit geprägt, daher werden bereits geschriebene Zeilen nicht wiederhergestellt, auch wenn Sie ihn erhöhen → Variablenreferenz

Backup​

Wie kann ich sehen, ob Backups erstellt werden?​

docker exec plantpulse-datalake pd backup schedule      # 잡 다섯의 일정 · 마지막 결과
docker exec plantpulse-datalake pd backup list          # 세트 목록

Der Bildschirm Backup der Admin-Konsole zeigt dasselbe → Backup · Restore

Um die nächtliche Backup-Zeit zu ändern​

docker exec plantpulse-datalake pd backup schedule set --job postgres-diff --calendar "*-*-* 02:45:00"

Es überlebt sogar ein Neuerstellen des Containers.

cassandra-full ist immer noch fail (exit 120 (medusa))​

Images vor 2026-09-04 schlugen täglich fehl, da niemand die Medusa-Konfiguration verwendete. Jetzt wird pd beim Cassandra-Start neu geschrieben — überprüfen Sie nach pd restart storage mit pd backup run --engine cassandra --type full.

Protokolle​

Wo schaue ich mir die Protokolle an?​

Auf dem Host bin/logs.sh plantpulse-datalake (letzte 200 Zeilen, mit -f verfolgen), im Container pd logs [서비스]. App-Container-Protokolle sind nicht in pd logs, siehe stattdessen logs.sh <서비스> → Protokolle und Integrität

Ich möchte wissen, wer wann den Service heruntergefahren hat​

Ereignisjournal plantpulse-datalake-admin-api/logs/pd-events.jsonl oder der Bildschirm Ereignisse der Admin-Konsole. Befehle, die von der Konsole ausgeführt wurden, werden in operator:<name> protokolliert. Von der Konsole aus geänderte Konfigurationen werden im Bildschirm Audit protokolliert.

Weitere Ressourcen​