Zum Hauptinhalt springen

Servicebetrieb

Start / Stopp / Statusprüfung

Alle Betriebsskripte befinden sich im Verzeichnis bin/.

cd /home/kopens/plantpulse-ai/bin

Gesamtsystem starten

# 포그라운드 실행 (터미널에 로그 출력)
./start.sh

# 백그라운드 데몬 실행 (SSH 종료 후에도 유지)
./start-daemon.sh

Gesamtsystem stoppen

./stop.sh

Der Stopp erfolgt sicher in der Reihenfolge Dienste → Datenbanken.

Statusprüfung

./status.sh

Beispielausgabe:

--------------------------------------------------------------------
PLANTPULSE AI - STATUS
--------------------------------------------------------------------

<DATABASE>
[OK] VALKEY(REDIS) (6379)
[OK] POSTGRES (5432)
[OK] CASSANDRA (9042)
[OK] MINIO (9001)
[OK] QDRANT (6333)
[OK] NEO4J (7687)

<AI / LIB SERVICES>
[OK] LITELLM (4000)

<RAG/TIMESERIES>
[OK] LIGHTRAG (7114)
[OK] TIMESERIES (8970)

<WEB SERVER>
[OK] WEB (80)

--------------------------------------------------------------------
STATUS CHECK COMPLETED
--------------------------------------------------------------------

Wird ein Dienst als [DOWN] angezeigt, prüfen Sie die Logs des betreffenden Moduls.


Betrieb einzelner Module

Jedes Modul kann unabhängig gestartet und gestoppt werden.

AI Chat Web

cd /home/kopens/plantpulse-ai/web/bin
./start.sh # 시작
./stop.sh # 종료
./log-viewer.sh # 로그 확인

TimeSeries-Insight

cd /home/kopens/plantpulse-ai/timeseries/bin
./start.sh
./stop.sh
./log-viewer.sh

RAG (LightRAG)

# LightRAG는 Docker compose 서비스로 기동됩니다
docker compose up -d lightrag
docker compose stop lightrag
docker logs -f lightrag
info

MCP- und Ontologie-Werkzeuge werden vom integrierten Plattform-MCP (server-web /api/v5/mcp) bereitgestellt und daher nicht separat im AI-Stack betrieben.


Logverwaltung

Integrierter Log-Viewer

Logs aller Dienste in Echtzeit anzeigen:

cd /home/kopens/plantpulse-ai/bin
./log-viewer.sh

Speicherorte der einzelnen Logs

DienstLogdatei
Gesamtsystemlogs/application.log, logs/system.log
AI Chat Webweb/logs/system.log
TimeSeriestimeseries/logs/system.log
RAG (LightRAG)docker logs lightrag
Installationlogs/setup.log

Logs bereinigen

Bei knappem Speicherplatz Logs und temporäre Dateien bereinigen:

cd /home/kopens/plantpulse-ai/bin
./clean.sh
warnung

clean.sh löscht alle Logdateien und temporären Caches. Sichern Sie benötigte Logs vorab.


Störungsbehebung

Wenn ein bestimmter Dienst DOWN ist

  1. Mit status.sh prüfen, welcher Dienst DOWN ist
  2. Logs des betreffenden Moduls prüfen: tail -f <module>/logs/system.log
  3. Betreffendes Modul neu starten:
cd /home/kopens/plantpulse-ai/<module>/bin
./stop.sh
./start.sh

Gesamtsystem neu starten

cd /home/kopens/plantpulse-ai/bin
./stop.sh
./start.sh

Portkonflikte prüfen

# 특정 포트 사용 확인
ss -tlnp | grep <port-number>

# 예: LightRAG 포트 확인
ss -tlnp | grep 7114