Skip to main content

Service Operations

Start / Stop / Status Check​

All operation scripts are located in the bin/ directory.

cd /home/kopens/plantpulse-ai/bin

Starting the Entire System​

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

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

Stopping the Entire System​

./stop.sh

Shuts down safely in the order of services → databases.

Status Check​

./status.sh

Example output:

--------------------------------------------------------------------
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
--------------------------------------------------------------------

If any service is shown as [DOWN], check the logs for that module.

Operating Individual Modules​

Each module can be started and stopped independently.

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 and ontology tools are provided by the platform's integrated MCP (server-web /api/v5/mcp), so they are not operated separately in the AI stack.

Log Management​

Integrated Log Viewer​

View the logs of all services in real time:

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

Individual Log Locations​

ServiceLog File
Entire systemlogs/application.log, logs/system.log
AI Chat Webweb/logs/system.log
TimeSeriestimeseries/logs/system.log
RAG (LightRAG)docker logs lightrag
Installationlogs/setup.log

Log Cleanup​

Clean up logs and temporary files when disk space runs low:

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

clean.sh deletes all log files and temporary caches. Back up any logs you need beforehand.

Fault Response​

When a Specific Service Is DOWN​

  1. Use status.sh to identify which service is DOWN
  2. Check the logs for that module: tail -f <module>/logs/system.log
  3. Restart that module:
cd /home/kopens/plantpulse-ai/<module>/bin
./stop.sh
./start.sh

Restarting the Entire System​

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

Checking for Port Conflicts​

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

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