본문으로 건너뛰기

서비스 운영

시작 / 종료 / 상태 확인​

모든 운영 스크립트는 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·온톨로지 도구는 플랫폼 통합 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 <모듈>/logs/system.log
  3. 해당 모듈 재시작:
cd /home/kopens/plantpulse-ai/<모듈>/bin
./stop.sh
./start.sh

전체 시스템 재시작​

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

포트 충돌 확인​

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

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