4.11. Servidor de depuración (dbgs)

<< Prev Next >>

Si necesita iniciar manualmente el servidor de depuración, debe utilizar la línea de comandos, que puede especificar los siguientes comandos:

dbgs --version|--help
--service|--daemon
--addr=<host>
--port=<port>|--range=<range>
--ownerPID=<PID>
--password=<pwd>
--notify=<file>
--debugServerUsers=<file>

Descripción del comando:

Comando	Descripción
--version -v	Muestra la versión del servidor de depuración.
--help -h -?	Muestra la información de ayuda breve sobre los parámetros de la línea de comandos de inicio del servidor de depuración.
--service	Registra el servidor de depuración como un servicio de Windows. La clave service es incompatible con la clave daemon.
--daemon	Esta clave permite iniciar el servidor de depuración en el modo "daemon" de Linux, es decir, en el modo de aplicación en segundo plano, que no interactúa con el terminal desde el que se lanza esta aplicación. Ejecutar el servidor de depuración con esta clave no significa que tras un reinicio del sistema el agente del servidor se inicie automáticamente para su ejecución. La clave daemon es incompatible con la clave service.
--addr=<host> -a <host>	Permite especificar una dirección IP que será la dirección del servidor de depuración. Tiene sentido si tienes varias tarjetas de red con diferentes direcciones IP instaladas en tu ordenador. Si no se especifica la dirección IP, se utilizará la dirección de una tarjeta de red arbitraria.
--port=<port> -p <port>	Puerto en el que se realizará la conexión con el servidor de depuración. Si el puerto especificado no está disponible, entonces el servidor de depuración no se iniciará y la depuración será imposible. El puerto debe especificarse explícitamente, no hay valor por defecto. Cuando el servidor de depuración es iniciado por el clúster de servidores, se utilizará el puerto 1550, que es establecido por defecto por el clúster y puede ser anulado utilizando las claves de inicio del clúster de servidores. Si se especifican al mismo tiempo los parámetros de port y range, se ignorará el parámetro de port.
--range=<range> -r <range>	Especifica el rango de puertos a partir del cual seleccionar el puerto en el que conectarse al servidor de depuración. Si todos los puertos especificados en este parámetro no están disponibles, el servidor de depuración no se iniciará y la depuración no será posible. El rango de puertos se especifica con el símbolo ":", con múltiples rangos (o puertos específicos) separados por ",". Por ejemplo: 2560:2590, 4567, 9000:12000. En este ejemplo, los puertos del rango 2560 a 2590, el puerto 4567 y los puertos del rango 9000 a 12000 se utilizarían para seleccionar un puerto. El resultado será un único puerto seleccionado y utilizado en la operación. La información sobre el puerto seleccionado (junto con la dirección del servidor de depuración) se escribirá en el archivo especificado con el parámetro notify. Si se especifican al mismo tiempo los parámetros de port y range, se ignorará el parámetro de port.
--ownerPID=<PID> -opid <PID>	Este parámetro especifica el identificador del proceso del sistema operativo cuyo tiempo de vida determina el tiempo de vida del proceso del servidor de depuración. El servidor de depuración monitoriza el estado del proceso con el identificador especificado. Cuando este proceso termine, también terminará su trabajo. Al mismo tiempo, todos los procesos de depuración que se ejecuten a través de este servidor de depuración también terminarán. Cuando se depura una base de información de archivos, el Designer establece automáticamente su propio identificador de proceso para este parámetro, y cuando se ejecuta desde un clúster de servidores, el identificador de proceso del administrador del clúster (rmngr) se establece en este parámetro.
--password=<pwd> -pwd <pwd>	Contraseña de acceso al servidor de depuración. La contraseña especificada será necesaria para todos los depuradores que quieran depurar utilizando este servidor de depuración. Si el parámetro debugServerUsers se especifica al mismo tiempo que el parámetro password, el parámetro password se ignora.
--notify=<file>	Nombre completo del archivo en el que el servidor de depuración pone su dirección. El Designer o el gestor de clústeres lee la información de la dirección del servidor de depuración y borra este archivo.
--debugServerUsers=<file> -dbgsUsers <file>	Permite especificar un archivo con una lista de usuarios de depuración al servidor de depuración. Si el parámetro debugServerUsers se especifica al mismo tiempo que el parámetro password, el parámetro password se ignora. Si no se especifica el parámetro debugServerUsers, el servidor de depuración no restringe la depuración de ninguna manera.

Comando

Descripción

--version

-v

Muestra la versión del servidor de depuración.

--help

-h

Muestra la información de ayuda breve sobre los parámetros de la línea de comandos de inicio del servidor de depuración.

--service

Registra el servidor de depuración como un servicio de Windows.

La clave service es incompatible con la clave daemon.

--daemon

Esta clave permite iniciar el servidor de depuración en el modo "daemon" de Linux, es decir, en el modo de aplicación en segundo plano, que no interactúa con el terminal desde el que se lanza esta aplicación. Ejecutar el servidor de depuración con esta clave no significa que tras un reinicio del sistema el agente del servidor se inicie automáticamente para su ejecución.

La clave daemon es incompatible con la clave service.

--addr=<host>

-a <host>

Permite especificar una dirección IP que será la dirección del servidor de depuración. Tiene sentido si tienes varias tarjetas de red con diferentes direcciones IP instaladas en tu ordenador. Si no se especifica la dirección IP, se utilizará la dirección de una tarjeta de red arbitraria.

--port=<port>

-p <port>

Puerto en el que se realizará la conexión con el servidor de depuración. Si el puerto especificado no está disponible, entonces el servidor de depuración no se iniciará y la depuración será imposible. El puerto debe especificarse explícitamente, no hay valor por defecto. Cuando el servidor de depuración es iniciado por el clúster de servidores, se utilizará el puerto 1550, que es establecido por defecto por el clúster y puede ser anulado utilizando las claves de inicio del clúster de servidores.

Si se especifican al mismo tiempo los parámetros de port y range, se ignorará el parámetro de port.

--range=<range>

-r <range>

Especifica el rango de puertos a partir del cual seleccionar el puerto en el que conectarse al servidor de depuración. Si todos los puertos especificados en este parámetro no están disponibles, el servidor de depuración no se iniciará y la depuración no será posible.

El rango de puertos se especifica con el símbolo ":", con múltiples rangos (o puertos específicos) separados por ",". Por ejemplo: 2560:2590, 4567, 9000:12000. En este ejemplo, los puertos del rango 2560 a 2590, el puerto 4567 y los puertos del rango 9000 a 12000 se utilizarían para seleccionar un puerto. El resultado será un único puerto seleccionado y utilizado en la operación. La información sobre el puerto seleccionado (junto con la dirección del servidor de depuración) se escribirá en el archivo especificado con el parámetro notify.

Si se especifican al mismo tiempo los parámetros de port y range, se ignorará el parámetro de port.

--ownerPID=<PID>

-opid <PID>

Este parámetro especifica el identificador del proceso del sistema operativo cuyo tiempo de vida determina el tiempo de vida del proceso del servidor de depuración. El servidor de depuración monitoriza el estado del proceso con el identificador especificado. Cuando este proceso termine, también terminará su trabajo. Al mismo tiempo, todos los procesos de depuración que se ejecuten a través de este servidor de depuración también terminarán.

Cuando se depura una base de información de archivos, el Designer establece automáticamente su propio identificador de proceso para este parámetro, y cuando se ejecuta desde un clúster de servidores, el identificador de proceso del administrador del clúster (rmngr) se establece en este parámetro.

--password=<pwd>

-pwd <pwd>

Contraseña de acceso al servidor de depuración. La contraseña especificada será necesaria para todos los depuradores que quieran depurar utilizando este servidor de depuración.

Si el parámetro debugServerUsers se especifica al mismo tiempo que el parámetro password, el parámetro password se ignora.

--notify=<file>

Nombre completo del archivo en el que el servidor de depuración pone su dirección. El Designer o el gestor de clústeres lee la información de la dirección del servidor de depuración y borra este archivo.

--debugServerUsers=<file>

-dbgsUsers <file>

Permite especificar un archivo con una lista de usuarios de depuración al servidor de depuración. Si el parámetro debugServerUsers se especifica al mismo tiempo que el parámetro password, el parámetro password se ignora.

Si no se especifica el parámetro debugServerUsers, el servidor de depuración no restringe la depuración de ninguna manera.

Cuando se ejecuta un servidor de depuración como servicio o "demonio", debe recordarse que los elementos de depuración de las bases de información basadas en archivos y los elementos de depuración de cliente de las bases de información cliente-servidor pueden depurarse a través de dicho servidor de depuración. No se admite la depuración de elementos de depuración de servidor de bases de información cliente-servidor a través de un servidor de depuración que funcione en modo servicio o "demonio".

<< Prev Next >>