Datenbankverwaltung

Übersicht

Auf dieser Seite werden die Konfiguration, die Zugriffsmethoden, die Statusprüfung und die grundlegenden Tuning-Richtlinien der Datenspeicher beschrieben, die von der installierten PlantPulse-Plattform verwendet werden.

Die Plattform betreibt vier Arten von Datenspeichern, die je nach Verwendungszweck integriert sind.

Speicher	Verwendungszweck	Standard-Port	Hinweise
Aster TSDB	Zeitreihe / Massendaten (Tag-Punkte, Ereignisse)	9042 (CQL)	Keyspace pp. Einzelne Massendaten-DB-Engine der Plattform
PostgreSQL	Metastore (Master- / Konfigurationsdaten)	5432	Datenbank pp, Schema pp
Valkey (Redis-kompatibel)	Cache / Sitzungen / Echtzeitstatus	6379	Mit redis-cli erreichbar
RustFS	Objektspeicher (S3-kompatibel)	9000 (S3) / 9001 (Konsole)	Speicherung von Dateien / großen Ausgabedaten

Darüber hinaus gibt es das Hive Metastore + Iceberg-Tabellenformat, das von der Analyseebene (Spark / Kyuubi) verwendet wird. Dies wird von der Plattform intern verwaltet, sodass keine separaten Betriebsaufgaben erforderlich sind.

Hinweis: Die Ports 7000 (Cluster-Gossip) und 7199 (JMX) von Aster TSDB sind ausschließlich für die interne Kommunikation bestimmt. Bitte nicht extern exponieren.

Zugriffsmethoden

Die folgenden Befehle beziehen sich alle auf das Innere des Data-Lake-Containers. Alle vier Speicher laufen in plantpulse-datalake einem Container. Wenn Sie die Shell ohne Argumente öffnen, gelangen Sie direkt in diesen Container.

cd /opt/kopens/plantpulse-platform-docker/bin
./shell.sh

Zugriffskonten und Passwörter werden über Umgebungsvariablen (z. B. PP_CASSANDRA_USER/PASSWORD, PP_PG_USER/PASSWORD, PP_REDIS_PASSWORD) verwaltet.

Punkt	Ort
Tatsächlich angewendete Werte	Secret-Sidecar des Hosts /etc/kopens/plantpulse-platform.env (Berechtigungen 0600)
Methode zum Ändern von Werten	bin/passwd.sh — eine direkte Änderung der Datei wird nicht übernommen → Passwort-Rotation

Pfadprüfung — Die maßgebliche Quelle des Secret-Sidecars ist genau /etc/kopens/plantpulse-platform.env (Berechtigungen 0600). Bei älteren Installationen kann unter /opt/kopens/ ein gleichnamiger Eintrag übrig sein, der jedoch nicht gelesen wird; das Installationsskript stellt die maßgebliche Quelle wieder her → Umgebungsvariablen-Referenz

Aster TSDB (cqlsh)

cd /opt/kopens/plantpulse-platform/plantpulse-storage/db/cassandra/bin
./cqlsh -u <PP_CASSANDRA_USER> 127.0.0.1 9042

-- 키스페이스 / 테이블 확인
DESCRIBE KEYSPACE pp;
SELECT table_name FROM system_schema.tables WHERE keyspace_name = 'pp';

PostgreSQL (psql)

PostgreSQL 18 wird verwendet. Die Client-Binärdateien befinden sich in /usr/pgsql-18/bin.

/usr/pgsql-18/bin/psql -h 127.0.0.1 -U <PP_PG_USER> -d pp

-- 메타스토어 스키마 확인 (기본 search_path 는 pp 스키마)
\dn
\dt pp.*

Valkey (redis-cli)

redis-cli -h 127.0.0.1 -p 6379 -a '<PP_REDIS_PASSWORD>' ping

Achtung: Bitte nur für Abfragen (SELECT / DESCRIBE / ping) verwenden. Für Datenänderungen oder Schemaänderungen beachten Sie bitte die Hinweise.

Statusprüfung

Aster TSDB-Knotenstatus

Das pd node-Verb umschließt nodetool.

cd /opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin
./pd node status

Im Normalzustand wird der Knoten als UN (Up / Normal) angezeigt. Wenn ein Knoten DN (Down) sichtbar ist, sind ein Neustart des Speichers oder eine Prüfung der Protokolle erforderlich.

PostgreSQL-Status

/usr/pgsql-18/bin/pg_isready -h 127.0.0.1 -p 5432
/usr/pgsql-18/bin/psql -h 127.0.0.1 -U <PP_PG_USER> -d pp -c "SELECT version();"

Integriertes Status-Dashboard / Health-API

# 포트별 서비스 상태 + CPU / 메모리 / 디스크 요약
cd /opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin
./status.sh

# 헬스 API — cassandra / postgres 컴포넌트 상태 포함
curl -kfsS https://127.0.0.1:4950/api/health | jq

Bitte prüfen Sie, ob die Komponenten cassandra und postgres der Health-API-Antwort normal (UP) sind.

Schema / Datenplatzierung

Punkt	Ort	Inhalt
Aster TSDB-Keyspace	pp	Zeitreihendatentabellen (tm_*)
PostgreSQL-Schema	Datenbank pp / Schema pp	Master- / Konfigurationstabellen (mm_*)
Daten-Dateipfad	/data1/pp-data	Als Docker-Volume pp-data gemountet

Das PostgreSQL-Metastore-Schema ist zum Zeitpunkt des Image-Builds vorab geseedet, sodass nach der Installation keine separaten Schemaerstellungsarbeiten erforderlich sind. Beim Verbinden ist search_path auf das Schema pp eingestellt, sodass Abfragen nur mit dem Tabellennamen möglich sind.

Alle Daten werden unter /data1/pp-data (Volume pp-data) gespeichert. Daher bleiben die Daten auch beim Entfernen des Containers oder beim Aktualisieren des Images erhalten.

Tuning-Standardwerte (Auslieferungskonfiguration)

Aster TSDB wird mit den folgenden Standardwerten ausgeliefert, die auf die Plattform-Workload abgestimmt sind.

Punkt	Auslieferungsstandard	Beschreibung
JVM-Heap	-Xms16G -Xmx16G	Anfangs- und Maximal-Heap identisch (verhindert dynamisches Resizing)
GC	ZGC (Generational)	Geringe Latenz Garbage Collector
Datei-Cache	file_cache_enabled: false	Nutzung des OS-Seitencaches, Obergrenze für Off-Heap entfernt
Direct-Speicher	-XX:MaxDirectMemorySize=6G	Für Memtable Off-Heap + IO-Puffer

Wichtig — Änderungspfad für Konfigurationen: Die in den jeweiligen Service-Pfaden bereitgestellten Konfigurationsdateien (z. B. cassandra.yaml, jvm-server.options für Aster TSDB) sind gerenderte Artefakte aus den Vorlagen in plantpulse-datalake-cli/config/templates/. Wenn Sie diese Dateien direkt bearbeiten, werden sie beim nächsten Neustart / Neu-Konfigurieren (configure) mit den Vorlagenwerten überschrieben, sodass die Änderungen verloren gehen.

Wenn Tuning-Werte geändert werden müssen, gehen Sie bitte unbedingt wie folgt vor.

1. Vorlage in /etc/kopens/conf des Hosts (die als Bindung in plantpulse-datalake-cli/config/templates des Containers mountet wird) oder Variable PP_* in bin/env.sh ändern
2. Im Data-Lake-Container pd config render ausführen — die Vorlage wird erneut gerendert und in den jeweiligen Service-Pfaden bereitgestellt
3. Den betreffenden Dienst neu starten (z. B. pd restart storage)

Da die Vorlage ein Host-Verzeichnis ist, kann der Betreiber sie direkt auf dem Host bearbeiten, und die Änderungen bleiben auch nach einer Neuinstallation erhalten.

Wenn eine Änderung der Standardwerte erforderlich ist, wird empfohlen, sich zuerst mit dem technischen Support-Team abzustimmen.

Backup-Überblick

Alle Daten, einschließlich der Datenbanken, werden im Volume pp-data gespeichert. Daher ist eine Sicherung auf Volume-Ebene die einfachste und sicherste Methode.

cd /opt/kopens/plantpulse-platform-docker/bin

# 기본 세트 (pp-data · pp-security) 를 한 번에
./backup.sh

# 볼륨 하나만 — <volume-name> [보관일수] [백업경로]
./tools/backup-volume.sh pp-data 7 /data1/pp-backup/docker-volume

Im Standardsatz von backup.sh ist pp-backup das Ziel der Sicherung, während pp-temp für die Wiederherstellung nicht nützlich ist und daher fehlt. Bei Bedarf kann es als Argument angegeben und gesichert werden.

Detaillierte Verfahren wie Point-in-Time-Recovery, individuelle Sicherungen pro DB und externe Speichersynchronisierung finden Sie auf der Seite Administratorhandbuch - Backup und Wiederherstellung.

Hinweise

• Keine direkten DDL-Befehle auf der Betriebs-DB — Führen Sie Tabellenerstellung / -änderung / -löschung (CREATE / ALTER / DROP / TRUNCATE) nicht direkt aus. Das Schema wird von der Plattform über versionsbezogene Migrationen verwaltet. Bei willkürlichen Änderungen können Updates fehlschlagen oder Daten verloren gehen.
• Direkte Datenänderungen vermeiden — Masterdaten (mm_*) bitte über die Management-Konsolenoberfläche ändern. Direkte UPDATEs in der DB können Inkonsistenzen mit Cache- / Integrationsdiensten verursachen.
• Verwendung von eingebetteten / alternativen DBs verboten — Konfigurationen, die das integrierte Aster TSDB / PostgreSQL durch andere DB-Produkte oder eingebettete DBs ersetzen, werden nicht unterstützt.
• Kein direktes Löschen von Datendateien — Löschen Sie keine Dateien unter /data1/pp-data, um Speicherplatz freizugeben. Wenn eine Datenbereinigung erforderlich ist, kontaktieren Sie bitte den technischen Support.
• Konten / Portänderungen über Umgebungsvariablen — Wenn DB-Konten oder Ports geändert werden müssen, verwenden Sie bitte die Override-Methode über Umgebungsvariablen (PP_*) statt einer direkten Änderung der Konfigurationsdatei.

Technischer Support

Bei Fragen zum Datenbankbetrieb können Sie uns jederzeit kontaktieren.

Ansprechpartner	Kontakt
Technischer Support	webmaster@kopens.com