インストール — 選定から検証まで
PlantPulse Edge のインストールは、まずデプロイモードを選ぶことから始まります。
2026.05 以降の新規インストールの標準は、単一 Docker コンテナ + install.sh です。
既存の native インストール手順書は残しますが、新規ボックスには標準として推奨しません。
コンテナモードは plantpulse-edge.service、legacy native モードは
plantpulse.service を使用します。同一ボックスで両方のサービスを同時に起動すると、
80/443/1880/9042 などのポートやデータパスが競合します。
1. どのインストールを選ぶか
| 状況 | 選択 | 理由 |
|---|---|---|
| 現場に単一ゲートウェイ、インターネット接続可 | クイックインストール (install.sh) | OS パッケージ、Docker、sysctl、firewall、chrony、SSL、systemd、イメージ pull を一括処理 |
| 量産ラインで100台以上の反復インストール | 量産ライン (factory.sh) | EDGE_ID/hostname/資格情報/ラベル/インベントリまで prompt-driven で処理 |
| インターネット遮断、セキュリティサイト、USB 持ち込み | オフライン / 閉域網インストール | install bundle と container image tar.zst を外部で準備 |
| VMware / Hyper-V / KVM / クラウド VM | VM / クラウドインストール | 基本は install.sh で、VM のネットワークとリソース差分のみ補正 |
| PLC 網 / WAN 網 / VLAN 設計が先に必要 | ネットワーク構成ガイド | NIC の役割、static IP、routing、firewall を事前整理 |
| インストール完了後の運用チーム引き渡し基準が必要 | プロダクション引き渡し基準 | health、バックアップ、再起動、セキュリティ、エビデンスファイルまで Go/No-Go 判定 |
| 2026.05 未満の native ボックスの保守 | (legacy) H/W 全体インストール | 従来の tools/setup.sh ベースの native インストール手順を保存 |
旧手順書の tools/setup.sh は native 時代の全体インストールツールです。
2026.05+ の新規ボックスは Linux 起動後に クイックインストール を基準として進め、
NIC の static 設定が必要な場合は LAN1_* / LAN2_* env で install.sh に渡します。
2. 標準インストールが行うこと
クイックインストール の install.sh は、以下の項目を idempotent に整えます。
| 領域 | 処理内容 |
|---|---|
| OS 準備 | 必須パッケージ、Docker、chrony、firewall、sysctl/limits |
| ネットワーク | 任意の nmcli static IP 設定、WAN/PLC NIC env override |
| セキュリティ | ボックスごとの random admin/MQTT/OPC-UA/API key、CERT_PASS ベースの TLS material |
| ランタイム | /etc/kopens/app.properties、/data1/pp-data、container image pull/load |
| systemd | plantpulse-edge.service、OTA path/service、host action path/service |
| 検証 | /api/v1/system/version、/api/v1/system/health、tool-based status check |
インストール後の初期資格情報は /etc/kopens/credentials.txt に1回だけ保存されます。
このファイルは root 専用で保管し、出荷/引き渡し時に安全に受け渡してください。
3. インストール前の確認
| 項目 | 基準 |
|---|---|
| OS | Linux。RHEL/Fedora/Rocky/CentOS 系を推奨、VM も可 |
| 権限 | root または sudo -i |
| ネットワーク | product.kopens.io / product.kopens.io に到達可能 |
| ディスク | /opt/kopens 3GB+、/data1 データ用に 100GB+ を推奨 |
| メモリ | 8GB 最小、16GB 以上を推奨 |
| 運用モード | 新規運用/量産はコンテナモード。legacy native は既存ボックスの保守用 |
閉域網の場合はインターネット確認の代わりに、オフライン / 閉域網インストール で bundle と image tar.zst を準備します。
4. 標準インストールの概要
sudo -i
curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh | bash
ワンライナー実行を好む場合:
sudo -i
bash < <(curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh)
詳細なオプション、env override、想定出力は クイックインストール を参照します。
5. インストール後の正常判定基準
# 한 줄 상태 점검
sudo bash /opt/kopens/install/bin/status.sh
# 버전 / 컨테이너 모드 확인
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
# 전체 컴포넌트 health
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool
正常判定基準:
plantpulse-edge.serviceがactive/api/v1/system/versionのcontainer_mode=true/api/v1/system/healthHTTP 200、主要 componentsUP- プロダクション引き渡し基準 の Go / No-Go 項目を通過
- Web UI:
https://<gateway-ip>/ui/main - Node-RED:
https://<gateway-ip>/ui/flow/
問題がある場合は インストールのトラブルシューティング または コンテナモード運用ガイド をまず確認します。
6. 次のドキュメント
- クイックインストール (
install.sh) - Docker(コンテナ)インストール詳細 — イメージ座標 /
docker runの解剖 / OTA - ネイティブインストール (直接) — コンテナなしでホストに直接インストール (dev/legacy)
- env 環境設定 —
env.sh/PP_LANG/CERT_PASS/-Dpe.conf.dir - 量産ライン (
factory.sh) - オフライン / 閉域網インストール
- VM / クラウドインストール
- ネットワーク構成ガイド
- インストール直後のチェックリスト
- プロダクション引き渡し基準
- インストールのトラブルシューティング
- コンテナモード運用ガイド
- (legacy) H/W 全体インストール (
tools/setup.sh)