Configuración del archivo de registro del servidor de bases de datos de Rational DOORS

Rational DOORS 9.5 proporciona un mejor control sobre los archivos de registro en el lado del servidor.

Permite especificar límites en el tamaño de los archivos de registro, establecer la limpieza automática de archivos antiguos, elegir el formato de los archivos de registro de salida, cambiar el nivel de registro y cambiar estas opciones de configuración de registro sin tener que reiniciar el servidor. Este archivo de configuración se supervisa cada 60 segundos y cualquier cambio realizado a este archivo se verá reflejado dentro de este intervalo.

El servidor de Rational DOORS continúa dando soporte al anterior estilo de registro que se puede habilitar con conmutadores de línea de mandatos -logfile (-l) (Consulte los conmutadores de línea de mandatos del servidor de base de datos de Rational DOORS).

El archivo de configuración basado en XML que controla la información que se debe registrar en los archivos de registro, archivo de ejemplo 'logging-config.xml', se encuentra ubicado bajo la vía de acceso raíz de DOORS (por ejemplo, C:\Archivos de programa\IBM\Rational\DOORS\9.5). La vía de acceso al archivo de configuración se debería proporcionar en la entrada de registro logxconfig bajo DOORS_Server o mediante la opción de línea de mandatos ‘-x’ o ‘-logxconfig’ seguida por la vía de acceso al archivo de configuración.

El archivo de ejemplo xml logging-config se debe configurar para que incluya una vía de ubicación de carpeta válida en la que generar los archivos de registro.

Por ejemplo:

<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> se puede cambiar a <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />

Actualización del archivo logging-config.xml

El archivo logging-config.xml contiene básicamente dos secciones:

La primera sección contiene una lista de los anexadores donde se proporcionan valores sobre la vía de acceso al archivo de registro, el nivel de registro, el tamaño máximo de archivo, el número máximo de índices de copia y el formato para cada archivo de registro.

Existen 5 modalidades de registro FATAL < ERROR < WARN < INFO < DEBUG (la información que se registrará en cada nivel será toda la información que se registre de dicho nivel o uno inferior).

La segunda sección del registrador en la que se establecen valores en relación a la modalidad de toda la creación del registro y un conjunto de anexadores que se deben habilitar para la creación del registro.

Para inhabilitar la creación del registro, establezca el nivel de prioridad con el valor "off".

En la siguiente tabla se describen los parámetros que se utilizan en el archivo logging-config.xml:

Nombre de sección Nombre de parámetro Descripción Valor
Parámetros de sección de anexador      
  appender nombre Se trata del nombre del anexador que se utilizará más tarde para describir qué anexadores deben habilitarse más tarde. Cualquier valor. Por ejemplo: SystemOutAppender
  file Archivo de registro que se crea con el nombre de archivo especificado bajo la ubicación indicada en este valor de parámetro. Ubicación accesible en su sistema.
  append true: anexador para el archivo mencionado en el parámetro file. false : sobrescribe el archivo mencionado en el parámetro file. true/false
  Threshold Este parámetro establece la modalidad del registro. off, fatal, error, warn, info, debug
    Si el umbral se establece en fatal, únicamente registrará información muy grave en el archivo de registro.  
    Si el umbral se establece en error, únicamente registrará información muy grave y de error en el archivo de registro.  
    Si el umbral se establece en warn, únicamente registrará información muy grave, de error y de aviso en el archivo de registro.  
    Si el umbral se establece en info, registrará información muy grave, de error, de aviso y de información en el archivo de registro.  
    Si el umbral se establece en debug, registra toda la información (muy grave, error, aviso, información y depuración).  
    Si el umbral se establece en off, se inhabilitará la creación del registro.  
  MaxFileSize Este parámetro establece el tamaño máximo del archivo de registro y cuando el archivo de registro alcanza este límite crea un nuevo archivo de registro con un nombre de archivo al que se añade un número que se va incrementando. Cualquier valor con unidades. Por ejemplo: 1000KB
  MaxBackupIndex Este parámetro establece el número máximo de archivos que puede crear el registrador. Cuando alcance este valor, se dirigirá al archivo más antiguo y volverá a grabarlo. Cualquier valor entero.
  Patrón de conversión Este parámetro especifica el formato en que se registra la información en el archivo de registro. %d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n : empieza con una fecha
    Básicamente incluye el formato fecha hora junto con el tipo de registro [modalidad de registro] y resumen de la información registrada. Existe la posibilidad de cambiar la secuencia dependiendo de cómo desee ver los registros. [%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS} : empieza con la modalidad de registro
Parámetros de la sección del registrador      
  priority Establece el nivel de modalidad de creación del registro a nivel general. Para inhabilitar la creación del registro establezca este valor en "off". off, fatal, error, warn, info, debug
  appender-ref El valor para ref contiene el nombre de los anexadores que se han definido en las secciones anteriores de anexador. Dependiendo de los anexadores definidos con anterioridad, necesita habilitarlos proporcionando sus nombres para crear el registro. <appender-ref ref="DOORSConsoleAppender"/>
    Si desea habilitar varios anexadores, cree varias instancias con el código <appender-ref>. <appender-ref ref="SystemOutAppender"/>

Comentarios