====== 1. Dispatcher Error Mailbenachrichtigung einrichten ======
===== 1.1 Service.properties editieren =====
Die Datei Service.properties befindet sich unter folgendem Pfad auf dem Server
C:\plm\dispatcher\DispatcherClient\conf\Service.properties
{{:dispatcher_error_mail_001.png?direct|}}
* Service.properties im Editor öffnen und nach folgendem Abschnitt suchen (ca. ab Zeile 236):
##############################################################################
#
# E - M A I L
#
# The following are the recognized Dispatcher Client e-mail properties:
#
# Name : Service.Email.AdminEmailId
# Description : Adminstrator e-mail addresses to receive notification.
# specified e-mail inbox
# Value : One or more valid, comma delimited, e-mail addresses. If a
# different address delimiter must be used, it must be specified
# as the Service.Email.AdminEmailIdDelimiter property value.
#
Service.Email.AdminEmailId=
#
# Name : Service.Email.AdminEmailIdDelimiter
# Description : The delimiter used for AdminEmailId property value.
# Value : A valid delimiter character
# Default value : ,
#
Service.Email.AdminEmailIdDelimiter=,
#
# Name : Service.Email.SMTPServerName
# Description : Server used for basic text messaging
# Value : A valid IP address of the SMTP Server
#
Service.Email.SMTPServerName=LOCALHOST
#
# Name : Service.Email.SendUserEmailOnError
# Description : 0 = off
# 1 = Turn on e-mail based notification for Teamcenter users
# that create translation requests. When a translation
# error occurs, e-mail will be sent to the e-mail address
# specified for the user that owns the translation
# request.
# Value : 0 or 1
#
Service.Email.SendUserEmailOnError=0
#
# Name : Service.Email.SenderId
# Description : All adminstrator and user error notifications sent via e-mail
# will use this value as the e-mail sender address.
# Value : A single valid e-mail address.
# Default value : The Dispatcher Client name.
#
Service.Email.SenderId=CHANGE_ME@LOCALHOST
#
# Name : Service.Email.EmailSubjectPrefix
# Description : This set of characters is prepended to the subject
# of the e-mail
# Value : String
#
Service.Email.EmailSubjectPrefix=[TS_ERROR]
###############################################################################
Folgende Einträge müssen editiert werden:
Service.Email.AdminEmailId=**your_admin_mail_adress@domain.com**\\
Service.Email.AdminEmailIdDelimiter=,\\
Service.Email.SMTPServerName=**mail.domain.com**\\
Service.Email.SendUserEmailOnError=**1**\\
Service.Email.SenderId=**noreply@domain.com**\\
Service.Email.EmailSubjectPrefix=**[DISPATCHER-ERROR]**\\
* Dispatcher Client Dienst stoppen/starten\\ \\ Damit die Änderungen aktiviert werden muss der Dispatcher Client Dienst gestoppt und wieder gestartet werden.\\ \\
* Dienst über das Icon "STOP DC" auf dem Desktop stoppen\\ \\ {{:dispatcher_error_mail_002.png?direct|}}\\ \\
* Dienst über "Dienste" wieder starten\\ \\ {{:dispatcher_error_mail_003.png?direct|}}\\ \\
* Kontrolle im Log: "C:\plm\dispatcher\Logs\Dispatcher\process\DispatcherClient_192.168.0.226_2099.log" ob dienst korrekt läuft\\ \\ Beispiel:\\ \\
2020-10-27 14:11:17,870 INFO - Aktualisierte Aufgaben-ID: Ua612219285f981aeb1946 DELETE
2020-10-27 14:32:16,714 INFO - Connecting to DispatcherClient on Port: 2099
2020-10-27 14:32:16,800 INFO - Connected to DispatcherClient on Port: 2099
2020-10-27 14:32:16,801 INFO - Dienst wird angehalten...
2020-10-27 14:32:17,145 INFO - Stopped DispatcherClient.
2020-10-27 14:35:00,301 INFO - Dienst wird gestartet...
2020-10-27 14:35:00,308 INFO - In 4tier mode. Url is http://etc-dev:7070/tc
2020-10-27 14:35:00,314 WARN - TC_USE_KEYMANAGER environment variable is configured to not use KeyManager.
2020-10-27 14:35:02,477 INFO - Anmeldung an TC-Server abgeschlossen.
2020-10-27 14:35:02,552 INFO -
2020-10-27 14:35:02,552 INFO - Connected to Scheduler on Url rmi://localhost:2001
2020-10-27 14:35:03,571 INFO - Anforderungsstatus-Verwaltungsaufgabe wird geplant. Intervall in Minuten: 30
2020-10-27 14:35:03,573 INFO - Verarbeitung der Datenbankanforderungen wird gestartet.
===== 1.2 Test durch provozieren eines Fehlers =====
Beispiel:
* Neues Item erstellen "Dispatcher Test"\\ \\
* Neues Word.docx Dataset erstellen\\ \\ {{:dispatcher_error_mail_004.png?direct|}}\\ \\
* Vorbereitung korrupte Word Datei:\\ PNG Bilddatei aus Internet laden, auf dem Desktop abspeichern und in Test.docx umbenennen\\ \\
* Check Out des Word Data Sets\\ \\ {{:dispatcher_error_mail_005.png?direct|}}\\ \\
* Rechtsclick und "Named References..." wählen\\ \\
* Auf "Upload" klicken und die Datei Test.docx vom Desktop wählen\\ \\ {{:dispatcher_error_mail_006.png?direct|}}\\ \\
* Named References mit close schliessen\\ \\
* Check In des Word Data Sets\\ \\
* Dataset ausgewählt lassen und die Translation über das Menü "Translation -> Translate" starten und bei Service pdf wählen\\ \\ {{:dispatcher_error_mail_007.png?direct|}}\\ \\
* Über die Administrations Console den Vorgang überwachen, der nun auf einen Fehler läuft und unter State "TERMINAL" zurück gibt
=> Nun wird eine Email mit der Fehlermeldung versendet
Inhalt der Mail:
[DISPATCHER-ERROR]DispatcherClient_192.168.0.226_2099:Ua612236e05f983276180a
Fehlerbericht aus "DispatcherService"
Konvertierungsanforderungsdetails --
Aufgaben-ID:Ua612236e05f983276180a
Anbieter:SIEMENS
Konvertierer:avamsofficetopdfvbs
Datum:27-Oct-2020 15:45
Primäre und sekundäre Objektliste --
Primäres Objekt:000153/A
Sekundäres Objekt:000153/A-Dispatcher Test
Benutzername:infodba
Benutzer-E-Mail-ID:Unbekannt
Hostname:eTC-Dev
Kommentar:Error returned by the translator...
Fehlerbericht:Konvertierung auf Grund nicht erzeugter Dateien fehlgeschlagen.