Variablenreferenz — was die Datalake liest

Hier sind nur die Variablen aufgelistet, die der Datalake-Container tatsächlich liest. Die autoritative Quelle der Standardwerte ist plantpulse-datalake-cli/config/defaults.env im Container; Werte vom Host überschreiben diese. Alle Werte auf der Host-Seite (einschließlich DOCKER_*) finden Sie in der Umgebungsvariablen-Referenz.

«vorhanden» und «erreichbar» sind nicht dasselbe

Variablen in der Spalte «Vom Host änderbar» in der Tabelle unten mit Nein werden vom Sidecar zumindest nicht an den Container übergeben. Der compose-Prozess übergibt diesen Namen nicht an die Datalake. Der Wert wird durch defaults.env oder ein Template definiert.

Secrets — was passiert, wenn sie fehlen

pd kennt drei Listen von Secrets. Werte haben nirgends einen Standard; sie kommen nur über Sidecar → Compose → Umgebungsvariable herein.

Liste	Variable	Wenn leer
Erforderlich	`PP_REDIS_PASSWORD` `PP_PG_PASSWORD` `PP_CASSANDRA_PASSWORD` `PP_MINIO_PASSWORD` `PP_MQ_PASSWORD` `PP_TSE_PASSWORD` `PP_SPARK_PASSWORD` `PP_HIVE_PASSWORD` `PP_GRAVITINO_PASSWORD` `PP_TEMPORAL_PASSWORD` `PP_KESTRA_DB_PASSWORD` `PP_KESTRA_ADMIN_PASSWORD` `PP_TLS_KEYSTORE_PASSWORD` `PP_CEP_API_KEY` `PP_DATA_GATEWAY_API_KEY`	`pd start` wird mit exit 3 beendet und listet alle fehlenden Namen auf. Compose fordert diese auch über `:?` an, daher wird der Stack überhaupt nicht gestartet
Worker hinzufügen	`PP_PG_REPLICA_PASSWORD`	Nur auf WORKER-Knoten erforderlich
Optional	`PP_DATALAKE_ADMIN_PASSWORD` `PP_DATALAKE_ADMIN_API_KEY` `PP_DATA_GATEWAY_WEB_PASSWORD` `PP_CEP_WEB_PASSWORD`	Nur diese eine Funktion wird deaktiviert. Stack startet normal. `pd doctor` gibt den Namen an

So ändern Sie diese: Passwörter · API-Schlüssel ändern. Die abgeleiteten Werte PP_TLS_TRUSTSTORE_PASSWORD · PP_REDIS_TRUSTSTORE_PASSWORD · PP_MQ_TRUSTSTORE_PASSWORD werden aus dem Keystore-Passwort generiert und müssen nicht separat gesetzt werden.

Knoten · Adressen

Variable	Standardwert	Bedeutung	Vom Host änderbar
`PP_MODE`	`MASTER`	`MASTER` / `WORKER`. Für Worker wird `worker-add.sh` verwendet	Knotendatei
`PP_HOST_IP`	`10.99.0.100` (feste IP im Compose-Netzwerk)	Adresse dieses Containers. Grundlage für beworbene Adressen	`DOCKER_PP_IP`
`PP_MASTER_IP`	`PP_HOST_IP`	Adresse, unter der andere Boxen diese Datalake erreichen	Knotendatei
`PP_SERVICE_IP`	Leer	Öffentliche IP hinter NAT. Wird in TLS SAN eingefügt	Knotendatei `DOCKER_PP_EXTERNAL_IP`
`PP_KAFKA_ADVERTISED_HOST`	Bei Start hergeleitet	Adresse, die Kafka Clients ankündigt	Knotendatei (nur bei NAT oder sekundärer Schnittstelle)
`PP_CLUSTER_CORES`	Host-Kerne − 2 (4 bis 30)	Kernanzahl für Spark etc.	`DOCKER_PP_CLUSTER_CORES`
`PP_DATA_DISK_NAME`	Vom Host erkannt	Gerät zum Messen der Festplattennutzung	`DOCKER_PP_DATA_DISK_NAME`
`PP_DATA_DIR` · `PP_TEMP_DIR` · `PP_BACKUP_DIR`	`/data1/pp-data` · `/data1/pp-temp` · `/data1/pp-backup`	Einhängepunkte für Volumes	Nein (Compose-Literal)
`PP_LANG` · `PP_TZ`	`en` · `Asia/Seoul`	Sprache · Zeitzone	Sidecar

Speicher

Variable	Standardwert	Vom Host änderbar
`PP_REDIS_USER` · `PP_REDIS_PORT`	`redis` · `6379`	Nur Kontoname (nicht Port)
`PP_PG_USER` · `PP_POSTGRES_PORT` · `PP_DB_NAME`	`plantpulse` · `5432` · `pp`	Kontoname · DB-Name (nicht Port)
`PP_CASSANDRA_USER` · `PP_CASSANDRA_PORT` · `PP_KEYSPACE`	`cassandra` · `9042` · `pp`	Kontoname · Keyspace (nicht Port)
`PP_MINIO_USER` · `PP_MINIO_PORT` · `PP_MINIO_BUCKET`	`minio` · `9000` · `plantpulse`	Nur Kontoname
`PP_PG_REPLICA_USER`	`replica`	Sidecar

PP_KEYSPACE · PP_DB_NAME · PP_TOPIC_PREFIX sind Kennungen, die die Datalake erstellt und die App liest. Um sicherzustellen, dass beide die gleichen verwenden, befinden sie sich in der x-pp-secrets Verankerung des Compose. Wenn Sie diese nach der Installation ändern, wird ein neuer leerer Speicher mit dem neuen Namen erstellt, und alte Daten bleiben unter dem alten Namen erhalten.

Analyse · Messaging · Zeitreihen · Workflows

Variable	Standardwert	Vom Host änderbar
`PP_HIVE_USER` · `PP_HIVE_PORT` · `PP_HIVE_DB`	`hive` · `9083` · `hive-metastore-230`	Nur Kontoname
`PP_SPARK_USER` · `PP_SPARK_PORT` · `PP_SPARK_WEBUI_PORT` · `PP_KYUUBI_PORT`	`spark` · `7077` · `4440` · `10000`	Nur Kontoname
`PP_GRAVITINO_USER` · `PP_GRAVITINO_ICEBERG_REST_PORT`	`gravitino` · `19001`	Nur Kontoname
`PP_MQ_USER` · `PP_TOPIC_PREFIX`	`mq` · `pp`	Sidecar
`PP_KAFKA_PORT` · `PP_KAFKA_TLS_PORT` · `PP_KAFKA_CONTROLLER_PORT`	`9092` · `9094` · `9093`	Nein
`PP_MQTT_PORT` · `PP_MQTT_TLS_PORT`	`1883` · `1884`	Nein
`PP_TSE_USER` · `PP_TSE_PORT` · `PP_TSE_TLS_PORT` · `PP_TSE_PROTOCOL`	`tse` · `7800` · `7801` · `http`	Nur Kontoname
`PP_TSE_DATAPOINT_TTL`	`31536000` (365 Tage)	Nein — Template bearbeiten
`PP_TEMPORAL_USER` · `PP_TEMPORAL_PORT`	`temporal` · `7233`	Nur Kontoname
`PP_KESTRA_DB_USER` · `PP_KESTRA_ADMIN_EMAIL` · `PP_KESTRA_PORT`	`kestra` · `admin@plantpulse.io` · `8380`	Kontoname · E-Mail
`PP_CEP_PORT` · `PP_CEP_TLS_PORT` · `PP_CEP_PROTOCOL`	`7400` · `7401` · `http`	Nein
`PP_DATA_GATEWAY_PORT` · `PP_DATA_GATEWAY_TLS_PORT` · `PP_DATA_GATEWAY_PROTOCOL`	`5500` · `5501` · `http`	Nein

PP_TSE_DATAPOINT_TTL — Lebensdauer eines Zeitreihendatenpunkts

Die Zeitreihen-Engine schreibt diesen TTL bei jedem Schreibzugriff (INSERT … USING TTL). Wenn Sie den Wert ändern, gilt er also ab der nächsten geschriebenen Zeile, bereits geschriebene Zeilen verfallen nach dem alten Wert. Eine Erhöhung bringt sie nicht zurück; eine Senkung verkürzt sie nicht. Um sie zu ändern, bearbeiten Sie /etc/kopens/conf/plantpulse-timeseries-engine.conf.template.

Admin-Konsole · Abfrage-Konsole

Variable	Standardwert	Bedeutung	Vom Host änderbar
`PP_DATALAKE_ADMIN_USER`	`admin`	Admin-Konsole Benutzername	Sidecar
`PP_DATALAKE_ADMIN_PASSWORD`	Vom Sidecar gesetzt	Admin-Konsole Passwort. Wenn leer, nur die Konsole deaktiviert	`passwd.sh`
`PP_DATALAKE_ADMIN_API_KEY`	Keine	`X-API-Key` des Log-Endpunkts. Wenn leer, nur Authentifizierung mit Schlüssel deaktiviert	`passwd.sh`
`PP_DATALAKE_ADMIN_PORT`	`4949`	Listening-Port im Container. 4950 ist TLS für dieselbe Konsole	Nein
`PP_DATALAKE_ADMIN_LOGS_ENABLED`	`true`	Wenn `false`, nur der Konsolen-Log-Bildschirm geht aus	Sidecar
`PP_DATA_GATEWAY_WEB_USER` · `PP_DATA_GATEWAY_WEB_PASSWORD`	`admin` · Keine	Anmeldedaten der Datengateay-Konsole (SQL). Wenn leer, nur diese Konsole geschlossen	Sidecar
`PP_CEP_WEB_USER` · `PP_CEP_WEB_PASSWORD`	`admin` · Keine	CEP-Konsole Anmeldedaten. Wenn leer, nur diese Konsole geschlossen	Sidecar
`PP_BACKUP_SCHEDULE_ENABLED`	`true`	Globaler Schalter für Backup-Timer	Sidecar

Die restlichen Konsolenkonfigurationen PP_DATALAKE_ADMIN_PD_PATH · PP_DATALAKE_ADMIN_LOG_ROOT · PP_DATALAKE_ADMIN_BACKUP_HISTORY werden von Compose als Literale eingefügt. Sie müssen diese nicht ändern.

TLS

Variable	Standardwert	Bedeutung
`PP_TLS_ENABLED`	`true`	Master-Schalter
`PP_TLS_CERT_DIR`	`/var/security/plantpulse`	Zertifikatsverzeichnis
`PP_TLS_DOMAIN` · `PP_TLS_VALID_DAYS`	`plantpulse.io` · `3650`	Zertifikatsdomäne · Gültigkeitsdauer
`PP_TLS_SAN_IPS` · `PP_TLS_SAN_DNS`	Host-IP · Hostname	Zertifikat SAN. Muss die externe Zugriffs-IP enthalten
`PP_TLS_NODE_NAMES` · `PP_MAX_WORKERS`	`master worker-1 … worker-5` · `5`	Ein Zertifikat pro Worker. Beide müssen übereinstimmen, damit der Build erfolgreich ist

Die Zertifikate selbst werden vom plantpulse-certs Container erstellt → Sicherheitskonfiguration

Variablen, die mit `PD_` beginnen

PD_ sind Datalake-«lokale Variablen». Der Operator setzt nur zwei davon, die restlichen ~270 sind interne Skriptvariablen oder Image-Stempel.

Variable	Bedeutung
`PD_HOME`	Baum, in dem `pd` lebt. Vom Image definiert
`PD_OPTIONS`	Komponenten ein/aus JSON — `{"enable-hive": false}`. Weggelassene Schlüssel sind aktiviert. Der aktuelle Compose-Stack übergibt diesen Wert nicht an den Container → FAQ
`PD_IMAGE_TAG` · `PD_IMAGE_BUILD_VERSION` · `PD_IMAGE_BUILT_AT` · `PD_IMAGE_VCS_REF`	Image-Stempel. Nicht anfassen — `pd env` · `pd doctor` würden zu falschen Quellen führen

Secrets — was passiert, wenn sie fehlen​

Knoten · Adressen​

Speicher​

Analyse · Messaging · Zeitreihen · Workflows​

Admin-Konsole · Abfrage-Konsole​

TLS​

Variablen, die mit PD_ beginnen​

Verwandte Dokumentation​