モジュール別詳細マニュアル
PlantPulse プラットフォームは、複数の独立したモジュールで構成されています。モジュールとコンテナは 1:1 ではありません — アプリケーション6つは各々コンテナを持ち、データレイク系は plantpulse-datalake コンテナ1つの中で共存します。
データレイク系は別の最上位セクション データレイク にまとめられています — パス・設定ファイル・パスワード変更・管理コンソール・pd CLI・運用・コンポーネント(storage・messaging・analytics・timeseries・cep・workflow・data-gateway)・FAQ。
モジュール分類
モジュールカテゴリ
| カテゴリ | モジュール | 説明 |
|---|---|---|
| アプリケーション | server | ウェブコンソール、IIoTエンジン、REST API |
| batch | スケジュール済みバッチ処理 | |
| data-gateway | REST ベースのデータゲートウェイ | |
| sql | 廃止予定 (2026-09-07) — SQL コンソールは data-gateway に統合されました | |
| datalake-admin-api | 管理コンソールバックエンド + ヘルス API (4950 / 4949) | |
| warehouse | Iceberg ベースのデータウェアハウス | |
| 処理 | cep | 複合イベント処理 (Esper) |
| plugin | OPC-UA / AAS 産業標準プラグイン | |
| timeseries | 時系列エンジン + ビジュアライゼーション UI | |
| メッセージング | messaging | Kafka + MQTT(HiveMQ)。STOMP(ActiveMQ)は廃止されました |
| ストレージ | storage | Cassandra + PostgreSQL + Valkey + MinIO |
| 分析 | analytics | Spark + Hive + Kyuubi + Gravitino + Hadoop |
| ワークフロー | workflow | Temporal + Kestra |
| データレイク運用 | pd CLI | 起動/停止/再起動・設定・ノード管理の単一エントリーポイント |
| データレイク運用 | 管理コンソール | ブラウザ運用コンソール (4950 / 4949) |
| utilities | setup、backup、recovery、exporter、migrator、mirror-maker、simulator、api、lab |
モジュール共通構造
各サービスモジュールは共通のディレクトリ構造と運用インターフェースに従います。
plantpulse-<module>/
├── app/ # 애플리케이션 WAR / JAR
├── bin/
│ ├── start.sh # 포그라운드 시작
│ ├── stop.sh # 정지
│ └── log-viewer.sh # 실시간 로그 (tail -F)
├── server/ 또는 lib/ # 내장 Tomcat 서버 또는 JAR
├── logs/ # system.log (메인 로그)
└── conf/ 또는 config/ # 설정 파일
共通運用コマンド
ホストから — スタック全体を扱います (/opt/kopens/plantpulse-platform-docker/bin/)。
| 作業 | コマンド | 備考 |
|---|---|---|
| 全体起動 | up.sh | 準備完了まで待機。0 = 利用可能 |
| 全体停止 | down.sh | 依存順序の逆順、状態保存 |
| 全体再起動 | restart.sh | ドレイン → 停止 → 起動 → 準備待機 |
| アプリ単体再起動 | docker compose -f compose/docker-compose.yml restart <서비스> | アプリは各々コンテナ |
| 状態確認 | status.sh | 0 = 正常 / 2 = 異常 |
| 統合ログ | logs.sh | 引数なしなら全コンテナ。-f で追尾 |
データレイク コンテナ内から — インフラコンポーネントを個別に扱います (./shell.sh で進入)。
| 作業 | コマンド |
|---|---|
| サービス状態 | ./pd status [서비스] |
| サービス再起動 | ./pd restart <서비스> |
| 設定レンダリング | ./pd config render |
| Cassandra ノード | ./pd node status · ./pd node repair … |
| 診断 | ./pd doctor |
モジュール依存関係
PlantPulse は依存関係の順序に従ってフェーズごとに起動されます。モジュール単位の再起動時に依存関係を認識する必要があります。
再起動時の注意: インフラモジュール(storage / messaging / analytics)を再起動すると、これに依存するすべてのアプリケーションも一緒に再起動する必要があります。ホストから
bin/restart.shでスタック全体を再起動するのが最も安全です。
ポートマッピング概要
| 領域 | ポート | モジュール |
|---|---|---|
| 外部公開 | 80 / 443 | server (HTTP / HTTPS) |
| 外部公開 | 7443 | server (管理コンソール HTTPS) |
| 外部公開 | 4950 | monitor (ヘルスチェック、HTTPS) |
| メッセージング | 9092 / 9093 / 9094 | messaging (Kafka) |
| メッセージング | 1883 / 1884 | messaging (MQTT) |
| ストレージ | 9042 | storage (Cassandra) |
| ストレージ | 5432 | storage (PostgreSQL) |
| ストレージ | 6379 | storage (Valkey) |
| ストレージ | 9000 / 9001 | storage (MinIO) |
| 分析 | 7077 / 4440 | analytics (Spark Master / UI) |
| 分析 | 10000 | analytics (Kyuubi) |
| 分析 | 19001 | analytics (Gravitino) |
| 分析 | 9083 | analytics (Hive Metastore) |
| 時系列 | 7800 / 7801 | timeseries (Engine) |
| 時系列 | 3000 | timeseries (UI) |
| ワークフロー | 7233 / 8233 | workflow (Temporal) |
| ワークフロー | 8380 | workflow (Kestra) |
| 処理 | 7400 / 7401 | cep |
| 処理 | 5500 | data-gateway |
| 処理 | 11004 / 11005 | plugin (OPC-UA) |
| 処理 | 8007 / 8090 | plugin (AAS V2 / V3) |
| アプリケーション | 9500 | batch |
| アプリケーション | 9600 | warehouse |
| アプリケーション | 4000 | sql |
全ポートはポート設定情報ページをご参照ください。
テクニカルサポート
モジュール別の運用に関するお問い合わせは、webmaster@kopens.com にお願いします。