Modificación de los atributos de MBean con la herramienta wsadmin

Puede personalizar Rational ClearQuest Web Server estableciendo los atributos de MBean disponibles con la interfaz de línea de mandatos wsadmin de WebSphere Application Server.
Importante: No modifique ningún atributo de MBean, a menos que los atributos estén documentados como modificables con la anotación [W], que indica grabación, o a menos que se lo indique el Soporte de IBM®. La modificación de atributos de MBean de sólo lectura [R] o no documentados puede afectar al rendimiento del sistema.

ClearQuest Web Server debe estar en ejecución cuando utilice la herramienta wsadmin.

Los atributos de MBean se clasifican por el MBean en el que residen. Puede recuperar todos los parámetros que se indican mediante [R] para lectura. Los parámetros que se pueden modificar se marcan con una [W] que indica grabación. Puede acceder a los atributos utilizando la herramienta wsadmin de IBM WebSphere Application Server herramienta con mandatos Jacl (Aplicación Java Control Language). El archivo teamAdminUtils.jacl proporciona ejemplos de mandatos, sintaxis y funciones Jacl. También puede modificar algunos de los atributos MBean de ClearQuest Web Server atributos utilizando la ventana Configuración del sitio.

Puede cambiar los parámetros modificables de MBean sólo si ClearQuest Web Server se está ejecutando. Los cambios realizados se aplicarán inmediatamente sin necesidad de iniciar los procesos del 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 gestionada por ClearQuest realiza automáticamente la gestión de ciclos de vida en cada proceso RPC de ClearQuest.

MBeans y atributos de MBean

Los atributos de MBeans de ClearQuest Web Server que se describen a continuación, están organizados por MBean:
  • 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 de ClearQuest Web Server se almacenan en la fábrica del servidor de CqServerFactoryMBean.
    Tabla 1. Atributos de TeamServerMBean
    Atributo de MBean Control de acceso Descripción
    attachmentTempLocation [R,W] Especifica un directorio para almacenar los adjuntos. De forma predeterminada, los adjuntos se almacenan profundamente dentro de la estructura de directorios del perfil de WAS. Sin embargo, Windows limita la longitud de los nombres de las vías de acceso a aproximadamente a 250 bytes. Si el nombre de archivo del adjunto es mayor que aproximadamente 150 bytes, ClearQuest podría no almacenar el adjunto porque el nombre de la vía de acceso completo del adjunto en la ubicación de almacenamiento predeterminada superaría los 250 bytes.
    cqFulltextSearchCacheSize [R,W] El número de coincidencias de registro guardadas en ClearQuest Core para una búsqueda de texto completo individual. El valor predeterminado es 0 (sin definir). Un valor positivo altera temporalmente el valor predeterminado de ClearQuest Core.
    cqFulltextSearchRecordHitLimit [R,W] El número máximo de coincidencias de registro que se devuelven en una llamada de servicio web de búsqueda de texto completo. El número también representa el número de coincidencias que se pueden almacenar en memoria caché en el servidor de aplicaciones. El valor predeterminado es 100.
    cqLoginSessionTimeout [R,W] La cantidad de tiempo, en segundos, que una sesión de inicio de sesión de Rational ClearQuest persistirá antes de que se exceda 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 en un valor demasiado alto puede consumir recursos durante más tiempo del necesario. No cambie el valor predeterminado.
    cqLoginSessionWaitTimeout [R,W] La cantidad de tiempo, en segundos, que una hebra puede esperar para adquirir la sesión de inicio de sesión de Rational ClearQuest. El valor predeterminado es de 300 segundos.
    cqServerFactory [R] El nombre de objeto del MBean de la 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, lo que impide que los usuarios no autorizados vean la lista de bases de datos.
    ejbBufferLimit [R,W] El número máximo de objetos devueltos por una llamada EJB. El valor predeterminado es 100.
    keepAliveInterval [R,W] Si este valor es superior a 0 segundos, ClearQuest Web Server emitirá mensajes keepalive entre el cliente y los componentes de servidor de fondo en el intervalo periódico especificado. Este atributo está diseñado para garantizar que se completen las consultas de ClearQuest de larga ejecución sin eliminar los sockets subyacentes. Este valor debe ser como mínimo de 10 segundos menos que los valores de tiempo de espera excedido de los sockets. El valor predeterminado es 300 segundos (5 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 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 este valor a menos que se lo indique el Soporte de IBM.
    maxCqSessionsPerUser [R,W] El 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] El 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; este valor debe ser mayor que o igual a 2.
    mediumReadSocketTimeoutMultiplier [R,W] Multiplicador para aplicar al valor de tiempo de espera excedido de lectura en el socket entre la capa intermedia y el componente de servidor de fondo para determinadas operaciones de larga ejecución. El valor predeterminado de 2 indica que el valor de tiempo de espera excedido de socket de lectura es de dos veces el valor predeterminado de fábrica del tiempo de espera excedido de socket de lectura predeterminado 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.
    numberOfActiveSessions [R] El número de sesiones activas que el servidor maneja.
    numberOfHttpSessionsCreated [R] El número de sesiones manejadas por este servidor.
    oncrpcBufferLimit [R,W] El número máximo de objetos que devueltos en una sola llamada ONC RPC. El valor predeterminado es 100.
    oncrpcInterruptLimit [R,W] El número máximo de objetos devueltos para una solicitud de llamada de usuario. El valor predeterminado es 1000.
    oncrpcServers [R] Los nombres de objeto para la ejecución de MBeans del servidor ONC RPC.
    procureServerInterval [R,W] La cantidad de tiempo (en segundos) que una hebra de solicitud puede esperar para obtener un servidor antes de que la hebra de solicitud devuelva una excepción a la agrupación de conexiones gestionadas. El valor predeterminado es 60 segundos.
    sessionObjectDefaultTimeout [R,W] El periodo de tiempo predeterminado, en segundos, que un objeto permanece en una sesión. El valor predeterminado es 1800 segundos (30 minutos). Este valor debe ser mayor que o igual a 0.
    sessionQueryObjectTimeout [R,W] El período de tiempo que persistirá una sesión de inicio de sesión de ClearQuest antes de que se exceda el tiempo de espera si no se entrega una 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] El período de tiempo que persistirá una sesión de inicio de sesión de ClearQuest antes de que se exceda el tiempo de espera si no se entrega un registro nuevo o modificado. 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. Puede aumentar este valor si se está utilizando demasiada CPU.
    totalNumberOfOncrpcServers [R] El 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] El número de llamadas a ONC RPC realizadas desde el inicio del servidor.
    totalWebServiceCallCount [R] El número de llamadas de servicio web realizadas desde el inicio del servidor.
    versionNumber [R] El número de versión del producto ClearQuest Web Server, expresado como un valor de serie, separado por puntos. Por ejemplo, 7.1.2.1.
  • CqServerFactoryMBean
    Este atributo mantiene los valores de configuración relevantes para la fábrica de conexiones gestionadas por 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 de este MBean no afectan el comportamiento general de ClearQuest como lo hacen algunos de los atributos de ClearQuest en el MBean 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; no es necesario iniciar los procesos del servidor. Los procesos de fondo existentes no resultan afectados.
    Tabla 2. Atributos de CqServerFactoryMBean
    Atributo de MBean Control de acceso Descripción
    activeHttpSessionThreshold [R,W] El número de sesiones HTTP activas en un servidor ONC RPC de ClearQuest de fondo activo. Si se supera este valor, 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] El intervalo periódico, en minutos, que utiliza ClearQuest Web Server para iniciar el procedimiento de borrado que termina todos los procesos RPC de ClearQuest abandonados. El valor predeterminado es de 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] El 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.
    recycleServerHttpSessionLimi [R,W] El 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 este límite no está seleccionado.
    recycleServerLifetimeLimit [R,W] El 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 este límite no está seleccionado.
    recycleServerOncrpcCallLimit [R,W] El 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 este límite no está seleccionado.
    recyclingPeriod [R,W] La 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 de 1800 segundos (30 minutos). Este valor debe ser mayor que 0.
    remoteChartReportServerHostName [R,W] UNIX Linux El nombre de host de una instancia de ClearQuest Web Server de Windows designado para procesar solicitudes de gráficas. El valor predeterminado es " " (una serie vacía/sin definir).
    remoteChartReportServerPort [R,W] UNIX Linux El número de puerto de una instancia de ClearQuest Web Server de Windows designado para procesar solicitudes de gráficas. El valor predeterminado es 0.
    serverWorkerThreadCount [R,W] El 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 proceso de OncrpcServerMBean base. (Nunca se crea una instancia del OncrpcServerMBean base). Cada proceso del servidor de MBean se ejecuta sólo mientras el proceso que representa se está ejecutando en ClearQuest Web Server.Cuando el proceso termina, también termina el proceso del MBean asociado. La Tabla 3 describe los atributos base que se encuentran en todos los procesos de servidor MBean.
    Tabla 3. Atributos de OncrpcServerMBean
    Atributo de MBean Control de acceso Descripción
    hostname [R] El nombre del host en el que se ejecuta el servidor ONC RPC de fondo.
    oncrpcCalls [R] El número total de llamadas a ONC RPC que ha manejado el servidor de ONC RPC de fondo.
    port [R] El número de puerto de entero donde escucha el servidor de ONC RPC de fondo.
    serverId [R] El ID exclusivo del servidor de ONC RPC de fondo.
    serverStartTime [R] La indicación de fecha y hora de cuándo se inició el servidor de ONC RPC de fondo. Este valor es el número de milisegundos desde el 1 de enero de 1970, 00:00:00, hora media de Greenwich.
    serverState [R] El estado actual del servidor de ONC RPC de fondo, representado con un entero (0=STOPPED, 1=RUNNING, 2=STOPPING, 3=DEAD).
    serverStoppingTime [R] La 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 milisegundos desde el 1 de enero de 1970, 00:00:00, hora media de Greenwich.
    serverStopTime [R] La 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 milisegundos desde el 1 de enero de 1970, 00:00:00, hora media de Greenwich.
    serverType [R] El tipo de servidor ONC RPC de fondo: Rational ClearQuest.
  • 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 persiste mientras el proceso de fondo de ONC RPC de ClearQuest al representa se ejecuta en ClearQuest Web Server. Tan pronto como el proceso termina, el MBean que representa el proceso termina también.

    El proceso de CqOncrpcServerMBean es una extensión del proceso de OncrpcServerMBean. Cada proceso de CqOncrpcServerMBean contiene todos los valores definidos por el proceso de OncrpcServerMBean más los atributos descritos en la Tabla 4.

    Tabla 4. Atributos de CqOncrpcServerMBean
    Atributo de MBean Control de acceso Descripción
    activeHttpSessions [R] El número de sesiones HTTP activas que maneja actualmente el servidor de ONC RPC de ClearQuest de fondo.
    activeStatefulHttpSessions [R] El número actual de sesiones HTTP con estado que maneja actualmente el servidor de ONC RPC de ClearQuest de fondo.
    recycleReasonCode [R] El 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. Este atributo es un valor entero.
    1
    RECYCLE_TIME_LIMIT_EXCEEDED
    2
    ONCRPC_CALL_LIMIT_EXCEEDED
    3
    SESSION_LIMIT_EXCEEDED
    recycleServerHttpSessionLimit [R,W] El 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 utilizando el valor del atributo recycleServerHttpSessionLimit en CqServerFactoryMBean. El valor sólo se pueden establecer desde un servidor de ONC RPC de fondo de ClearQuest. Todos los procesos del servidor de ONC RPC de fondo son volátiles. Si se establece este valor en un servidor de ONC RPC de ClearQuest es posible que falle si la fábrica de conexiones gestionadas de ClearQuest finaliza el servidor.
    totalHttpSessions [R] El número total de sesiones HTTP que soporta el servidor de ONC RPC de fondo de ClearQuest.
    workerThreadCount [R] El número de hebras que el servidor de ONC RPC de ClearQuest de fondo utiliza para procesar las solicitudes.

Ejemplos

Utilización de la herramienta wsadmin para recuperar y establecer los atributos de MBean

Este ejemplo ilustra los mandatos basados en Jacl para iniciar y utilizar la herramienta wsadmin.

// En esta sección se proporciona mandatos de ejemplo para iniciar y utilizar la herramienta wsadmin.
// Con fines ilustrativos, un indicador de mandatos del sistema operativo se denota con el
// carácter de almohadilla, "#", y el indicador de mandatos de wsadmin mediante "wsadmin>".
//
// Existen scripts de la herramienta wsadmin de ClearQuest Web Server que proporcionan prácticos
// cómodos métodos y funciones. De manera predeterminada, estos scripts se encuentran en el
// siguiente directorio:
// En Windows:
//      "C:\Program Files\IBM\RationalSDLC\common\CM\scripts" 
// En el sistema UNIX y Linux:
// "/opt/rational/common/CM/scripts" en el sistema UNIX y Linux.
//
// Abra un indicador de mandatos y establezca su directorio predeterminado en la ubicación de
// de los scripts de wsadmin de ClearQuest Web Server.  Por ejemplo:
//
// En Windows:
# cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
//
// En el sistema UNIX y Linux:
# cd /opt/rational/common/CM/scripts
//
// Establezca la variable de entorno WAS_BIN en la ubicación de la herramienta wsadmin
// utilizando la sintaxis adecuada para su shell preferido. Por ejemplo:
//
// En Windows:
# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin" 

// En el sistema UNIX y Linux:
# WAS_BIN=/opt/rational/common/eWAS/bin

// Inicie wsadmin especificando el nombre de perfil de ClearQuest Web Server.
// El nombre de perfil de ClearQuest Web Server predeterminado es 'cmprofile'.  Por ejemplo:
//
// En Windows:
# %WAS_BIN%\wsadmin -profileName cmprofile

// En el sistema UNIX y Linux:
# $WAS_BIN/wsadmin.sh -profileName cmprofile

// El siguiente mandato wsadmin carga las funciones prácticas de wsadmin de ClearQuest Web Server:
wsadmin> source teamAdminUtils.jacl

// El mandato siguiente es un ejemplo de cómo visualizar algunos mandatos de ClearQuest Web Server prácticos.
// La función getTeamServer es útil para establecer un puntero al TeamServerMBean de
// nivel superior, y le ayudará a obtener y establecer atributos individuales de TeamServerMBean.
//
wsadmin> info proc *Team*
    startTeamEAR stopTeamEAR getTeamServer

// El mandato siguiente muestra los mandatos 'dump' disponibles para la fácil y
// rápida visualización de los valores del MBean:
wsadmin> info proc dump*

   dumpAllServers dumpAll dumpTeamServer dumpCcServers dumpCqServerFactory 
   dumpCcServerFactory dumpCqServers


// El mandato siguiente usa el cómodo mandato 'getTeamServer' para establecer la
// variable 't' que se puede utilizar para acceder a los atributos de TeamServerMBean:
wsadmin> set t [getTeamServer]

// Recupere los valores de los atributos de TeamServerMBean mediante la variable 't':
wsadmin> $AdminControl getAttributes $t

{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
    mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
    process=server1}

{oncrpcBufferLimit 100}
{cqLoginSessionWaitTimeout 300}
{oncrpcInterruptLimit 1000}
{sessionReaperThreadDelay 900}
{sessionQueryObjectTimeout 1800}
{oncrpcServers {
{cqLoginSessionTimeout 1800}
{cqFulltextSearchRecordHitLimit 100}
{ejbBufferLimit 100}
{sessionRecordObjectTimeout 10800}
{cqFulltextSearchPageSize 25}
{numberOfActiveSessions 0}
{sessionObjectDefaultTimeout 1800}
{maxProcureServerAttempts 6}
{cqFulltextSearchCacheSize 1000}
{maxCqSessionsPerUser 2}
{totalNumberOfOncrpcServers 0}
{numberOfHttpSessionsCreated 0}
{procureServerInterval 60}



// La siguiente es una forma más cómoda de recuperar todos los atributos de TeamServerMBean:
wsadmin> dumpTeamServer

Atributos de TeamServerMBean:
====================

{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
    mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
    process=server1}


// Otros mandatos 'get' prácticos son: getCqServerFactory, getTeamServer
// y getOncrpcServers.


//El mandato siguiente configura la variable 'cq' para acceder a los atributos de
// ccServerFactory. Tenga en cuenta que la variable 't' definida en un mandato anterior se utiliza para
//obtener un puntero al valor del atributo cqServerFactory de TeamServerMBean; la
// variable 'cq' se puede utilizar después para acceder a los atributos de CqServerFactoryMBean:
wsadmin> set cq [$AdminControl getAttribute $t cqServerFactory]

// La siguiente es una forma más cómoda de configurar la variable 'cq':
wsadmin>set cq [getCqServerFactory]

//El mandato siguiente recupera los valores de los atributos de CqServerFactoryMBean utilizando la
// variable 'cq' definida anteriormente:
wsadmin> $AdminControl getAttributes $cq
. . . 

// El mandato siguiente configura la variable 'os' para utilizarla para acceder a la lista de
// MBeans del servidor ONCRPC, cada uno de los cuales representa un servidor de fondo ONCRPC específico.
// El mandato utiliza uno de los cómodos métodos definidos en el script teamAdminUtils.jacl
// que se 'generó' al principio de esta sesión:
wsadmin> set os [$AdminControl invoke $t getOncrpcServers]
        .   .   .   

        // Se muestra una lista de servidores de fondo oncrpc en ejecución. El primer
        // servidor oncrpc está en el índice 0 (cero), el segundo está en el índice 1, etc.


// El mandato siguiente configura la variable 'o' para acceder al MBean del primer servidor oncrpc
// visualizado en el resultado del mandato anterior. Este nivel de acceso a atributos de MBeans
// (es decir, MBeans de servidor oncrpc específicos) es complicado ya que los procesos del
// servidor oncrpc de fondo son transitorios y es posible que se desechen antes de acceder a ellos.
wsadmin> set o [getOnc 0]      // '0' es el número de índice del primer servidor de fondo
                               //  listado en el resultado del mandato anterior.

// El mandato siguiente recupera los valores de atributos de MBeans para el servidor oncrpc de CQ
// definido por la variable 'o':
wsadmin> $AdminControl getAttributes $o
        {workerThreadCount 16}
        {serverState 1}
        {activeStatefulHttpSessions 0}
        {port 3431}
        {oncrpcCalls 7}
        {recycleServerHttpSessionLimit 500}
        {serverId {ClearQuest - 0
        {serverType ClearQuest}
        {hostname testhost2}
        {activeHttpSessions 0}
        {totalHttpSessions 1}


// El mandato siguiente establece y luego obtiene el atributo recycleServerHttpSessionLimit
// en el servidor oncrpc de CQ definido anteriormente por la variable 'o':
wsadmin> $AdminControl setAttribute $o recycleServerHttpSessionLimit 501

wsadmin> $AdminControl getAttribute $o recycleServerHttpSessionLimit
     501


// Los restantes mandatos muestran algunos accesos más de MBeans del servidor oncrpc y sus salidas.
//Recuerde que la lista de servidores ONCRPC es transitoria; utilizar mandatos de vuelco
// tales como dumpCqServers o dumpAllServers resulta más práctico:

wsadmin> listOnc
       "WebSphere:cell=testhost2Node02Cell,version=6.1.0.0,spec=1.0,
       name=ClearQuest - 11,mbeanIdentifier=ClearQuest - 11,
       type=stp.management.CqOncrpcServerMBean,node=testhost2Node02,
       process=server1"
       

//Estos son ejemplos de lo que verá si utiliza los mandatos dump más prácticos:
wsadmin> dumpAllServers

Servidor ONCRPC: ClearQuest - 0
============
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname testhost2}
{activeHttpSessions 0}
{totalHttpSessions 0}


wsadmin> dumpCqServers
Servidor de CQRPC: ClearQuest - 0
===========
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname duke2}
{activeHttpSessions 0}
{totalHttpSessions 0}


wsadmin> dumpCqServerFactory
Atributos de CqServerFactoryMBean:
==========================
{serverWorkerThreadCount 10}
{recycleServerLifetimeLimit 14400}
{recyclingPeriod 3600}
{recycleServerOncrpcCallLimit 500000}
{recycleServerHttpSessionLimit 500}
{maximumActiveServers 4}
{activeHttpSessionThreshold 40}


wsadmin> dumpAll
     // La salida de este mandato es un vuelco de todos los valores de los atributos de MBean,
     // incluidos todos los procesos de servidor ONCRPC de fondo actualmente en ejecución.

Utilización de la herramienta wsadmin para importar y exportar los atributos de MBean

Utilice la herramienta wsadmin con los mandatos import y export de ClearQuest Web Server para importar y exportar, respectivamente, los atributos de MBean. Estos mandatos permiten recuperar y actualizar los valores de los atributos de MBean y proporcionar un sencillo método para capturar configuraciones específicas. Si ClearQuest Web Server no funciona correctamente, puede importar en tiempo real una configuración capturada anteriormente, que sabe que funciona correctamente.

Puede editar los archivos de propiedades utilizando un editor de texto, y, a continuación, importar y exportar estos archivos en tiempo real. Puede comentar las entradas de los archivos de propiedades que no tenga que importar. Asegúrese de seguir los convenios de denominación para los nombres de MBean y los nombres de atributos. Para borrar un valor de serie cuando se utiliza el mandato importFile, especifique " " o deje el valor en blanco en el archivo de propiedades que vaya a importar. No deje en blanco los valores numéricos.

// Este mandato wsadmin carga todos los mandatos y métodos prácticos,
// incluidos los mandatos importFile y exportToFile.  Estos mandatos
// permiten recuperar y actualizar los valores de los atributos de MBean y son un modo
// sencillo de capturar configuraciones específicas.  Si ClearQuest Web Server
// (al que en releases anteriores se hacía referencia como CM Server) no funciona
// correctamente, puede importar una configuración capturada previamente
// en tiempo real.
wsadmin> source teamAdminUtils.jacl

// Utilice el mandato exportToFile si desea capturar una instantánea de los MBeans
// TeamServerMBean y CqServerFactoryMBean.  Especifique el
// nombre de vía de acceso completo donde almacenará el archivo.  Puede editar el archivo de
// propiedades resultante con un editor de texto, e importar el archivo utilizando
// el mandato importFile.
//Importante: debe utilizar barras inclinadas en el nombre de vía de acceso para estos mandatos.
wsadmin> exportToFile C:/temp/CmServer.properties

El archivo "C:/temp/CmServer.properties" no existe, se continúa con la exportación...
Recuperando MBeans...
Exportando TeamServerMBean.sessionReaperThreadDelay...
Exportando TeamServerMBean.cqLoginSessionTimeout...
Exportando TeamServerMBean.cqLoginSessionWaitTimeout...
Exportando TeamServerMBean.sessionObjectDefaultTimeout...
Exportando TeamServerMBean.sessionQueryObjectTimeout...
Exportando TeamServerMBean.sessionRecordObjectTimeout...
Exportando TeamServerMBean.oncrpcBufferLimit...
Exportando TeamServerMBean.oncrpcInterruptLimit...
Exportando TeamServerMBean.ejbBufferLimit...
Exportando TeamServerMBean.cqFulltextSearchPageSize...
Exportando TeamServerMBean.cqFulltextSearchCacheSize...
Exportando TeamServerMBean.cqFulltextSearchRecordHitLimit...
Exportando TeamServerMBean.procureServerInterval...
Exportando TeamServerMBean.maxProcureServerAttempts...
Exportando TeamServerMBean.maxCqSessionsPerUser...
Exportando CqServerFactoryMBean.serverWorkerThreadCount...
Exportando CqServerFactoryMBean.activeHttpSessionThreshold...
Exportando CqServerFactoryMBean.maximumActiveServers...
Exportando CqServerFactoryMBean.recycleServerHttpSessionLimit...
Exportando CqServerFactoryMBean.recycleServerLifetimeLimit...
Exportando CqServerFactoryMBean.recycleServerOncrpcCallLimit...
Exportando CqServerFactoryMBean.recyclingPeriod...

wsadmin> importFile C:/temp/CmServer.properties

El archivo "C:/temp/CmServer.properties" no se ha encontrado, se continúa con la exportación...
Importando valor '900' en la propiedad sessionReaperThreadDelay en MBean TeamServerMBean
    Valor anterior=900
    Nuevo valor=900
Importando valor '1803' en la propiedad cqLoginSessionTimeout en MBean TeamServerMBean
    Valor anterior=1803
    Nuevo valor=1803
Importando valor '300' en la propiedad cqLoginSessionWaitTimeout en MBean TeamServerMBean
    Valor anterior=300
    Nuevo valor=300
Importando valor '1800' en la propiedad sessionObjectDefaultTimeout en MBean TeamServerMBean
    Valor anterior=1800
    Nuevo valor=1800
   . . .

// Si intenta realizar la exportación a un archivo que ya existe, se añadirá automáticamente una indicación de fecha y hora al
// nombre de archivo especificado en el mandato:
wsadmin> exportToFile C:/temp/CmServer.properties

El archivo "C:/temp/CmServer.properties" ya existe; se añade la fecha al nombre de archivo.
exportFilePath es ahora: C:/temp/CmServer.properties_2008-07-09_16-27-11
Recuperando MBeans...
Exportando TeamServerMBean.sessionReaperThreadDelay...

// Este es el aspecto de un archivo exportado típico:
C:\> type c:\temp\CmServer.properties
# Export of ClearQuest Web server MBean attributes, created: 2008-07-09_16-22-29
#
#
# Atributos grabables de TeamServerMBean
#
TeamServerMBean.sessionReaperThreadDelay=900
TeamServerMBean.cqLoginSessionTimeout=1803
TeamServerMBean.cqLoginSessionWaitTimeout=300
TeamServerMBean.sessionObjectDefaultTimeout=1800
TeamServerMBean.sessionQueryObjectTimeout=1803
TeamServerMBean.sessionRecordObjectTimeout=10800
TeamServerMBean.oncrpcBufferLimit=100
TeamServerMBean.oncrpcInterruptLimit=1000
TeamServerMBean.ejbBufferLimit=100
TeamServerMBean.cqFulltextSearchPageSize=25
TeamServerMBean.cqFulltextSearchCacheSize=1000
TeamServerMBean.cqFulltextSearchRecordHitLimit=100
TeamServerMBean.procureServerInterval=60
TeamServerMBean.maxProcureServerAttempts=6
TeamServerMBean.maxCqSessionsPerUser=2
#
# Atributos grabables de CqServerFactoryMBean
#
CqServerFactoryMBean.serverWorkerThreadCount=10
CqServerFactoryMBean.activeHttpSessionThreshold=40
CqServerFactoryMBean.maximumActiveServers=4
CqServerFactoryMBean.recycleServerHttpSessionLimit=500
CqServerFactoryMBean.recycleServerLifetimeLimit=14400
CqServerFactoryMBean.recycleServerOncrpcCallLimit=500000
CqServerFactoryMBean.recyclingPeriod=3600

Comentarios