Opción de preprocesamiento (herramienta de administración Distributed Replay)

La herramienta de administración de Distributed Replay de Microsoft SQL Server, DReplay.exe, es una herramienta de línea de comandos que puede usar para comunicarse con Distributed Replay Controller. En este tema se describe la opción de la línea de comandos preprocess y la sintaxis correspondiente.

La opción preprocess inicia la fase de preprocesamiento. Durante esta fase, el controlador prepara los datos de seguimiento de entrada para la reproducción en el servidor destino.

 Para obtener más información sobre las convenciones de sintaxis que se usan con la herramienta de administración, vea Convenciones de sintaxis de Transact-SQL (Transact-SQL).

Sintaxis

dreplay preprocess [-m controller] -i input_trace_file
    -d controller_working_dir [-c config_file] [-f status_interval]

Parámetros

• -m controller
  Especifica el nombre del equipo que se va a controlar. Puede utilizar "localhost" o "." para hacer referencia al equipo local.

  Si no se especifica el parámetro -m, se usa el equipo local.

• -i input_trace_file
  Especifica la ruta de acceso completa del archivo de seguimiento de entrada en el controlador, por ejemplo D:\Mytrace.trc. El parámetro -i es obligatorio.

  Si hay archivos de sustitución incremental en el mismo directorio, se cargarán y usarán automáticamente. Los archivos deben seguir la convención de nomenclatura de sustitución incremental de archivos, por ejemplo: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.

  [!NOTA]

  Si está usando la herramienta de administración en un equipo que no es el controlador, tendrá que copiar los archivos de seguimiento de entrada en el controlador de forma que se pueda usar una ruta de acceso local para este parámetro.

• -d controller_working_dir
  Especifica el directorio del controlador donde se almacenará el archivo intermedio. El parámetro -d es obligatorio.

  Se aplican los siguientes requisitos:

  • El directorio debe residir en el controlador.

  • Debe especificar la ruta de acceso completa, comenzando con una letra de unidad (por ejemplo, c:\WorkingDir).

  • La ruta de acceso no debe finalizar con una barra diagonal inversa "\".

  • No se admiten las rutas de acceso UNC.

• -c config_file
  Es la ruta de acceso completa del archivo de configuración de preprocesamiento; se usa para especificar la ubicación del archivo de configuración del preprocesamiento cuando está almacenado en una ubicación diferente. Este parámetro puede ser una ruta UNC o puede residir localmente en el equipo donde se ejecuta la herramienta de administración.

  El parámetro -c no es obligatorio si no se necesita ningún filtrado o si no se desea modificar el tiempo de inactividad máximo.

  Sin el parámetro -c, se usa el archivo de configuración de preprocesamiento predeterminado, DReplay.exe.preprocess.config.

• -f status_interval
  Especifica la frecuencia (en segundos) con la que se muestran los mensajes de estado.

  Si no se especifica -f, el intervalo predeterminado es de 30 segundos.

Ejemplos

En este ejemplo, la copia intermedia del preprocesamiento se inicia con toda la configuración predeterminada. El valor localhost indica que el servicio del controlador se está ejecutando en el mismo equipo que la herramienta de administración. El parámetro input_trace_file especifica la ubicación de la información de seguimiento de entrada, c:\mytrace.trc. Dado que no se usa ningún filtrado de archivos de seguimiento, no es necesario especificar el parámetro -c.

dreplay preprocess –m localhost -i c:\mytrace.trc -d c:\WorkingDir

En este ejemplo, se inicia la fase de preprocesamiento y se especifica un archivo de configuración del preprocesamiento modificado. A diferencia del ejemplo anterior, el parámetro -c se usa para indicar el archivo de configuración modificado, si se ha almacenado en otra ubicación. Por ejemplo:

dreplay preprocess –m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config

En el archivo de configuración del preprocesamiento modificado, se agrega una condición de filtro que deja fuera las sesiones del sistema durante la reproducción distribuida. El filtro se agrega modificando el elemento <PreprocessModifiers> del archivo de configuración del preprocesamiento, DReplay.exe.preprocess.config.

En el ejemplo siguiente se muestra un ejemplo del archivo de configuración modificado:

<?xml version='1.0'?>
<Options>
    <PreprocessModifiers>
        <IncSystemSession>No</IncSystemSession>
        <MaxIdleTime>-1</MaxIdleTime>
    </PreprocessModifiers>
</Options>

Permisos

Debe ejecutar la herramienta de administración como un usuario interactivo, como un usuario local o una cuenta de usuario de dominio. Para utilizar una cuenta de usuario local, la herramienta de administración y el controlador se deben estar ejecutando en el mismo equipo.

Para obtener más información, vea Seguridad de reproducción distribuida.

Vea también

Tasks

Preparar los datos de seguimiento de entrada

Conceptos

SQL Server Distributed Replay

Configurar Distributed Replay