Exportar (0) Imprimir
Expandir todo

Archivos de registro

Publicada: junio de 2009

Actualizado: junio de 2010

Se aplica a: Windows 7

Los archivos de registro de Herramienta de migración de estado de usuario de Windows® (USMT) 4.0 pueden servir para supervisar la migración y solucionar los errores y las migraciones que no se han completado. En este tema se describen las opciones de línea de comandos disponibles para habilitar los archivos de registro de USMT, así como los nuevos elementos XML que distinguen entre los tipos de error que son irrecuperables y, por tanto, interrumpen la migración, y los tipos de error que son recuperables y que se pueden omitir para proseguir con la migración.

Opciones de línea de comandos de registro

Archivos de registro de ScanState y LoadState

Registro de progreso

Registro de archivos de lista

Registro de diagnóstico

Opciones de línea de comandos de registro

En la siguiente tabla se describe cada opción de línea de comandos relacionada con los archivos de registro y, asimismo, se proporcionan el nombre del archivo de registro y una descripción del tipo de información que cada uno de ellos contiene.

 

Opción de línea de comandos Nombre de archivo Descripción

/l: [rutaDeAcceso\]nombreDeArchivo

Scanstate.log o LoadState.log

Especifica el nombre y la ubicación del archivo de registro de ScanState o LoadState.

/progress: [rutaDeAcceso\]nombreDeArchivo

Especifica la ruta de acceso y el nombre de archivo de registro de progreso.

Contiene información sobre el estado de la migración por porcentaje completado.

/v: [nivelDeDetalle]

No aplicable

Vea la sección "Opciones de supervisión" del tema Sintaxis de ScanState.

/listfiles [rutaDeAcceso\]nombreDeArchivo

Especifica la ruta de acceso y el nombre de archivo del registro Listfiles.

Proporciona una lista de los archivos que se han migrado.

Establecer la variable de entorno MIG_ENABLE_DIAG en una ruta de acceso a un archivo XML.

USMTDiag.xml

El registro de diagnóstico contiene información detallada del entorno del sistema y del entorno del usuario, así como información sobre las unidades de migración (migunits) que se han recopilado y su contenido.

noteNota
Los archivos de registro no se pueden almacenar en rutaDeAccesoDeAlmacén. Si lo hace, el archivo de registro se sobrescribirá cuando se ejecute USMT.

Archivos de registro de ScanState y LoadState

Los archivos de registro de ScanState y LoadState son archivos de texto que se crean cuando se ejecutan las herramientas ScanState y LoadState, y que pueden servir para supervisar la migración. El contenido de dicho archivo dependerá de las opciones de línea de comando usadas y del nivel de detalle que se haya especificado. Para obtener más información sobre los niveles de detalle, vea Opciones de supervisión en Sintaxis de ScanState.

Registro de progreso

Puede crear un archivo de progreso por medio de la opción /progress. Algunas herramientas externas, como Microsoft System Center Operations Manager 2007, pueden analizar el registro de progreso para actualizar los sistemas de supervisión. Los tres primeros campos de cada línea aparecen dispuestos del siguiente modo:

  • Date: fecha con el formato díanombreCortoDelMesaño. Por ejemplo: 08 jun 2006.

  • Local time: hora con el formato horas:minutos:segundos (usando un reloj de 24 horas). Por ejemplo: 13:49:13.

  • Migration time: duración de la ejecución de USMT con el formato horas:minutos:segundos. Por ejemplo: 00:00:10.

El resto de campos son pares clave-valor, tal y como se indica en la siguiente tabla.

 

Clave Valor

programa

ScanState.exe o LoadState.exe.

productVersion

Número de la versión de producto completa de USMT.

computerName

Nombre del equipo de origen o de destino en el que se ha ejecutado USMT.

commandLine

Comando completo que se ha usado para ejecutar USMT.

PHASE

Informa de que se está iniciando una nueva fase de la migración. Puede ser uno de los siguientes:

  • Initializing

  • Scanning

  • Collecting

  • Saving

  • Estimating

  • Applying

detectedUser

  • En la herramienta ScanState, se trata de los usuarios que USMT ha detectado en el equipo de origen y que se pueden migrar.

  • En la herramienta LoadState, se trata de los usuarios que USMT ha detectado en el almacén y que se pueden migrar.

includedInMigration

Define si el perfil de usuario o componente se incluye en la migración. Los valores válidos son Yes o No.

forUser

Especifica cualquiera de los siguientes elementos:

  • Estado de usuario que se está migrando.

  • Este equipo, que hace referencia a los archivos y configuraciones que no están asociados a un usuario.

detectedComponent

Especifica el componente que USMT ha detectado.

  • En ScanState, se trata de un componente o aplicación que está instalado en el equipo de origen.

  • En LoadState, se trata de un componente o aplicación que se ha detectado en el almacén.

totalSizeInMBToTransfer

Tamaño total en megabytes (MB) de los archivos y configuraciones que se van a migrar.

totalPercentageCompleted

Porcentaje total de la migración que ScanState o LoadState ha completado.

collectingUser

Especifica el usuario del que ScanState está recopilando archivos y configuraciones.

totalMinutesRemaining

Estimación de tiempo (en minutos) que queda para que la migración finalice.

error

Tipo de error recuperable que ha tenido lugar. Puede ser uno de los siguientes:

  • UnableToCopy: no se pudo copiar el almacén porque el disco en el que se encuentra el almacén está lleno.

  • UnableToOpen: no se pudo abrir el archivo para la migración porque hay otra aplicación o servicio que lo ha abierto en modo no compartido.

  • UnableToCopyCatalog: no se pudo copiar porque el almacén está dañado.

  • UnableToAccessDevice: no se pudo obtener acceso al dispositivo.

  • UnableToApply: no se pudo aplicar la configuración en el equipo de destino.

objectName

Nombre del archivo o configuración que ha provocado el error recuperable.

action

Acción que USMT lleva a cabo en relación con el error recuperable. Los valores son:

  • Ignore: el error recuperable se omite y la migración prosigue, dado que se especificó la opción /c en la línea de comandos.

  • Abort: la migración se ha interrumpido porque no se especificó la opción /c.

errorCode

Código de error o valor de retorno.

numberOfIgnoredErrors

Número total de errores recuperables que USMT ha omitido.

message

Mensaje correspondiente al código de error.

Registro de archivos de lista

El registro de archivos de lista (Listfiles.txt) proporciona una lista de los archivos que se han migrado. Esta lista puede servir para solucionar problemas de XML o bien usarse a modo de registro de los archivos que se recopilaron en el almacén de migración. El registro de archivos de lista solo está disponible para ScanState.exe.

Registro de diagnóstico

El registro de diagnóstico se puede obtener si se establece la variable de entorno MIG_ENABLE_DIAG en una ruta de acceso a un archivo XML.

El registro de diagnóstico contiene lo siguiente:

  • Información detallada del entorno del sistema

  • Información detallada del entorno del usuario

  • Información sobre las unidades de migración (migunits) recopiladas y su contenido

Usar el registro de diagnóstico

Básicamente, el registro de diagnóstico es un informe donde figuran todas las unidades de migración (migunits) incluidas en la migración. Una unidad de migración es una colección de datos que se identifica mediante el componente asociado con los archivos XML. El almacén de migración está formado por todas las unidades de migración de la migración. El registro de diagnóstico se puede usar para comprobar qué unidades de migración se han incluido en la migración y, asimismo, para solucionar problemas durante la creación de los archivos XML de migración.

Los siguientes ejemplos describen los escenarios comunes en los que se puede usar el registro de diagnóstico.

¿Por qué no se migra este archivo cuando he creado una regla "include" para incluirlo?

Supongamos que tenemos la siguiente estructura de directorios y queremos que el directorio “data” se incluya en la migración, junto con el archivo “New Text Document.txt” contenido en “New Folder”. El directorio C:\data contiene:

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

El directorio C:\data\New Folder contiene:

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

Para migrar estos archivos, crea el siguiente archivo XML de migración:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://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>

Sin embargo, al probar la migración observa que el archivo “New Text Document.txt” no se ha incluido. Para solucionar este problema, la migración se puede repetir con la variable de entorno MIG_ENABLE_DIAG establecida de forma que se genere el registro de diagnóstico. Al buscar el componente “DATA1” en el registro de diagnóstico, hallamos la siguiente sección XML:

<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>

El análisis de esta sección XML pone de manifiesto que la unidad de migración se creó cuando se procesó la regla de migración. En la sección <Perform> se detallan los archivos cuya recopilación fue programada, así como el resultado de la operación de recopilación en sí. El archivo “New Text Document.txt” no aparece en esta sección, lo cual confirma que la regla de migración no se creó del modo adecuado.

Un análisis del tema de referencia de elementos XML revela que la etiqueta <pattern> necesita modificarse de la siguiente forma:

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

Cuando la migración se vuelve a realizar con la etiqueta modificada, el registro de diagnóstico indica lo siguiente:

<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>

El registro de diagnóstico confirma que el valor de <pattern> modificado hace que el archivo se migre.

¿Por qué se migra este archivo cuando he creado una regla "exclude" para excluirlo?

En este escenario tiene la siguiente estructura de directorios y desea que todos los archivos del directorio “data” se migren, excepto los archivos de texto. La carpeta C:\Data contiene:

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

La carpeta C:\Data\New Folder contiene:

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

Crea el siguiente archivo XML de migración:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://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>

Sin embargo, al probar la migración observa que todos los archivos de texto se siguen incluyendo en la migración. Para solucionar este problema, la migración se puede realizar con la variable de entorno MIG_ENABLE_DIAG establecida de forma que se genere el registro de diagnóstico. Al buscar el componente “DATA1” en el registro de diagnóstico, hallamos la siguiente sección XML:

<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>

Al revisar el registro de diagnóstico, confirma que los archivos se siguen migrando y que el problema reside en la regla XML de migración creada. Crea una actualización para el script XML de migración del siguiente modo:

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://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>

El script XML de migración revisado excluye los archivos de la migración, tal y como señala el registro de diagnóstico:

<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>

Consulte también

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft