Conmutadores de línea de mandatos para el servidor de base de datos

Puede utilizar conmutadores de línea de mandatos para establecer las opciones del mandato dbadmin y gestionar el servidor de base de datos de IBM® Rational DOORS.
Nota: Para utilizar el mandato dbadmin, se necesita el conmutador -data. Si omite dicho conmutador o utiliza un valor de datos no válido, el mandato no se puede ejecutar y se muestra este mensaje: -F- DBADMIN: El servidor no se ha especificado.

Para obtener la lista de conmutadores de línea de mandatos para el cliente de Rational DOORS, consulte Conmutadores de línea de mandatos para el cliente de Rational DOORS.

Tabla 1. Conmutadores de línea de mandatos para el mandato dbadmin en Rational DOORS
Conmutador (abreviatura) Parámetro Descripción
-data (-d) puerto@servidor_DOORS Este conmutador identifica el servidor de base de datos, donde puerto es el número de puerto que el servidor de base de datos utiliza y servidor_DOORS es el nombre del sistema donde está instalado el servidor de base de datos. Este conmutador siempre es necesario.
-killprocess (-k) identificador_canal Este conmutador desconecta la conexión de usuario especificada por el parámetro identificador_canal.

El parámetro identificador_canal se muestra con el conmutador -userlist.

-killserver (-K)   Este conmutador detiene el servidor.
-locklist (-l)   Este conmutador lista todos los archivos que están bloqueados actualmente y el identificador de canal para cada archivo.
-outfile (-o) nombre de archivo Este conmutador envía salida a un archivo.

Utilice este conmutador con los conmutadores -locklist y -userlist.

-password (-P) contraseña Este conmutador es la contraseña actual para el servidor.
-newpassword (-p) nueva_contraseña Este conmutador es la nueva contraseña para el servidor.
-unlock (-U) identificador_canal Este conmutador desbloquea el archivo especificado por el parámetro identificador_canal.

El parámetro identificador_canal se muestra con el conmutador -locklist.

-userlist (-u)   Este conmutador lista todas las conexiones de usuario.
-serverLogging nivel_registro Si el servidor se ha iniciado con los parámetros loglevel y logfile, puede utilizar este conmutador para cambiar el nivel de registro.

No es necesario reiniciar el servidor para que el nuevo nivel de registro se haga efectivo.

Para obtener una descripción de los niveles de registro, consulte Archivos de registro.
-logxconfig (-X) nombre_archivo_registro El nombre completo del archivo de configuración log4cxx; por ejemplo, c:\Archivos de programa\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxx es un marco para registrar mensajes de aplicación. Cuando se utiliza este parámetro en la línea de mandatos o en el registro, la salida corresponde a los mensajes de aplicación en el archivo de configuración especificado. Se registran seis niveles de mensaje:
  • TRACE
  • DEBUG
  • INFO, incluidos ACK, CONFIRM y QUERY
  • WARNING
  • ERROR
  • FATAL
-tdsUserFilterLimit serie Este conmutador establece límites en las búsquedas de usuario de Rational Directory Server.
-tdsGroupFilterLimit serie Este conmutador establece límites en las búsquedas de grupo de Rational Directory Server.
-useCardAuthentication   Este conmutador activa la autenticación de tarjeta inteligente.
-doNotUseCardAuthentication   Este conmutador desactiva la autenticación de tarjeta inteligente.
-useOSUserAuthentication   Este conmutador activa la autenticación de usuario de sistema operativo.
-doNotUseOSUserAuthentication   Este conmutador desactiva la autenticación de usuario de sistema operativo.
-secure on, ON, off, OFF Este conmutador especifica si el servidor de Rational DOORS se ha configurado para iniciarse en modalidad segura.
-keyDB nombre de archivo Este conmutador es la vía de acceso completa al archivo de base de datos de claves que contiene las claves que se utilizan para la validación y la autenticación SSL de Rational DOORS, incluido el nombre de archivo.

La vía de acceso predeterminada es DOORS\9.versión\certdb\server_authentication.kdb.

Este conmutador tiene prioridad sobre el conmutador -certdb. Para especificar una ubicación para la carpeta de base de datos de claves de Rational Directory Server, utilice el conmutador -certdb. Para especificar una ubicación separada para el archivo de base de datos de claves de SSL de Rational DOORS, utilice el conmutador -keyDB.

-certdb nombre_carpeta Este conmutador identifica la carpeta que contiene los archivos de base de datos de claves que contienen las claves para Rational Directory Server y Rational DOORS SSL.

La vía de acceso predeterminada es DOORS\9.versión\certdb\.

Para colocar los archivos de base de datos de claves para Rational DOORS SSL en una carpeta separada, utilice el conmutador -keyDB. El conmutador -keyDB tiene prioridad sobre el conmutador -certdb.

-certName serie Este conmutador identifica la etiqueta del certificado que identifica el servidor durante la autenticación segura.

La etiqueta predeterminada es IBMSV1.

-serverhostname serie Este conmutador es el nombre que el servidor utiliza para identificarse durante la validación de certificados.

La etiqueta predeterminada es IBMEDSERV.

Tabla 2. Conmutadores de línea de mandatos para dbadmin en Rational DOORS Web Access
Conmutador (abreviatura) Parámetro Descripción
-dwaHost servidor_DWA Este conmutador identifica el servidor de Rational DOORS Web Access, donde servidor_DWA es el nombre de host completo del sistema en el que se ejecuta el servidor; por ejemplo, dwaserver.ibm.com.
-dwaPort puerto Este conmutador identifica el número de puerto en el que se ejecuta el servidor de Rational DOORS Web Access.

Consulte las notas importantes que siguen a esta tabla sobre los valores predeterminados y los URI.

-dwaProtocol http o https Este conmutador especifica el protocolo que utiliza el servidor de Rational DOORS Web Access.

Si la comunicación es segura, especifique https. De lo contrario, especifique http. No especifique ambos.

Consulte las notas importantes que siguen a esta tabla que tratan sobre la relación del protocolo y los valores de puertos predeterminados.

-dcnEnable   Este conmutador habilita las notificaciones de cambio de datos (Data Change Notifications) necesarias para permitir la comunicación con el servidor y el intermediario de Rational DOORS Web Access.
-dcnBrokerUri tcp://intermediario:61616 Este conmutador identifica el intermediario de Rational DOORS Web Access, donde intermediario es el sistema que aloja el intermediario y 61616 es el número de puerto predeterminado que el intermediario utiliza.
-dcnChannelName dcn Este conmutador configura el canal de notificaciones de cambio de datos (Data Change Notifications). El nombre del canal es siempre "dcn".
-dcnInfo   Este conmutador comprueba el estado del servicio de notificaciones de cambio de datos (Data Change Notifications).
-dcnEnable   Este conmutador activa el servicio de notificaciones de cambio de datos (Data Change Notifications).
-dcnDisable   Este conmutador desactiva el servicio de notificaciones de cambio de datos (Data Change Notifications).
Importante: Si el conmutador -dwaPort está vacío, el valor del puerto toma de forma predeterminada el puerto estándar correspondiente al protocolo seleccionado:
Tabla 3. Conmutadores de línea de mandatos para doorsd en Rational DOORS
Conmutador (abreviatura) Parámetro Descripción
-minstall -port número_puerto -serverdata vía_acceso_datos_servidor Este conmutador crea un servicio de servidor de base de datos de Rational DOORS adicional en sistemas con sistemas operativos Windows si los parámetros se establecen con estos valores:
  • número_puerto es igual al puerto de conexión de datos
  • vía_acceso_datos_servidor es igual a la carpeta de directorio de datos en el servidor
Por ejemplo: "doorsd -minstall -port 36666 -serverdata C:\Archivos de programa(x86)\IBM\Rational\DOORS\9.6\new_data". Se asigna un número de instancia como, por ejemplo, 00001, al nuevo servicio.
-remove   Este conmutador elimina el servicio predeterminado que se creó al instalar por primera vez el servidor de base de datos.
-mremove -i número_instancia_servicio Este conmutador elimina una instancia específica de un servicio de servidor de base de datos donde número_puerto es igual al número de instancia asignado al nombre del servicio de base de datos.
-list   Este conmutador tiene como salida una lista, en formato de tabla, de todos los servicios de servidor de base de datos de Rational DOORS y su estado.
-logfile archivo_registro Este conmutador establece el archivo que se utiliza para el registro de transacciones del servidor de base de datos. Para obtener una descripción de los niveles de registro, consulte Archivos de registro.
-loglevel nivel_registro Este conmutador establece el nivel de detalle para la información registrada por el registro de transacciones del servidor de base de datos. Utilice el valor 0 para desactivar el registro. Utilice el valor 6 para producir el nivel más detallado.
-start   Este conmutador inicia el servicio de servidor de base de datos predeterminado.
-stop   Este conmutador detiene el servicio de servidor de base de datos predeterminado.

Mandato de línea de mandatos de ejemplo

Puede utilizar los conmutadores de línea de mandatos en la línea de mandatos y en atajos.

Para cerra un servidor que se ejecuta en 36677@IBMEDSERV, especifique este mandato:
dbadmin -data 36677@abc -killserver

Mandato de atajo de ejemplo

Para iniciar un servidor, utilice el siguiente atajo. Revise el mandato para que refleje la vía de instalación de Rational DOORS.
"C:\Archivos de programa (x86)\IBM\Rational\DOORS\9.versión\bin\doorsd.exe" -start

Comentarios