Zum Hauptinhalt springen

Inspektion nach der Installation

Nach Abschluss der Installation (One-Line-Installation, Produktionslinien-Installation, Air-Gap-Installation) wird das Gateway in der folgenden Reihenfolge in den betriebsbereiten Zustand überführt.

1. 1-Minuten-Healthcheck​

sudo bash /opt/kopens/install/bin/status.sh
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

Erwartung:

  • container running + healthy
  • 9 Ports listening (80, 443, 1883, 1884, 6379, 9042, 1880, 12000, 12443) — 7799 (Tomcat JMX) hört nur auf 127.0.0.1
  • /api/v1/system/version → build_date / image_tag / container_mode=true
  • /api/v1/system/health → 200, alle components UP

pe-status Wenn alle Punkte ✓ sind, folgen Sie dem nächsten Abschnitt. Falls einige ✗ sind, lesen Sie den Abschnitt «Fehlerbehebung» unter Betrieb im Containermodus.

Vor der Inbetriebnahme muss zudem das Acceptance Log gemäß den Kriterien für die Produktionsabnahme erstellt werden.

2. Änderung des Initialpassworts — Zuerst​

Überführen Sie das System nicht in den Betrieb, ohne die bei der Installation erstellten Anmeldedaten zu ändern. Was genau zu ändern ist, finden Sie unter Initialpasswort ändern — dies ist ein verpflichtender Punkt der Inbetriebnahme und muss vor dem unten genannten Backup und Mirroring erfolgen.

3. Automatisches Backup einrichten​

sudo tee /etc/cron.d/plantpulse-edge-backup > /dev/null << 'EOF'
# 매일 새벽 3시 백업 + 일요일 새벽 4시 30일 초과 백업 삭제
0 3 * * * root /opt/kopens/install/bin/backup.sh > /dev/null 2>&1
0 4 * * 0 root find /data1/pp-backups -name 'pe-backup-*.tar.zst' -mtime +30 -delete
EOF

sudo bash /opt/kopens/install/bin/backup.sh
ls -lh /data1/pp-backups/

Details: Backup und Wiederherstellung

4. Externes NAS / S3 Mirroring (Disaster Recovery)​

Wenn Backups nur auf derselben Festplatte wie das Gateway liegen, gibt es keinen Disaster Recovery-Effekt. Ein externes Mirroring wird dringend empfohlen:

# 컨테이너 백업 예시
LATEST=$(ls -t /data1/pp-backups/pe-backup-*.tar.zst | head -1)
rsync -av "$LATEST" "$LATEST.sha256" nas:/backup/edge/

5. Benutzer- und Berechtigungseinstellungen (Optional)​

Falls neben dem Standard-Admin benutzerspezifische Konten benötigt werden:

Das Gateway verfügt über eine Oberfläche für Benutzer, Rollen und Menüzugriffsrechte.

OberflächeAdresseFunktion
Benutzerverwaltung/system/userKonten erstellen und Rollen zuweisen
Rollenverwaltung/system/roleRollen definieren
Menüzugriffsrechte/system/menu_accessFestlegen, welche Menüs pro Rolle sichtbar sind
SzenarioEmpfehlung
Ein-Personen-BetriebNutzung des Standardkontos, nur Passwort ändern
Mehr-Personen-BetriebTrennung der Konten und Zuweisung von Rollen zur Nachverfolgbarkeit von Aktivitäten
Externe PartnerZuerst die folgende Prüfung durchführen
Prüfen Sie «tatsächliche Sperrung», bevor Sie Partnern Zugriff gewähren

Es gibt zwar Oberflächen und Tabellen zur Speicherung von Rollen und Menüzugriffsrechten, aber es ist sicherer, direkt in der Installation zu prüfen, ob diese bei jeder Anfrage tatsächlich angewendet werden.

Prüfungsmethode: Erstellen Sie ein Konto mit einer eingeschränkten Rolle, loggen Sie sich mit diesem Konto ein und prüfen Sie, ob Menüs, die gesperrt sein sollten (z. B. Verbindung löschen), wirklich nicht zugänglich sind. «Menü ist nicht sichtbar» ist nicht dasselbe wie «Zugriff ist gesperrt, auch wenn die Adresse direkt eingegeben wird».

Wenn festgelegt ist, was für Externe sichtbar sein soll, ist es zuverlässiger, über Plattform-Berechtigungsgruppen nur das Notwendige freizugeben, anstatt die Gateway-Oberfläche zu nutzen.

6. Nächste Schritte​

  1. Home-Bildschirm-Karten / Aktionsleitfaden — Bedeutung der 30 Karten
  2. Neue PLC-Verbindung hinzufügen
  3. Tag-Registrierung + PLC-Adresseneingabe (Vollständiger Leitfaden für 44 Treiber)
  4. Sparkplug B Publishing — Bei Integration externer SCADA-Systeme
  5. Flow (Node-RED) — Automatisierung / Alarm / externe Integration
  6. Betriebsübersicht — Starten/Stoppen/Neustart/Backup/Upgrade/Diagnose

7. Abnahme-Checkliste (Für Lieferanten und SI-Partner)​

Bei der Abnahme einer neuen Anlage müssen folgende Punkte erfüllt sein:

  • Bei Containermodus status.sh vollständig OK, bei Native bin/ps.sh 5 Java/Node-Prozesse geprüft
  • /api/v1/system/version HTTP 200 + erwartete edge_id/site_id/container_mode Rückgabe
  • /api/v1/system/health HTTP 200 + components UP
  • Acceptance Log der Kriterien für die Produktionsabnahme erstellt + sha256 dokumentiert
  • /api/v1/monitoring HTTP 200 + cpu_used_percent < 30%, memory_used_percent < 60%
  • Alle 30 Home-Karten angezeigt + Aktualisierung im 1-Sekunden-Takt
  • 1 Simulator-OPC registriert → Start → Chart im /ui/opcua-Baum korrekt
  • 1 reale PLC registriert → Erfassungsstatus 🟢 Normal + Aktualisierung des letzten Wertes
  • Automatische PLC-Wiederverbindung nach Container systemctl restart plantpulse-edge.service oder Native bin/restart.sh (auto_collect=true)
  • Backup-Cron registriert + Erstellung der ersten Backup-Datei/des ersten Verzeichnisses geprüft
  • Erstes Backup .tar.zst und .sha256 an externen Backup-Ort kopiert
  • Nachrichteneingang beim externen SCADA / Sparkplug-Empfänger bestätigt
  • Passwortänderung abgeschlossen (Standardpasswort von Admin geändert)
  • Berechtigung /etc/kopens/credentials.txt 0600 root geprüft + Verfahren zur Passwortübermittlung abgeschlossen
  • 30-Sekunden-Überwachung mit log-viewer — Keine Logs der Stufe SEVERE / ERROR
  • Festplattenkapazität 30%+ frei (df -h /data1)
  • OS NTP-Synchronisation (timedatectl) normal
  • Gateway-IP / Zugangsdaten an Betriebsteam übermittelt + Übergabeprotokoll unterzeichnet

Mehr erfahren​