PDAP- Scheduler Installation & Einrichtung Stand: August2007 Scheduler Seite 1
Inhaltsverzeichnis Installation InstallationdesPDAP-Schedulers... 3 EinrichtungderDatenbankverbindung... 7 EinrichtungdesSchedulers DieSchedulerAnmeldung... 9 SchedulerEinstellungen... 10 Aktivierungdes Schedulers... 10 InstallationderScheduler-Tasks...11 EinrichtungderJobs DerSchedulerJobmanager... 12 DerEMailDienst... 13 DerDatenimport... 15 BenutzungderHilfen PDAP-Scheduler... 18 SchedulerJobmanager... 18 SchedulerTasks... 18 Spezialfälle DatenimportinmehrereDatenbanken... 19 1.)Anpassung derini-datei... 19 2.)Die Import-beschreibungen... 19 3.)Das Importverzeichnis... 20 4.)Anlegen derschedulerjobs... 20 Seite 2
Installation Installationdes PDAP-Schedulers Umdie Installationzu beginnen, startensiebittediedatei Setup.exe. Die nachfolgendenabbildungenzeigen imeinzelnen,welche Meldungenwährendder Installationangezeigt werden. BetätigenSiedie Schaltfäche Weiter. Seite 3
MöchtenSiedenSchedulerineinemanderenVerzeichnisinstallieren? DannklickenSieaufdieSchaltfläche Ändern undwählensiedort einandereszielverzeichnisaus. Seite 4
KlickenSie aufdieschaltfläche Installieren,ummit derinstallation zubeginnen. Seite 5
KlickenSieaufdieSchaltfläche Fertigstellen,umdieInstallation abzuschließen. Seite 6
Einrichtungder Datenbankverbindung Nachder ProgramminstallationmüssenSiedenScheduler einmal startenumdierestlichensystemeinrichtungendurchzuführen.beim Programmstart wird alserstesdieverbindungzur Datenbankeingerichtet.Eserscheint hierzu derpdapdatenbankassistent. Seite 7
WählenSie andieser StelleIhrenDatenbanktypausundklickenSie dieschaltfläche Weiter. BeiSchritt 3kannderAssistent abgebrochenwerden,da abhier die nötigedateischeduler.inibereitserstellt wurde. Seite 8
EinrichtungdesSchedulers DieScheduler Anmeldung UmdenScheduler zu starten, wirdeingültigerbenutzeraccount benötigt. Zudemmussder entsprechende Benutzer über dienötigen Rechteverfügen, denscheduler zu starten. FürdenSchedulerwirddasRecht Ändern imscheduler Jobmanagerbenötigt. DieVergabederRechte wirdimpdap,unter dem Menüpunkt System > Benutzergruppenrechte,vorgenommen. Ist dieberechtigunggegeben, kanndieanmeldungdurchgeführt werden.startensiedenscheduler, gebensiebenutzernameund Kennwort einundbestätigensie mit der Schaltfläche OK. Seite 9
Scheduler Einstellungen BeimerstenStart desschedulersöffnensichzunächst die Einstellungen. Hier habensie die Möglichkeit,diverse Einstellungen bezüglichdes Schedulersvorzunehmen.Für weitereinformationenhierzu schauen Sieinder Scheduler Hilfenach. Siekönnendiesedirekt mit der F1- Tasteerreichen.NehmenSiediegewünschtenEinstellungenvor und übernehmensiediesemit der Schaltfläche Schließen. Siekönnen dieeinstellungenauchjederzeit überdieschaltfläche Einstellungen erreichen Aktivierungdes Schedulers Mit der Schaltfläche Start wird der Scheduleraktiviert. Der Timer läuft nunundangelegte JobswerdenZeitgesteuert ausgeführt. Sie könnendenaktivierungsstatusauchanderfärbung destnaicons (TaskbarNotificationArea) indertaskleistelinksnebenderuhr erkennen.grünbedeutet,der Schedulerist aktiv. Sie können den Scheduler jetzt vor unbefugtem Zugriff schützen, indemsie ihnmit der Schaltfläche Verkleinern minimieren. Umden Schedulernunwiederzu öffnen,machensieeinendoppelklickauf dastnaiconund meldensie sichmit IhremBenutzernamenund Passwort erneut an. Seite10
Installationder Scheduler-Tasks NachdemProgrammstart desschedulers, wurdenallescheduler- TasksimUnterordnerdesSchedulerProgrammverzeichnisses \Tasks indiedatenbankeingetragen. Somit stehendieseim Scheduler Jobmanager despdapzurauswahlundeskönnenentsprechende Zeitpläne angelegt werden. SolltenweitereTasksimTasksverzeichnisdesSchedulershinzukommen,werdendiese, sofernder Scheduler aktiviert ist, automatischin diedatenbank eingetragen.sollte der Scheduler nicht aktivsein,kann dieeintragung desneuentasksauchmanuellüber dieschaltfläche Aktualisieren durchgeführt werden. Seite11
EinrichtungderJobs DerScheduler Jobmanager Die Jobs werdeninnerhalb despdap,mit Hilfe desscheduler Jobmanagers,angelegt. Den Jobmanager finden Sie unter dem Menüpunkt System. ÖffnenSie diesenper Doppelklickund eserscheint folgendesfenster. Umnun einen Job anlegen zu können,betätigen Sie die Schaltfläche Neu inderoberenbuttonleistedespdaps.nachdemausfüllender einzelnenfelder,betätigensieabschließenddieschaltflächespeichernund wechselnsie mit der SchaltflächeAnzeigenwiederinden entsprechendenmodus. Seite12
DerEMailDienst Bevor Sie einen Job für den EMailDienst anlegen,nehmen Sie die nötigen Konfigurationen am EMailDienst vor.hierzu finden Sie im ProgrammverzeichnisdesSchedulersimUnterverzeichnisTasksdas KonfigurationsToolmit demnamencontrolpanel.exe StartenSie dieses. NehmenSiediegewünschtenEinstellungenvorund übernehmensie diese.wichtig fürdie Lauffähigkeit sind diedatenbankeinstellungen, soferndiese vondenvorgabenabweichen,unddie SMTPEinstellungen,damit dertaskemailsverschickenkann. Seite13
Nunkönnen Sie mit demanlegen des Jobs beginnen. WählenSie zuerst einen Namenfür den Job und wählen Sie dentask MailErinnerungsdienstfür Reklamationen. Sie habendie Möglichkeit alsparameter /mode:heute einzutragen. Mit diesemparameter erinnert deremaildienst ausschließlichan TerminedesaktuellenDatums. Dieskönnte z.b.dazu benutzt werden, 2 Jobsanzulegen.Einer, der jedentag anaktuelletermine erinnert und einenweiteren,der alle 3 Tageanüberschritteneerinnert. Außerdemgibt esdie Möglichkeit eineverzögerungintagenanzugeben.also könnensie z.b.antermine erinnernlassen, diemindestens um3 Tage überschritten sind indemsie als Parameter /delay:3 angeben. Weiter müssensienochdenstartzeitpunkt setzenund einintervall wählen. Zuletzt setzensie dieaktivierung auf Bereit und speichern denjob. Jetzt taucht der Jobinder entsprechenden Liste des Schedulersauf. Wennder Scheduleraktivist,wird deremaildienst nunnachdem angegebenen Zeitplanausgeführt. Seite14
DerDatenimport FürdenDatenimport musszuerst eine Importbeschreibungexistieren. StellenSie sicher, dassdieseunter Tools>Datenimport vorhanden ist. Seite15
AlsnächsteslegenSiedasImportverzeichnis,mit Hilfe desparameterssys_inf_erp_import_verz,indenglobaleneinstellungen fest,ausdemder Datenimport später seinedatenbeziehen soll. Wirdder Parameterleer gelassen,benutzt der Dateimport dasver- zeichnis: PDAP-Scheduler- Programmverzeichnis \Tasks\Datenimport\SAP. Seite16
SindalleVorkehrungengetroffen,kannder Jobangelegt werden. Tragen Sie einen Namen für den Job ein und wählen Sie den Task Stammdatenimport aus. AlsParameter müssensiedennamender Importbeschreibungmit dempräfix /idf: angeben. DerName musshierbeiexakt so übergebenwerden,wiediebeschreibung imdatenimporttooldespdap benannt ist. Sollteder Name Leerzeichenenthalten, musser nochin Anführungszeichengesetzt werden. Beispiel:/idf: SAPR3ImportVorlage DanachlegenSiedenStartzeitpunkt und dasintervallfest. Damit ist dieeinrichtungdeszeitgesteuertendatenimportsabgeschlossenund der Scheduler, soferner aktivist, wirddentasknunim angegebenenintervallausführen. Seite17
BenutzungderHilfen PDAP-Scheduler Scheduler Jobmanager SchedulerTasks Die Scheduler Hilfe lässt sichüber den Menüpunkt Hilfe im Scheduleraufrufen, oder direkt per F1-TasteimFensterdes Schedulers. DieHilfe fürdenscheduler JobmanagererreichenSiedirekt indem Sie imfenster des Jobmanagers die F1-Taste betätigen. Die Hilfe der einzelnentasks lassen sich kompfortabelüber den Scheduler Jobmanagererreichen.Hierzu wählensiedenentsprechendentask undbenutzendieschaltfläche nebendemfeld,umdie DetailsdesTasksanzuzeigen. Indem sichöffnendenfenster lässt sichdanndie Hilfeüber die Schaltflächemit demfragezeichenöffnen. Seite18
Spezialfälle Datenimportin mehrere Datenbanken 1.)Anpassung derini-datei Zunächst müssendienötigenanpassungenanderdatei Datenimport.inigetätigt werden. DieDateibefindet sichimprogrammverzeichnisdesschedulers.im Unterverzeichnis\Tasks\Datenimport\Datenimport.ini. Hier mussfür jededatenbank eineentsprechende Sektionangelegt werden,dieunteranderemdenservernamenenthält. [DB-A]... SERVER NAME=wgs_pdap_orcl_1 USER NAME=pdap... [DB-B]... SERVER NAME=wgs_pdap_orcl_2 USER NAME=pdap... WennSienicht sicher sind, können sie diesektionenauchausder pdap.iniimjeweiligenpdapprogrammverzeichniskopieren. 2.) Die Import-beschreibungen DieImportbeschreibungenmüssenjeweilsinder Datenbankabgelegt sein,in dieimportiert werdensoll. D.h.: ImportbeschreibungAin Datenbank A ImportbeschreibungBinDatenbank B Seite19
3.) Das Importverzeichnis IndeneinzelnenDatenbankenmussdasjeweiligeImportverzeichnis angegeben sein. Dieses wird über den globalen Parameter SYS_INF_ERP_IMPORT_VERZindenglobalenEinstellungen angegeben.eskönnenauchverschiedeneverzeichnissefür dieverschiedenendatenbankenbenutzt werden. 4.)Anlegen derschedulerjobs Jetzt können mit HilfedesScheduler JobmanagersdesPDAP die Jobs angelegt werden. Diesewerdenalle ineinerdatenbank abgelegt und zwar injener,mit derder Scheduler verbundenist.hier könnenauch später die Logs eingesehenwerden. Für jede Datenbank,in die Importiert werden soll, muss ein Job angelegt werden.alsparametermüssenjeweilsdienamender Importbeschreibungen, sowiedieverbindungsparametermit dem NamenderjeweiligenSektioninderDatenimport.iniDateieingetragenwerden. Seite20
SobaldSie danndenzeitplanfestgelegt haben,ist dieeinrichtung abgeschlossenund nachdemdiezu ImportierendenDatenimImportverzeichnis abgelegt wurden,können die Importe nun Zeitgesteuert vonscheduler durchgeführt werden. DieeinzelnenDatenimportekönnenauchzeitgleichlaufen. Seite21
Vorwort: Der PDAP Scheduler wird eingesetzt, um Jobs zeitlich gesteuert auf einem Server auszuführen. Beispielsweise könnte der Scheduler einmal pro Tag eine Synchronisation der Stammdaten mit einem SAP-System vornehmen oder per email an Terminüberschreitungen erinnern. Praktisch alles ist möglich. Und alles lässt sich bequem aus dem PDAP hearaus von überall administrieren. Außerdem werden alle Einstellungen und Änderungen in der Datenbank protokolliert und können so stets nachvollzogen werden. Bei auftretenden Fehlern werden Sie sogar per email benachrichtigt. Das Prinzip: Alle verfügbaren Tasks werden im Ordner "Tasks" im Programmverzeichnis des Schedulers abgelegt. Beim Start des Schedulers wird der Ordner durchsucht, und alle gültigen Tasks werden in die Datenbank aufgenommen. Vom Scheduler Jobmanager des PDAP aus, können nun die Tasks im Tasksordner des Schedulers ausgewählt werden und Zeitpläne für diese erstellt werden. Die Bedienung des Jobmanagers entnehmen Sie bitte der PDAP Hilfe. Sobald der Scheduler aktiviert wird, wird überprüft, ob ein Startzeitpunkt überschritten wurde. Ist dies der Fall, wird der jeweilige Task gestartet. Jobs mit hoher Priorität werden hierbei zuerst berücksichtigt. Es werden so viele Jobs gestartet, bis die maximale Anzahl gleichzeitig laufender Jobs, die Sie in den Einstellungen selbst wählen können, erreicht ist. Alle weiteren Jobs werden zum nächstmöglichen Zeitpunkt gestartet. Für diesen Fall besteht die Möglichkeit auszuwählen, ob der nächste Startzeitpunkt vom letzten geplanten Startzeitpunkt aus oder vom eigentlichen Startzeitpunkt aus berechnet werden soll. Die Überprüfung der Startzeiten erfolgt in einem von ihnen gewählten Intervall, das sich ebenfalls in den Einstellungen angeben lässt. Die einzelnen Tasks kommunizieren zu ihrer Laufzeit mit dem Scheduler. Sie können Fehler, Abbrüche oder erfolgreiche Abschlüsse melden. Beim stoppen oder beenden des Schedulers werden alle laufenden Jobs abgebrochen. Erste Schritte
Anmeldung Um den Scheduler starten zu können, müssen Sie sich mit einem PDAP Benutzeraccount anmelden. Beachten müssen Sie hierbei, dass der Benutzer über die nötigen Rechte verfügt den Scheduler zu starten. Der Benutzer benötigt das Recht "Ändern" für den Scheduler Jobmanager im PDAP.
Erste Schritte Zuerst kopieren Sie Ihre zu planenden Tasks in den Ordner "Tasks" im Programmverzeichnis des Schedulers. Wenn Sie eine komplette Schdulerinstallation durchgeführt haben, ist dieser Schritt bereits geschehen. Anschließend starten Sie den Scheduler. Sollte der Scheduler bereits laufen, benutzen Sie einfach die Schaltfläche "Aktualisieren". Nun können Sie im PDAP den Scheduler Jobmanager benutzen, um Zeitpläne für die einzelnen Tasks festzulegen, sog. Jobs. Jetzt kann der Scheduler über die Schaltfläche "Start" aktiviert werden, wenn er nicht bereits aktiv ist. Die Benutzeroberfläche
Die PDAP Scheduler Benutzeroberfläche 1: In dieser Tabelle werden die für den Scheduler geplanten Jobs inklusive aller nötigen Informationen angezeigt. Im folgenden wird die Bedeutung der einzelnen Spalten erklärt. Job Name: Task: Parameter: Startzeitpunkt: Letzter Start: Status: Diese Spalte zeigt die Bezeichnung des geplanten Jobs, die beim Anlegen des Jobs aus dem PDAP angegeben wurde. Die Bezeichnung des zu startenden Tasks. Die Startparameter, die beim Start des Jobs übergeben werden. Der nächste planmäßige Startzeitpunkt. Der Zeitpunkt an dem der Job zuletzt gestartet wurde. Zeigt, ob ein Job bereit ist, ausgesetzt ist oder, bei einmalig laufenden Jobs, fertig ist. L. Ergebnis: Zeigt an, mit welchem Ergebnis der Job abgeschlossen wurde. Die Möglichkeiten sind: Beendet: Wenn der Job erfolgreich abgeschlossen wurde. Abbruch: Wenn der Job abgebrochen wurde. Fehler: Wenn ein Fehler aufgetreten ist. Wartet: Wenn ein Task mehrfach gestartet wird, obwohl er dies nicht darf. Jobdauer: Zeigt an, wie lange der Job bei der letzten Ausführung gelaufen ist. Priorität: Zeigt, die Priorität des Jobs. ( "Wichtig" oder "Normal" ) Intervall: Zeigt das Intervall an, in dem der Job gestartet werden soll. Erw. Intervall: Zeigt das evtl. erweiterte Intervall. Ist hier z.b. eine 3 eingetragen und das Intervall ist "Täglich", wird der betroffene Job alle 3 Tage ausgeführt. 2: Dieser Teil des Fensters zeigt ein Fehlerprotokoll. Tritt ein Fehler auf, wird er hier
dokumentiert. Zum Löschen der Einträge löschen sie die Datei "Error_Log.txt" im Scheduler Programmverzeichnis. Der Schduler muss dazu beendet wereden. 3: Die Schaltfläche "Aktualisieren" aktualisiert die Tabelle der geplanten Jobs, überprüft, ob alle Jobs im Ordner Tasks bereits in der Datenbank vorhanden sind und fügt ggf. neue ein. 4: Mit dieser Schaltfläche lässt sich das Fehlerprotokoll ein- und ausblenden. 5: Öffnet die Einstellungen. 6: Startet bzw. stoppt den Scheduler. Je nach dem, ob er bereits läuft. Hinweis: Wird der Scheduler gestoppt, werden alle laufenden Jobs abgebrochen. 7: Stoppt und beendet den Scheduler. 8: Diese Schaltfläche minimiert den Scheduler. Er ist dann als kleines Zahnrad in der Taskleiste rechts, neben der Uhr, zu sehen. 9: Zeigt die Zeit in Sekunden an, bis zur nächsten Aktion. Die Einstellungen In den Einstellungen lassen sich folgende Optionen konfigurieren: Prüfintervall: Nächsten Startzeitpunkt: Max. Anzahl...: Autostart: Das Zeitintervall in dem geprüft wird, ob ein Job den Starttermin überschritten hat. Hier wählen Sie, ob der nächste Startzeitpunkt vom letzten geplanten aus oder vom tatsächlichen Startzeitpunkt aus berechnet werden soll. Hinweis: Größere Differenzen zwischen diesen beiden Zeiten können auftreten, wenn die maximale Anzahl gleichzeitig laufender Jobs erreicht wurde oder der Scheduler zum geplanten Zeitpunkt nicht läuft. Hier können Sie angeben, wie viele Jobs maximal gleichzeitig laufen dürfen. Hier geben Sie an, ob der Scheduler mit Windows zusammen gestartet werden soll. Außerdem entscheiden Sie, ob der Scheduler bei der Anmeldung aller
Windows-Benutzer gestartet wird oder nur bei der Anmeldung des aktuellen Benutzers. Auch wenn Sie sich für alle Benutzer entscheiden, wird der Scheduler bei weiteren Benutzeranmeldungen nicht mehrfach gestartet. Näheres zur Autostart-Funktion finden Sie hier. Anmelden als: Hier können Sie wählen, mit welchem Benutzeraccount sich der Scheduler beim Autostart am PDAP-System anmelden soll. Startverzögerung: Geben Sie an, wie lange der Scheduler beim Autostart auf die Datenabnk warten soll email-benachrichtigung:wenn Sie hier den Haken setzen, werden sie bei Auftreten von Fehlern unter der unten angegebenen email-adresse benachrichtigt. SMTP-Host: Die Adresse des Mail-Servers, über den die email-benachrichtigungen verschickt werden sollen. email-empfänger: email-absender: Adresse des Empfängers für die email-benachrichtigungen. Absenderadresse für die Benachrichtigungen. ( Wird benötigt, da der Mail-Server die Mail eventuell abweisen könnte, wenn sie eine unbekannte Absenderadresse enthält. )
Autostart Um den Scheduler bei der Windows Anmeldung automatisch starten zu lassen, müssen Sie folgende einfache Schritte durchführen. Öffnen Sie die Einstellungen über die Schaltfläche "Einstellungen" im Scheduler Hauptfenster. Dann setzen Sie den Haken für die Option "Autostart" und wählen aus, ob der Scheduler bei der Windows-Anmeldung aller Benutzer oder nur des aktuellen Benutzers gestartet werden soll. Sollten Sie sich für alle Benutzer entscheiden, wird der Scheduler bei der Anmeldung mehrerer Windows-Benutzer nicht mehrfach ausgeführt, sondern nur mit der Anmeldung des ersten Benutzers gestartet. Außerdem müssen Sie noch einen Benutzeraccount, im Menüpunkt "Anmelden als" wählen, mit dem der Scheduler sich automatisch am PDAP-System anmeldet. Hinweis: Achten Sie bitte darauf, dass der gewählte Benutzer über die nötigen Rechte verfügt, den Scheduler zu Starten. Es wird das Recht "Ändern" für den Scheduler Jobmanager im PDAP benötigt. Bei Bedarf können Sie auch eine Startverzögerung angeben. Diese wird z.b. benötigt, wenn der Scheduler auf dem Datenbank Server läuft und der Scheduler schneller als die Datenbank startet. Nun wird der Scheduler ab der nächsten Windowsanmeldung automatisch gestartet. Beim automatischen Start wird der Scheduler minimiert in der TNA ( Symbol links neben der Windows Uhr ) gestartet. Ins Scheduler Fenster gelangen sie jetzt per Doppelklick auf das Scheduler Symbol oder über des Menü, das sich per Rechtsklick auf das Scheduler Symbol öffnen lässt. Bevor sich das Fenster jedoch öffnet, erscheint eine Passwortabfrage.