運用概要

何をしようとしていますか

やりたいこと	参照先
起動・停止・再起動	起動 · 停止 · 再起動
状態確認・監視	モニタリング
バックアップ・復元	バックアップ
パスワード・キー変更	認証情報
トラブル時の診断	診断
状況別対応	運用シナリオ
コンテナを直接扱う場合	コンテナ運用
テーブル・スキーマ	データベースモデル
冗長化	HA
バージョンアップ	アップグレード
ディスク整理	クリーンアップ

ゲートウェイサーバーにSSHで接続した**管理者(root)**が実行する運用スクリプト集です。一般ユーザーはWeb UIだけで十分ですが、起動 / 停止 / バックアップ / アップグレード / 障害診断などの運用作業はこれらのスクリプトを使って行います。

コンテナモード (2026.05+) は別ガイド

systemctl is-active plantpulse-edge.service が active の場合はコンテナモード。このページのネイティブスクリプト (bin/start.sh など) の代わりに コンテナモード運用 ページの /opt/kopens/install/bin/*.sh コマンドを使用してください。本ページはネイティブ配布ボックス専用です。

インストールパス (ネイティブ):

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`	`stop.sh` + `start.sh` を 1プロセスで — 全体スタック	約150〜210秒
	`restart-app.sh`	Tomcat (アプリ)のみ再起動 — 画面の「アプリ再起動」がこれ	30〜90秒
	`reboot.sh`	OS再起動	—
バックアップ	`backup.sh`	設定 + DBスナップショット + ツールデータ一括バックアップ	分単位
アップグレード	`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-app.sh (アプリのみ、30〜90秒) です。 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 またはスクリプト冒頭のコメントを参照してください。

何をしようとしていますか​

一覧​

サブコンポーネント自身の start.sh / stop.sh​

権限 / 場所の参考情報​

詳細情報​

何をしようとしていますか

一覧

サブコンポーネント自身の `start.sh / stop.sh`

権限 / 場所の参考情報

詳細情報