跳到主要内容

服务运维

启动 / 停止 / 状态检查​

所有运维脚本均位于 bin/ 目录下。

cd /home/kopens/plantpulse-ai/bin

启动整个系统​

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

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

停止整个系统​

./stop.sh

按照 服务 → 数据库 的顺序安全停止。

状态检查​

./status.sh

输出示例:

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

如果有服务显示为 [DOWN],请检查该模块的日志。

单个模块运维​

各模块可独立启动/停止。

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

MCP 与本体(Ontology)工具由平台集成 MCP(server-web /api/v5/mcp)提供,因此不在 AI 技术栈中单独运维。

日志管理​

集成日志查看器​

实时查看所有服务的日志:

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

各日志位置​

服务日志文件
系统整体logs/application.log, logs/system.log
AI Chat Webweb/logs/system.log
TimeSeriestimeseries/logs/system.log
RAG (LightRAG)docker logs lightrag
安装logs/setup.log

日志清理​

磁盘空间不足时,清理日志及临时文件:

cd /home/kopens/plantpulse-ai/bin
./clean.sh
注意

clean.sh 会删除所有日志文件和临时缓存。请提前备份需要保留的日志。

故障处理​

某个服务处于 DOWN 状态时​

  1. 使用 status.sh 确认哪个服务处于 DOWN 状态
  2. 检查该模块的日志: tail -f <module>/logs/system.log
  3. 重启该模块:
cd /home/kopens/plantpulse-ai/<module>/bin
./stop.sh
./start.sh

重启整个系统​

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

检查端口冲突​

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

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