運用 — 一覧
ゲートウェイサーバーへ SSH 接続した 管理者 (root) が実行する運用スクリプト集です。一般ユーザーは Web UI だけで十分ですが、起動 / 停止 / バックアップ / アップグレード / 障害診断 といった運用作業はこれらのスクリプトで実施します。
コンテナモード (2026.05+) は別ガイド
systemctl is-active plantpulse-edge.service が active ならコンテナモードです。
本ページの native スクリプト (bin/start.sh など) ではなく、コンテナモード ページの
/opt/kopens/install/bin/*.sh コマンドを使用してください。本ページは native 配置ボックス専用です。
インストールパス (native):
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
一覧
| 分類 | スクリプト | 概要 | 所要時間 |
|---|---|---|---|
| 起動 | start.sh | ゲートウェイ スタック全体 の起動 | 約90〜120秒 |
start-daemon.sh | start.sh を nohup でバックグラウンド実行 | 即時 | |
| 停止 | stop.sh | モジュール単位の全停止 (各コンポーネント最大20秒、Cassandra drain を含む) | 約60〜90秒 |
| 再起動 | restart.sh | Tomcat のみ 再起動 — 無停止、最も使用頻度が高い | 約6秒 |
reboot.sh | OS 再起動 | — | |
| バックアップ | backup.sh | 設定 + DB snapshot + ツールデータの一括バックアップ | 数分 |
| アップグレード | upgrade.sh | バックアップ → 新バージョンのダウンロード / インストール | 5〜15分 |
firmware.sh | OS パッケージ更新 (dnf update) | 数分 | |
| 診断 | log-viewer.sh | 7コンポーネントのログを統合 tail -f | 無限 |
ps.sh | 稼働中の plantpulse プロセス | 即時 | |
node-info.sh | nodetool info (Cassandra 状態) | 即時 | |
node-cql.sh | Cassandra cqlsh 対話モード | — | |
network-speed-test.sh | 外部ネットワークの速度測定 | 数分 | |
| クリーンアップ | clean.sh | ログ / 一時ファイルの一括削除 | 即時 |
node-cleanup.sh | Cassandra のディスク回収 | 数分 | |
| シナリオ | — | 新バージョン配置 / 障害診断 / ディスク不足 / 定期バックアップ / 災害復旧のランブック | — |
最も使用頻度の高いコマンド
開発 / 配置サイクルで ほぼ毎回使用 するのは restart.sh (Tomcat のみ、6秒) です。start.sh は OS 再起動後に一度、stop.sh は点検・バックアップの直前のみです。
サブコンポーネント個別の start.sh / stop.sh
全体スクリプト (start.sh、stop.sh) は順序制御のみを行い、内部実装は コンポーネント別 スクリプトが担当します。1つだけ再起動 したい場合は直接呼び出します:
| コンポーネント | 起動 | 停止 |
|---|---|---|
| Redis (cache) | $PE_HOME/cache/bin/start.sh | $PE_HOME/cache/bin/stop.sh |
| Cassandra (DB) | $PE_HOME/db/bin/start.sh | $PE_HOME/db/bin/stop.sh |
| HiveMQ (MQTT) | $PE_HOME/mqtt/bin/start.sh | $PE_HOME/mqtt/bin/stop.sh |
| timeseries-engine | $PE_HOME/timeseries/engine/bin/start.sh | $PE_HOME/timeseries/engine/bin/stop.sh |
| timeseries-dashboard | $PE_HOME/timeseries/dashboard/bin/start.sh | $PE_HOME/timeseries/dashboard/bin/stop.sh |
| Tomcat (server) | $PE_HOME/server/bin/start.sh | $PE_HOME/server/bin/stop.sh |
| Node-RED | $PE_HOME/node/bin/start.sh | $PE_HOME/node/bin/stop.sh |
例 — Node-RED のみ再起動:
$PE_HOME/node/bin/stop.sh
$PE_HOME/node/bin/start.sh
権限 / パスに関する注意
- すべてのスクリプトは root 権限が必要です (ポート 80/443 のバインド、systemctl、/opt/ への書き込み)。
- ディレクトリ:
| 用途 | パス |
|---|---|
| ゲートウェイのコード / 成果物 | /opt/kopens/plantpulse-edge/ |
| ユーザーデータ (sparkplug bdSeq, grafana, node-red, hivemq, apm) | /data1/pp-data/ |
| バックアップ成果物 | /data1/pp-backup/ |
| Tomcat ログ | $PE_HOME/server/logs/catalina.out |
| Cassandra ログ | $PE_HOME/db/logs/system.log |
| HiveMQ ログ | $PE_HOME/mqtt/log/hivemq.log |
| Node-RED ログ | $PE_HOME/node/log/node-red.log |
- 注意:
/opt/kopens/と/data1/pp-data/は 別々のディスク に配置することを推奨します。コード更新とデータ保存が分離され、アップグレード時のデータ損失リスク が低減します。
さらに詳しく
- 各カテゴリの詳細な手順は、左メニューの 起動 / 停止 / 再起動 / バックアップ / アップグレード / 診断 / クリーンアップ / シナリオ ページを参照してください。
- 各スクリプトの使用方法は
--helpまたはスクリプト冒頭のコメントを参照してください。