Partager via

Fichiers journaux

  • Article

Vous pouvez utiliser les journaux de l’Outil de migration utilisateur (USMT) 5.0 pour surveiller votre migration, corriger les erreurs et résoudre les problèmes des migrations qui ont échoué. Cette rubrique décrit les options de ligne de commande disponibles pour activer les journaux de l’USMT ainsi que les nouveaux éléments XML qui configurent les types d’erreurs qui sont irrécupérables et doivent arrêter la migration, et les types qui sont récupérables et doivent être ignorés afin que la migration puisse continuer.

Options de ligne de commande des journaux

Journaux ScanState et LoadState

Journal de progression

Journal Liste de fichiers

Journal de diagnostic

Options de ligne de commande des journaux

Le tableau suivant décrit chaque option de ligne de commande associée aux journaux et fournit le nom de journal ainsi qu’une description du type des informations contenues dans chaque journal.

Option de ligne de commande Nom du fichier Description

/l: [Path\]FileName

Scanstate.log ou LoadState.log

Spécifie le chemin d’accès et le nom de fichier de ScanState.log ou LoadState.log.

/progress: [Path\]FileName

Spécifie le chemin d’accès et le nom de fichier du journal de progression.

Fournit des informations sur l’état de la migration, en pourcentage effectué.

/v: [VerbosityLevel]

Non applicable

Voir la section « Options de suivi » dans Syntaxe de ScanState.

/listfiles [Path\]FileName

Spécifie le chemin d’accès et le nom de fichier du journal de liste des fichiers.

Fournit une liste des fichiers qui ont été migrés.

Affectez à la variable d’environnement MIG_ENABLE_DIAG un chemin d’accès à un fichier XML.

USMTDiag.xml

Le journal de diagnostic contient des informations détaillées sur l’environnement système, sur l’environnement utilisateur et sur les unités de migration (migunits) collectées et leur contenu.

Notes

Vous ne pouvez pas stocker les fichiers journaux dans chemin_accès_magasin. Si vous le faites, le journal sera remplacé durant l’exécution de l’USMT.

Journaux ScanState et LoadState

Les journaux Scanstate et Loadstate sont des fichiers texte qui sont créés quand vous exécutez les outils ScanState et LoadState. Vous pouvez les utiliser pour surveiller la migration. Le contenu du journal dépend des options de ligne de commande que vous utilisez et du niveau de commentaires que vous spécifiez. Pour plus d’informations sur les niveaux de commentaires, voir Options de suivi dans Syntaxe de ScanState.

Journal de progression

Vous pouvez créer un journal de progression en utilisant l’option /progress. Des outils externes, comme Microsoft System Center Operations Manager 2007, peuvent analyser le journal de progression pour mettre à jour vos systèmes de surveillance. Les 3 premiers champs de chaque ligne sont définis comme suit :

  • Date : date au format jourMoisAbrégéannée. Par exemple, 08 juin 2006.

  • Heure locale : heure au format heures:minutes:secondes (au format 24 heures). Par exemple, 13:49:13.

  • Heure de la migration : durée d’exécution d’USMT au format heures:minutes:secondes. Par exemple, 00:00:10.

Les autres champs sont des paires clé/valeur comme indiqué dans le tableau suivant.

Clé Valeur

program

ScanState.exe ouLoadState.exe.

productVersion

Numéro de version complet du produit d’USMT.

computerName

Nom de l’ordinateur source ou de destination sur lequel USMT a été exécuté.

commandLine

Commande complète utilisée pour exécuter USMT.

PHASE

Indique qu’une nouvelle phase de la migration commence. Il peut s’agir de l’une des phases suivantes :

  • Initialisation

  • Analyse

  • Collecte

  • Enregistrement

  • Estimation

  • Application

detectedUser
  • Pour l’outil ScanState, il s’agit des utilisateurs qu’USMT a détectés sur l’ordinateur source comme pouvant faire l’objet d’une migration.

  • Pour l’outil LoadState, il s’agit des utilisateurs qu’USMT a détectés dans le magasin comme pouvant faire l’objet d’une migration.

includedInMigration

Indique si le profil utilisateur/composant est inclus pour la migration. Les valeurs valides sont Oui ou Non.

forUser

Spécifie l’une des données suivantes :

  • État utilisateur migré.

  • Cet ordinateur, ce qui représente les fichiers et les paramètres qui ne sont pas associés à un utilisateur.

detectedComponent

Spécifie un composant détecté par USMT.

  • Pour ScanState, il s’agit d’une application ou d’un composant installé sur l’ordinateur source.

  • Pour LoadState, il s’agit d’une application ou d’un composant détecté dans le magasin.

totalSizeInMBToTransfer

Taille totale des fichiers et paramètres à migrer en mégaoctets (Mo).

totalPercentageCompleted

Pourcentage total de la migration qui a été effectué par ScanState ou par LoadState.

collectingUser

Spécifie l’utilisateur pour lequel ScanState collecte des fichiers et des paramètres.

totalMinutesRemaining

Durée estimée de la migration, en minutes.

error

Type de l’erreur récupérable qui s’est produite. Il peut s’agir de l’une des erreurs suivantes :

  • UnableToCopy : copie impossible dans le magasin car le disque sur lequel il est stocké est saturé.

  • UnableToOpen : impossible d’ouvrir le fichier pour la migration car il est ouvert en mode non partagé par une autre application ou par un autre service.

  • UnableToCopyCatalog : copie impossible car le magasin est endommagé.

  • UnableToAccessDevice : impossible d’accéder au périphérique.

  • UnableToApply : impossible d’appliquer le paramètre à l’ordinateur de destination.

objectName

Nom du fichier ou paramètre ayant provoqué l’erreur récupérable.

action

Action exécutée par USMT par rapport à l’erreur récupérable. Les valeurs sont :

  • Ignore : l’erreur récupérable a été ignorée et la migration s’est poursuivie, car l’option /c a été spécifiée sur la ligne de commande.

  • Abort : la migration a été arrêtée, car l’option /c n’a pas été spécifiée.

errorCode

Code d’erreur ou valeur renvoyée.

numberOfIgnoredErrors

Nombre total d’erreurs récupérables ignorées par USMT.

message

Message correspondant au code d’erreur (errorCode).

Journal Liste de fichiers

Le journal Liste de fichiers (Listfiles.txt) fournit une liste des fichiers qui ont été migrés. Cette liste peut servir à la résolution des problèmes XML ou peut être conservée comme enregistrement des fichiers qui ont été regroupés dans le magasin de migration. Le journal Liste de fichiers n’est disponible que pour ScanState.exe

Journal de diagnostic

Vous pouvez obtenir le journal de diagnostic en indiquant pour la variable d’environnement MIG_ENABLE_DIAG un chemin d’accès à un fichier XML.

Le journal de diagnostic contient les éléments suivants :

  • des informations détaillées sur l’environnement système ;

  • des informations détaillées sur l’environnement utilisateur ;

  • des informations sur les unités de migration (migunits) collectées et leur contenu.

Utilisation du journal de diagnostic

Le journal de diagnostic est essentiellement un rapport de toutes les unités de migration (migunits) incluses dans la migration. Une unité de migration est une collection de données identifiée par le composant auquel elle est associée dans les fichiers XML. Le magasin de migration est constitué de toutes les unités de migration incluses dans la migration. Le journal de diagnostic peut être utilisé pour vérifier les unités de migration qui ont été incluses dans la migration et pour résoudre les problèmes lors la création de fichiers XML de migration.

Les exemples ci-dessous illustrent des cas de figure courants dans lesquels vous pouvez utiliser le journal de diagnostic.

Pourquoi ce fichier n’a-t-il pas été migré alors qu’une règle « include » a été créée dans ce sens ?

Imaginons que nous disposons de la structure de répertoires suivante et que nous voulons inclure le répertoire « data » dans la migration avec le fichier « New Text Document.txt » dans le dossier « New Folder ». Le répertoire de C:\data contient les éléments suivants :

01/21/2009  10:08 PM    <DIR>          .
01/21/2009  10:08 PM    <DIR>          ..
01/21/2009  10:08 PM    <DIR>          New Folder
01/21/2009  09:19 PM                13 test (1).txt
01/21/2009  09:19 PM                13 test.txt
               2 File(s)             26 bytes

Le répertoire de C:\data\New Folder contient les éléments suivants :

01/21/2009  10:08 PM    <DIR>          .
01/21/2009  10:08 PM    <DIR>          ..
01/21/2009  10:08 PM                 0 New Text Document.txt
               1 File(s)              0 bytes

Pour migrer ces fichiers, vous créez le fichier XML de migration suivant :

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\ [*]</pattern>
        </objectSet>
      </include>

    </rules>
  </role>
</component>
</migration>

Toutefois, à l’issue du test de la migration, vous remarquez que le fichier « New Text Document.txt » n’est pas inclus dans la migration. Pour résoudre cet échec, la migration peut être reproduite en définissant la variable d’environnement MIG_ENABLE_DIAG de façon à générer le journal de diagnostic. Lors de la recherche du composant « DATA1 » dans le journal de diagnostic, la section XML suivante est découverte :

<MigUnitList>
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
<Patterns Type="Include">
<Pattern Type="File" Path="C:\data [*]"/>
</Patterns>
</MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)">
<Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
</MigUnit>
</Perform>

L’analyse de cette section XML révèle la présence de l’unité de migration créée lors du traitement de la règle de migration. La section <Perform> présente de façon détaillée les fichiers réels dont la collecte a été planifiée et le résultat de cette même opération. Le fichier « New Text Document.txt » ne figure pas dans cette section, ce qui confirme que la règle de migration n’a pas été correctement créée.

Une analyse de la rubrique de référence des éléments XML révèle que la balise <pattern> doit être modifiée comme suit :

<pattern type="File">c:\data\* [*]</pattern>

Après réexécution de la migration avec la balise modifiée, le journal de diagnostic révèle les informations suivantes :

<MigUnitList>
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
<Patterns Type="Include">
<Pattern Type="File" Path="C:\data\* [*]"/>
</Patterns>
</MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)">
<Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder [New Text Document.txt]" SimObj="false" Success="true"/>
</MigUnit>
</Perform>

Ce journal de diagnostic confirme que la valeur modifiée de <pattern> permet la migration du fichier.

Pourquoi ce fichier a-t-il été migré alors qu’il était censé être exclus par la règle d’exclusion qui été créée à cet effet ?

Dans ce scénario, vous disposez de la structure de répertoires suivante et vous voulez que tous les fichiers présents dans le répertoire « data » soient migrés, à l’exception des fichiers texte. Le dossier C:\Data contient les éléments suivants :

Directory of C:\Data

01/21/2009  10:08 PM    <DIR>          .
01/21/2009  10:08 PM    <DIR>          ..
01/21/2009  10:08 PM    <DIR>          New Folder
01/21/2009  09:19 PM                13 test (1).txt
01/21/2009  09:19 PM                13 test.txt
               2 File(s)             26 bytes

Le dossier C:\Data\New Folder contient les éléments suivants :

01/21/2009  10:08 PM    <DIR>          .
01/21/2009  10:08 PM    <DIR>          ..
01/21/2009  10:08 PM                 0 New Text Document.txt
               1 File(s)              0 bytes

Vous créez le fichier XML de migration suivant :

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\* [*]</pattern>
        </objectSet>
      </include>
    </rules>
    <rules>
      <exclude>
        <objectSet>
          <pattern type="File">c:\* [*.txt]</pattern>
        </objectSet>
      </exclude>

    </rules>
  </role>
</component>

Toutefois, à l’issue du test de la migration, vous remarquez que tous les fichiers texte sont toujours inclus dans la migration. Pour résoudre ce problème, la migration peut être exécutée en définissant la variable d’environnement MIG_ENABLE_DIAG de façon à générer le journal de diagnostic. Lors de la recherche du composant « DATA1 » dans le journal de diagnostic, la section XML suivante est découverte :

<MigUnitList>
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
<Patterns Type="Include">
<Pattern Type="File" Path="C:\data\* [*]"/>
</Patterns>
<Patterns Type="Exclude">
<Pattern Type="File" Path="C:\* [*.txt]"/>
</Patterns>
</MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)">
<Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test (1).txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test.docx]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test.txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder [New Text Document.txt]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder [test.docx]" SimObj="false" Success="true"/>
</MigUnit>
</Perform>

Après examen du journal de diagnostic, vous constatez que les fichiers sont toujours migrés et que le problème est imputable à la règle de migration XML qui a été créée. Vous créez la mise à jour suivante pour le script de migration XML :

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/TestSuite_BUGFIX">

<component context="System"  type="Application">
  <displayName>DATA1</displayName>
  <role role="Data">
    <rules>
      <include>
        <objectSet>
          <pattern type="File">c:\data\* [*]</pattern>
        </objectSet>
      </include>
    </rules>
    <rules>
      <exclude>
        <objectSet>
          <pattern type="File">c:\data\* [*.txt]</pattern>
        </objectSet>
      </exclude>

    </rules>
  </role>
</component>


</migration>

Votre script de migration XML corrigé exclut les fichiers de la migration, comme en atteste le journal de diagnostic :

<MigUnitList>
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)" Context="System" ConfidenceLevel="100" Group="Applications" Role="UserData" Agent="CMXEAgent" Selected="true" Supported="true">
<Patterns Type="Include">
<Pattern Type="File" Path="C:\data\* [*]"/>
</Patterns>
<Patterns Type="Exclude">
<Pattern Type="File" Path="C:\data\* [*.txt]"/>
</Patterns>
</MigUnit>
</MigUnitList>
<Perform Name="Gather" User="System">
<MigUnit Name="&lt;System&gt;\DATA1 (CMXEAgent)">
<Operation Name="Store" Type="File" Path="C:\data" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data [test.docx]" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder" SimObj="false" Success="true"/>
<Operation Name="Store" Type="File" Path="C:\data\New Folder [test.docx]" SimObj="false" Success="true"/>
</MigUnit>
</Perform>

Voir aussi

Autres ressources

Bibliothèque d’éléments XML
Syntaxe de ScanState
Syntaxe de LoadState