メインコンテンツまでスキップ

サービス運用

起動 / 停止 / 状態確認​

すべての運用スクリプトは 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・オントロジーツールはPlatform統合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