管理者ガイド
何をしようとしてここに来ましたか
| 行いたいこと | 読むべき場所 |
|---|---|
| 起動・停止・再起動 | 起動と停止 |
| 状態確認・監視 | モニタリング |
| バックアップとリカバリ練習 | バックアップとリカバリ |
| パスワード・APIキーの変更 | クレデンシャルローテーション |
| ユーザー・権限管理 | ユーザー管理 |
| セキュリティ点検 | セキュリティ |
| 動作が遅くなったとき | パフォーマンスチューニング |
| 仮想タグの計算が動作しないとき | 仮想タグ運用 |
| データの蓄積量・削除タイミング | データ保存ポリシー |
| ファイアウォールの開放ポート | ポート |
| OEE · RAM · EMS の数値で迷ったとき | OEE · RAM · EMS よくある質問 |
| 設定値を探すとき | プロパティリファレンス |
| テーブル・スキーマを確認するとき | データベースモデル |
| 冗長化構成 | HA |
| バージョンアップ — 手順 | アップグレード |
| バージョンアップ時・連携機能の修正 | アップグレードノート |
| モジュールの分割構成 | モジュール詳細 · 下記モジュールマップ |
モジュールマップ
PlantPulse Platform は、複数の独立したモジュールで構成されています。モジュールとコンテナは 1:1 ではありません — アプリケーション系はそれぞれコンテナを持ち、データレイク系は plantpulse-datalake コンテナ 1 つの中で共に動作します。
データレイク系は、別途最上位セクション データレイク にまとめられています — パス · 設定ファイル · パスワード変更 · 管理コンソール · pd CLI · 運用 · コンポーネント (storage · messaging · analytics · timeseries · cep · workflow · data-gateway) · FAQ.
モジュール分類
モジュリカテゴリ
| カテゴリ | モジュール | 説明 |
|---|---|---|
| アプリケーション | server | ウェブコンソール, IIoT エンジン, REST API |
| batch | スケジュールバッチ処理 | |
| data-gateway | REST ベース データゲートウェイ | |
| datalake-admin-api | 管理コンソールバックエンド + ヘルス API (4950 / 4949) | |
| warehouse | Iceberg ベース データウェアハウス | |
| 処理 | cep | 複合イベント処理 (Aster CEP) |
| plugin | OPC-UA / AAS 産業標準プラグイン | |
| timeseries | 時系列エンジン + 可視化 UI | |
| メッセージング | messaging | Kafka + MQTT(HiveMQ). STOMP(ActiveMQ) は廃止されました |
| ストレージ | storage | Aster TSDB + PostgreSQL + Valkey + RustFS |
| 分析 | 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 | drain → 停止 → 起動 → 準備待機 |
| アプリ単体再起動 | docker compose -f compose/docker-compose.yml restart <서비스> | アプリはそれぞれ個別コンテナ |
| 状態点検 | status.sh | 0 = 正常 / 2 = 異常 |
| 統合ログ | logs.sh | 引数なしの場合は全コンテナ。-f で追跡 |
データレイクコンテナ内で — インフラコンポーネントを個別に操作します (./shell.sh で進入)。
| 作業 | コマンド |
|---|---|
| サービス状態 | ./pd status [서비스] |
| サービス再起動 | ./pd restart <서비스> |
| 設定レンダリング | ./pd config render |
| Aster TSDB ノード | ./pd node status · ./pd node repair … |
| 診断 | ./pd doctor |
モジュール依存関係
PlantPulse は、依存関係の順序に従って段階的に起動します。モジュール単位の再起動時には、依存関係を把握しておく必要があります。
再起動時の注意: インフラモジュール (storage / messaging / analytics) を再起動する場合、それに依存するすべてのアプリケーションも併せて再起動する必要があります。ホストから
bin/restart.shを使用してスタック全体を再起動するのが最も安全です。
ポートマッピング要約
| 領域 | ポート | モジュール |
|---|---|---|
| 外部公開 | 80 / 443 | server (HTTP / HTTPS) |
| 外部公開 | 4950 | monitor (ヘルスチェック, HTTPS) |
| メッセージング | 9092 / 9093 / 9094 | messaging (Kafka) |
| メッセージング | 1883 / 1884 | messaging (MQTT) |
| ストレージ | 9042 | storage (Aster TSDB) |
| ストレージ | 5432 | storage (PostgreSQL) |
| ストレージ | 6379 | storage (Valkey) |
| ストレージ | 9000 / 9001 | storage (RustFS) |
| 分析 | 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 までご連絡ください。