QE2000101: FFAXGATE/FSMSGATE - Logdateien

[Marko Riebe]

Referenz QE2000101

FFAXGATE, FSMSGATE
Erstellen einer Logdatei

Problem:
Wenn Probleme mit der Exchange Server Anbindung bestehen, sollten die Exchange Gateways FFAXGATE und FSMSGATE dies mit einem Log belegen können. Es stellt sich hier auch die Frage, wo und wie die Gateways solche Logdateien ablegen.

Ursache:
Die Exchange Gateways können detaillierte Debug-Logs erstellen. Diese sind jedoch standardmäßig nicht aktiv.

Lösung:
Um das Logging der Gateways zu aktivieren gibt es folgende Methoden :

1. Loglevel

Registry Key:

• "HKEY_LOCAL_MACHINE\Software\Ferrari\FFaxConnector " für den Dienst FFAXGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FSMSConnector " für den Dienst FSMSGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FVOX2KConnect or" für den Dienst FVOXGATE

REG_SZ (Zeichenkette) "LogLevel" mit folgenden Werten :

• "LOG_DEFAULT" (Standard)
• "LOG_INFO" (Es werden allgemeine Informationen geloggt.)
• "LOG_ERROR" (Es werden zu den Informationen alle Fehler mitgeloggt.)
• "LOG_DEBUG" (Es werden Informationen, Fehler und zusätzliche Ausgaben geloggt.)

2. Log Typ

Registry Key:

• "HKEY_LOCAL_MACHINE\Software\Ferrari\FFaxConnector " für den Dienst FFAXGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FSMSConnector " für den Dienst FSMSGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FVOX2KConnect or" für den Dienst FVOXGATE

REG_SZ (Zeichenkette) "LogType" mit folgenden Werten :

• "LOG_FILE" (Es wird in eine Logdatei geschrieben.)
• "LOG_EVENT" (Es wird in das Ereignisprotokoll (Anwendungen) geschrieben.)
• "LOG_DEBUGVIEW" (Es wird in den Debug Viewer geschrieben.)

3. Zeilenbegrenzung der Logdatei bei LogType LOG_FILE

Registry Key:

• "HKEY_LOCAL_MACHINE\Software\Ferrari\FFaxConnector " für den Dienst FFAXGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FSMSConnector " für den Dienst FSMSGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FVOX2KConnect or" für den Dienst FVOXGATE

REG_SZ (Zeichenkette) "MaxLogLines" mit dem Zahlenwert der maximalen Zeilenanzahl der Logdatei. Wird die Zeilenanzahl überschritten, wird die Datei gelöscht und das Log beginnt von vorn.


3. Angabe einer speziellen Logdatei bei LogType LOG_FILE

Registry Key:

• "HKEY_LOCAL_MACHINE\Software\Ferrari\FFaxConnector " für den Dienst FFAXGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FSMSConnector " für den Dienst FSMSGATE
• "HKEY_LOCAL_MACHINE\Software\Ferrari\FVOX2KConnect or" für den Dienst FVOXGATE

REG_SZ (Zeichenkette) "LogFile" mit dem Pfad und dem Namen der Datei, die geschrieben werden soll. Wird dieser Eintrag weggelassen, wird eine Datei "FFAXGATE.LOG", "FSMSGATE.LOG" bzw. "FVOXGATE.LOG" im Root des Laufwerks C: erstellt.


4. Masterkey zum schnellen Erstellen einer Logdatei

Wird folgender Registry Key gesetzt :
"HKEY_LOCAL_MACHINE\Software\Ferrari"
REG_DWORD "gdebug" mit folgenden Werten:

• 0 (kein Log)
• 1 (Log für Ausgabedialoge, diese Option ist deaktiviert)
• 2 (Logdatei)
• 3 (Log in den Debugviewer)

Ein Setzen dieses Keys bewirkt ein globales Setzen von Log Typ auf LOG_FILE und Loglevel auf LOG_DEBUG. Es werden, falls nicht anders angegeben eine Datei "FFAXGATE.LOG", "FSMSGATE.LOG" bzw. "FVOXGATE.LOG" im Root des Laufwerks C: erstellt. In aller Regel sollte der REG_DWORD "gdebug" auf "2" gesetzt werden. Für ein längeres Logging ist die Logzeilenanzahl zu begrenzen, da diese Dateien sehr schnell sehr groß werden können.

Die Erstellten Logdateien können im Problemfalle an die Hotline der Ferrari electronic AG geschickt werden.

Diese Referenz betrifft folgende Produkte:
- OfficeMaster™ Connectoren für Exchange 2000/2003 Version 6.0.0.0 - 6.1.0.4 / OfficeMaster 2