Utilisation de journaux pour résoudre les problèmes liés à l’installation et à la configuration dans Office System 2007

Consulter le journal d’événements d’applications

Les journaux d’événements d’applications Windows se trouvent dans l’Observateur d’événements.

Lorsque le système démarre automatiquement une réparation et échoue, il enregistre normalement deux événements dans le journal d’événements d’applications Windows.

• L’événement MsiInstaller 1001 identifie le code produit, la fonctionnalité et le code de composant du chemin d’accès de clé qui a été demandé.

• L’événement MsiInstaller 1004 identifie le code produit, la fonctionnalité et le code de composant du chemin d’accès de clé détecté comme étant rompu.

Le fichier MSI du produit spécifié sera nécessaire pour identifier la ressource exacte référencée en tant que chemin d’accès de clé rompu. Vous trouverez cette information à l’un des emplacements suivants :

• Panneau de configuration | Ajout/Suppression de programmes

• Le Registre sous la ruche HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90120000-####-####-0000-0000000FF1CE}. Recherchez le GUID qui référence le fichier *<produit>*WW.msi.

Pour plus d’informations sur le schéma de numérotation des GUID, voir l’article 928516 de la Base de connaissances Microsoft Description du schéma de numérotation des GUID de codes de produits dans les programmes et les suites Office 2007 (https://go.microsoft.com/fwlink/?linkid=128098\&clcid=0x40C) .

Configurer les attributs de journalisation

Le programme d’installation recherche une copie du fichier Config.xml dans le dossier où se trouve Setup.exe. Si aucune copie n’est détectée, il utilise le fichier Config.xml présent dans le dossier de produit principal du produit que vous installez. Si plusieurs produits sont disponibles dans la source d’installation, le programme d’installation attend que vous spécifiiez le produit à installer pour rechercher la copie de Config.xml. En raison de cette conception, l’élément Logging est uniquement utilisé par le programme d’installation lorsque le fichier Config.xml réside dans le même dossier que Setup.exe ou si vous spécifiez le fichier Config.XML en utilisant l’option de ligne de commande Setup /config. Si le programme d’installation utilise le fichier Config.xml dans le dossier du produit, les options de journalisation standard par défaut sont utilisées.

Pour configurer les attributs de journalisation du programme d’installation, modifiez le fichier Config.xml à utiliser pour l’installation. Utilisez l’élément Logging dans le fichier Config.xml pour spécifier le type de journalisation effectué par le programme d’installation. Voici la syntaxe utilisée :

<Logging

   Type="Off" | "Standard"(par défaut) | "Verbose" | "Debug"

   Path="chemin_d’accès"

   Template="nom_fichier.txt"

/>

Le tableau suivant présente les attributs de journalisation du programme d’installation disponibles.

Vous pouvez spécifier * n’importe où dans la valeur Template. Le programme d’installation insère une chaîne à cet endroit en utilisant le format suivant :

YYYYMMDDHHMMSS xxx

où :

1. AAAA = Année

2. MM = Mois

3. JJ = Jour

4. HH = Heure

5. MM = Minute

6. SS = Secondes

7. xxx = chaîne unique générée par le programme d’installation

Le fichier journal Setup.exe contient la ligne de commande spécifiée pour l’installation et permet donc de vérifier si la syntaxe, l’orthographe, les chemins d’accès, etc., sont corrects.

Pour plus d’informations sur la modification du fichier Config.xml, voir Fichier Config.xml dans Office System 2007.

Consulter le journal du programme d’installation

Vous trouverez les fichiers journaux dans le dossier C:\Windows\%TEMP% si le programme d’installation a été exécuté par le système. Si le programme d’installation est exécuté sous le compte d’un utilisateur, ils se trouvent dans le dossier %TEMP% de l’utilisateur.

L’avant-dernière ligne du journal du programme d’installation comporte un code de retour. Les codes de retour courants sont 0 (installation réussie), 3010 (redémarrage nécessaire), 1642 (versions de correctifs incorrectes) et 1603 (erreur irrécupérable). D’autres valeurs de code de retour figurent dans l’article 290158 de la Base de connaissances Microsoft Liste des codes et messages d’erreur dans les processus Windows Installer des produits Office 2003 et Office XP (https://go.microsoft.com/fwlink/?linkid=128248\&clcid=0x40C).

Si vous recevez un message d’erreur pendant l’installation, recherchez le numéro de l’erreur dans le fichier journal. Procédez comme suit pour diagnostiquer le problème :

1. Recherchez le numéro d’erreur dans le fichier journal. Si vous avez reçu un message d’erreur 1603, recherchez « return value 3 » (localisé) afin de déterminer la raison de l’échec.

2. Lisez chaque ligne précédente à partir de celle qui comporte le numéro d’erreur. En général, vous commencez par la ligne indiquant l’échec et finissez par une ligne indiquant une erreur du programme d’installation.

3. Si vous ne recevez pas un numéro d’erreur, vous pouvez également rechercher le mot « Error ».

4. Lorsqu’aucune erreur évidente n’est générée ou consignée, recherchez la chaîne « Note ». Une « Note » correspond à une erreur souvent attendue (par exemple, lors de la recherche d’un fichier qui a été supprimé, il est normal de recevoir une erreur « Fichier introuvable »). Toutefois, cela indique parfois une véritable erreur.

Bien qu’un code de retour de 0 indique normalement l’absence de problèmes, parfois le processus d’installation ne se termine pas comme prévu alors qu’aucune erreur n’est générée.

Pour plus d’informations sur les codes d’erreur utilisés par les installations Office System 2007 lorsque vous activez la journalisation détaillée, voir Codes d’erreur des installations Office 2007.

Activer la journalisation du TCO

Pour activer la journalisation pour Office System 2007, ajoutez les paramètres de Registre suivants :

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

Le programme d’installation n’écrit pas les informations entrées sur une ligne de commande dans le journal sauf si la stratégie système Debug est définie. Pour écrire des lignes de commande dans le journal, définissez la stratégie système Debug sur la valeur 7.

Le fichier journal est créé dans le dossier %TEMP% sous le nom Office.log. Le nom du journal ne peut pas être contrôlé et le journal est remplacé lorsqu’il devient complet.

Consulter le journal du TCO

Lorsque la journalisation du TCO est activée, reproduisez le problème et examinez le fichier journal créé par Office.log dans le dossier %TEMP%

Recherchez les entrées GimmeFile() qui indiquent qu’un fichier est manquant, endommagé ou qu’une version est incorrecte. Ensuite, recherchez dans le fichier journal le nom de ce fichier pour déterminer s’il a été correctement installé.

Si le fichier n’est pas installé correctement, vérifiez le chemin d’accès source fourni pour le fichier pour vous assurer de sa validité.

Si le problème est lié à une réparation à la demande ou à une installation à la demande, recherchez les entrées GimmeFile() associées pour identifier le problème.

Désactiver la journalisation du TCO

Pour désactiver (supprimer) les entrées de la journalisation du TCO pour Office System 2007, placez les paramètres de Registre suivants dans un fichier .reg et utilisez la commande Regedit.exe –s :

REGEDIT4

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

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

Ne supprimez pas manuellement des ressources de chemin d’accès de clé (fichiers ou valeurs de Registre) pour déclencher une réparation. Si vous pensez que des fichiers ont été endommagés, activez la journalisation, réexécutez le programme d’installation Office en mode maintenance et utilisez l’option Réparer Office.

Activer la journalisation de Windows Installer

Pour activer la journalisation de Windows Installer, ouvrez le Registre à l’aide de Regedit.exe et créez le chemin d’accès et les clés suivants :

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

Les lettres peuvent figurer dans n’importe quel ordre dans le champ de la valeur. Chaque lettre active un mode de journalisation différent. La fonction réelle de chaque lettre pour MSI version 1.1 est indiquée dans le tableau suivant.

La journalisation de Windows Installer doit être utilisée uniquement à des fins de résolution de problèmes et ne doit pas demeurer activée, car cela aurait des conséquences négatives sur les performances du système et sur l’espace disque. Chaque fois que vous utilisez la fonctionnalité Ajout/Suppression de programmes dans le Panneau de configuration, un nouveau fichier Msi*.log est créé.

Pour plus d’informations sur la l’activation de la journalisation de Windows Installer, voir l’article 223300 de la Base de connaissances Microsoft Comment faire pour activer l’enregistrement de Windows Installer (https://go.microsoft.com/fwlink/?linkid=128265\&clcid=0x40C).

Examiner le journal de Windows Installer en utilisant l’analyseur du journal détaillé de Windows Installer

L’analyseur du journal détaillé de Windows Installer (Wilogutl.exe) facilite l’analyse des fichiers journaux à partir d’une installation Windows Installer et affiche des solutions suggérées aux erreurs détectées dans un fichier journal.

Par défaut, les erreurs non critiques ne sont pas affichées. Wilogutl.exe peut être exécuté en mode silencieux ou avec une interface utilisateur. L’outil génère des rapports sous la forme de fichiers texte dans ces deux modes. Il fonctionne très bien avec les fichiers journaux Windows Installer détaillés, mais il fonctionne également avec les journaux non détaillés. Pour plus d’informations, voir Journalisation (en anglais) (https://go.microsoft.com/fwlink/?linkid=128276\&clcid=0x40C) (en anglais) .

Pour plus d’informations sur l’analyseur du journal détaillé de Windows Installer (Wilogutl.exe), voir Wilogutl.exe (en anglais) (https://go.microsoft.com/fwlink/?linkid=128277\&clcid=0x40C) (en anglais) et Blog du Kit de développement logiciel (SDK) pour Microsoft Windows – joyaux cachés du SDK Windows : Partie 1 (https://go.microsoft.com/fwlink/?linkid=128278\&clcid=0x40C) .

Pour télécharger l’analyseur du journal détaillé de Windows Installer (Wilogutl.exe), voir Mise à jour du kit de développement logiciel Microsoft Windows pour Windows Vista (en anglais) (https://go.microsoft.com/fwlink/?linkid=128279\&clcid=0x40C) (en anglais) .

Lorsqu’il est exécuté en mode interface utilisateur, Wilogutl.exe affiche les boîtes de dialogue indiquées dans le tableau suivant.

Nom	Description
Windows Installer Verbose Log Analyzer	La boîte de dialogue Windows Installer Verbose Log Analyzer permet aux utilisateurs de sélectionner un fichier journal à des fins d’analyse : Le bouton Open ouvre le fichier dans le Bloc-notes. La zone Preview permet de vérifier que le fichier journal correct a été sélectionné. Le bouton Analyze commence l’analyse du fichier journal et affiche la boîte de dialogue Detailed Log File View. Windows Installer Verbose Log Analyzer
Detailed Log File View	La boîte de dialogue Detailed Log File View affiche des informations sur les erreurs consignées. Utilisez les boutons Back et Next pour passer d’une erreur à l’autre. Pour afficher les erreurs non critiques, activez la case à cocher Show Ignored Debug Errors. La version du programme d’installation sur l’ordinateur utilisé pour l’exécution de l’installation consignée s’affiche. Si l’installation consignée a été exécutée avec des autorisations avec des privilèges élevés, la case à cocher Elevated install? est activée et des informations sont fournies dans les zones de texte Client Side Privilege Details et Server Side Privilege Details . La boîte de dialogue Detailed Log File View contient les boutons suivants : States : affiche la boîte de dialogue Feature and Component States. Properties : affiche la boîte de dialogue Properties. Policies : affiche la boîte de dialogue Policies. HTML Log : affiche le journal sous la forme d’un fichier HTML annoté. Save Results : enregistre les fichiers des rapports dans le répertoire spécifié. Error Help : affiche l’aide des messages d’erreur du programme d’installation. Help : affiche l’aide de l’analyseur du journal du programme d’installation Windows Installer. How to Read a Log File : affiche le document de l’aide du fichier journal. Detailed Log File View
Feature and Component States	La boîte de dialogue Feature and Component States affiche les états suivants des colonnes de fonctionnalités et de composants : La colonne Feature indique le nom de la fonctionnalité dans le package d’installation. La colonne Component indique le nom du composant dans le package d’installation. La colonne Installed indique l’état de la fonctionnalité ou du composant à la fin de l’installation. La colonne Request indique la sélection de l’utilisateur pendant l’installation pour l’état de la fonctionnalité ou du composant. La colonne Action indique l’action effectuée par le programme d’installation pour la fonctionnalité ou le composant. Pour plus d’informations, voir Fonction MsiGetComponentState (en anglais) (https://go.microsoft.com/fwlink/?linkid=128284&clcid=0x40C) (en anglais) et Fonction MsiGetFeatureState (en anglais) (https://go.microsoft.com/fwlink/?linkid=128285&clcid=0x40C) (en anglais) .
Properties	La boîte de dialogue Properties indique les propriétés Windows Installer et leurs valeurs à la fin de l’installation. Vous pouvez trier les propriétés par nom ou valeur en utilisant les onglets suivants : L’onglet Client indique les propriétés et les valeurs pendant la partie côté client de l’installation. L’onglet Server indique les propriétés et les valeurs pendant la partie côté serveur de l’installation. L’onglet Nested affiche les propriétés et les valeurs des installations simultanées. Pour plus d’informations, voir Propriétés (en anglais) (https://go.microsoft.com/fwlink/?linkid=128287&clcid=0x40C) (en anglais) et Installations simultanées (en anglais) (https://go.microsoft.com/fwlink/?linkid=128288&clcid=0x40C) (en anglais) .
Policies	La boîte de dialogue Policies affiche la stratégie système définie après l’installation : Une valeur de 0 (zéro) définie pour la stratégie signifie que la stratégie n’est pas activée. Une valeur de 1 (un) signifie que la stratégie est activée. Le caractère ? (point d’interrogation) signifie que la valeur de la stratégie n’est pas enregistrée dans le journal. Si vous avez besoin d’une valeur de stratégie ne figurant pas dans le journal, essayez d’utiliser Regedit.exe pour vérifier les clés de Registre sur l’ordinateur à partir duquel l’installation a échoué. Pour plus d’informations sur les stratégies système, voir Stratégie système (en anglais) (https://go.microsoft.com/fwlink/?linkid=128292&clcid=0x40C) (en anglais) .

Pour plus d’informations sur la résolution des problèmes de Windows Installer, voir l’article 907749 de la Base de connaissances Microsoft Procédures de base de résolution des problèmes liés à Windows Installer (https://go.microsoft.com/fwlink/?linkid=128294\&clcid=0x40C).

Activer la journalisation d’OSE

Pour activer la journalisation d’OSE, entrez manuellement les entrées de Registre suivantes :

REGEDIT4

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

Examiner le journal d’OSE

Les journaux d’OSE sont initialement créés dans le répertoire d’installation %TEMP% de l’utilisateur, car Office Source Engine n’est pas encore défini en tant que service système.

Une fois Office Source Engine correctement installé et enregistré, la journalisation bascule vers le répertoire %WINDIR%\Temp.

Lorsque vous y êtes invité, fournissez ce journal au Support technique Microsoft pour analyse.