Installationsübersicht

Der Edge wird als einzelner Docker-Container bereitgestellt, und install.sh erledigt alles in einem Durchgang, von der OS-Vorbereitung bis zur systemd-Registrierung. Dieser Abschnitt behandelt den Ablauf und das Umfeld.

Wenn Sie der Reihe nach lesen

Die meisten Vor-Ort-Szenarien sind mit diesen drei Punkten abgedeckt.

1. Installation (install.sh) — ein Gateway aufsetzen
2. Inspektion direkt nach der Installation — Healthcheck · Passwort ändern · Backup
3. Produktions-Ünahmekriterien — Go/No-Go vor Übergabe an das Betriebsteam

Wenn die Situation anders ist

Situation	Wohin
Wiederholte Installation von 100+ Geräten in einer Fertigungslinie	Fertigungslinie (factory.sh) — ID · Zugangsdaten · Labels · Inventar
Kein Internet · USB-Import	Air-Gap-Netzwerk-Installation
VMware · Hyper-V · KVM · Cloud-VM	Virtuelle Maschine · Cloud-Installation — nur Netzwerk- und Ressourcenunterschiede
PLC-Netz / WAN-Netz Auslegung zuerst	Netzwerkkonfiguration — NIC-Rollen · static IP · Firewall
Passwort muss geändert werden	Initiales Passwort ändern — Pflicht bei Inbetriebnahme
Installation hängt fest	Installations-Fehlerbehebung — nach Symptomen
systemd-Einheiten · Mounts · OTA verstehen	Docker-Installation — Referenz

---

Was die Installation bewirkt

Die install.sh des One-Line-Install richtet die folgenden Punkte idempotent ein.

Bereich	Verarbeitungsinhalt
OS-Vorbereitung	Erforderliche Pakete, Docker, chrony, Firewall, sysctl/limits
Netzwerk	Optionale nmcli static-IP-Einstellung, WAN/PLC-NIC-env override
Sicherheit	Zufällige admin/MQTT/OPC-UA/API-Keys pro Box, CERT_PASS-basierte TLS-Materialien
Laufzeit	/etc/kopens/app.properties, /data1/pp-data, Container-Image pull/load
systemd	plantpulse-edge.service, OTA-Pfad/-Dienst, Host-Action-Pfad/-Dienst
Verifikation	/api/v1/system/version, /api/v1/system/health, tool-basierter Statuscheck

Nach der Installation werden die initialen Zugangsdaten einmalig in /etc/kopens/credentials.txt gespeichert. Diese Datei ist root-exklusiv aufzubewahren und bei Auslieferung/Übernahme sicher zu übergeben.

---

Vor der Installation prüfen

Punkt	Kriterium
OS	Linux. RHEL/Fedora/Rocky/CentOS-Familie empfohlen, VM auch möglich
Rechte	root oder sudo -i
Netzwerk	product.kopens.io · docker.kopens.io erreichbar
Disk	/opt/kopens 3GB+, /data1 für Daten 100GB+ empfohlen
Speicher	8GB Minimum, 16GB+ empfohlen

Bei einem Air-Gap-Netzwerk bereiten Sie stattdessen das Bundle und das Image tar.zst nach Air-Gap-Netzwerk-Installation vor.

---

Kriterien für den Abschluss der Installation

# 한 줄 상태 점검
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

Normale Kriterien:

• plantpulse-edge.service ist active
• /api/v1/system/version der container_mode=true
• /api/v1/system/health HTTP 200, Hauptkomponenten UP
• Go/No-Go-Punkte der Produktions-Ünahmekriterien bestanden
• Web-UI: https://<gateway-ip>/ui/main
• Node-RED: https://<gateway-ip>/ui/flow/

Bei Problemen zuerst Installations-Fehlerbehebung oder Container-Modus-Betrieb prüfen.

---

Nach der Installation geht es weiter zur Inspektion direkt nach der Installation — das initiale Passwort ändern ist darin enthalten.