インストール概要
エッジは単一のDockerコンテナとして配備され、install.shがOS準備からsystemd登録まで
一括で処理します。このセクションでは、その手順と周辺を扱います。
順番に読む場合
ほとんどの現場では、この3つで完了します。
- インストール (
install.sh) — ゲートウェイ1台を構築します - インストール直後の点検 — ヘルスチェック・パスワード変更・バックアップ
- プロダクション引き受け基準 — 運用チームへの引き渡し前のGo/No-Go
状況が異なる場合
| 状況 | 参照先 |
|---|---|
| 量産ラインで100台以上を繰り返しインストール | 量産ライン (factory.sh) — ID・資格情報・ラベル・インベントリまで |
| インターネット遮断・USB持ち込み | 閉域網インストール |
| VMware・Hyper-V・KVM・クラウドVM | 仮想マシン・クラウドインストール — ネットワークとリソースの違いのみ |
| PLCネットワーク / WANネットワークの設計が先 | ネットワーク構成 — NICの役割・static IP・ファイアウォール |
| パスワードを変更する必要がある | 初期パスワード変更 — コミッショニング必須 |
| インストールが詰まった | インストールトラブルシューティング — 症状別 |
| systemdユニット・マウント・OTAを知る必要がある | Dockerインストール — リファレンス |
インストールが行うこと
ワンラインインストールのinstall.shは、idempotentに以下の項目を整理します。
| 領域 | 処理内容 |
|---|---|
| OS準備 | 必須パッケージ、Docker、chrony、firewall、sysctl/limits |
| ネットワーク | オプションのnmcli static IP設定、WAN/PLC NIC env override |
| セキュリティ | ボックスごとのrandom admin/MQTT/OPC-UA/APIキー、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ベースのステータスチェック |
インストール後の初期資格情報は、/etc/kopens/credentials.txtに一度だけ保存されます。
このファイルはroot専用として保管し、出荷/引き渡し時に安全に受け渡してください。
インストール前の確認
| 項目 | 基準 |
|---|---|
| OS | Linux。RHEL/Fedora/Rocky/CentOS系を推奨、VMも可能 |
| 権限 | rootまたはsudo -i |
| ネットワーク | product.kopens.io・docker.kopens.ioに到達可能 |
| ディスク | /opt/kopens 3GB以上、/data1データ用100GB以上推奨 |
| メモリ | 8GB最小、16GB以上推奨 |
閉域網の場合は、インターネット確認の代わりに閉域網インストールでbundleとimage tar.zstを準備します。
インストール完了の基準
# 한 줄 상태 점검
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/
問題がある場合は、インストールトラブルシューティングまたは コンテナモード運用を最初に確認します。
インストールが完了したら、インストール直後の点検に進みます — 初期パスワード変更がその中に含まれています。