インストールおよび設定
インストールパス
PlantPulse AI のデフォルトインストールパスは次のとおりです:
/home/kopens/plantpulse-ai/
ディレクトリ構成
plantpulse-ai/
├── bin/ # 오케스트레이션 스크립트
│ ├── setup.sh # 초기 설치 (의존성, 모델 등)
│ ├── start.sh # 전체 시스템 시작
│ ├── stop.sh # 전체 시스템 종료
│ ├── status.sh # 서비스 상태 확인
│ ├── start-daemon.sh # 백그라운드 데몬 시작
│ ├── clean.sh # 로그/임시파일 정리
│ └── log-viewer.sh # 통합 로그 뷰어
├── template/
│ ├── env.sh # 환경 변수 설정 (핵심 설정 파일)
│ └── proxy.yaml # LiteLLM 프록시 설정
├── db/ # 데이터베이스
│ ├── postgres/ # PostgreSQL
│ ├── cassandra/ # Apache Cassandra
│ ├── neo4j/ # Neo4j
│ ├── qdrant/ # Qdrant 벡터 DB
│ ├── valkey/ # Valkey (Redis)
│ └── minio/ # MinIO (S3)
├── lib/ # AI 서비스
│ └── litellm/ # LLM 프록시 서버 (채팅 LLM 게이트웨이)
├── web/ # AI Chat Web (내장 에이전트)
│ ├── app/ # WAR 애플리케이션
│ ├── config/ # application.properties
│ ├── bin/ # 시작/종료 스크립트
│ └── logs/ # 웹 서비스 로그
├── timeseries/ # TimeSeries-Insight
│ ├── app/ # FastAPI 애플리케이션
│ ├── bin/ # 시작/종료 스크립트
│ ├── frontend/ # Next.js 대시보드
│ ├── tests/ # 테스트 코드
│ └── logs/ # 시계열 로그
├── logs/ # 중앙 집중식 로그
└── README.md # 프로젝트 설명
備考
2026-07 の改編により、MCP・オントロジーツールはプラットフォームの 統合 MCP(server-web /api/v5/mcp)へ移管され、RAG は LightRAG Docker compose サービスに置き換えられました。旧 mcp/・ontology/・rag/・component/(Langflow コンポーネント)ディレクトリおよび Langflow・Phoenix・Jupyter は使用されません。
初期インストール
Step 1. 環境変数の設定
インストール前に template/env.sh ファイルを環境に合わせて修正します:
vi /home/kopens/plantpulse-ai/template/env.sh
主な設定項目:
| 変数 | 説明 | デフォルト値 |
|---|---|---|
PP_SERVER_HOST | PlantPulse IIoT サーバー IP | 100.68.69.41 |
PP_SERVER_PORT | PlantPulse IIoT サーバーポート | 7443 |
PP_HOME | ホームディレクトリ | /home/kopens |
PP_DATA_DIR | データ保存パス | /data1/pp-data |
PP_TEMP_DIR | 一時ファイルパス | /data1/pp-temp |
Step 2. 依存パッケージのインストール
cd /home/kopens/plantpulse-ai/bin
./setup.sh
setup.sh は次の順序でインストールを行います:
- Python ライブラリ
- LiteLLM プロキシ(チャット LLM ゲートウェイ)
- LightRAG サービス(Docker compose)
- TimeSeries 分析モデル(IBM Granite TSPulse、TTM)
備考
インストールログは logs/setup.log に記録されます。
Step 3. システムの起動
# 포그라운드 실행
./start.sh
# 또는 백그라운드 데몬으로 실행
./start-daemon.sh
Step 4. 状態確認
./status.sh
正常に稼働している場合、すべてのサービスが [OK] 状態で表示されます。
起動順序
start.sh は次の順序でサービスを起動します:
第1段階: データベース
| 順序 | サービス | ポート | 待機時間 |
|---|---|---|---|
| 1 | Valkey (Redis) | 6379 | 3秒 |
| 2 | PostgreSQL | 5432 | 3秒 |
| 3 | Cassandra | 9042 | 20秒 |
| 4 | MinIO | 9000/9001 | 1秒 |
| 5 | Qdrant | 6333 | 1秒 |
| 6 | Neo4j | 7474/7687 | 1秒 |
データベースのポートがすべて応答するまで待機した後、次の段階へ進みます。
第2段階: Cassandra の初期化
Cassandra のキースペースを作成します(初回起動時)。
第3段階: AI サービス
| 順序 | サービス | 説明 |
|---|---|---|
| 1 | LiteLLM | LLM プロキシ(チャット LLM ゲートウェイ) |
| 2 | LightRAG | ドキュメント検索サーバー |
| 3 | TimeSeries | 異常検知/予測サービス |
備考
MCP・オントロジーツールはプラットフォーム統合 MCP(server-web /api/v5/mcp)から提供されるため、AI スタックでは個別に起動しません。
第4段階: Web サーバー
AI Chat Web サービスを起動します。チャット/エージェントのオーケストレーションはこのサービスに内蔵されています。
警告
停止する際は、起動の逆順でサービスを停止します: サービス → データベースの順です。