Druckbrücke installieren

Die Druckbrücke wird unabhängig als Dienst installiert. Einen dauerhaft eingeschalteten Rechner wählen, der die freigegebenen Drucker und die konfigurierte Ennea-API erreicht. Druckbrücke und Maschinen-Edge-Runtime dürfen auf demselben Rechner laufen, besitzen jedoch eigene Installationen, Identitäten und Berechtigungen.

Vorbereiten

• Unterstütztes Betriebssystem und Architektur im mitgelieferten Release-Manifest prüfen. Ein x64-Paket ist kein ARM-Paket.
• Release-Paket beziehen und SHA-256-Manifest sowie gegebenenfalls Herausgebersignatur prüfen. Ein lokal gebautes, unsigniertes Paket ist kein signiertes Produktionsrelease.
• Ennea-HTTPS-API, Proxy-/Netzanforderungen sowie Drucker-IP-Adressen oder enge CIDRs und Ports mit der IT abstimmen.
• Im Operations Studio eine Druckbrücke am vorgesehenen Standort und in der richtigen Umgebung anlegen. Den Kopplungscode erst erzeugen, wenn die Installation bereit ist; Codes gelten 15 Minuten und nur einmal.

Keine Produktionsidentität für eine Testumgebung verwenden. Kopplungscode und Zugangsschlüssel sind Geheimnisse und gehören nicht in Befehlsverläufe, Screenshots oder Supporttickets.

Windows

Das bereitgestellte Paket EnneaPrintBridge-Version-windows-x64-setup.exe verwenden. Es enthält Anwendungsruntime und Diensthost. Die Kunden-IT muss Node.js und pnpm nicht separat installieren.

1. Installer mit Installationsberechtigung ausführen.
2. Ennea Print Bridge Setup im Startmenü öffnen.
3. HTTPS-API-Adresse und aktuellen Kopplungscode eingeben.
4. Benötigte Druckeradressen oder eingeschränkte Netze und Ports lokal freigeben.
5. Dienst starten und den letzten Kontakt im Operations Studio prüfen.

Der Dienst EnneaPrintBridge läuft als LocalService mit automatischem Start und Neustartrichtlinie. Koppeln und lokale Richtlinienänderungen erfordern lokale Administration. Konfiguration und Zustand liegen in %ProgramData%\Ennea\PrintBridge\config und state, getrennt von den Programmdateien.

Für spätere Verwaltung eine PowerShell mit Administratorrechten öffnen:

$bridge = "$env:ProgramFiles\Ennea Print Bridge\ennea-print-bridge.cmd"
& $bridge status
& $bridge policy approve --network 192.168.20.51 --ports 9100
& $bridge check --host 192.168.20.51 --port 9100
Restart-Service EnneaPrintBridge

Für zentrale Softwareverteilung unterstützt der Installer /S zur stillen Installation. Kopplung und lokale Richtlinie benötigen weiterhin eine ausdrückliche Konfiguration.

Windows-Dienstinstallation, Neustartverhalten, Unternehmenssignatur und reale Druckerabnahme müssen vor Inbetriebnahme am unterstützten Windows-Rechner geprüft werden. Ein Build-Workflow oder ein erfolgreicher macOS-Test liefern diesen Nachweis nicht.

Linux

Das Release-Archiv für unterstützte Distribution und Architektur verwenden. Für Linux x64:

tar -xzf ennea-print-bridge-1.0.0-linux-x64.tar.gz
cd ennea-print-bridge-1.0.0-linux-x64
sudo ./install.sh
sudo ennea-print-bridge init --url https://your-ennea-api.example
sudo ennea-print-bridge enroll
sudo ennea-print-bridge policy approve --network 192.168.20.51 --ports 9100
sudo ennea-print-bridge policy validate
sudo ennea-print-bridge check --host 192.168.20.51 --port 9100
sudo systemctl start ennea-print-bridge
sudo ennea-print-bridge status

enroll fragt den Kopplungscode interaktiv ab. Der Installer aktiviert den Dienst, lässt ihn zur Einrichtung aber gestoppt. Das Systemkonto ennea-print liest die root-eigene Konfiguration in /etc/ennea-print-bridge und schreibt den geschützten Zustand in /var/lib/ennea-print-bridge. Kein zweites Zustandsverzeichnis für dieselbe Installation anlegen.

Verbindungsrichtlinie

Eine einzelne Adresse ist die engste Freigabe. Alternativ kann die IT ein dediziertes Drucker-CIDR mit ausgewählten Ports freigeben, damit spätere Drucker innerhalb dieser Grenze ergänzt werden können. Ein unbeschränktes Büro- oder Maschinennetz ist nicht erforderlich. Eine Zielfreigabe erlaubt die Verbindung; sie legt weder den zentralen Druckerdatensatz an noch bestätigt sie physische Ausgabe.

Cloud-Konfiguration kann diese lokale Richtlinie nicht erweitern. Ein neues Ziel außerhalb bleibt blockiert, bis die IT die Hostrichtlinie ändert. Der Druckdienst benötigt keinen eingehenden Netzwerklistener.

Vollständige Installation prüfen

1. Richtige Druckbrücke, Standort, Umgebung und aktuellen Kontakt bestätigen.
2. Lokale Richtlinie und Druckerrevision kontrollieren.
3. Verbindung ohne Druck prüfen.
4. Ein Testetikett ausdrücklich einreihen, Auftrag ansehen und physische Ausgabe scannen.
5. Dienst neu starten und erhaltene Identität sowie Journal prüfen.
6. Kurze Cloud-Unterbrechung testen und sicherstellen, dass nachgeholte Bestätigungen keine zusätzliche Ausgabe erzeugen.

Gesendet belegt die TCP-Übertragung, keinen bestätigten Papierauswurf. Siehe Aufträge und Wiederherstellung.

Aktualisieren, ersetzen oder entfernen

Release-spezifisches Updateverfahren verwenden, geschützten Zustand erhalten und Änderungen mit dem Betrieb abstimmen. Vorheriges Paket und kompatible Zustandssicherung für Rollback aufbewahren. Niemals zwei Kopien mit derselben kopierten Identität und demselben Journal starten.

Eine kompromittierte oder stillgelegte Druckbrücke im Operations Studio widerrufen. Ein bewusst ersetzter Rechner benötigt eine neue Kopplung und einen Abgleich noch laufender Aufträge. Widerruf verhindert weitere autorisierte Cloud-Arbeit, kann aber bereits gesendete Bytes nicht zurückrufen.

Updates werden durch den Betreiber gesteuert; die Druckbrücke lädt keine ausführbaren Updates herunter. Dienst stoppen, geschützte Konfiguration und Zustand sichern, freigegebenen Installer ausführen und neu starten. Bei Rollback die Kompatibilität des Journalformats beachten.

Unter Windows über Installierte Apps → Ennea Print Bridge deinstallieren, unter Linux mit sudo ./uninstall.sh aus dem Release-Paket. Beide erhalten Konfiguration und Zustand. Bei gestopptem Dienst entfernt ennea-print-bridge forget den lokalen Zugang, erhält aber Deduplizierungsnachweise; die Druckbrücke in Ennea separat widerrufen. Gespeicherte Dateien erst nach Klärung unklarer Aufträge entfernen. diagnostics liefert bereinigte Betriebsnachweise; Ausgabe vor Weitergabe prüfen.

Bei einer kundenseitig betriebenen Ennea-Plattform die Druckbrücke mit deren HTTPS-API koppeln. Einen Deploymentwechsel bewusst neu koppeln; kein stiller Rückfall auf einen öffentlichen Cloud-Endpunkt.

Vor Änderung des API-Ziels offene Bestätigungen synchronisieren und unklare Ausgaben im ursprünglichen Deployment abgleichen. Dienst stoppen und forget, danach init --url und enroll für das neue Ziel verwenden. Offene Bestätigungen, angenommene/laufende Aufträge, vorhandene Zugangsdaten oder eine unvollständige Kopplung blockieren den Wechsel. Journal und lokale Richtlinie bleiben erhalten. Für Reparatur derselben Druckbrücke einen neuen Code erzeugen und Erneut koppeln im Windows-Setup oder enroll bei gestopptem Dienst verwenden; danach den Dienst starten.