Edge Runtime installieren

Nutze das für deine Bereitstellung gelieferte Paket und die zugehörigen Cloud-Adressen. Die folgenden Quellinstallationsbefehle benötigen Node.js 24 und pnpm. Für die Inbetriebnahme brauchst du einen Administrator mit Connector- und Dienstidentitätsrechten, den richtigen Bereich, zugewiesene Arbeitsplätze und genehmigte Netzwerkwege.

Registrieren und genehmigen

1. Öffne Edge Connectors direkt oder über das Studio im zugewiesenen Bereich.
2. Erzeuge ein Registrierungstoken mit vorgesehenem Namen und erlaubten Arbeitsplatzzuweisungen. Es gilt 24 Stunden.
3. Lege das Paket in ein für das Dienstkonto beschreibbares Verzeichnis auf dem Rechner.
4. Kopiere .env.example in eine private .env und trage die gelieferten Werte ein.

CLOUD_API_URL=https://your-ennea-api.example
CLOUD_WS_URL=wss://your-ennea-api.example
REGISTRATION_TOKEN=<lokal-eintragen>
EDGE_STATE_DIR=/var/lib/ennea-edge
LOG_LEVEL=info
NODE_ENV=production

Setze beide Cloud-Adressen ausdrücklich. Der aktuelle Konfigurationslader hat unabhängige Standardwerte und leitet die WebSocket-Adresse nicht automatisch aus der API-Adresse ab.

Aus dem Quellrepository:

pnpm install
pnpm --filter @ennea/edge-runtime build
pnpm --filter @ennea/edge-runtime start

Bei separat gelieferten Paketen gelten deren Installationsbefehle. Ein für eine ältere Laufzeit gebautes Programm ist nicht automatisch gleichwertig.

Der erste Start registriert den Rechner und speichert Identität und API-Schlüssel. Der Connector wartet anschließend auf Genehmigung. Der Start kann bei der Authentifizierung enden, bis ein Administrator genehmigt und passende Dienstrechte eingerichtet hat. Prüfe Connector und Zuweisungen, genehmige und starte erneut. Entferne das ursprüngliche Registrierungstoken nach erfolgreicher Registrierung aus der lokalen Umgebung.

Speicher und Dienst

Halte .env, edge-config.json, data/ und logs/ privat und dauerhaft verfügbar. Sie enthalten Zugangsdaten und Fertigungsdaten. Die Identität liegt unter EDGE_STATE_DIR (Standard ~/.ennea/edge), zusammen mit privaten Unterverzeichnissen data/ und logs/. Bestehenden Zustand vor Pfadwechseln gemeinsam migrieren; siehe Sicherheit.

Nutze ein eigenes Dienstkonto, festes Arbeitsverzeichnis, den installierten Node-24-Pfad, eine Neustartregel und geordnetes Beenden über SIGTERM. Ein Node-24-Laufzeitarchiv startet über start.sh oder start.cmd; ein Quellbuild über node dist/index.js. Erhalte den Zustand bei Aktualisierungen und nutze das vereinbarte Sicherungsverfahren.

Konfiguration

Einstellung	Bedeutung
CLOUD_API_URL, CLOUD_WS_URL	API- und WebSocket-Adressen der Bereitstellung.
REGISTRATION_TOKEN	Nur für die Erstregistrierung.
EDGE_API_KEY, EDGE_CONNECTOR_ID, EDGE_HARDWARE_ID	Ausdrückliche Identitäts- und Zugangsdatenvorgaben; nur bereitgestellte Identitäten verwenden.
EDGE_STATE_DIR	Eigenes privates Verzeichnis für Identität, Cache und Logs; alten Zustand gemeinsam migrieren.
DATA_DIR, LOG_DIR	Optionale explizite Cache-/Logpfade, vor dem Öffnen abgesichert.
PLC_REST_ENABLED, OPCUA_SERVER_ENABLED	Standardmäßig deaktiviert; vor Aktivierung sicher einrichten.
EDGE_LOCAL_PRINCIPALS_FILE	Private Maschinen-IDs, Tokens und Arbeitsplatz-/Aktionsrechte.
LOG_LEVEL	Protokollierungsgrad.
PLC_SERVER_PORT	Lokaler REST-Port; Standard 3005.

Der lokale OPC-UA-Server nutzt standardmäßig 4841 und unterstützt OPCUA_SERVER_PORT. TLS-Zertifikate/Schlüssel, Bindeadressen und OPC-UA-Vertrauen wie unter Sicherheit beschrieben einrichten. Standardwerte sind fünf Sekunden für Synchronisierung und 30 Sekunden für Pufferwiederholungen. Gespeicherte Konfiguration kann diese unterstützten Werte ändern. Der aktuelle Heartbeat läuft alle 30 Sekunden.

Vor der Inbetriebnahme prüfen

Prüfe Genehmigung, Dienstrechte, Arbeitsplatzzuweisung, Cloud-Synchronisierung, reinen SPS-Lesezugriff und lokale Erreichbarkeit. Teste anschließend eine Meldung an einem erlaubten Auftrag und prüfe das Cloud-Ergebnis. Prüfe Druck separat. Lies Sicherheit vor der Freigabe lokaler Ports und Fehlerbehebung bei Problemen.