Comment configurer l'enregistrement pour des périphériques Windows Mobile et Windows CE
S'applique à: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2
La journalisation de Microsoft System Center Configuration Manager 2007 pour les périphériques mobiles permet aux administrateurs d'évaluer et de dépanner les activités de gestion des périphériques mobiles sur le périphérique mobile et sur le serveur. Les fonctions de journalisation des périphériques mobiles ont été considérablement améliorées dans Configuration Manager 2007. Configuration Manager 2007 offre à présent la possibilité de lire les journaux du client de périphérique à l'aide de SMSTrace.exe et de configurer le niveau de détail de journalisation sur les périphériques mobiles à l'aide des fonctionnalités de journalisation. Les fonctionnalités de journalisation des clients de périphérique mobile sont configurées via les paramètres du registre sur le périphérique mobile. Trois niveaux de configuration des paramètres sont disponibles :
Composant
Global
Valeur par défaut
Portée des paramètres
Chaque processus consignable porte un nom de composant. Si les paramètres de journalisation sont spécifiés au niveau du composant, celui-ci est utilisé s'il est défini. Si aucun paramètre de journalisation n'est défini au niveau du composant, les paramètres de journalisation déclarés au niveau global sont utilisés. Si aucun paramètre de journalisation n'est défini au niveau global, les paramètres définis par défaut dans les fonctionnalités de journalisation sont utilisés.
Les paramètres de journalisation définis au niveau global sont stockés sous la clé de registre suivante : HKLM\Comm\ApplicationDownload\Logging
.
Les paramètres de journalisation définis au niveau du composant sont stockés dans une sous-clé de la clé globale. Le nom de la sous-clé correspond à celui du composant, comme dans l'exemple suivant : HKLM\Comm\ApplicationDownload\Logging\
<NomComposant>. Par exemple, si le processus nomme le composant « Composant1 », le processus de ce composant peut être contrôlé à l'aide des paramètres sous la clé suivante : HKLM\Comm\ApplicationDownload\Logging\Component1
.
Valeurs minimum et maximum
Certains paramètres de journalisation possèdent des valeurs minimum et maximum définies dans les fonctionnalités. Ainsi, un utilisateur ne peut pas définir dans le registre une valeur qui aurait un effet négatif sur le périphérique mobile ou trop faible pour collecter des informations significatives.
Si une valeur de paramètre du registre est inférieure au seuil minimum autorisé, la valeur minimum est utilisée. Si une valeur de paramètre du registre est supérieure au seuil maximum autorisé, la valeur maximum est utilisée.
Paramètres
Le tableau suivant répertorie les paramètres de journalisation disponibles. Ces paramètres peuvent être définis à la fois dans les clés de registre au niveau global et du composant. Le nom du paramètre est le nom de la valeur du registre sous la clé.
Nom du paramètre | Type | Valeur min. | Valeur max. | Valeur par défaut | Description |
---|---|---|---|---|---|
LogDirectory |
REG_SZ |
Non applicable |
Non applicable |
"\Temp\DMClientLogs" sur Windows Mobile Smartphone 2003 redirigé vers \Storage\temp\DMClientLogs |
Répertoire dans lequel sont créés les fichiers journaux. |
MaxLogSizeBytes |
DWORD |
1024 (1K) |
1048576 (1 Mo) |
32K |
Taille maximum des fichiers journaux, en octets, du composant avant que le fichier ne soit substitué. |
MaxLogCount |
DWORD |
2 |
24 |
5 |
Nombre maximum de fichiers journaux du composant. Si le nombre de fichiers dépasse cette limite, les fichiers les plus anciens seront supprimés. |
LogLevel |
DWORD |
0 (PROLIXE) |
3 (ERREUR) |
3 (ERREUR) |
Indique le type minimum d'une instruction de journalisation qui sera enregistrée dans le journal. Si une instruction de journalisation passe au dessous de ce paramètre, l'instruction est ignorée. Si vous spécifiez une valeur supérieure à 3 (ERREUR) les instructions ne sont pas enregistrées dans le fichier journal (la journalisation est désactivée). |
Les fonctionnalités de journalisation ne détectent pas les modifications apportées aux paramètres sur le champ. Les paramètres sont lus au démarrage du service client. Pour appliquer les paramètres mis à jour, le service de gestion des périphériques doit être redémarré à l'issue des modifications. Cette opération peut s'effectuer dans le panneau de configuration Gestion des périphériques.
Fichiers journaux pour l'installation de clients de périphériques mobiles
Tout au long de l'installation du client de périphérique mobile sur le périphérique mobile, des fichiers journaux sont générés sur le périphérique mobile. Les fichiers journaux peuvent être utilisés pour confirmer la fin de l'installation. Une fois que l'installation du client s'est déroulée correctement, les fichiers journaux suivants sont disponibles sur le périphérique mobile :
DMInstaller[date:time].log
DMClientSetup[date:time].log
DMSvc[date:time].log
Appellation
Les fonctionnalités de journalisation gèrent un ensemble de fichiers journaux pour chaque composant. Lorsque le processus de journalisation est appelé, il crée un nouveau fichier journal ou ouvre un fichier journal existant correspondant au composant. Le fichier journal est enregistré jusqu'à ce qu'il soit substitué comme décrit ci-dessous. Le nom de chaque fichier journal se présente au format suivant :
<NomComposant>-<Date>-<Heure>.log
<NomComposant> est le nom du composant passé dans la fonction InitLogger.
<Date> est la date de création du fichier journal au format AAAAMMHH.
<Heure> est l'heure UTC de création du fichier journal au format hhmmss.
Par exemple, si le nom du composant est « Composant1 » et que le fichier journal a été créé le 13 juin 2006 à 13h05 UTC, le nom du fichier journal sera Composant1-20060613-130500.log.
Substitution
Lorsqu'un fichier journal dépasse la valeur du paramètre MaxLogSizeBytes, il est « substitué », c'est-à-dire qu'il est fermé et qu'un nouveau fichier est créé. Lorsque le nombre total de fichiers journaux du composant (fichiers actuellement ouverts plus les fichiers journaux substitués) dépasse la valeur du paramètre MaxLogCount, le fichier le plus ancien est supprimé.
Format
Les fonctionnalités de journalisation enregistrent les entrées de journal dans un format compatible avec l'éditeur de journaux SMS Trace (smstrace.exe). Chaque entrée comprend les éléments suivants :
Texte journal : texte du journal émis par les macros de journalisation (COMMENTAIRES, INFOS, AVERTISSEMENT, ERREUR)
Heure (heure locale)
Date (heure locale)
Type journal : 0 pour Prolixe, 1 pour Info, 2 pour Avertissement, 3 pour Erreur
Thread
Fichier source
Activation des niveaux de journalisation
Suivez les indications ci-dessous pour déterminer le niveau de journalisation à utiliser :
- Prolixe : Utilisez la journalisation documentée uniquement pour les instructions susceptibles d'aider le personnel d'assistance technique et le support technique Microsoft à résoudre les problèmes qui se produisent sur le périphérique mobile. La journalisation documentée fournit des informations détaillées. Exemples de données journalisées en mode documenté : entrée/sortie de la fonction de traçage, paramètres transmis aux fonctions, etc. Les instructions de journalisation PROLIXE sont enregistrées dans le fichier journal si LogLevel = 0.
Notes
L'utilisation de la journalisation documentée est laissée à votre appréciation. Si vous utilisez des paramètres incorrects, les fichiers journaux peuvent saturer le périphérique mobile.
Info (informations) : Utilisez la journalisation Info pour les instructions qui informent l'utilisateur final ou le personnel technique des événements sans erreur liés aux aspects fonctionnels du périphérique mobile. Parmi les exemples, citons le début et la fin d'une procédure fonctionnelle, notamment « Téléchargement du package » ou « Téléchargement réussie du package ». Les instructions de journalisation INFO sont enregistrées dans le fichier journal si la valeur du paramètre LogLevel est inférieure ou égale à 1.
Avertissement : Utilisez les instructions de la journalisation Avertissement pour informer l'utilisateur d'une condition d'erreur qui est traitée et qui n'indique pas un échec de la fonction du périphérique mobile. Cela peut être très utile pour rechercher l'origine de l'erreur. Les instructions de journalisation AVERTISSEMENT sont enregistrées dans le fichier seulement si la valeur du paramètre LogLevel est inférieure ou égale à 2.
Erreur : Utilisez les instructions de la journalisation Erreur pour informer l'utilisateur d'une condition d'erreur indiquant un échec d'une procédure fonctionnelle du produit. Exemple : « Échec du téléchargement du package » ou « Échec de la vérification du hachage du package ». Les instructions de journalisation ERREUR sont enregistrées dans le fichier journal.
Le mode de journalisation documenté peut être activé au cours de l'installation ou de la mise à niveau en paramétrant la valeur EnableVerboseLogging=True dans le fichier DMCommonInstaller.ini ou ClientSettins.ini. Ainsi, la journalisation documentée est activée sur les clients installés ou mis à jour à l'aide du fichier DMCommonInstaller.ini ou ClientSettings.ini. La journalisation documentée ou tout autre niveau de journalisation peut être activé sur des périphériques mobiles spécifiques gérés par Microsoft System Center Configuration Manager 2007 en ayant recours à l'élément de configuration du registre pour déployer les clés et les valeurs de registre nécessaires, indiquées dans le tableau précédent. Les paramètres de journalisation peuvent également être modifiés à l'aide d'un paramètre du registre des éléments de configuration distribué avec un package de configuration. Les modifications apportées aux paramètres de journalisation ne prennent effet qu'après le redémarrage du client du périphérique mobile. Cette opération peut s'effectuer en réinitialisant à chaud le périphérique mobile.
Notes
L'utilisation du mode de journalisation documentée n'est pas recommandée, sauf s'il s'adresse au personnel d'assistance technique de Microsoft. Les données fournies en mode de journalisation documentée ne sont pas utiles pour le personnel du support technique de l'entreprise.
Exemple de documents de configuration de la consignation
Comme les paramètres de journalisation sont stockés dans le registre, le fournisseur CSP (Registry Configuration Service Provider) peut être utilisé pour lancer des requêtes ou définir les paramètres de journalisation sur le périphérique mobile.
Interrogation des paramètres de journalisation
L'exemple CSP suivant illustre la manière d'interroger les paramètres de la journalisation globale sur un périphérique :
<wap-provisioningdoc>
<characteristic type="Registry">
<characteristic type="HKLM\Comm\ApplicationDownload\Logging">
<parm-query name="LogDirectory"/>
<parm-query name="MaxLogSizeBytes"/>
<parm-query name="MaxLogCount"/>
<parm-query name="LogLevel"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
Définition des paramètres de journalisation
L'exemple CSP suivant illustre la manière de définir les paramètres de la journalisation globale sur un périphérique :
<wap-provisioningdoc>
<characteristic type="Registry">
<characteristic type="HKLM\Comm\ApplicationDownload\Logging">
<parm name="LogDirectory" value="\Temp\Logs" datatype="string"/>
<parm name="MaxLogSizeBytes" value="7000" datatype="integer"/>
<parm name="MaxLogCount" value="7" datatype="integer"/>
<parm name="LogLevel" value="0" datatype="integer"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
Emplacement des fichiers journaux
Les fichiers journaux des clients de périphérique mobile se trouvent dans les emplacements suivants :
Clients des ordinateurs Mobile Device Center ou ActiveSync de Configuration Manager 2007
Périphériques Windows CE et Windows Mobile Pocket PC
Périphériques Windows Mobile 5 Smartphone et Windows Mobile 6 Standard
Périphériques Windows Mobile 2003 Smartphone
Emplacement Chemin Fichiers journaux Sur un bureau ActiveSync ou Mobile Device Center géré par Configuration Manager 2007
%temp%\SmsDm dans le dossier temporaire de l'utilisateur
DmClientXfer.log
DmCommonInstaller.log
DmInvExtension.log
Sur tous les périphériques Windows CE, Windows Mobile Pocket PC et Windows Mobile 6 Professional
\temp\DmClientLogs
DmCertEnroll...log
DmClientSetup…log
DmInstaller…log
DmSvc…log
DMCertResp.htm (dans \temp)
Sur les périphériques Windows Mobile Smartphone 5 et Windows Mobile 6 Standard
\ Temp\DmClientLogs dans le dossier de stockage du périphérique mobile ou \temp\DMClientLogs dans le système de fichiers du périphérique mobile
DmCertEnroll...log
DmClientSetup…log
DmInstaller…log
DmSvc…log
DMCertResp.htm
Sur les périphériques Windows Mobile Smartphone 2003
\Storage\temp\DMClientLogs
DmCertEnroll...log
DmClientSetup…log
DmInstaller…log
DmSvc…log
DMCertResp.htm
Sur un serveur de site de gestion des périphériques sans client Configuration Manager 2007 installé
<DossierInstallation> \ CCM \ Logs
DmClientHealth.log
DmClientRegistration.log
DmpDatastore.log
DmpDiscovery.log
DmpFileCollection.log
DmpHardware.log
DmpIsapi.log
DmpSoftware.log
DmpStatus.log
FspIsapi.log
<DossierInstallation> \Logs
DmpMSI.log
DmpSetup.log
Fspmgr.log
fspMSI.log
\%répwin%\System32\Logfiles\W3SVC1
Tous les journaux IIS (nommés par date et heure)
Sur les serveurs de site avec le client Configuration Manager 2007 installé
Le répertoire Configuration Manager 2007 est en fait installé dans \%répwin%\System32\CCM.
DmClientHealth.log
DmClientRegistration.log
DmpDatastore.log
DmpDiscovery.log
DmpFileCollection.log
DmpHardware.log
DmpIsapi.log
DmpSoftware.log
DmpStatus.log
FspIsapi.log
Voir aussi
Tâches
Comment activer l'enregistrement pour un composant
Concepts
Comment vérifier l'installation ou la mise à niveau du client de périphérique mobile
Autres ressources
Comment modifier le fichier .ini de configuration du client de périphérique mobile
Propriétés du Registre
Pour plus d'informations, consultez Informations et prise en charge de Configuration Manager 2007.
Pour contacter l'équipe de documentation, envoyez un e-mail à SMSdocs@microsoft.com.