Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		Vorhergehende Überarbeitung
speedy:30_modules:jobserver [2021/01/05 16:04] – angelegt adminspeedy:30_modules:jobserver [2024/03/21 09:22] (aktuell) – [Konfiguration] speedy
Zeile 1: Zeile 1:
 ====== Jobserver ====== ====== Jobserver ======
 +Der speedy-Jobserver erledigt zeitaufwendige Druckaufträge oder erstellt Vorschaubilder für speedWEB an einer zentralen Stelle. \\
 +Weiterhin kann der Jobserver das erstellen der Neutralformate bei der Freigabe oder anderer Statuswechsel übernehmen. 
 +[{{:speedy:30_modules:jobserver.png|}}]
  
 +Um einen Jobserver einzurichten wird der Spooler-Mechanismus genutzt. Jobs können nur abgearbeitet werden wenn die entsprechende Konfiguration erstellt wurde und die entsprechenden Module vorhanden sind. Es wird eine Transferdatei genutzt um die Jobs an den Jobserver zu übergeben. Diese Datei hat die Endung *.jsjob. Wird ein Jobserver verwendet werden die Jobs auf dem Server ausgeführt. \\
 +Dies bedeutet:   
 +  * Bei Druckjobs muss das verwendete CAD System vorhanden sein.
 +  * Bei Erstellung von Neutralformaten müssen die entsprechenden CAD Systeme oder die mit dem Originaldateityp verknüpften Anwendungen vorhanden sein.
 +  * Entsprechende Leistung (CPU, Arbeitsspeicher, Grafik, ...) muss auf dem Server vorhanden sein. 
 +
 +\\
 +Momentan verfügbare Jobs:
 +  * jsPlot: Stapeldruck auf dem Jobserver
 +  * jsRendition: Bildgenerierung/Vorschaugenerierung auf dem Jobserver
 +  * jsNeutralformat: Neutralformatgenerierung bei Statuswechsel auf dem Jobserver
 +  * weitere Jobs auf Anfrage bzw. in Vorbereitung
 +
 +
 +==== Ablauf des Jobserver ====
 +Der Jobserver überwacht den Posteingang. In den meisten Fällen ein entsprechendes freigegebenes Verzeichnis. \\
 +Sendet ein Client eine Jobdatei (*.jsjob) in den Posteingang des Jobservers wird diese eingelesen und in der Warteschleife (js_jobs in der Datenbank) eingetragen. \\
 +Die Warteschleife wird abgearbeitet in dem zu jedem Job der passende Processor gestartet wird, wenn der Job an der Reihe ist. 
 +
 +Im Fall von Druckjobs ist die Stapeldruck-Einstellung im Job enthalten. Der Druckjob wird wie der Stapeldruck lokal nur auf dem Server ausgeführt. Die entsprechenden Anwendungen müssen auf dem Server zur Verfügung stehen.
 +
 +==== jsPlot ====
 +Dieser Job kann dafür verwendet werden die Aufgaben und die Druckaufträge des Stapeldrucks auf den Server zu verlagern. Dies hat den Vorteil dass Zeitaufwendige Generierungen keine Zeit auf den Clients beanspruchen.
 +Es muss zwingend Notwendig das benutzte CAD-Programm oder Office Programm (je nach Druckregeln) auf dem Server installiert und lizenziert sein, da sonst kein Druck möglich ist.
 +\\
 +Der Jobserver arbeitet die Jobaufträge nach einander ab. Dies bedeutet dass die Ausführung und Generierung unter bestimmten Umständen länger dauern kann.
 +
 +=== Einstellungen ===
 +^Name^Beschreibung^
 +|plot.jobserver.available | Gibt an ob der Jobserver installiert und verfügbar ist. Standardwert=0 |
 +|plot.jobserver.path | Pfad zu den Jobdateien. |
 +|plot.jobserver.timeslot | Zeitangabe wann der Jobserver Jobs ausführen darf. Beispiel: 12:00-13:00;19:00-23:00; |
 +|plot.jobserver.maxprio | Prioritätsschwelle über der die Druckjobs trotz Timeslot trotzdem ausgeführt werden. |
 +|plot.jobserver.sendmsg | Gibt an ob beim beenden des Jobs eine Nachricht gesendet werden soll. |
 +|plot.jobserver.receiver | Gibt die zu empfangenden User oder Gruppe an an den die Nachricht gesendet werden soll. |
 +
 +==js_types==
 +^types_name^types_parallelcount^types_maxtime^types_killable^types_maxrestart^types_settinghead^types_exepath^types_flag^
 +|plot|1|50000|1|1|plot|c:\DevProjects\speedy\Dev\bin64\jsPlot.exe|0|
 +==== jsRendition ====
 +Dieser Job ist dafür gedacht Vorschaubilder für das Web Frontend zu generieren. Diese Generierung erfolgt im Hintergrund damit die Clients damit nicht belastet werden. 
 +Es muss zwingend Notwendig das benutzte CAD-Programm auf dem Server installiert und lizenziert sein, da sonst keine Generierung der Vorschaubilder möglich ist.
 +\\
 +Der Jobserver arbeitet die Jobaufträge nach einander ab. Dies bedeutet dass die Ausführung und Generierung unter bestimmten Umständen länger dauern kann.
 +
 +=== Einstellungen ===
 +^Name^Beschreibung^
 +|rendition.jobserver.available | Gibt an ob der Jobserver installiert und verfügbar ist. Standardwert=0 |
 +|rendition.jobserver.path | Pfad zu den Jobdateien. |
 +|rendition.jobserver.timeslot | Zeitangabe wann der Jobserver Jobs ausführen darf. Beispiel: 12:00-13:00;19:00-23:00; |
 +|rendition.jobserver.maxprio | Prioritätsschwelle über der die Druckjobs trotz Timeslot trotzdem ausgeführt werden.|
 +|rendition.jobserver.sendmsg | Gibt an ob beim beenden des Jobs eine Nachricht gesendet werden soll. |
 +|rendition.jobserver.receiver | Gibt die zu empfangenden User oder Gruppe an an den die Nachricht gesendet werden soll. |
 +
 +==js_types==
 +^types_name^types_parallelcount^types_maxtime^types_killable^types_maxrestart^types_settinghead^types_exepath^types_flag^
 +|rendition|1|50000|1|1|rendition|c:\DevProjects\speedy\Dev\bin64\jsRendition.exe|0|
 +==== jsNeutralformat ====
 +Dieser Job kann dafür verwendet werden Neutralformate die bei einem Statuswechsel in speedyPDM generiert werden auf den Server zu verlagern. Dies hat den Vorteil dass zeitaufwendige Generierungen keine Zeit auf den Clients beanspruchen.
 +Es muss Zwingend Notwendig das benutzte CAD-Programm auf dem Server installiert und lizenziert sein, da sonst keine Neutralformat-Generierung möglich ist.
 +\\
 +Der Jobserver arbeitet die Jobaufträge nach einander ab. Dies bedeutet dass die Ausführung und Generierung unter bestimmten Umständen länger dauern kann.
 +
 +=== Einstellungen ===
 +^Name^Beschreibung^
 +|neutralformat.jobserver.available | Gibt an ob der Jobserver installiert und verfügbar ist. Standardwert=0 |
 +|neutralformat.jobserver.path | Pfad zu den Jobdateien. |
 +|neutralformat.jobserver.timeslot | Zeitangabe wann der Jobserver Jobs ausführen darf. Beispiel: 12:00-13:00;19:00-23:00; |
 +|neutralformat.jobserver.maxprio | Prioritätsschwelle über der die Druckjobs trotz Timeslot trotzdem ausgeführt werden. |
 +|neutralformat.jobserver.sendmsg | Gibt an ob beim beenden des Jobs eine Nachricht gesendet werden soll. |
 +|neutralformat.jobserver.receiver | Gibt die zu empfangenden User oder Gruppe an an den die Nachricht gesendet werden soll. |
 +
 +==js_types==
 +^types_name^types_parallelcount^types_maxtime^types_killable^types_maxrestart^types_settinghead^types_exepath^types_flag^
 +|neutralformat|1|50000|1|1|neutralformat|c:\speedy7\bin64\jsNeutralFormat.exe|0|
 +==== Konfiguration ====
 +Um den Spooler als Jobserver zu Nutzen ist folgende Konfiguration in der dwSpool.ini zu machen:
 +<code>
 +[WATCHDIR] 
 +WatchDirX = //"Pfad für die Ablage der Jobdateien"    (siehe auch [*.jobserver.path]) //
 +
 +[WatchDirX.JSJOB] 
 +Filter=*.jsjob 
 +Description= 
 +Command=%1 
 +ShowWindow = 1 
 +</code>
 +
 +Dies dient als Beispiel und kann ihrer Konfiguration angepasst werden.\\
 +Desweiteren werden 3 Tabellen in der Datenbank benötigt:
 +  * js_jobs
 +  * js_proc
 +  * js_types
 +
 +Diese 3 Tabellen nutzt der Jobserver um die Jobs abzuarbeiten.
 +
 +In der **js_types** Tabelle werden die zur Verfügung stehenden Jobs definiert
 +^Schlüssel^Beschreibung^
 +|types_id | ID des Typs |
 +|types_name | Name des Types. Beispiel: plot->Beschreibt den Druckjob |
 +|types_parallelcount | Beschreibt wieviele Prozesse von diesem Typ gleichzeitig gestartet werden können |
 +|types_maxtime | Maximale Zeit die ein Job brauchen darf(in Millisekunden). Nach dieser Zeit wird der Job beendet. Dies kann genutzt werden um aufgehängte Jobs neu starten zu können |
 +|types_killable | Gibt an ob nach abgelaufener maxtime der Prozess beendet werden kann oder nicht |
 +|types_maxrestart | Max Wert wie oft ein Prozess erneut gestartet werden kann |
 +|types_settinghead | Gibt den Knoten der Eigenschaften an die zu diesem Job gehören. Beispiel: plot-> dadurch werden die Einstellungen plot.jobserver eingelesen und verwendet. \\ *.jobserver.available gibt an ob der Jobserver aktiv ist. \\ *.jobserver.path gibt an welches Verzeichnis überwacht werden soll. |
 +|types_exepath | Vollständiger Pfad zur Job-Anwendung. |
 +|types_flag | Allgemeines Flag |
 +
 +Beispielkonfiguration eines Drucktyps:\\
 +[{{:speedy:30_modules:jobserver_typconfig.jpg|}}]
 +\\ \\
 +
 +=== Konfigurationsparameter ===
 +^Name^Beschreibung^
 +|jobserver.database.keepAll | Definiert, ob abgearbeitete Jobs, mit entsprechender Markierung, in der Datenbank verbleiben oder aus der Warteschleife gelöscht werden. |
 +|jobserver.archiveDir | Archivverzeichnis. |
 +|jobserver.errorDir | Verzeichnis für fehlerhafte Druckjobs. |
 +|jobserver.timeslot | Zeitangabe wann der Jobserver Jobs ausführen darf. Beispiel: 12:00-13:00;19:00-23:00; |
 +|jobserver.maxprio | Prioritätsschwelle über der die Druckjobs trotz Timeslot trotzdem ausgeführt werden. |
 +|jobserver.message.subject| Betreff der Nachricht die automatisch gesendet wird. |
 +|jobserver.message.body| Nachricht die bei der automatisch generierten Nachricht gesendet werden soll.|
 +|jobserver.servername| Gibt den Computername vom Jobserver an.|
 +
 +===== dwSessionSvc =====
 +
 +Über die dwSessionSvc kann die Session als Dienst ausgeführt werden. Dies kann helfen die Anmeldezeit in Speedy-Modulen drastisch zu verbessern. Hauptsächlich macht der dienst auf Servermaschinen wie z.B. der Jobserver Sinn. \\
 +Die dwSessionSvc.exe muss im bin64 Verzeichnis liegen(momentan noch nicht mit ausgeliefert, bei mmh nachfragen). Zur Installation muss eine Kommandozeile(cmd) als Administrator ausgeführt werden.
 +Es gibt folgende 3 Übergabeparameter:
 +
 +^Parameter^Beschreibung^
 +| -Service | Der Service wird als Dienst im Windows registriert. Er kann dann auch unter den Windows-Diensten eingesehen und Konfiguriert werden.(Präferiert)|
 +| -RegServer | Service wird mit COM-Modul registriert.|
 +| -UnregServer | Lokaler Server wird Deregistriert. Ebenso der Service.|
 +
 +Am besten danach den Dienst auf Automatisch(Verzögerter Start) stellen.
 +/*
 +==== Tabellen ====
 +Tabellendefinitionen der Jobserver Tabellen.
 +
 +**js_jobs**
 +<code SQL>
 +CREATE TABLE `js_jobs` (
 + `jobs_id` INT(11) NOT NULL AUTO_INCREMENT,
 + `jobs_type` VARCHAR(50) NULL DEFAULT NULL,
 + `jobs_schedule` DATETIME NULL DEFAULT NULL,
 + `jobs_prior` INT(11) NULL DEFAULT '0',
 + `jobs_createdby` VARCHAR(50) NULL DEFAULT NULL,
 + `jobs_createdat` DATETIME NULL DEFAULT NULL,
 + `jobs_response` INT(11) NULL DEFAULT '0',
 + `jobs_responseusr` VARCHAR(50) NULL DEFAULT NULL,
 + `jobs_host` VARCHAR(50) NULL DEFAULT NULL,
 + `jobs_time` DATETIME NULL DEFAULT NULL,
 + `jobs_flag` INT(11) NULL DEFAULT '0',
 + `jobs_path` VARCHAR(255) NULL DEFAULT NULL,
 + `jobs_restarted` INT(11) NULL DEFAULT '0',
 + PRIMARY KEY (`jobs_id`)
 +)
 +COLLATE='latin1_swedish_ci'
 +ENGINE=InnoDB
 +AUTO_INCREMENT=85
 +;
 +
 +</code>\\
 +
 +**js_proc**
 +<code SQL>
 +CREATE TABLE `js_proc` (
 + `proc_id` INT(11) NOT NULL AUTO_INCREMENT,
 + `proc_jid` INT(11) NOT NULL,
 + `proc_jsdtype` VARCHAR(50) NULL DEFAULT NULL,
 + `proc_startat` DATETIME NULL DEFAULT NULL,
 + `proc_endat` DATETIME NULL DEFAULT NULL,
 + `proc_result` VARCHAR(255) NULL DEFAULT NULL,
 + `proc_finished` INT(11) NULL DEFAULT '0',
 + `proc_flag` INT(11) NULL DEFAULT '0',
 + PRIMARY KEY (`proc_id`),
 + INDEX `proc_jid` (`proc_jid`)
 +)
 +COLLATE='latin1_swedish_ci'
 +ENGINE=InnoDB
 +AUTO_INCREMENT=27381
 +;
 +
 +</code>\\
 +
 +**js_types**
 +<code SQL>
 +CREATE TABLE `js_types` (
 + `types_id` INT(11) NOT NULL AUTO_INCREMENT,
 + `types_name` VARCHAR(50) NULL DEFAULT NULL,
 + `types_parallelcount` INT(11) NULL DEFAULT NULL,
 + `types_maxtime` INT(11) NULL DEFAULT NULL,
 + `types_killable` INT(11) NULL DEFAULT '0',
 + `types_maxrestart` INT(11) NULL DEFAULT '0',
 + `types_settinghead` VARCHAR(50) NULL DEFAULT NULL,
 + `types_exepath` VARCHAR(255) NULL DEFAULT NULL,
 + `types_flag` INT(11) NULL DEFAULT NULL,
 + PRIMARY KEY (`types_id`)
 +)
 +COLLATE='latin1_swedish_ci'
 +ENGINE=InnoDB
 +AUTO_INCREMENT=3
 +;
 +
 +</code>
 +*/