Puede personalizar IBM® Rational ClearQuest Web Server estableciendo los atributos de MBean disponibles.
Atención: No modifique ningún atributo de MBean a menos que estén
documentados como modificables con la notación [W] de write (escritura), o que IBM Support así se lo indique. La modificación de atributos de MBean de sólo lectura [R] o no documentados
puede afectar al rendimiento del sistema.
Los atributos se clasifican por el MBean en el que residen.
Puede recuperar todos los parámetros que están marcados con [R] que indica lectura. Los parámetros que se pueden modificar
se marcan con una [W] que indica grabación. Puede acceder a los atributos mediante mandatos Jacl
utilizando el programa de utilidad de línea de mandatos de la línea de mandatos
wsadmin de
IBM WebSphere Application Server. El archivo teamAdminUtils.jacl proporciona ejemplos de mandatos,
sintaxis y funciones Jacl. También puede modificar algunos de los atributos de MBean de
ClearQuest Web Server mediante el
recuadro de diálogo Configuración del sitio.
Puede realizar cambios sobre los parámetros modificables de MBean sólo si ClearQuest Web Server se está
ejecutando. Los cambios realizados se aplicarán inmediatamente sin que sea necesario reiniciar el
servidor. Los cambios realizados en los atributos de los MBeans que rigen el inicio de los procesos de
servidor de ONC RPC (Open Network Computing Remote Procedure
Call) de fondo no afectan a los procesos ONC RPC de fondo que ya se han iniciado. Sólo los
nuevos procesos del servidor de ONC RPC de fondo que se acaban de iniciar utilizan los nuevos valores.
Se crean dos MBeans cuando se inicia ClearQuest Web
Server: TeamServerMBean, que contiene los atributos de configuración de
ClearQuest Web Server, y
CqServerFactoryMBean, que contiene los atributos de la fábrica de conexiones gestionada por
ClearQuest.
La fábrica de conexiones gestionada por ClearQuest es el componente de ClearQuest Web Server
responsable de iniciar uno o varios procesos multihebra de servidor de fondo ONC RPC de
ClearQuest. Debido a que el proceso RPC de ClearQuest es multihebra, puede procesar solicitudes de
muchas
credenciales distintas. La fábrica de conexiones gestionadas de ClearQuest realiza automáticamente
gestión de ciclos de vida en cada proceso RPC de ClearQuest.
ClearQuest Web Server incluye los siguientes MBeans.
- TeamServerMBean
TeamServerMBean contiene los atributos que son relevantes para el
comportamiento global de ClearQuest Web Server. Los atributos que son específicos para controlar
cómo funciona la fábrica del servidor de ClearQuest se almacenan en la fábrica del servidor
CqServerFactoryMBean.
- cqFulltextSearchCacheSize[R,W]: número de coincidencias de registro guardadas en
ClearQuest Core para una búsqueda de texto completo individual. Este valor se utiliza para alterar
temporalmente el comportamiento predeterminado que ClearQuest Core presupone. El valor predeterminado para
este atributo es 0, lo que indica a ClearQuest Web Server que este valor no está establecido y no se debe utilizar para alterar temporalmente el valor predeterminado de ClearQuest Core. Un valor positivo alterará temporalmente el valor predeterminado de ClearQuest Core.
- cqFulltextSearchPageSize[R,W]: número de coincidencias de registro en una página de
resultados de búsqueda de texto completo en ClearQuest Core para una búsqueda de texto
completo individual. Este valor se utiliza para alterar
temporalmente el comportamiento predeterminado que ClearQuest Core presupone. El valor predeterminado para
este atributo es 0, lo que indica a ClearQuest Web Server que este valor no está establecido y no se debe utilizar para alterar temporalmente el valor predeterminado de ClearQuest Core. Un valor
positivo alterará temporalmente el valor predeterminado de ClearQuest Core.
- cqFulltextSearchRecordHitLimit[R,W]: número máximo de coincidencias de registro devueltas en
una llamada de servicio web para una búsqueda de texto completo individual; asimismo, número de
coincidencias que puede almacenarse en la memoria caché de un servidor de aplicaciones. El valor predeterminado es 100.
- cqLoginSessionTimeout[R,W]: cantidad de tiempo en segundos que una sesión de inicio
de sesión de ClearQuest
permanecerá antes de exceder el tiempo de espera. El valor predeterminado es 1800 segundos (30 minutos). Cada sesión
de ClearQuest emplea una conexión de base de datos, de forma que si se establece este valor como demasiado alto es posible
que se consuman recursos durante un tiempo superior al necesario. No cambie el valor predeterminado.
- cqLoginSessionWaitTimeout[R,W]: cantidad de tiempo en segundos que una hebra debe
esperar para adquirir la sesión de inicio de sesión de Rational ClearQuest. El valor
predeterminado es de 300 segundos.
- cqServerFactory[R]: nombre de objeto del MBean de fábrica de conexiones J2C de
ClearQuest.
- cqUserDBListSecureAccess[R,W]: indica si los usuarios pueden ver la lista de bases de datos cuando intenten iniciar sesión en
ClearQuest Web con credenciales no válidas. El valor predeterminado es false, que indica que los usuarios pueden ver la lista de la base de datos si intentan iniciar sesión con credenciales no válidas. Si el valor se establece en true, se habilita la autenticación de usuario para evitar que los usuarios vean la lista de bases de datos si intentan iniciar sesión con credenciales no válidas.
- ejbBufferLimit[R,W]: número máximo de objetos que devolverá una llamada de EJB. El valor predeterminado es 100.
- keepAliveInterval[R,W]: si establece un valor superior a 0 (cero) segundos, ClearQuest Web Server emitirá mensajes keep alive entre el cliente y los componentes de servidor de fondo con el intervalo periódico especificado si no se ha enviado tráfico durante este intervalo. Se ha diseñado
para garantizar que las consultas de ClearQuest de larga ejecución se puedan completar sin que la
infraestructura elimine los sockets subyacentes.
Este valor debe ser como mínimo de 10 segundos menos que
los valores de tiempo de espera de socket. El valor predeterminado es 300 segundos (cinco minutos).
- largeReadSocketTimeoutMultiplier[R,W]: el multiplicador que se aplica al valor de tiempo de espera excedido de lectura en el socket entre la capa central y el componente de servidor de fondo para algunas operaciones de muy larga duración. El valor predeterminado de 4 indica que el valor de tiempo de espera excedido de socket de lectura es cuatro veces el valor predeterminado de fábrica del tiempo de espera excedido de socket de lectura del servidor de fondo. Este multiplicador sólo se aplica a algunas operaciones. No cambie el valor a menos que IBM Support se lo indique.
- maxCqSessionsPerUser[R,W]: número máximo de sesiones de
ClearQuest que se
crearán para cada usuario en una única sesión. El valor predeterminado es 2; el valor mínimo es 1.
- maxProcureServerAttempts[R,W]: número máximo de intentos en que se puede obtener un servidor
ONC RPC de fondo antes de devolver una excepción a la agrupación de conexiones gestionada. El valor predeterminado es 6; debe ser mayor o igual que 2.
- mediumReadSocketTimeoutMultiplier[R,W]: el multiplicador que se aplica al valor de tiempo de espera excedido de lectura en el socket entre la capa central y el componente de servidor de fondo para algunas operaciones de larga duración. El valor predeterminado de 2 indica que el valor de tiempo de espera excedido de socket de lectura es dos veces el valor predeterminado de fábrica del tiempo de espera excedido de socket de lectura del servidor de fondo. Este multiplicador sólo se aplica en ciertas operaciones. No cambie el valor a menos que IBM Support se lo indique.
- numberOfActiveSessions[R]: número de sesiones activas que el servidor maneja
actualmente.
- numberOfHttpSessionsCreated[R]: número total de sesiones que ha manejado este servidor.
- oncrpcBufferLimit[R,W]: número máximo de objetos que se devolverán en una sola
llamada ONC RPC. El valor predeterminado es 100.
- oncrpcInterruptLimit[R,W]: número máximo de objetos que se devolverán para una
solicitud de usuario. El valor predeterminado es 1000.
- oncrpcServers[R]: nombres de objeto para los MBeans de servidor ONC RPC actualmente en
ejecución.
- procureServerInterval[R,W]: cantidad de tiempo total (en segundos) que se permite
esperar a una hebra de solicitud al intentar obtener un servidor antes de devolver una excepción a la agrupación de
conexiones gestionada. El valor predeterminado es 60 segundos.
- sessionObjectDefaultTimeout[R,W]: periodo de tiempo predeterminado en segundos que un objeto
permanecerá en una sesión. El valor predeterminado es 1800 segundos (30 minutos). Debe ser mayor o igual que 0.
- sessionQueryObjectTimeout[R,W]: periodo de tiempo que una sesión de inicio de sesión
de ClearQuest
permanecerá antes de exceder el tiempo de espera si no se ha entregado una consulta o carpeta de consulta nueva
o modificada. Este valor no puede ser menor
que el valor de cqLoginSessionTimeout.
El valor predeterminado es 1800 segundos (30 minutos). Este valor altera temporalmente el valor
definido por sessionObjectDefaultTimeout.
- sessionRecordObjectTimeout[R,W]: periodo de tiempo que una sesión de inicio de
sesión de ClearQuest
permanecerá antes de exceder el tiempo de espera si existe un
registro modificado o que se acaba de crear que no se ha entregado. Este valor no puede ser menor
que el valor de cqLoginSessionTimeout.
El valor
predeterminado es 10.800 segundos (3 horas). Este valor altera temporalmente el valor
definido por sessionObjectDefaultTimeout.
- sessionReaperThreadDelay[R,W]: retardo de tiempo en segundos para la hebra reaper
de sesión. El valor predeterminado es 900 segundos (15 minutos).
El rango de valores es
de 300 a 1800 segundos. Es posible que desee disminuir este valor si la memoria virtual tiene
una gran demanda. Es posible que desee aumentar este valor si se consume demasiada CPU.
- totalNumberOfOncrpcServers[R] - número de servidores RPC de fondo que se ejecutan
actualmente en todas las instancias de fábrica de conexiones de
Rational ClearQuest.
- totalOncrpcCallCount[R]: número total de llamadas a oncrpc realizadas desde el inicio del servidor.
- totalWebServiceCallCount[R]: número total de llamadas de servicio web realizadas desde el
inicio del servidor.
- versionNumber[R]: número de versión del producto ClearQuest Web Server, expresado como un valor de serie, separado por puntos. Por ejemplo, 7.1.0.1.
- CqServerFactoryMBean
Este MBean mantiene atributos de configuración relevantes para la
fábrica de conexiones gestionadas de ClearQuest. La fábrica de conexiones gestionadas por ClearQuest inicia y gestiona los procesos de fondo de ONC RPC de ClearQuest que se comunican con ClearQuest Core. Los atributos en este MBean no afectan al comportamiento
general de ClearQuest como lo hacen algunos de los atributos específicos de ClearQuest
en TeamServerMBean. En su lugar, los atributos de este MBean controlan el comportamiento de la fábrica y
la gestión de los procesos de fondo de ONC RPC de ClearQuest que inicia.
Los cambios realizados en este MBean se aplican de forma inmediata para los procesos de fondo que se
acaban de iniciar (los procesos de fondo existentes no resultan afectados); no es necesario iniciar los
procesos del servidor.
- activeHttpSessionThreshold[R,W]: número de sesiones HTTP activas en un servidor ONCRPC de
ClearQuest de fondo
activo que, si se supera, puede hacer que esta fábrica de conexiones gestionadas inicie otro servidor
ONC RPC de
ClearQuest de
fondo. El valor predeterminado es 30.
- cqrpcAbandonedProcessCleanupEnabled[R,W]: indica si
ClearQuest Web Server iniciará el procedimiento de borrado que termina todos los procesos RPC de ClearQuest abandonados.
El valor predeterminado es TRUE.
- cqrpcAbandonedProcessCleanupInterval[R,W]: duración en minutos del intervalo periódico en el que
ClearQuest Web Server inicia el procedimiento de borrado para terminar los procesos RPC de ClearQuest. El valor predeterminado es 30 minutos.
El valor debe ser mayor o igual que 0. El intervalo funciona en la potencia de 2 más cercana. Un valor de 0 indica que el intervalo se establece en 2.
- maximumActiveServers[R,W]: número máximo de servidores de ONC RPC de
ClearQuest de fondo
activos permitido por esta fábrica de conexiones gestionadas. El valor predeterminado es 10.
- recycleServerHttpSessionLimit[R,W]: número de sesiones HTTP que un servidor de ONC RPC de
ClearQuest de fondo
procesará antes de que esta fábrica de conexiones gestionadas lo recicle.
El valor
predeterminado es 200. Un valor de cero indica que no se debe comprobar este límite.
- recycleServerLifetimeLimit[R,W]: tiempo de vida máximo, en segundos, que un servidor de ONC RPC
de ClearQuest de
fondo puede ejecutarse antes de que esta fábrica de conexiones gestionadas lo recicle. El valor predeterminado es 86.400 segundos (24 horas). Un valor de cero indica que no se comprobará este límite.
- recycleServerOncrpcCallLimit[R,W]: número máximo de solicitudes ONC RPC que un
servidor ONC RPC de ClearQuest
de fondo procesará antes de que esta fábrica de conexiones gestionadas lo recicle. El valor predeterminado es 100.000. Un valor de cero indica que no se comprobará este límite.
- recyclingPeriod[R,W]: cantidad de tiempo, en segundos, que tiene un servidor de ONC RPC de
ClearQuest ONC de
fondo que se está reciclando para finalizar el trabajo de sesiones pendiente antes de que esta
fábrica de conexiones gestionadas lo finalice. El estado de un servidor de ONC RPC de
ClearQuest de fondo
que se está reciclando será 2 (STOPPING). El valor predeterminado es 1800 segundos (30 minutos). Debe ser mayor que 0.
- remoteChartReportServerHostName[R,W]: sólo para sistemas UNIX y Linux. Nombre de host de un Windows ClearQuest Web Server designado para procesar solicitudes de gráfica e informe. El valor
predeterminado es "" (serie vacía/unset).
- remoteChartReportServerPort[R,W]: sólo para sistemas UNIX y Linux. Número de puerto de un Windows ClearQuest Web Server designado para procesar solicitudes de gráfica e informe. El valor predeterminado es 0.
- serverWorkerThreadCount[R,W]: número de hebras que un servidor de ONC RPC de
ClearQuest de fondo
utilizará para manejar las solicitudes entrantes. El valor predeterminado es 30.
- OncrpcServerMBean:
Para cada proceso de fondo ONC RPC que inicia la fábrica de
conexiones gestionadas de ClearQuest, se crea una instancia de CqOncrpcServerMBean. Cada MBean
contiene los valores definidos en el OncrpcServerMBean base (tenga en cuenta que nunca se crea una
instancia del OncrpcServerMBean base). Cada MBean del proceso servidor sólo persiste mientras el
proceso
que representa se ejecuta en el sistema de ClearQuest Web Server. Cuando el proceso
termina, el MBean que representa el proceso termina también. Estos son los atributos base que se
encuentran en todos los MBeans del proceso servidor:
- hostname[R]: nombre del host donde se ejecuta el servidor de ONC RPC de fondo.
- oncrpcCalls[R]: número total de llamadas a ONC RPC que ha manejado el servidor de ONC RPC de
fondo.
- port[R]: número de puerto de entero donde escucha el servidor de ONC RPC de fondo.
- serverId[R]: ID exclusivo del servidor de ONC RPC de fondo.
- serverStartTime[R]: indicación de fecha y hora de cuándo se inició el servidor de ONC RPC de
fondo. El valor
es el número de segundos desde el 1 de enero de 1970, 00:00:00, hora media de Greenwich.
- serverState[R]: estado actual del servidor de ONC RPC de fondo, representado con un entero
(0=STOPPED, 1=RUNNING, 2=STOPPING, 3=DEAD).
- serverStoppingTime[R]: indicación de fecha y hora de cuándo el servidor de ONC RPC de fondo
ha pasado al
estado STOPPING (2). El valor
es el número de segundos desde el 1 de enero de 1970, 00:00:00, hora media de Greenwich.
- serverStopTime[R]: indicación de fecha y hora de cuando el servidor de ONC RPC de fondo
ha pasado al
estado STOPPED (0) o DEAD (3). El valor es el número de segundos desde el 1 de enero de 1970, 00:00:00,
hora media de Greenwich.
- serverType[R]: tipo del servidor de ONC RPC de fondo
(Rational ClearCase).
- CqOncrpcServerMBean
Para cada proceso de fondo ONC RPC de ClearQuest que inicia la fábrica de
conexiones
gestionadas de ClearQuest, se crea una instancia del MBean CqOncrpcServerMBean. Esta instancia sólo
persiste mientras el proceso de fondo ONC RPC de ClearQuest que representa se está ejecutando en el
sistema
de ClearQuest Web Server. Tan pronto como el proceso termina, el MBean que representa el proceso
termina también.
CqOncrpcServerMBean es una extensión de OncrpcServerMBean. Cada
CqOncrpcServerMBean contiene todos los valores definidos por OncrpcServerMBean más los valores
adicionales definidos aquí:
- activeHttpSessions[R]: número de sesiones HTTP activas que maneja actualmente el servidor
de ONC RPC de
ClearQuest de
fondo.
- activeStatefulHttpSessions[R]: número actual de sesiones HTTP con estado que maneja
actualmente el servidor de ONC RPC de
ClearQuest de fondo.
- recycleReasonCode[R]: código de razón (representado como un entero) que especifica el motivo
por el que se recicla el servidor de ONC RPC de
ClearQuest de
fondo.
- 1=RECYCLE_TIME_LIMIT_EXCEEDED
- 2=ONCRPC_CALL_LIMIT_EXCEEDED
- 3=SESSION_LIMIT_EXCEEDED
- recycleServerHttpSessionLimit[R,W]: número máximo de sesiones que manejará el servidor
de ONC RPC de ClearQuest de fondo antes de reciclarse.
El valor predeterminado se establece inicialmente utilizando el valor del atributo recycleServerHttpSessionLimit
en CqServerFactoryMBean. Sólo se puede establecer en un servidor de ONC RPC de ClearQuest de fondo en
ejecución.
Tenga en cuenta que todos los procesos del servidor de ONC RPC son volátiles. Definir el valor
en un servidor de ONC RPC de
ClearQuest que se está ejecutando puede fallar si la fábrica de conexiones gestionada por ClearQuest finaliza el servidor cuando se está intentando cambiar el valor.
- totalHttpSessions[R]: número total de sesiones HTTP que ha gestionado el servidor de ONC RPC de fondo de
ClearQuest.
- workerThreadCount[R]: número de hebras que utiliza el servidor de ONC RPC de
ClearQuest de fondo
para procesar las solicitudes.