Verwenden von Protokollen zur Behandlung von Installations- und Konfigurationsproblemen in 2007 Office System

Überprüfen des Anwendungsprotokolls

Die Windows-Anwendungsereignisprotokolle werden in der Ereignisanzeige gespeichert.

Wenn eine Reparatur automatisch vom System initiiert wird und dabei ein Fehler auftritt, werden in der Regel zwei Ereignisse im Windows-Anwendungsereignisprotokoll aufgezeichnet.

• Mit dem MsiInstaller-Ereignis 1001 werden der Produktcode, das Feature und der Komponentencode des angeforderten Schlüsselpfads identifiziert.

• Mit dem MsiInstaller-Ereignis 1004 werden der Produktcode, das Feature und der Komponentencode des als fehlerhaft erkannten Schlüsselpfads identifiziert.

Die MSI-Datei des angegebenen Produkts wird benötigt, um die genaue Ressource zu identifizieren, die als fehlerhafter Schlüsselpfad erkannt wurde. Sie finden diese Informationen an einem der folgenden Speicherorte:

• Systemsteuerung | Software

• In der Registrierung unter der Struktur HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90120000-####-####-0000-0000000FF1CE}. Suchen Sie nach der GUID, die auf *<Produkt>*WW.msi verweist.

Informationen zum Nummerierungsschema für GUIDs finden Sie im Microsoft Knowledge Base-Artikel 928516: Beschreibung des Nummerierungsschemas für Produktcode-GUIDs in 2007 Office System-Suites und -Programmen (https://go.microsoft.com/fwlink/?linkid=128098\&clcid=0x407).

Konfigurieren von Protokollierungsattributen

Setup sucht im selben Ordner, in dem Setup.exe gespeichert ist, nach einem Exemplar von Config.xml. Wenn keine Datei gefunden wird, wird die Datei Config.xml verwendet, die im Hauptordner des zu installierenden Produkts gespeichert ist. Wenn in der Installationsquelle mehrere Produkte verfügbar sind, wird Setup angehalten, bis Sie angeben, welches Produkt installiert werden soll, bevor die Kopie von Config.xml gesucht wird. Daher wird das Protokollierungselement nur von Setup verwendet, wenn sich die Datei Config.xml in demselben Ordner befindet wie die Datei Setup.exe oder wenn Sie die Datei Config.xml mithilfe der Befehlszeilenoption Setup / config / festlegen. Wenn Setup die Datei Config.xml im Produktordner verwendet, werden die Standardprotokollierungsoptionen verwendet.

Bearbeiten Sie die Datei Config.xml, die Sie für die Installation verwenden werden, um die Protokollierungsattribute für Setup zu konfigurieren. Verwenden Sie das Protokollierungselement in der Datei Config.xml, um den Typ der Protokollierung anzugeben, die von dieser Installation ausgeführt wird. Es folgt die verwendete Syntax:

<Logging

   Type="Off" | "Standard"(Standard) | "Verbose" | "Debug"

   Path="Pfad"

   Template="Dateiname.txt"

/>

Die folgende Tabelle enthält die verfügbaren Setupprotokollierungsattribute.

Sie können * überall für Template angeben. An dieser Stelle wird eine Zeichenfolge mit folgendem Format eingefügt:

JJJJMMTTHHMMSS xxx

Dabei gilt:

1. JJJJ = Jahr

2. MM = Monat

3. TT = Tag

4. HH = Stunde

5. MM = Minuten

6. SS = Sekunden

7. xxx = eine von Setup generierte eindeutige Zeichenfolge

Die Setup.exe-Protokolldatei enthält die für die Installation angegebene Befehlszeile und kann daher zur Bestätigung der richtigen Syntax, Rechtschreibung, Pfade usw. verwendet werden.

Weitere Informationen zum Bearbeiten der Datei Config.xml finden Sie unter "Config.xml" in 2007 Office System.

Überprüfen des Setupprotokolls

Die Protokolldateien befinden sich im Ordner C:\Windows\%TEMP%, wenn Setup vom System ausgeführt wurde. Wenn Setup unter einem Benutzerkonto ausgeführt wird, befinden sie sich im %TEMP%-Ordner des Benutzers.

Die vorletzte Zeile des Setupprotokolls besitzt einen Rückgabecode. Häufig auftretende Rückgabecodes sind 0 für eine erfolgreiche Installation, 3010 für einen erforderlichen Neustart, 1642 für falsche Patchversionen und 1603 für einen schwerwiegenden Fehler. Weitere Rückgabecodewerte finden Sie im Microsoft Knowledge Base-Artikel 290158: Liste der Fehlercodes und Fehlermeldungen für Windows Installer-Prozesse in Office 2003- und Office XP-Produkten (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128248\&clcid=0x407).

Wenn während der Installation eine Fehlermeldung angezeigt wird, suchen Sie in der Protokolldatei nach der Fehlernummer. Führen Sie zur Diagnose des Problems die folgenden Schritte aus:

1. Suchen Sie die Fehlernummer in der Protokolldatei. Wenn Sie eine Fehlermeldung 1603 erhalten, suchen Sie nach "Rückgabewert 3" (lokalisiert), um die Ursache für den Fehler zu ermitteln.

2. Lesen Sie jede Zeile oberhalb der Zeile, die die Fehlernummer enthält. In der Regel sehen Sie eine Zeile, in der ein Fehler aufgetreten ist, der schließlich zum Setupfehler geführt hat.

3. Falls keine Fehlernummer angezeigt wird, können Sie auch nach dem Wort "Error" suchen.

4. Wenn kein offensichtlicher Fehler generiert oder protokolliert wird, suchen Sie nach der Zeichenfolge "Note". "Note" gibt einen Fehler an, der häufig erwartet wird (z. B. würde beim Überprüfen des Vorhandenseins einer Datei, die gelöscht wurde, ein Fehler "File not found" (Datei nicht gefunden) erwartet). Manchmal ist es jedoch ein Hinweis auf einen richtigen Fehler.

Obwohl der Rückgabecode 0 in der Regel angibt, dass keine Probleme aufgetreten sind, wird in manchen Fällen zwar kein Fehler generiert, der Installationsvorgang kann jedoch nicht wie erwartet abgeschlossen werden.

Weitere Informationen zu den Fehlercodes, die von 2007 Office System-Installationen verwendet werden, wenn die ausführliche Protokollierung aktiviert ist, finden Sie unter Fehlercodes für 2007 Office System-Installationen.

Aktivieren der TCO-Protokollierung

Fügen Sie die folgenden Registrierungseinstellungen hinzu, um die Protokollierung für 2007 Office System zu aktivieren:

REGEDIT4

[HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Common\Debug]
"TCOTest"=dword:00000001
"TCODarwinTest"=dword:00000001
"TCOAssertInstalls"=dword:00000001
"TCOTrace"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Installer]
"Logging"="voicewarmupx"
"Debug"=dword:00000007

Die an einer Befehlszeile eingegebenen Informationen werden erst dann von Installer in das Protokoll geschrieben, wenn die Systemrichtlinie zum Debuggen festgelegt ist. Legen Sie die Systemrichtlinie zum Debuggen auf den Wert 7 fest, um Befehlszeilen in das Protokoll zu schreiben.

Die Protokolldatei wird im %TEMP%-Ordner mit dem Namen Office.log erstellt. Der Protokollname kann nicht gesteuert werden und wird überschrieben, wenn das Protokoll voll ist.

Überprüfen des TCO-Protokolls

Wenn die TCO-Protokollierung aktiviert ist, reproduzieren Sie das Problem, und überprüfen Sie die Protokolldatei Office.log, die im Ordner %TEMP% erstellt wird.

Suchen Sie nach GimmeFile()-Einträgen, die anzeigen, dass eine Datei nicht vorhanden ist, beschädigt ist oder eine falsche Version hat. Suchen Sie dann weiter in der Protokolldatei nach diesem Dateinamen, um zu überprüfen, ob sie erfolgreich installiert wurde.

Wenn die Datei nicht erfolgreich installiert wurde, überprüfen Sie den für die Datei angegebenen Quellpfad, um dessen Gültigkeit sicherzustellen.

Wenn das Problem mit einer Aktion vom Typ "Reparatur bei Bedarf" oder "Installation bei Bedarf" verbunden ist, suchen Sie nach den entsprechenden GimmeFile()-Einträgen, um das Problem zu identifizieren.

Deaktivieren der TCO-Protokollierung

Sie können die TCO-Protokollierungseinträge für 2007 Office System deaktivieren (entfernen), indem Sie die folgenden Registrierungseinstellungen in einer REG-Datei platzieren und den Befehl Regedit.exe –s verwenden:

REGEDIT4

[-HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Common\Debug]

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Installer]
"Logging"=-
"Debug"=-

Löschen Sie keypath-Ressourcen (Dateien oder Registrierungswerte) nicht manuell, um eine Reparatur auszulösen. Wenn Sie vermuten, dass Dateien beschädigt wurden, aktivieren Sie die Protokollierung, führen Sie Office-Setup im Wartungsmodus erneut aus, und verwenden Sie dann die Option zur Reparatur von Office.

Aktivieren der Windows Installer-Protokollierung

Öffnen Sie zum Aktivieren der Windows Installer-Protokollierung die Registrierung mithilfe von Regedit.exe, und erstellen Sie den folgenden Pfad und Schlüssel:

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer
Reg_SZ: Logging
Value: voicewarmupx

Die Buchstaben im Wertfeld können in beliebiger Reihenfolge auftreten. Jeder Buchstabe aktiviert einen anderen Protokollierungsmodus. Die tatsächliche Funktion jedes Buchstabens für die MSI-Version 1.1 ist in der folgenden Tabelle dargestellt.

Die Windows Installer-Protokollierung sollte nur zur Problembehandlung verwendet werden und nicht aktiviert bleiben, da sie nachteilige Auswirkungen auf die Systemleistung und den Speicherplatz hat. Bei jeder Verwendung der Option Software in der Systemsteuerung wird eine neue Msi*.log-Datei erstellt.

Weitere Informationen zum Aktivieren der Windows Installer-Protokollierung finden Sie im Microsoft Knowledge Base-Artikel 223300: Aktivieren der Windows Installer-Protokollierung (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128265\&clcid=0x407).

Überprüfen des Windows Installer-Protokolls mithilfe von Windows Installer Verbose Log Analyzer

Windows Installer Verbose Log Analyzer (Wilogutl.exe) hilft bei der Analyse von Protokolldateien einer Windows Installer-Installation, und es werden vorgeschlagene Lösungen für Fehler angezeigt, die in einer Protokolldatei gefunden werden.

Standardmäßig werden unkritische Fehler nicht angezeigt. Wilogutl.exe kann im stillen Modus oder mit einer Benutzeroberfläche (User Interface, UI) ausgeführt werden. Das Tool generiert Berichte als Textdateien sowohl in der Benutzeroberfläche als auch im stillen Modus. Die besten Ergebnisse werden mit ausführlichen Windows Installer-Protokolldateien erzielt, eine Verwendung mit nicht ausführlichen Protokollen ist jedoch ebenfalls möglich. Weitere Informationen finden Sie unter Protokollierung (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128276\&clcid=0x407).

Weitere Informationen zu Windows Installer Verbose Log Analyzer (Wilogutl.exe) finden Sie unter Wilogutl.exe (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128277\&clcid=0x407) und Microsoft Windows SDK Blog - Verborgene Schätze in Windows SDK: Teil 1 (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128278\&clcid=0x407).

Informationen zum Download von Windows Installer Verbose Log Analyzer (Wilogutl.exe) finden Sie unter Microsoft Windows Software Development Kit-Update für Windows Vista (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128279\&clcid=0x407).

Bei der Ausführung im Benutzeroberflächenmodus zeigt Wilogutl.exe die in der folgenden Tabelle dargestellten Dialogfelder an.

Name	Beschreibung
Windows Installer Verbose Log Analyzer	Im Dialogfeld Windows Installer Verbose Log Analyzer können Benutzer eine Protokolldatei für die Analyse auswählen: Mit der Schaltfläche Open wird die Datei im Editor geöffnet. Mit dem Bereich Preview kann überprüft werden, dass die richtige Protokolldatei ausgewählt wurde. Mit der Schaltfläche Analyze wird die Analyse der Protokolldatei gestartet und das Dialogfeld Detailed Log File View geöffnet. Windows Installer Verbose Log Analyzer
Detailed Log File View	Im Dialogfeld Detailed Log File View werden Informationen zu protokollierten Fehlern angezeigt. Verwenden Sie die Schaltflächen Back und Next, um durch mehrere Fehler zu navigieren. Wenn Sie nicht kritische Fehler anzeigen möchten, aktivieren Sie das Kontrollkästchen Show Ignored Debug Errors. Es wird die Installer-Version auf dem Computer angezeigt, die zum Ausführen der protokollierten Installation verwendet wurde. Wenn die protokollierte Installation mit erhöhten Berechtigungen ausgeführt wurde, ist das Kontrollkästchen Elevated install? aktiviert, und in den Textfeldern Client Side Privilege Details und Server Side Privilege Details sind Informationen bereitgestellt. Das Dialogfeld Detailed Log File View enthält die folgenden Schaltflächen: States - Zeigt das Dialogfeld Feature and Component States an. Properties - Zeigt das Dialogfeld Properties an. Policies - Zeigt das Dialogfeld Policies an. HTML Log - Zeigt das Protokoll als kommentierte HTML-Datei an. Save Results - Speichert die Berichtdateien im angegebenen Verzeichnis. Error Help - Zeigt die Hilfe zu Installer-Fehlermeldungen an. Help - Zeigt die Hilfe für Windows Installer Setup Log Analyzer an. How to Read a Log File - Zeigt das Hilfedokument zur Protokolldatei an. Detailed Log File View
Feature and Component States	Im Dialogfeld Feature and Component States werden die folgenden Status von Feature- und Komponentenspalten angezeigt: In der Spalte Feature wird der Name des Features im Installationspaket angezeigt. In der Spalte Component wird der Name der Komponente im Installationspaket angezeigt. In der Spalte Installed wird der Status des Features oder der Komponente am Ende der Installation angezeigt. In der Spalte Request wird die Auswahl des Benutzers während der Installation für den Status des Features oder der Komponente angezeigt. In der Spalte Action wird die Aktion angezeigt, die von Installer für das Feature oder die Komponente ausgeführt wurde. Weitere Informationen finden Sie unter MsiGetComponentState (Funktion) (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128284&clcid=0x407) und MsiGetFeatureState (Funktion) (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128285&clcid=0x407).
Properties	Im Dialogfeld Properties werden Windows Installer-Eigenschaften und ihre Werte am Ende der Installation angezeigt. Sie können die Eigenschaften nach Name oder nach Wert sortieren, indem Sie die folgenden Registerkarten verwenden: Auf der Registerkarte Client werden Eigenschaften und Werte während des clientseitigen Teils der Installation angezeigt. Auf der Registerkarte Server werden Eigenschaften und Werte während des serverseitigen Teils der Installation angezeigt. Auf der Registerkarte Nested werden die Eigenschaften und Werte von gleichzeitigen Installationen angezeigt. Weitere Informationen finden Sie unter Eigenschaften (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128287&clcid=0x407) und Gleichzeitige Installationen (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128288&clcid=0x407).
Policies	Im Dialogfeld Policies wird die Systemrichtlinie angezeigt, die nach der Installation festgelegt wurde: Wird ein Wert von 0 (Null) für die Richtlinie festgelegt, bedeutet dies, dass die Richtlinie nicht aktiviert ist. Der Wert 1 (Eins) bedeutet, dass die Richtlinie aktiviert ist. Der Wert ? (Fragezeichen) bedeutet, dass der Richtlinienwert im Protokoll nicht aufgezeichnet wird. Wenn Sie einen Richtlinienwert benötigen, der im Protokoll nicht enthalten ist, können Sie mit Regedit.exe die Registrierungsschlüssel auf dem Computer überprüfen, auf dem für die Installation ein Fehler aufgetreten ist. Weitere Informationen zu Systemrichtlinien finden Sie unter Systemrichtlinie (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128292&clcid=0x407).

Weitere Informationen zur Behandlung von Windows Installer-Problemen finden Sie im Microsoft Knowledge Base-Artikel 907749: Erste Schritte bei der Problembehandlung für Windows Installer (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=128294\&clcid=0x407).

Aktivieren der OSE-Protokollierung

Wenn Sie die OSE-Protokollierung aktivieren möchten, geben Sie die folgenden Registrierungseinträge manuell ein:

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Delivery\SourceEngine\Settings]
"LogLevel"=dword:00000002
"TraceLevel"=dword:00000003
"TraceFiles"=dword:00000001

Überprüfen des OSE-Protokolls

OSE-Protokolle werden erstmalig im Verzeichnis %TEMP% des installierenden Benutzers erstellt, da Office Source Engine noch nicht als Systemdienst eingerichtet ist.

Nachdem Office Source Engine erfolgreich installiert und registriert wurde, wechselt die Protokollierung in das Verzeichnis %WINDIR%\Temp.

Stellen Sie dieses Protokoll bei Bedarf für Microsoft Product Support zur Analyse bereit.