Zum Hauptinhalt springen

FAQ

Hier finden Sie Antworten auf häufig gestellte Fragen von Benutzern, die die PlantPulse Platform betreiben. Für detailliertere Anleitungen besuchen Sie bitte die Seite Fehlerbehebung.

Installation / Lizenz​

F. Welche Installationsmethode sollte ich wählen?​

A. Die One-Line-Installation ist der Standard. Mit einem einzigen Befehl werden das OS-Setup, die Firewall und der Start der Container erledigt; Updates und Rollbacks erfolgen mit demselben Tool. Für Air-Gap-Netzwerke lesen Sie bitte das Air-Gap-Verfahren für die Docker-Installation und für die Installation auf Kubernetes das Kapitel Kubernetes-Installation.

F. Kann die Installation auch in einem Air-Gap-Netzwerk erfolgen?​

A. Ja, das ist möglich. Erstellen Sie auf einem mit dem Internet verbundenen Knoten ein Bundle mit ./airgap-bundle.sh, übertragen Sie dieses per USB oder internem Dateiserver in das Air-Gap-Netzwerk und führen Sie anschließend ./airgap-load.sh aus. Die detaillierten Schritte finden Sie im Abschnitt Docker-Installation - Air-Gap-Installation.

F. Wie erhalte ich eine Lizenz?​

A. Die Anmeldedaten für die Image-Registry und die Lizenzen werden vom KOPENS-Betriebsteam ausgestellt. Bitte wenden Sie sich an webmaster@kopens.com.

F. Wie sehen die Mindest- und empfohlenen Anforderungen aus?​

A. Basierend auf einem einzelnen Knoten:

KategorieMinimumEmpfohlen
CPU16 vCPU32 vCPU
Arbeitsspeicher128GB (Datalake Master ≥ 96GB, 64GB wird nicht unterstützt)256GB
Festplatte200GB1TB+ (je nach Datenmenge)
OSRHEL · Rocky · Oracle Linux 8/9/10 · Ubuntu 22.04+ · Amazon Linux 2023Identisch

Detaillierte Spezifikationen finden Sie auf der Seite Systemanforderungen.

F. Welche Betriebssysteme werden unterstützt?​

A. Die One-Line-Installation wird auf folgenden Betriebssystemen unterstützt:

  • RHEL · Rocky Linux · Oracle Linux 8.x · 9.x · 10.x
  • Ubuntu 22.04 oder höher
  • Amazon Linux 2 · 2023

Auf nicht verifizierten Betriebssystemen kann das OS-Setup mit der Option SKIP_OS=1 übersprungen und ein manuelles Setup durchgeführt werden.

F. Kann der Betrieb auch mit Podman erfolgen?​

A. Ja, das ist möglich. Wenn Sie DOCKER_CMD="docker" in bin/env.sh zu DOCKER_CMD="podman" ändern, funktionieren alle Skripte mit Podman.

Installation / Start​

F. Wie lange dauert die Installation?​

A. Bei der One-Line-Installation dauert es etwa 10–20 Minuten (je nach Netzwerkgeschwindigkeit) vom OS-Setup + Docker-Installation + Image-Download + Container-Start. Der anschließende interne Bootvorgang der Container nimmt weitere 3–5 Minuten in Anspruch (Aster TSDB Schema-Migration + JVM Warm-up).

F. Über welche Adresse greife ich nach der Installation zu?​

A. Bitte rufen Sie im Browser die folgende Adresse auf:

http://[서버IP]/
  • Der Proxy-Container öffnet einen einzigen Port 80. Es gibt keinen separaten Port für die Management-Konsole.
  • [서버IP] ist die Serveradresse, die Sie bei der Installation angegeben haben.
  • Standard-Administrator-Konto: admin / admin123!
  • Bitte ändern Sie das Passwort unbedingt nach dem ersten Login.

F. Ich habe gestartet, aber der Health-Status wird als „unhealthy“ angezeigt.​

A. Der Bootvorgang dauert 3–5 Minuten. Wenn der Status nach 5 Minuten immer noch „unhealthy“ ist, lesen Sie bitte Fehlerbehebung - Probleme beim Container-Start.

F. Ich habe env.sh geändert, aber die Änderung wird nicht übernommen.​

A. Änderungen an env.sh werden nur zum Zeitpunkt des Bootens übernommen. Damit diese wirksam werden, muss das System mit dem folgenden Befehl neu gestartet werden:

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

F. Wie stelle ich ein, dass das System nach einem Server-Neustart automatisch startet?​

A. Da die Container mit der --restart unless-stopped-Richtlinie ausgeführt werden, starten sie automatisch mit, sobald der Docker-Daemon startet. Der Docker-Daemon selbst ist so konfiguriert, dass er beim Booten über systemctl enable docker automatisch startet.

Betrieb / Verwaltung​

F. Wie starte, stoppe oder starte ich die Platform neu?​

A. Auf dem Host in /opt/kopens/plantpulse-platform-docker/bin/:

./up.sh              # 기동 — 준비될 때까지 대기 (종료 코드 0 = 쓸 수 있다)
./down.sh            # 중지 (데이터 보존)
./restart.sh         # 재시작 (graceful drain + 준비 대기)
./status.sh          # 상태 요약 (0 = 정상 / 2 = 비정상)

Weitere Details finden Sie auf der Seite Startguide.

F. Kann ich einzelne Komponenten neu starten, ohne das gesamte System neu zu starten?​

A. Ja, das ist möglich. Die Methode unterscheidet sich jedoch, ob es sich um eine App oder die Infrastruktur handelt.

Da die sechs Apps jeweils in eigenen Containern laufen, entspricht das Neustarten des jeweiligen Containers einem Neustart der App.

cd /opt/kopens/plantpulse-platform-docker
docker compose -f compose/docker-compose.yml restart plantpulse-server-web

Infrastrukturkomponenten wie Storage, Analyse oder Messaging laufen gemeinsam im Datalake-Container. Hierfür müssen Sie in den Container wechseln und die einzelnen Skripte verwenden.

./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd restart storage
exit

Eine detaillierte Liste finden Sie im Startguide — Neustart einzelner Komponenten.

F. Wo kann ich die Logs einsehen?​

A. Sie können die Standard-Logs der Container auf dem Host einsehen sowie detaillierte Modul-Logs innerhalb der Container.

# 전체 컨테이너 로그를 한 화면에 (서비스 이름 접두, 시간순)
./logs.sh

# 특정 컨테이너만
./logs.sh plantpulse-server-web -n 200

# 데이터레이크 안 컴포넌트 로그 파일
./logs.sh cassandra

# 볼 수 있는 대상 전체 목록
./logs.sh --list

# 모듈별 로그를 호스트로 한 번에 복사
./tools/copy-log-to-local.sh
Wenn unklar ist, welcher Container das Problem verursacht

Da es acht Container gibt, ist es leicht, die Ursache zu übersehen, wenn man nur ein Log betrachtet. ./logs.sh ohne Argumente zeigt die Logs aller acht Container chronologisch gemischt an.

F. Wie führe ich ein Backup durch?​

A. Backups auf Ebene der Docker-Volumes sind als tar.gz möglich.

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

./backup.sh                                              # 기본 세트 (pp-data · pp-security)
./tools/backup-volume.sh pp-data 7 /data1/pp-backup/docker-volume   # 볼륨 하나만

Informationen zu empfohlenen Backup-Intervallen finden Sie unter Betriebsverwaltung - Backup und Wiederherstellung.

F. Wie aktualisiere ich auf eine neue Version?​

A. Führen Sie den Installations-Oneliner erneut auf demselben Server aus (ohne vorheriges Löschen oder Bereinigen). Die neuen Betriebs-Skripte, die Compose-Datei und die Images werden aktualisiert, während die Daten in den Volumes erhalten bleiben.

sudo -i
curl -fsSL https://product.kopens.io/plantpulse-platform/install.sh | bash

./update.sh ist kein offizielles Verfahren — dabei werden nur die Images ersetzt, wodurch neue Dienste der Version nicht erkannt werden. Informationen zu Backup- und Verifizierungsmethoden finden Sie unter Upgrade.

F. Wie führe ich ein Rollback durch, wenn nach einem Update Probleme auftreten?​

A. Der Oneliner sichert den Stack unmittelbar vor dem Upgrade. Schlägt das Upgrade fehl, wird automatisch auf die vorherige Version zurückgesetzt (einschließlich der Daten zum Zeitpunkt des Backups — Daten, die während der Zeit der neuen Version eingingen, gehen verloren). Beheben Sie die Ursache und führen Sie den Oneliner erneut aus. Wenn das Upgrade erfolgreich war, Sie aber später dennoch zurücksetzen müssen, verwenden Sie bin/upgrade-rollback.sh <백업 위치> — Upgrade.

F. Kann ich Worker-Knoten hinzufügen, um einen Cluster zu konfigurieren?​

A. Ja, das ist möglich. Die Referenzliste der Worker ist compose/workers.roster, und das Hinzufügen erfolgt über ein spezielles Skript.

cd /opt/kopens/plantpulse-platform-docker/bin
bin/worker-add.sh          # 빈 id·주소 자동 선택 (링 합류까지 확인합니다)

Weitere Details finden Sie auf der Seite Cluster-Installation.

F. Wie erhöhe ich den Arbeitsspeicher der Container?​

A. Bearbeiten Sie DOCKER_PP_MEMORY in env.sh und führen Sie anschließend einen der folgenden Befehle aus:

./restart.sh
Legen Sie zuerst fest, um welchen Container es sich handelt

Jeder Container hat separate Grenzwerte. Für den Datalake gilt DOCKER_DATALAKE_MEMORY (Standard 96G), für Apps gibt es dienstspezifische Variablen wie DOCKER_SERVER_MEMORY · DOCKER_BATCH_MEMORY → Referenz für Umgebungsvariablen

Überprüfen Sie mit docker stats --no-stream, welcher Container das Limit erreicht hat.

Daten / Leistung​

F. Wo werden die Daten gespeichert?​

A. Sie werden in den Docker-Volumes des Hosts gespeichert.

VolumeZweck
pp-dataHauptdaten (Aster TSDB, PostgreSQL, RustFS)
pp-tempTemporäre Verarbeitungsdateien
pp-backupEigene Backups
pp-securityZertifikate / Schlüssel
pp-templateTemplate-Daten

Der tatsächliche Host-Pfad ist /data1/docker-data/volumes/ (änderbar über DOCKER_DATA_DIR in env.sh).

F. Bleiben die Daten erhalten, wenn die Container entfernt werden?​

A. Ja, ./remove.sh entfernt nur die Container, während die Volumes erhalten bleiben. Bei einer Neuinstallation können die alten Daten wieder verwendet werden. Um auch die Volumes vollständig zu entfernen, muss ./tools/remove-all-volumes.sh ausgeführt werden.

F. Kann die Datenaufbewahrungsdauer angepasst werden?​

A. Die Aufbewahrungsdauer von Zeitreihendaten kann über die Aster TSDB TTL-Einstellungen angepasst werden. Dies ist über die Systemkonfiguration in der Konsole oder in den Properties möglich. Weitere Details finden Sie unter Leistungsoptimierung und in der Properties-Referenz.

F. Die Antwortzeiten sind langsamer geworden. Wie diagnostiziere ich das?​

A. Bitte prüfen Sie die folgenden Punkte in dieser Reihenfolge:

# 1. 컨테이너 자원 사용량
docker stats --no-stream

# 2. 호스트 부하
top
df -h

# 3. critical 로그 확인
./ops-check.sh

# 4. Cassandra 컴팩션 / 디스크 I/O
./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node compactionstats

Weitere Informationen zur Feinabstimmung finden Sie auf der Seite Leistungsoptimierung.

F. Die Festplattenbelegung von Aster TSDB ist zu hoch.​

A. Sie können diese mit dem folgenden Befehl bereinigen:

./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node cleanup      # 불필요 데이터 정리
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node compact      # 수동 컴팩션

Prüfen Sie langfristig eine Anpassung der Aufbewahrungsdauer (TTL) oder eine Erweiterung des Festplattenplatzes.

Sicherheit / Benutzer​

F. Wie lautet das Standardpasswort und wo kann ich es ändern?​

A. Das Standard-Administrator-Konto ist admin / admin123!. Bitte ändern Sie das Passwort sofort nach dem Login über das Benutzer-Icon oben rechts > Menü «Passwort ändern».

Passwörter für Service-Konten (Datenbank, Messaging etc.) werden über die Variable PP_*_PASSWORD in bin/env.sh verwaltet und bei der Erstinstallation in /etc/kopens/plantpulse-platform.env gespeichert (Modus 0600).

Pfadprüfung — Die Referenz des Secret-Sidecars ist ausschließlich /etc/kopens/plantpulse-platform.env (Berechtigung 0600). In alten Installationen könnten unter /opt/kopens/ Dateien gleichen Namens existieren; diese werden jedoch nicht gelesen, und das Installationsskript setzt diese auf die Referenz zurück → Referenz für Umgebungsvariablen

F. Wie funktioniert die Benutzer- und Berechtigungsverwaltung?​

A. Benutzer, Rollen und Berechtigungen können im Menü Sicherheitsverwaltung der Konsole verwaltet werden. Weitere Details finden Sie auf den Seiten Benutzerverwaltung und Sicherheitseinstellungen.

F. Wie ändere ich die HTTPS-Zertifikate?​

A. Zertifikate werden im Volume pp-security gespeichert. Ein regelmäßiger Austausch wird empfohlen. Die detaillierten Schritte finden Sie auf der Seite Sicherheitseinstellungen.

F. Welche Ports müssen nach außen geöffnet werden?​

A. Für den Zugriff durch Benutzer oder externe Systeme wird empfohlen, nur die Ports 80, 443, 4950 zu öffnen. Wenn Anlagen direkt verbunden werden, fügen Sie 1883/1884 (MQTT) und 11004/11005 (OPC-UA) hinzu. Alle anderen Ports (DB, Kafka, Cluster, JMX) sollten auf den Zugriff aus privaten Netzwerken beschränkt werden. Eine detaillierte Liste finden Sie unter Port-Konfigurationsinformationen.

Der Health-Status und die Management-Konsole sind sowohl über 4950 (HTTPS) als auch über 4949 (Klartext) erreichbar. Da 4949 Klartext ist, verwenden Sie in nicht vertrauenswürdigen Netzwerken bitte 4950.

F. Wie wird die Kommunikation zwischen Knoten in einer Multi-Node-Umgebung geschützt?​

A. Für die interne Cluster-Kommunikation (JGroups, Aster TSDB, Kafka) wird automatisch eine Quellbeschränkung angewendet, sodass der Zugriff nur aus RFC 1918 privaten Netzwerken (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) und dem Tailscale CGN-Bereich (100.64.0.0/10) möglich ist.

Mehrsprachigkeit / Zeitzone​

F. Kann das System mit englischer Benutzeroberfläche betrieben werden?​

A. Ja, das ist möglich. Führen Sie in env.sh Folgendes aus:

export PP_LANG=en
export PP_TZ=America/New_York   # 운영 지역 타임존

Danach ./restart.sh. Beachten Sie jedoch: Da Aster TSDB Zeitreihendaten im KST-Epoch-Format lädt, muss bei einem Betrieb in Korea unbedingt PP_TZ=Asia/Seoul beibehalten werden.

F. Kann PlantPulse die Sprache der Benutzeroberfläche (Koreanisch/Englisch) pro Benutzer umschalten?​

A. Nein. Die Platform verwendet ein Modell mit einem einzigen Locale pro Server-Instanz. Dies wird zum Booten der JVM über eine Umgebungsvariable festgelegt; ein individueller Toggle pro Benutzer wird nicht unterstützt. Bitte betreiben Sie koreanische Boxen mit ko und globale Boxen mit en.

Anbindung externer Systeme​

F. Wie verbinde ich mich mit einem OPC-UA-Server?​

A. Registrieren Sie die OPC-UA-Serverinformationen (URL, Authentifizierung, Sicherheitsrichtlinie) im Menü Verbindungsverwaltung der Konsole und mappen Sie die zu erfassenden Tags. Die detaillierte Anleitung finden Sie auf der Seite Verbindungsverwaltung.

F. Wie sende ich Daten von einem MQTT-Gerät?​

A. Verbinden Sie sich mit dem MQTT-Broker (HiveMQ) über die Host-IP auf Port 1883 (PLAINTEXT) oder 18884 (TLS). Die Authentifizierungsdaten befinden sich in env.sh unter PP_MQ_USER / PP_MQ_PASSWORD.

F. Wie binde ich externe Systeme über eine API an?​

A. Alle Funktionen werden auch als REST API bereitgestellt. Bitte beachten Sie den Developer Guide - API-Handbuch.

Monitoring / Alarme​

F. Wie binde ich den Status der Platform in ein externes Monitoring-System ein?​

A. Health-Endpunkte und ops-check-Ergebnisse können vom Monitoring-System per Polling abgefragt werden.

# Healthcheck 엔드포인트 (모니터링용)
curl -kfsS https://[서버IP]:4950/api/health

# 운영 health + critical log (스크립트 호출)
ssh root@[서버IP] /opt/kopens/plantpulse-platform-docker/bin/ops-check.sh

Weitere Details finden Sie auf der Seite System-Monitoring.

F. Kann ich Alarme per E-Mail oder SMS erhalten?​

A. E-Mails werden über SMTP-Einstellungen unterstützt. Aktivieren Sie für jeden Alarm im Menü «Alarmeinstellungen» unter Externer Weiterleitungskanal die Optionen E-Mail-Versand und SMS-Versand (SMS wird nur gesendet, wenn ein Gateway konfiguriert ist). Wer den Alarm tatsächlich erhalten hat, wird im Empfänger-Panel der Alarm-Details protokolliert. Die Anbindung an Messenger (z. B. Slack) ist über externe Webhooks oder die Flow-Engine konfigurierbar.

Support / Kontakt​

F. Wo finde ich Hilfe?​

A. Bitte prüfen Sie zuerst die folgenden Ressourcen:

Sollten diese Ressourcen nicht ausreichen, wenden Sie sich bitte an webmaster@kopens.com und fügen Sie den Diagnose-Tarball bei.

F. Welche Informationen muss ich mitsenden?​

A. Bitte beachten Sie den Abschnitt Fehlerbehebung - Benötigte Informationen für Support-Anfragen. Der durch ./doctor.sh erstellte Diagnose-Tarball enthält die meisten erforderlichen Informationen (sensible Daten wie Passwörter werden automatisch maskiert).

F. Wo finde ich die aktuelle Dokumentation?​

A. Die aktuellste Dokumentation finden Sie unter https://kopens.gitbook.io/plantpulse-platform/.