Schritt-für-Schritt-Anleitung zur Konfiguration eines -Appenders zur Benachrichtigung über Fehlermeldungen und Warnungen der windream-dienste

Transkript

1 Newsletter der windream GmbH Juni 2009 windreamnews Schritt-für-Schritt-Anleitung zur Konfiguration eines -Appenders zur Benachrichtigung über Fehlermeldungen und Warnungen der windream-dienste Im Folgenden erfahren Sie, wie Sie auf einfache Art und Weise einen so genannten -Appender konfigurieren und auf diese Weise keine wichtige Meldung der aktiven windream-dienste verpassen. Das folgende Beispiel erklärt die Konfiguration eines -Appender für Errors und Warnings des windream- Archivierungsdienstes. Weiterführende Informationen erhalten Sie auch im windream- Administrationshandbuch in Kapitel vier ab Seite 72 beziehungsweise in der windreamadmin.chm - Hilfedatei unter dem Stichwort Mail-Appender. Ab windream WM_4_0_1_12_MultiPatch_02 ( ) + WM_4_0_1_12_Logger_Patch_3 bzw. a windream können Meldungen (zum Beispiel Errors und/oder Warnings) von windream Diensten, deren Logging über eine xxxx.log.properties Datei konfiguriert wird, auch per SMTP Mail versand werden. Über geeignete, individuell einzurichtende -Filter in Ihrem -Client behalten Sie so den Überblick über kritische Vorgänge und sind immer auf dem Laufenden. Zum Beispiel wird der Mailversand für Errors/Warnings des Archivierungsdienstes folgendermassen konfiguriert: Schritt 1: Stoppen Sie den Dienst windream Agent" (Archivierungsdienst). Schritt 2: Öffnen Sie die Datei archiveanddelete.log.properties (Auszug siehe unten). Schritt 3: Ergänzen Sie in dieser Datei die Zeile log4cplus.logger.file um MAILMSGS. Schritt 4: Fügen Sie einen #MailAppender -Block für MAILMSGS hinzu. Schritt 5: Konfigurieren Sie die -Parameter. Ein # definiert ein Kommentarzeichen und ist gegebenenfalls zu entfernen, so zum Beispiel bei #PortNumber, #MailUser, #MailPasswort.

2 Newsletter der windream GmbH Seite 2 Legende: MailSender - Adresse des Mail Senders (z.b. windream@yourdomain.com) MailSubjekt - Fixer Betreff der Mail MailServer - Ihr SMTP Mail-Server PortNumber - Portnummer falls anders als 25 MailUser - Username falls Mailserver Authentifizierung notwendig MailPasswort - Passwort falls Mailserver Authentifizierung notwendig MailRecipient - Empfänger LogLevelMin - Minimaler Log-Level, Empfehlung ERROR oder WARN Schritt 6: Hier zunächst ein Auszug aus archiveanddelete.log.properties [... snip...] log4cplus.logger.file=info, FILEMSGS, MAILMSGS [... snip...] # MailAppender log4cplus.appender.mailmsgs=log4cplus::mailappender log4cplus.appender.mailmsgs.mailsender=windream@yourdomain.com log4cplus.appender.mailmsgs.mailsubject=archive Error on windream Server XXXXX log4cplus.appender.mailmsgs.mailserver=myexchangesrv #log4cplus.appender.mailmsgs.portnumber=25 #log4cplus.appender.mailmsgs.mailuser=windream #log4cplus.appender.mailmsgs.mailpassword=windream log4cplus.appender.mailmsgs.mailrecipient=windreamadmin@yourdomain.com log4cplus.appender.mailmsgs.layout=log4cplus::patternlayout log4cplus.appender.mailmsgs.layout.conversionpattern=%d{%y%m%d %H:%M:%S}; [%06t]; [%8p]; [%3x]; %m%n log4cplus.appender.mailmsgs.filters.1=log4cplus::spi::loglevelrangefilter log4cplus.appender.mailmsgs.filters.1.loglevelmin=error log4cplus.appender.mailmsgs.filters.1.loglevelmax=fatal log4cplus.appender.mailmsgs.filters.1.acceptonmatch=true Schritt 6.1: Testen Sie die Einstellungen mit WMLogTest.exe : Starten sie WMLogTest.exe aus dem windream Applikationsverzeichnis. Schritt 6.2: Geben Sie bei Application die properties -Datei an, entweder ArchiveAndDelete oder ArchiveAndDelete.log.properties und klicken Sie dann auf Init Logging.

3 Newsletter der windream GmbH Seite 3 Schritt 6.3: Klicken Sie nacheinander je einmal auf die Buttons Fatal und Error. Sie sollten jetzt bei dem angegebenen -Empfänger, dem MailRecipient, folgende s erhalten haben (je Klick erhalten Sie zwei s): Subject: Archive Error on windream Server XXXXX :55:26; [ 4088]; [ FATAL]; [WMLogTestDlg]; This is my manual WM_FATAL_LEVEL message without parameters. Subject: Archive Error on windream Server XXXXX :55:26; [ 4088]; [ FATAL]; [WMLogTestDlg]; This is my manual WM_FATAL_LEVEL message without parameters. Subject: Archive Error on windream Server XXXXX :56:10; [ 4088]; [ ERROR]; [WMLogTestDlg]; This is my manual WM_ERROR_LEVEL message containing a line with parameters 1=FirstParam 2=222 3=0x Subject: Archive Error on windream Server XXXXX :56:10; [ 4088]; [ ERROR]; [WMLogTestDlg]; This is my manual WM_ERROR_LEVEL message without parameters.

4 Newsletter der windream GmbH Seite 4 Schritt 6.4: Sollten Sie keine Mails erhalten, so kann die Fehlerursache über den Debugger identifiziert werden. Hierzu sind die Meldungslevel 31 und 32 in der windream-konfiguration unter Meldungen und DMS-Service Spezialeinstellungen einzustellen. Im Sysinternals Dbgview ( erhält man dann zum Beispiel folgende Information, anhand derer man die Fehlerursache ablesen kann in diesem Fall host not found: <c3po-exchangexx>. [2332] log4cplus: c3po-exchangexx [2332] log4cplus: windream@windream.com [2332] log4cplus: [2332] log4cplus: ***** [2332] log4cplus: Archive Error on windream Server VPCXPSQLORA3 [2332] log4cplus: admin@yourdomain.com [2332] log4cplus: :53:33; [ 3380]; [ FATAL]; [WMLogTestDlg]; This is my manual WM_FATAL_LEVEL message containing a line with parameters 1=FirstParam 2=222 3=0x [2332] [2332] log4cplus: log4cplus::mailappender::append - Portnumber <25>, UseIpAlways <0> [2332] log4cplus: CFastSmtp::BuildUniqueComputerName() - not an ip addr string: <c3po-exchangexx> [2332] log4cplus:warn CFastSmtp::BuildUniqueComputerName() - host not found: <c3po-exchangexx> [2332] log4cplus:warn CFastSmtp::ConnectServer() - Invalid socket [2332] [2332] log4cplus: MailAppender::append() - not connected Schritt 7: Echte" Archiv-Fehler: Treten echte Archiv-Fehler auf, erhalten Sie eine Mail mit dem Error-Stack pro Dokument, das nicht archiviert werden konnte. Selbstverständlich wird auch weiterhin in die Log-Datei auf dem Server geloggt, die dann vom windream-support ausgewertet werden kann. Dieser Error-Stack kann möglicherweise aber auch direkt vom Empfänger interpretiert werden. Zum Beispiel könnte bei Archivierung in einen normalen Filestore folgender Stack gesendet werden: :54:29; [ 5036]; [ ERROR]; [ARC]; # x ( ms) FAIL: '\ArchStoreTest\WM_4_5_0_11_FolderBrws_Patch_1.exe' ID:36144 Error: HRES: 0x STACK: ##HDRMSG0$ ?+WMTOOLS.ERRCLS_SYS_HRESULT+? ?+0+?++?+CAIS_TemporaryStore: :initinfofile() CreateFile(open) failed on path: C:\MyFilestores\ArchStore2\info.wmi Error with HRESULT: <0x >+?++?++?+DEVW2K3X64+?+56c$ ?+WMPD.ObjectStore_Error+?+1014+?+0+?++?+CAIS_ TemporaryStore::initInfoFile() Info file creation failed on path: C:\MyFilestores\ArchStore2\ info.wmi+?++?++?+devw2k3x64+?+56c$ ?+WMPD.ObjectStore_Error+?+1015+?+0+?++?+CAIS_TemporaryStor e::checkinfofile() initinfofile() failed+?++?++?+devw2k3x64+?+56c$ ?+WMPD.ObjectStore_ Error+?+1003+?+0+?++?+CAIS_TemporaryStore::createObject() checkinfofile() failed+?++?++?+ DEVW2K3X64+?+56c$ ?+WMPD.ObjectStore_Error+?+1005+?+0+?++?+CAIS_TemporaryStore::saveObject() createobject() failed+?++?++?+devw2k3x64+?+56c$ ?+WMPD.ObjectStore_Error+?+1009+?+0+?++?+ CAIS_ObjectStore::copyObject() saveobject() failed+?++?++?+devw2k3x64+?+56c$ ?+ WMPD.Server_Error+?+1088+?+0+?++?+CAIS_Server::copyBinaryObject() Function copyobject() failed!+?++?++?+devw2k3x64+?+56c$ ?+WMPD.BinaryObject_Error+?+1033+?+0+?++?+CAIS_BinaryObject: :move() copybinaryobject() failed+?++?++?+devw2k3x64+?+56c$ ?+WMPD.Document_ Error+?+1016+?+0+?++?+CAIS_Dokument::moveToArchivePoolRaw() (PDObject: Document - WM_4_5_0_11_ FolderBrws_Patch_1.exe[ID: 36144]) - Function BinaryObject->move() failed!+?++?++?+devw2k3x64 +?+56c$ ?+WMPD.Document_Error+?+1025+?+0+?++?+CAIS_Dokument::::saveRaw() (PDObject: Document -

5 Newsletter der windream GmbH Seite 5 WM_4_5_0_11_FolderBrws_Patch_1.exe[ID: 36144]) - Function movetoarchivepoolraw() failed!+?++?++?+ DEVW2K3X64+?+56c$ ?+WMPD.FSPDObject_Error+?+1005+?+0+?++?+CAIS_FS_PDObject::saveFS() (PDObject: Document - WM_4_5_0_11_FolderBrws_Patch_1.exe[ID: 36144]) - Function saveraw() failed!+?++?++?+devw2k3x64+?+56c$ ?+WMPD.Document_Error+?+1015+?+0+?++?+CAIS_Dokument::moveToA rchivepool() (PDObject: Document - WM_4_5_0_11_FolderBrws_Patch_1.exe[ID: 36144]) - Function savefs() failed!+?++?++?+devw2k3x64+?+56c$ ?+WMPD.PDObject_Error+?+1116+?+0+?++?+ CAIS_PDObject::moveToArchivePool() (PDObject: Document - WM_4_5_0_11_FolderBrws_Patch_1.exe[ID: 36144]) - movetoarchivepool() failed!+?++?++?+devw2k3x64+?+56c$ ?+ WMTOOLS.ERRCLS_SYS_HRESULT +? ?+0+?++?+WMARCMV.DLL -> From bool WorkerObject:: PerformAction( const IWMObjectPtr& piwmobjectptr, WMObjectEditMode awmobjecteditmode, long& lsuccessfullyprocesseddocumentscount, OperationType aoperationtype, ReportWrapper& areportwrapper ) Error: CALL_FUNC( piwmobjectptr, MoveToArchivePool() ) failed+?++?+guid_only²;²²;²²;²+?+devw2k3x64+?+13ac Hier wäre die Fehlerurache zum Beispiel CreateFile(open) failed on path: C:\MyFilestores \ArchStore2\info.wmi Error with HRESULT: <0x >. Windows Fehler wie zum Beispiel 0x können mit einem Freeware-Tool (Error Lookup), zum Beispiel von Tool.shtml in Klartext ausgegeben werden. Hier = Das System konnte den angegebenen Pfad nicht finden. Auf Rechnern, auf denen windream installiert ist, kann auch ein kleines Script genutzt werden, dass sowohl System- als auch windream-fehler in Klartext ausgibt:

6 Newsletter der windream GmbH Seite 6 Schritt 8: Zusammenfassungen vom Archivservice: Schritt 8.1: Der Archivservice schreibt zusammenfassende Meldungen von nicht archivierten Dokumenten mit WARN Level in sein Logfile. Diese kann man sich ebenfalls per senden lassen, wenn der Level statt auf ERROR auf WARN gesetzt wird: log4cplus.appender.mailmsgs.filters.1.loglevelmin=warn Eine solche Mail über fehlgeschlagene Archivvorgänge sähe dann zum Beispiel so aus: :54:29; [ 4960]; [ WARN]; [ARC]; ARCHIVE action failed for 2 of 7423 documents. Ein geeigneter -Filter in Ihrem Mailprogramm könnte dann zum Beispiel Warn - und Error -Mails filtern und in geeignete Ordner stellen. Schritt 8.2: Eine Gesamtzusammenfassung der erfolgreichen Archivvorgänge wird mit "INFO" Level geloggt und sähe so aus: :54:29; [ 3060]; [ INFO]; [ARC]; ARCHIVE action success for 7421 of 7423 documents. Info-Meldungen werden allerdings auch einige andere geloggt. Ist man nur an den Zusammenfassungen interessiert, wäre auch hierfür ein geeigneter -Filter, zum Beispiel nach ARCHIVE action success empfehlenswert.