PrinterController - Druckeransteuerung

Allgemein

Der COGLAS PrinterController ist ein Programm zur Ansteuerung von Druckern. Der PrinterController wird verwendet, um lokale Drucker beispielsweise aus dem Kundennetzwerk im COGLAS Webservice verfügbar zu machen.

Der COGLAS PrinterController ist versionsabhängig und wird mit dem COGLAS Release bereitgestellt.

Der COGLAS PrinterController ist als OnPremises Lösung gedacht. Beispiel: Kunden Lösung ist auf der OTC, und es sollen darüber die Kunden Drucker aus dem Kunden Netzwerk angesprochen werden.

Die COGLAS Funktion Arbeitsstationen muss u.a. aktiviert sein.

Einrichtung

Der COGLAS PrinterController wird zusammen mit dem Printservice SumatraPDF lokal auf dem Ziel Server installiert und eingerichtet.

	Aktion	Beschreibung
1	SumatraPDF	Für die Ausführung des COGLAS PrinterController ist der Printservice SumatraPDF erforderlich. Beschreibung der Einrichtung siehe = (Printservice SumatraPDF - Helpcenter Deutsch - Confluence (atlassian.net))
2	COGLAS PrinterController	Vorbereitung. Rollout lokal auf dem Server ablegen. Entpacken des ZIP Archivs. Beispiel Verzeichnis = “C:\Program Files\COGLAS\PrinterController”. Installation. Der COGLAS PrinterController wird als Windows Dienst installiert. Lokale ADMIN Rechte erforderlich. Windows Dienst installieren: sc create COGLAS_PC binPath="C:\Program Files\COGLAS GmbH\PrinterController\CoglasPro.PrinterController.exe" Windows Dienst de-installieren: sc delete COGLAS_PC Konfiguration. Datei “appsettings.json“. Es werden hier die Verbindungs- und Benutzerdaten zur Authentifizierung gespeichert. Firewall / Netzwerk Freigabe. Für die HTTPS und Websocket Verbindung zwischen dem OnPremises und dem Cloud COGLAS Webservice sind Firewall Freigaben kundenseitig für den Datenaustausch zu prüfen und ggf. einzurichten.
3	Manueller Start COGLAS PrinterController	Der manuelle Start ist für den Verbindungstest verfügbar. Hierzu die Windows Eingabeaufforderung im PrinterController Programm Verzeichnis öffnen Aufruf: CoglasPro.PrinterController.exe --console Der Befehl muss im COGLAS PrinterController Programm Verzeichnis aufgerufen werden. In der Windows Eingabeaufforderung wird wird eine laufende Umgebung des COGLAS PrinterControllers ausgeführt. Es kann der COGLAS PrinterController normal verwendet werden. Die Verbindung und die Protokollierung können geprüft werden. Am Ende des Tests soll der manuelle Start wieder gestoppt werden. Hierzu im Fenster zur Windows Eingabeaufforderung STRG+C mehrmals drücken, oder das Fenster einfach schließen. Anmerkung: Auf einem Computer kann nur eine Instanz eines COGLAS PrinterController laufen. Stoppen Sie den Windows Dienst, um einen Manuellen Start auszuführen und vise versa.
4	Automatischer Start COGLAS PrinterController	Der COGLAS PrinterController wurde als Windows Dienst eingerichtet. Der Windows Dienst kann nun in der Liste der Windows Dienste manuell gestoppt / gestartet werden.

Software Update

Der COGLAS PrinterController liegt installiert vor. Es soll ein Versionsupdate hierzu erfolgen.

	Aktion	Beschreibung
1	Vorbereitung	Rollout Daten lokal auf dem Server ablegen. ZIP Archiv entpacken. Erstellung einer Sicherung der aktuellen Installation des COGLAS PrinterControllers. Hierzu das produktive Programm Verzeichnis kopieren und separat in einem !Backup Verzeichnis ablegen. Das Sicherung-Verzeichnis sollte das Datum und die Version der Software enthalten.
2	Software Update	Den COGLAS PrinterController beenden, wenn diese noch läuft. Beispiel: den Windows Dienst stoppen. Die neue Programm Version aus dem entpackten ZIP Archiv kopieren und in das produktive Programmverzeichnis einfügen. Es werden Programm Dateien überschrieben. Wenn eine Abfrage hierzu kommt, dann diese bestätigen. Ende
3	Software Start	Den COGLAS PrinterController starten. Beispiel den Windows Dienst starten. Den Ausdruck bitte so schnell wie möglich überprüfen.
4	Konfiguration Datei “appsettings.json“	Die Einstellungen ändern sich i.d.R. nicht. Die Datei kann zum Versionsupdate unverändert bleiben. Sollte es Änderungen geben, dann empfehlen wir eine der beiden “Template_***_appsetting.json” Dateien zu verwenden, um eine aktuelle Konfiguration zu erfassen. “Template_http_appsetting.json” = Für eine HTTP Anbindung. “Template_https_appsetting.json” = Für eine HTTPS Anbindung.

Protokollierung

	Aktion	Beschreibung
1	Protokollierung Standard	Verzeichnis = “.\printercontroller\logs“ Beispiel Datei Name “log-2024-07-15.log“. Taggenaue Protokollierung. Vorhaltung ALLER Protokoll Dateien.
2	Protokollierung zu “nlog.config”	Protokollierung mit Custom Einstellungen möglich.
3	Beispiel NLog Parameter	maxArchiveFiles="90" für Vorhaltung Maximale Anzahl Dateien. fileName=”(..)” Pfad und Dateiname

Netzwerk Diagramm

Beispiel: COGLAS Webservice onCloud (OTC, Azure)
COGLAS PrinterController onPremises

Der PrinterController ist als Windows Dienst mit dem Benutzer “lokales System” eingerichtet und gestartet.
Der PrinterController überträgt die Liste der lokal verfügbaren Drucker an den COGLAS Webservice.
Im COGLAS kann zur Arbeitsstation eine oder mehrere Positionen erfasst werden mit dem Zugriff auf die Drucker des PrinterController.
Druckausgabe onPremises beim ersten Testdruck.

Beispiel: COGLAS Webservice onPremises
COGLAS PrinterController onPremises

Wie zuvor.
Der COGLAS Webservice und COGLAS PrinterController sind onPremises
Die Einrichtung erfolgt hier jedoch auf getrennten Servern.
Server A ist mit dem COGLAS Webservice eingerichtet.
Server B wird mit dem COGLAS PrinterController eingerichtet.
Auf dem Kunden Druckserver (Server B) sind alle relevanten Drucker bereitgestellt. Der hier eingerichtete COGLAS PrinterController stellt die dort lokal verfügbaren Drucker an den COGLAS Webservice bereit.

Übergabe an die Kunden Administration

Der COGLAS PrinterController ist eine Lösung für den Einsatz onPremises. Hieraus stellt sich die Frage der Wartung und Administration der installierten Lösung.

Grundsätzlich geht die Installation nach der Inbetriebnahme in die Administration des Kunden über.

Die Administration umfasst folgende Aufgaben:

Kontrolle, ob die Software Lösung aktiv ist und Daten verarbeitet werden.
Kontrolle der Protokollierung und ob darin beispielsweise ERROR Meldungen auftreten.
Ordnungsgemäßer Neustart der COGLAS Lösung.
Test der Funktion in der COGLAS WEB WMS Lösung.

Für diese Aufgabe muss der Kunde einen oder mehrere Ansprechpartner bereitstellen.
Die Person benötigt Zugriff auf den Server auf dem die COGLAS Lösung eingerichtet ist. Des Weiteren wird der Administrative Zugriff auf die COGLAS Lösung benötigt, um zum Beispiel mit dem Benutzerrecht “lokaler Administrator” den Windows Dienst des COGLAS PrinterControllers stoppen und neu starten zu können.

Kommt die Kunden Administration nicht weiter, so kann jederzeit eine Anfrage an den der COGLAS Support gemeldet werden. Verwenden Sie hierbei die Kontakt Vereinbarung unter https://help.coglas.com/ger/kontakt.

→ zurück zu COGLAS Prozessen
→ zurück zu COGLAS Menü