JobScheduler Information Dashboard - Sos-berlin.com

JobScheduler - Job Execution and Scheduling System 

Tagesplan und Historie 

März 2013 

JobScheduler 

Information Dashboard 

März 2013 JobScheduler Seite: 1 

Software Open Source

JobScheduler - Impressum 

Impressum 

Software- und Organisations-Service GmbH 

Giesebrechtstr. 15 

D-10629 Berlin 

Germany 

Telefon +49 (0)30 86 47 90-0 

Telefax +49 (0)30 8 61 33 35 

Mail info@sos-berlin.com 

Web http://www.sos-berlin.com 

Letzte Aktualisierung: 03/15/2013 12:01 PM 

Diese Dokumentation basiert auf der JobScheduler Version 1.3.12.3072. 

Copyright © 2005-2013 SOS GmbH Berlin. 


Software Open Source 

All rights reserved. All trademarks or registered trademarks are the property of their respective holders. Alle 

Informationen in diesem Dokument können ohne vorherige Ankündigung verändert werden. 

This product includes software developed by the Apache Software Foundation (http://apache.org/) 

We would appreciate any feedback you have, or suggestions for changes and improvements; please forward your 

comments to info@sos-berlin.com.

JobScheduler - Inhaltsverzeichnis 

Inhaltsverzeichnis 


1 Einleitung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.1 Spracheinstellung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.2 Anpassen der Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

2.2.1 Einstellungen für Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

2.2.2 Einstellungen für MySql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

2.2.3 Einstellungen für SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

2.2.4 Einstellungen für PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

2.2.5 Einstellungen für Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 

2.2.6 Einstellungen für DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 

3 Tagesplan erstellen und auswerten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

3.1 Tagesplan anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

3.1.1 Mehrere JobScheduler Instanzen simultan mit JOC öffnen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

3.1.2 Die geplanten, nicht gelaufenen Jobs vom aktuellen Tag anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

3.1.3 Die fehlerhaft gelaufenen Jobs von gestern anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

3.1.4 Einen Job ausblenden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 

3.1.5 Das Suchfeld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 

3.1.6 Die aktuell laufenden Jobs anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

3.1.7 Wann werden Aufträge als fehlerhaft gekennzeichnet? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

3.2 Farbcodes für unterschiedliche Auftragsstati . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

3.2.1 Farbcodes für die geplanten Aufträge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

3.2.2 Farbcodes für die Auftragshistorie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 

4 Glossar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

März 2013 JobScheduler Seite: 3

JobScheduler - Einleitung 

1 Einleitung 



Das JID (JobScheduler Information Dashboard) stellt Funktionen für eine Übersicht über die geplanten und 

tatsächlich gelaufenen Jobs zur Verfügung. Auf Wunsch kann auch JOC (JobScheduler Operations Center) in 

JID integriert werden. 

Tagesplan 

JobScheduler berechnet jeweils die nächste Startzeit von Jobs und Job-Ketten und startet diese automatisch. 

JobScheduler schaut dabei nicht in die Vergangenheit. JID mit dem Tageskalender unterstützt das Operating bei 

der Beantwortung der Fragen 

• was hätte laufen sollen und was davon ist gelaufen? 

• was wird in den nächsten Tagen laufen? 

Der Tagesplan ist hilfreich, da in ihm die geplanten Starts vermerkt sind. Wenn ein Job oder Auftrag gelaufen ist, 

wird dies in den Plan eingetragen. 

Auf diese Weise steht eine Übersicht zur Verfügung, in der schnell die nicht gelaufenen Jobs und Aufträge zu 

erkennen sind. 

Job Historie 

Desweiteren bietet eine Übersicht über alle gelaufenen bzw. aktuell laufenden Jobs und Job-Ketten, die 

Möglichkeit, eine zentralisierte Übersicht über das gesamte System zu erhalten. Die Darstellung kann auf alle oder

JobScheduler - Einleitung 



einzelne JobScheduler-Instanzen bezogen weden. Für jeden gelaufen Job bzw. Auftrag kann das Protokoll 

eingesehen werden. 

Der Tagesplan und die Übersicht über gelaufene Jobs ist geeignet, den Helpdesk bei der Überwachung und ersten 

Analyse zu unterstützen und benötigt keine laufende JobScheduler Instanz. Es ist rein Datenbank basiert. 

JOC (JobScheduler Operations Center) 

Die integrierte JOC View integriert das bekannte Operationscenter in JID. Es können beliebig viele Sichten 

geöffnet werden. Die Integration von JOC ist beim Aufruf unter Linux deaktiviert. Wenn eine Mozilla-Instanz 

installiert ist, kann sie im Script dashboard.sh aktiviert werden (s.u.).

JobScheduler - Installation 

2 Installation 



JID wird zusammen mit JobScheduler installiert. Bei bestehenden Installationen wird es bei einem Update 

hinzugefügt. Zusätzlich steht ein Setup für JID zur Verfügung, das nur JID installiert. 

Das Tagesplan Addon besteht aus 2 Jobs und einem Report zur Darstellung. Der Report zeigt die geplanten Läufe 

für alle JobScheduler an. Die Jobs werden auf den JobScheduler installiert, für die ein Tagesplan erstellt werden 

soll. Außerdem kann JOC (JobScheduler Operations Center) in JID integriert werden. 

2.1 Spracheinstellung 

Die Sprache wird entsprechend der lokalen Einstellungen des Betriebssystems verwendet. Sie kann ebenfalls über 

die Umgebungsvariable SOS_LOCALE=en|de gesetzt werden. 

2.2 Anpassen der Konfiguration 

Folgende Konfigurationsdateien konfigurieren JID. 

1.) ./bin/dashboard.sh|cmd 

In dieser Datei werden die Aufrufparameter für das JID eingestellt. 

• set enable_joc=true|false: 

Aktiviert/Deaktiviert die Einbindung von JOC in JID. Im Auslieferungszustand für Windows ist dieser Wert auf 

true eingestellt. Auf false sonst. 

• set enable_joe=true|false: 

Aktiviert/Deaktiviert die Einbindung von JOE in JID. Im Auslieferungszustand für Windows ist dieser Wert auf 

false eingestellt. 

• set enable_job_start=true|false: 

Aktiviert/Deaktiviert die Möglichkeit, Jobs und Aufträge direkt aus dem JID heraus zu starten. 

2.) ./config/live/sos/daily_schedule/CheckDaysSchedule.job.xml 

3.) ./config/live/sos/daily_schedule/CreateDaysSchedule.job.xml 

Die Konfigurationsdateien der beiden Jobs werden mit JOE (JobScheduler Object Editor) bearbeitet. Die 

Konfiguration muss um die Startzeit ergänzt werden




Der Job CreateDaysSchedule.job.xml sollte einmal täglich laufen. Er kann jederzeit wiederholt werden. Der Job 

CheckDaysSchedule.job.xml sollte periodisch laufen, zum Beispiel alle 5 Minuten. Der Job gleicht den Tagesplan 

mit den gelaufenen Jobs ab. 

In der Datei ./config/hibernate.cfg.xml werden die Datenbankeinstellungen vorgenommen. 

4.) ./config/hibernate.cfg.xml 

Diese Datei beinhaltet die Angaben für die Datenbankverbindung. Sie muss normalerweise nicht verändert werden 

und wird vom Setup entsprechend den gemachten Angaben angelegt. 

Die Anpassung der Datenbankeinstellungen werden mit einem Texteditor vorgenommen. Neben Benutzer und 

Kennwort werden folgende DB-spezifischen Angaben erwartet. 

• hibernate.connection.driver_class 

• hibernate.dialect 

• hibernate.connection.url 

2.2.1 Einstellungen für Oracle 

• hibernate.connection.driver_class: oracle.jdbc.driver.OracleDriver 

• hibernate.connection.url: jdbc:oracle:thin:@localhost:1521:myDb 

• hibernate.dialect: org.hibernate.dialect.Oracle10gDialect 

2.2.2 Einstellungen für MySql 

• hibernate.connection.driver_class: com.mysql.jdbc.Driver 

• hibernate.connection.url: jdbc:mysql://localhost:3306/myDb 

• hibernate.dialect: org.hibernate.dialect.MySQLInnoDBDialect 

2.2.3 Einstellungen für SQL Server 

• hibernate.connection.driver_class: com.microsoft.sqlserver.jdbc.SQLServerDriver 

• hibernate.connection.url: 

jdbc:sqlserver://localhost:1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName= 

myDb 

• hibernate.dialect: org.hibernate.dialect.SQLServerDialect 

2.2.4 Einstellungen für PostgreSQL 

• hibernate.connection.driver_class: org.postgresql.Driver 

• hibernate.connection.url: jdbc:postgresql://localhost/mydatabase 

• hibernate.dialect: org.hibernate.dialect.PostgreSQLDialect


2.2.5 Einstellungen für Sybase 

• hibernate.connection.driver_class: com.sybase.jdbc3.jdbc.SybDriver 

• hibernate.connection.url: jdbc:sybase:Tds:localhost:5000/myDb 

• hibernate.dialect: org.hibernate.dialect.SybaseDialect 

2.2.6 Einstellungen für DB2 

• hibernate.connection.driver_class: com.ibm.db2.jcc.DB2Driver 

• hibernate.connection.url: 

jdbc:db2://8of9:50000/myDb:driverType=2;retrieveMessagesFromServerOnGetMessage=true; 

• hibernate.dialect: org.hibernate.dialect.DB2Dialect 



JobScheduler - Tagesplan erstellen und auswerten 

3 Tagesplan erstellen und auswerten 



Der Tagesplan wird durch den Job /sos/dailyschedule/CreateDaysSchedule erstellt. Der Job erstellt den Tagesplan 

für den aktuellen Tag. Mit dem Parameter dayoffset wird gesteuert, dass Tagespläne für die Zukunft (dayoffset>0) 

oder für die Vergangenheit (dayoffset




Der Filter für den Zeitraum bezieht sich sowohl auf die Liste mit den geplanten bzw. gelaufenen Jobs, als auch auf 

die Detailliste pro Job/Auftrag. Die Filter des Kontextmenus (zum Beispiel "heute") beziehen sich auf die 

Hauptlisten. 

Die Spalten sind sortierbar. Das Spalten-Layout bleibt beim Sitzungswechsel erhalten. 

3.1.1 Mehrere JobScheduler Instanzen simultan mit JOC öffnen 

Wenn das JID das erste Mal gestartet wird, wird die Instanz von JobScheduler in JOC angezeigt, die als erster 

Eintrag in der Tabelle SCHEDULER_INSTANCES gefunden wird. Die Tabelle wird vom Job 

/sos/dailyschedule/CreateDaysSchedule mit den Angaben der Instanz versorgt, auf der der Job läuft. 

Weitere Instanzen können geöffnet werden, indem mit der rechten Maustaste auf den Reiter JOC oder auf den 

Reiter host:port geklickt wird. Im folgenden Fenster wird der Host und der Port der zu öffnenden Instanz 

eingegeben. Es können beliebig viele Instanzen geöffnet werden. Ebenfalls im Menü der rechten Maustaste 

befindet sich die Funktion zum Schließen einer JOC Ansicht. Die letzte Instanz kann nicht geschlossen werden.


3.1.2 Die geplanten, nicht gelaufenen Jobs vom aktuellen Tag anzeigen 



Die geplanten, nicht gelaufenen Jobs vom aktuellen Tag werden angezeigt, wenn in der Ansicht "Geplant" 

nacheinander die Filter "Nur Jobs", "verspätet", "wartend", "heute" ausgewählt werden. 

3.1.3 Die fehlerhaft gelaufenen Jobs von gestern anzeigen 

Die fehlerhaft gelaufenen Jobs von gestern werden angezeigt, wenn in der Ansicht "History" als Zeitspanne das 

gestrige Datum eingestellt wird. Anschließend werden der Filter "Nur Jobs" aktiviert und nach der Spalte "Exit" 

sortiert. Die fehlerhaften Jobs werden rot am Anfang der Liste dargestellt. 

3.1.4 Einen Job ausblenden 

Bestimmte Jobs können aus der History Ansicht ausgeblendet werden. Dazu wird aus dem Kontextmenü die 

Funktion "Zur Ignorliste" hinzufügen ausgewählt. Im Titel wird angezeigt, wieviele Jobs ausgeblendet sind. Die 

Ignoreliste kann an- und abgeschaltet werden. Außerdem kann die Ignoreliste zurückgesetzt werden. Die 

Ignoreliste wird beim Neustart wieder hergestellt. 

3.1.5 Das Suchfeld 

Mit dem Suchfeld kann mittels einer Volltextsuche die aktuelle Liste weiter eingeschränkt werden. Es wird in den 

Spalten "Job", "Job Chain" und Order gesucht. 

3.1.6 Die aktuell laufenden Jobs anzeigen 

Die aktuell laufenden Jobs werden in der Ansicht "History" angezeigt, wenn nach der Spalte Start sortiert wird. Die 

aktuell laufenden Jobs werden mit einem grauen Hintergrund dargestellt. Genau genommen werden die Einträge 

dargestellt, die keine Ende Zeit haben. Das können auch Jobläufe sein, die durch einen Taskabbruch beendet 

wurden. 

3.1.7 Wann werden Aufträge als fehlerhaft gekennzeichnet? 

Aufträge werden als fehlerhaft gekennzeichnet (roter Hintergrund in der Ansicht "History"), wenn ihr Status "fehler", 

"error" oder "fault" enthält oder mit ! beginnt. 

3.2 Farbcodes für unterschiedliche Auftragsstati 

Einen schnellen Hinweis über den Status eines Auftrags wird mit unterschiedlichen Hintergrundfarben gegeben. 

Die möglichen Stati und zugeordneten Farben sind von den Reitern abhängig.


3.2.1 Farbcodes für die geplanten Aufträge 

Weiß Gestarted, punktlich 

Grau Wartet auf Start 

Gelb Verspätet gestartet 

Rot Fehlerhaft gelaufen 

Magenta Nicht gestartet, verspätet, wartend 

Blauer Text Periodischer Job: Wird immer mit weißem Hintergrund gezeigt 

3.2.2 Farbcodes für die Auftragshistorie 

Weiß Erfolgreich gelaufen 

Rot Fehlerhaft gelaufen 



JobScheduler - Glossar 

Glossar 

Auftrag 

Job 

Job-Kette 

JOC (JobScheduler Operations Center) 

JOE (JobScheduler Object Editor) 



Ein Auftrag aktiviert die Verarbeitung einer Job-Kette. Der Auftrag enthält die Parameter für die Jobs einer 

Job-Kette. Jeder Job der Job-Kette hat Zugriff auf die Parameter eines Auftrags. Auftrag-Parameter 

überschreiben gleichnamige Job-Parameter. Ein Auftrag kann eine Zeitsteuerung enthalten. 

Ein Auftrag durchläuft nacheinander die Jobs einer Job-Kette. Tritt ein Verarbeitungsfehler in einem Job auf, 

dann kann konfiguriert werden, dass der Auftrag... 

• aus der Job-Kette entfernt wird. 

• von einem weiteren Job der Kette ausgeführt wird. 

• vom fehlerhaften Job wiederholt ausgeführt wird. 

• in der Kette am fehlerhaften Job stehen bleibt, dass heißt die Verarbeitung des Auftrag wird 

ausgesetzt, bis dieser wieder manuell fortgesetzt wird. 

Programme und Skripte, die vom JobScheduler ausgeführt werden sollen, müssen in Jobs eingebettet 

werden. Jobs können beliebige ausführbare Dateien starten oder Job-Skripte enthalten, die die 

Programmschnittstelle des JobScheduler verwenden. Jobs können in mehreren Instanzen (Tasks) 

ablaufen, wenn dies zur Skalierung der Leistung gewünscht ist. 

Es wird zwischen Standalone-Jobs und Auftrags-Jobs unterschieden. Während Auftrags-Jobs durch 

Aufträge innerhalb einer Job-Kette gestartet werden, können Standalone-Jobs davon unabhängig gestartet 

werden, dass heißt manuell, durch eine Zeitsteuerung oder per Verzeichnis-Überwachung. Standalone-Jobs 

können nicht in Job-Ketten eingereiht werden. 

Eine Reihe von Jobs, die nacheinander Aufträge verarbeiten. Der JobScheduler startet die Jobs einer 

Job-Kette automatisch, wenn ein Auftrag eintrifft. Job-Ketten bieten die Möglichkeit mehrere Aufträge parallel 

zu verarbeiten, indem die Jobs in mehreren Instanzen (Tasks) gestartet werden. 

JOC (JobScheduler Operations Center) ist die Oberfläche des JobScheduler zur Überwachung und 

Steuerung der JobScheduler Objekte, also zum Beispiel Jobs, Job-Ketten und Aufträge. 

_JOC öffnen Sie im Browser mit http://[scheduler_host]:[scheduler_port], wobei 

[scheduler_host] und [scheduler_port] der Hostname und die Nummer des TCP Ports des 

JobScheduler sind (z.B. http://localhost:4444). 

JOE ist der JobScheduler Object Editor. Mit ihm können die JobScheduler Objekte (Jobs, Job-Ketten, 

Aufträge, Schedules, Prozess-Klassen, Sperren) konfiguriert werden. 

Gestartet wird JOE mit dem Skript: 

• $SCHEDULER_HOME \bin\jobeditor.cmd (Windows) 

• $SCHEDULER_HOME /bin/jobeditor.sh (Unix)

JobScheduler - Glossar 

Schedule 



Die Zeitsteuerung eines Jobs oder Auftrags kann direkt am Job oder Auftrag angegeben oder in einem 

Schedule ausgelagert werden. Dem Job oder Auftrag wird dann lediglich der Schedule zugewiesen. Falls 

mehrere Jobs oder Aufträge die gleiche Zeitsteuerung haben sollen, braucht man diese so nur einmal zu 

formulieren. Überdies können Schedules für einen bestimmten Zeitraum andere Schedules ersetzen. So 

erreicht man in der Verwendung von Schedules noch mehr Flexibilität bei der Zeitsteuerung.

JobScheduler Information Dashboard - Sos-berlin.com

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?