Modificando Atributos MBean com a Ferramenta wsadmin

É possível customizar o servidor doRational ClearQuest Web ao configurar atributos MBean disponíveis com a interface de linha de comandos do WebSphere Application Server wsadmin.
Importante: Não modifique nenhum atributo MBean a menos que os atributos sejam documentados como modificáveis com a notação [W], que indica gravar ou o Suporte IBM® o instrua a fazê-lo. A modificação dos atributos MBean somente leitura [R] ou não documentados pode afetar o desempenho do sistema.

O servidor ClearQuest Web deve estar em execução ao usar a ferramenta wsadmin.

Os atributos MBean são categorizados pelo MBean no qual eles são armazenados. É possível recuperar todos os parâmetros que são denotados por [R] para leitura. Os parâmetros modificáveis são denotados por [W] para gravação. É possível acessar os atributos usando a ferramenta wsadmin do IBM WebSphere Application Server com comandos Jacl (Java Application Control Language). O arquivo teamAdminUtils.jacl fornece exemplos de comandos, sintaxe e funções Jacl. Também é possível modificar alguns dos atributos MBean do servidor ClearQuest Web usando a janela Configuração do Site.

É possível alterar os parâmetros MBean modificáveis apenas enquanto o servidor ClearQuest Web está em execução. As mudanças entram em vigor imediatamente sem a necessidade de reiniciar os processos do servidor. As alterações que são feitas nos atributos MBean que controlam o início dos processos do servidor Open Network Computing Remote Procedure Call (ONC RPC) de backend não afetam os processos ONC RPC de backend que estão em execução. Apenas novos processos de servidor ONC RPC de backend usam as novas configurações.

Dois MBeans são criados quando o ClearQuest Web inicia: TeamServerMBean, que contém atributos de configuração do servidor ClearQuest Web e CqServerFactoryMBean, que contém atributos connection factory gerenciados do ClearQuest.

O connection factory gerenciado do ClearQuest é o componente do servidor ClearQuest Web responsável por iniciar um ou mais processos do servidor de backend ONC RPC ClearQuest multiencadeados. Como cada processo RPC ClearQuest é multiencadeado, ele pode processar solicitações de muitas credenciais diferentes. O connection factory gerenciado do ClearQuest automaticamente executa gerenciamento de ciclo de vida em cada processo RPC ClearQuest.

MBeans e Atributos MBean

Os atributos MBeans do servidor ClearQuest Web, descritos a seguir, são organizados por MBean:
  • TeamServerMBean
    O TeamServerMBean contém atributos que são relevantes para o comportamento geral do servidor ClearQuest Web. Atributos que são específicos para controlar como o factory do servidor ClearQuest funciona são armazenados no factory do servidor CqServerFactoryMBean.
    Tabela 1. Atributos TeamServerMBean
    Atributo MBean Controle de acesso Descrição
    attachmentTempLocation [R,W] Especifica um diretório para armazenar anexos. Por padrão, os anexos são armazenados completamente na estrutura de diretório de perfil do WAS. No entanto, o Windows limita o comprimento dos nomes de caminho para aproximadamente 250 bytes. Se o nome do arquivo do anexo tiver mais do que aproximadamente 150 bytes, o ClearQuest poderá falhar ao armazenar o anexo porque o nome do caminho completo do anexo no local de armazenamento padrão terá mais de 250 bytes.
    cqFulltextSearchCacheSize [R,W] O número de ocorrências de registro que são salvas no ClearQuest principal para uma procura de texto completa única. O valor padrão é 0 (não configurado). Um valor positivo substitui a configuração para para o ClearQuest principal.
    cqFulltextSearchRecordHitLimit [R,W] O número máximo de ocorrências de registro que são retornados em uma chamada de serviço da web da procura de texto completa. O número também representa o número de ocorrências que podem ser armazenadas em cache no servidor de aplicativos. O valor padrão é 100.
    cqLoginSessionTimeout [R,W] A quantia de tempo, em segundos, que uma sessão de login do Rational ClearQuest persiste antes de atingir o tempo limite. O valor padrão é 1.800 segundos (30 minutos). Cada sessão do ClearQuest utiliza uma conexão com o banco de dados, portanto, configurar este valor muito alto pode consumir recursos por mais tempo do que o necessário. Não altere o valor padrão.
    cqLoginSessionWaitTimeout [R,W] A quantia de tempo, em segundos, que um encadeamento pode aguardar para adquirir a sessão de login do Rational ClearQuest. O valor padrão é de 300 segundos.
    cqServerFactory [R] O nome do objeto para o MBean do connection factory J2C do ClearQuest.
    cqUserDBListSecureAccess [R,W] Indica se os usuários podem ver a lista de bancos de dados quando eles tentam efetuar logon no ClearQuest Web com credenciais inválidas. O valor padrão é FALSE, indicando que os usuários poderão ver a lista de bancos de dados se tentarem efetuar logon com credenciais inválidas. Se o valor for configurado como TRUE, a autenticação do usuário está ativada, o que evita que usuários não autorizados vejam a lista de bancos de dados.
    ejbBufferLimit [R,W] O número máximo de objetos que são retornados por uma chamada EJB. O valor padrão é 100.
    keepAliveInterval [R,W] Se este valor for maior do que 0 segundos, o servidor ClearQuest Web emite uma mensagem keep-alive entre os componentes do cliente e servidor de backend no intervalo periódico especificado. Este atributo é projetado para assegurar que consultas do ClearQuest de longa execução possam ser concluídas sem remover os soquetes subjacentes. Este valor deve ser pelo menos 10 segundos menor do que os valores de tempo limite de soquete. O valor padrão é 300 segundos (5 minutos).
    largeReadSocketTimeoutMultiplier [R,W] O multiplicador a ser aplicado ao valor de tempo limite de leitura no soquete entre a camada intermediária e o componente de servidor de backend para operações de longa execução. O valor padrão 4 indica que o valor de tempo limite do soquete de leitura é quatro vezes o valor do tempo limite do soquete de leitura padrão do factory do servidor de backend. Este multiplicador é aplicado apenas a determinadas operações. Não altere este valor a menos que o Suporte IBM o instrua a fazê-lo.
    maxCqSessionsPerUser [R,W] O número máximo de sessões do ClearQuest que são criadas para cada usuário em uma única sessão. O valor padrão é 2; o valor mínimo é 1.
    maxProcureServerAttempts [R,W] O número máximo de tentativa a permitir que um servidor ONC RPC de backend seja obtido antes dele retornar uma exceção para o conjunto de conexões gerenciadas. O valor padrão é 6; este valor deve ser maior ou igual a 2.
    mediumReadSocketTimeoutMultiplier [R,W] O multiplicador a ser aplicado ao valor de tempo limite de leitura no soquete entre a camada intermediária e o componente de servidor de backend para determinadas operações de longa execução. O valor padrão 2 indica que o valor de tempo limite do soquete de leitura é duas vezes o valor do tempo limite do soquete de leitura padrão do factory do servidor de backend. Este multiplicador é aplicado apenas a determinadas operações. Não altere o valor a menos que o Suporte IBM o instrua a fazê-lo.
    numberOfActiveSessions [R] O número de sessões ativas que o servidor está manipulando.
    numberOfHttpSessionsCreated [R] O número de sessões que são manipuladas por este servidor.
    oncrpcBufferLimit [R,W] O número máximo de objetos que são retornados em uma única chamada do ONC RPC. O valor padrão é 100.
    oncrpcInterruptLimit [R,W] O número máximo de objetos que são retornados para uma solicitação de usuário. O valor-padrão é 1000.
    oncrpcServers [R] Os nomes de objetos para os MBeans do servidor ONC RPC em execução.
    procureServerInterval [R,W] A quantia de tempo (em segundos) que um encadeamento de solicitação pode esperar para obter um servidor antes que un encadeamento de solicitação retorne uma exceção para o conjunto de conexões gerenciadas. O valor padrão é 60 segundos.
    sessionObjectDefaultTimeout [R,W] A duração de tempo padrão, em segundos, que um objeto permanece em uma sessão. O valor padrão é 1.800 segundos (30 minutos). Este valor deve ser maior ou igual a 0.
    sessionQueryObjectTimeout [R,W] A duração de tempo que uma sessão de login do ClearQuest persiste antes de atingir seu tempo limite se uma consulta nova ou modificada não for entregue. Este valor não pode ser menor do que o valor cqLoginSessionTimeout. O valor padrão é 1.800 segundos (30 minutos). Este valor substitui o valor que é definido por sessionObjectDefaultTimeout.
    sessionRecordObjectTimeout [R,W] A duração de tempo que uma sessão de login doClearQuest persiste antes de atingir seu tempo limite se um registro novo ou modificado não for entregue. Este valor não pode ser menor do que o valor cqLoginSessionTimeout. O valor padrão é 10.800 segundos (3 horas). Este valor substitui o valor que é definido por sessionObjectDefaultTimeout.
    sessionReaperThreadDelay [R,W] Intervalo de tempo em segundos para o encadeamento removedor de sessão. O valor padrão é 900 segundos (15 minutos). O intervalo de valores é de 300 até 1800 segundos. Você pode querer diminuir este valor se a memória virtual estiver em alta demanda. Você pode querer aumentar este valor se muita CPU está sendo usada.
    totalNumberOfOncrpcServers [R] O número de servidores RPC de backend que estão em execução em todas as instâncias do connection factory do Rational ClearQuest.
    totalOncrpcCallCount [R] O número chamadas ONC RPC feitas desde que o servidor foi iniciado.
    totalWebServiceCallCount [R] O número de chamadas de serviço da web feitas desde que o servidor foi iniciado.
    versionNumber [R] O número da versão do produto do servidor ClearQuest Web, expresso como um valor da sequência de caracteres com separadores de ponto integrados. Por exemplo, 7.1.2.1.
  • CqServerFactoryMBean
    Este atributo contém valores de configuração relevantes para o connection factory gerenciado do ClearQuest. O connection factory gerenciador do ClearQuest inicia e gerencia os processos de backend ONC RPC ClearQuest que se comunicam com o ClearQuest principal. Os atributos neste MBean não afetam o comportamento geral do ClearQuest como fazem alguns dos atributos ClearQuest no MBean TeamServerMBean. Ao invés disso, os atributos neste MBean controlam o comportamento do factory e gerenciam os processos de backend ONC RPC ClearQuest que ele inicia. Mudanças que são feitas neste MBean entram em vigor imediatamente para processos de backend recentemente iniciados; não é necessário reiniciar os processos do servidor. Os processos de backend existentes não são afetados.
    Tabela 2. Atributos CqServerFactoryMBean
    Atributo MBean Controle de acesso Descrição
    activeHttpSessionThreshold [R,W] O número de sessões HTTP ativas em um servidor ONC RPC ClearQuest de backend ativo. Se este número for excedido, ele pode fazer com que este connection factory gerenciado inicie outro servidor ONC RPC ClearQuest de backend. O padrão é 30.
    cqrpcAbandonedProcessCleanupEnabled [R,W] Indica se o servidor ClearQuest Web inicia o procedimento de limpeza que termina quaisquer processos RPC ClearQuest abandonados. O padrão é TRUE.
    cqrpcAbandonedProcessCleanupInterval [R,W] O intervalo período, em minutos, que o servidor ClearQuest Web usa para iniciar o procedimento de limpeza para finalizar processos RPC ClearQuest abandonados. O padrão é 30 minutos. Este valor deve ser maior que ou igual a 0. O intervalo funciona na potência mais próxima de 2. Um valor de 0 indica que o intervalo é configurado como 2.
    maximumActiveServers [R,W] O número máximo de servidores ONC RPC do ClearQuest de backend ativos que são permitidos por este connection factory gerenciado. O padrão é 10.
    recycleServerHttpSessionLimi [R,W] O número de sessões HTTP que um servidor ONC RPC ClearQuest de backend processa antes do servidor ser reciclado pelo connection factory gerenciado. O padrão é 200. Um valor de zero indica que este limite não é verificado.
    recycleServerLifetimeLimit [R,W] O tempo de vida máximo, em segundos, que um servidor ONC RPC ClearQuest de backend pode ser executado antes do servidor ser reciclado pelo connection factory gerenciado. O padrão é 86.400 segundos (24 horas). Um valor de zero indica que este limite não é verificado.
    recycleServerOncrpcCallLimit [R,W] O número máximo de solicitações ONC RPC que um servidor ONC RPC ClearQuest de backend processa antes do servidor ser reciclado pelo connection factory gerenciado. O padrão é 100.000. Um valor de zero indica que este limite não é verificado.
    recyclingPeriod [R,W] A duração de tempo, em segundos, que um servidor ONC RPC ClearQuest de backend em reciclagem recebe como concessão para concluir o trabalho antes que ele seja finalizado pelo connection factory gerenciado. O estado de um servidor de backend ONC RPC ClearQuest é 2 (STOPPING). O padrão é 1800 segundos (30 minutos). Este valor deve ser maior que 0.
    remoteChartReportServerHostName [R,W] UNIX Linux O nome do host de um servidor da web Windows ClearQuest designado para processar solicitações de gráfico. O valor padrão é "" (sequência vazia/não configurado).
    remoteChartReportServerPort [R,W] UNIX Linux O número da porta de um servidor da web Windows ClearQuest designado para processar pedidos de gráfico. O valor padrão é 0.
    serverWorkerThreadCount [R,W] O número de encadeamentos que um servidor ONC RPC ClearQuest de backend usa para manipular solicitações recebidas. O padrão é 30.
  • OncrpcServerMBean
    Para cada processo de backend ONC RPC que é iniciado pelo connection factory gerenciado do ClearQuest, uma instância do processo CqOncrpcServerMBean é criada. Cada MBean contém os valores que são definidos no processo OncrpcServerMBean de base. (O OncrpcServerMBean de base nunca é instanciado). Cada processo do servidor MBean é executado apenas enquanto o processo que ele representa está em execução no servidor ClearQuest Web. Quando o processo finaliza, os processos MBean associados também finalizam. A Tabela 3 descreve os atributos de base que estão em todos os processos do servidor MBean.
    Tabela 3. Atributos OncrpcServerMBean
    Atributo MBean Controle de acesso Descrição
    hostname [R] O nome do host no qual o servidor ONC RPC de backend está em execução.
    oncrpcCalls [R] O número total de chamadas ONC RPC que o servidor ONC RPC de backend manipula.
    port [R] O número inteiro da porta na qual o servidor ONC RPC de backend está recebendo.
    serverId [R] O ID exclusivo para o servidor ONC RPC de backend.
    serverStartTime [R] O registro de data e hora que indica quando o servidor ONC RPC de backend foi iniciado. Este valor é o número de milissegundos desde 1 de janeiro de 1970, 00:00:00 Hora de Greenwich (GMT).
    serverState [R] O estado atual do servidor ONC RPC de backend, representado com um número inteiro (0=STOPPED, 1=RUNNING, 2=STOPPING, 3=DEAD).
    serverStoppingTime [R] O registro de data e hora que indica quando o servidor ONC RPC de backend entrou no estado STOPPING (2). O valor é o número de milissegundos desde 1 de janeiro de 1970, 00:00:00 Hora de Greenwich (GMT).
    serverStopTime [R] O registro de data e hora que indica quando o servidor ONC RPC de backend entrou no estado STOPPED (0) ou DEAD (3). O valor é o número de milissegundos desde 1 de janeiro de 1970, 00:00:00 Hora de Greenwich (GMT).
    serverType [R] O tipo de servidor ONC RPC de backend: Rational ClearQuest.
  • CqOncrpcServerMBean
    Para cada processo de backend ONC RPC ClearQuest que é iniciado pelo connection factory gerenciado do ClearQuest, uma instância do MBean CqOncrpcServerMBean é criada. Esta instância perdura apenas enquanto o processo de backend ONC RPC ClearQuest que ela representa está em execução no servidor ClearQuest Web. Assim que o processo finaliza, o MBean que representa o processo também é finalizado.

    O processo CqOncrpcServerMBean é uma extensão para o processo OncrpcServerMBean.Cada processo CqOncrpcServerMBean contém todos os valores que são definidos pelo processo OncrpcServerMBean mais os atributos que são descritos na Tabela 4.

    Tabela 4. Atributos CqOncrpcServerMBean
    Atributo MBean Controle de acesso Descrição
    activeHttpSessions [R] O número de sessões HTTP ativas que o servidor ONC RPC ClearQuest de backend está manipulando.
    activeStatefulHttpSessions [R] O número de sessões HTTP stateful que o servidor ONC RPC ClearQuest de backend está manipulando.
    recycleReasonCode [R] O código de razão que indica o motivo pelo qual o servidor ONC RPC ClearQuest de backend está sendo reciclado. Este atributo é um valor de número inteiro.
    1
    RECYCLE_TIME_LIMIT_EXCEEDED
    2
    ONCRPC_CALL_LIMIT_EXCEEDED
    3
    SESSION_LIMIT_EXCEEDED
    recycleServerHttpSessionLimit [R,W] O número máximo de sessões que o servidor ONC RPC ClearQuest de backend pode manipular antes dele ser reciclado. O valor padrão é configurado ao usar o valor do atributo recycleServerHttpSessionLimit no CqServerFactoryMBean. O valor pode ser configurado apenas em um servidor de backend ONC RPC ClearQuest. Todos os processos do servidor de backend ONC RPC são voláteis. Configurar este valor em um servidor ONC RPC ClearQuest pode falhar se o servidor é finalizado pelo connection factory gerenciado do ClearQuest.
    totalHttpSessions [R] O número de sessões HTTP que o servidor ONC RPC ClearQuest de backend suportas.
    workerThreadCount [R] O número de encadeamentos que o servidor ONC RPC ClearQuest de backend usa para processar solicitações.

Exemplos:

Usando a ferramenta wsadmin para recuperar e configurar atributos MBean

Este exemplo ilustra comandos baseados em Jacl para iniciar e usar a ferramenta wsadmin.

// This section provides sample commands to start and use the wsadmin tool.
// For illustrative purposes, an operating system command prompt is denoted by the
// hash character, "#", and the wsadmin command prompt is denoted by "wsadmin>". 
//
// There are ClearQuest Web server wsadmin tool scripts that provide several convenience 
// methods and functions.  By default, these scripts are located in the following
// directory:  
// On Windows:  
//      "C:\Program Files\IBM\RationalSDLC\common\CM\scripts" 
// On the UNIX system and Linux:  
//      "/opt/rational/common/CM/scripts" no sistema UNIX e Linux.
//
// Open a command prompt and set your default directory to the location of
// the ClearQuest Web server wsadmin tool scripts.  Por Exemplo: 
//
// On Windows:
# cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
//
// On the UNIX system and Linux:
# cd /opt/rational/common/CM/scripts
//
// Set the WAS_BIN environment variable to the location of the wsadmin tool 
// by using the syntax appropriate for your preferred shell.  Por Exemplo:
//
// On Windows:
# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin" 

// On the UNIX system and Linux:
# WAS_BIN=/opt/rational/common/eWAS/bin

// Start the wsadmin tool by specifying the ClearQuest Web server profile name.  
// The default ClearQuest Web server profile name is 'cmprofile'.  Por Exemplo:
//
// On Windows:
# %WAS_BIN%\wsadmin -profileName cmprofile

// On the UNIX system and Linux:
# $WAS_BIN/wsadmin.sh -profileName cmprofile

// The following wsadmin command loads the ClearQuest Web server wsadmin convenience functions:
wsadmin> source teamAdminUtils.jacl

// The next command is an example of how to display some useful ClearQuest Web server commands. 
// The getTeamServer function is useful for establishing a pointer to the top level 
// TeamServerMBean, and will help get and set individual TeamServerMBean attributes.
//
wsadmin> info proc *Team*
    startTeamEAR stopTeamEAR getTeamServer

// The following command displays the available 'dump' commands for quick and 
// easy viewing of the MBean values:
wsadmin> info proc dump*

   dumpAllServers dumpAll dumpTeamServer dumpCcServers dumpCqServerFactory 
   dumpCcServerFactory dumpCqServers


// The next command uses the convenience command 'getTeamServer' to set up the 
// variable 't', which can then be used to access TeamServerMBean attributes:
wsadmin> set t [getTeamServer]

// Retrieve the TeamServerMBean attribute values using the 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}



// Following is a more convenient way to retrieve all of the TeamServerMBean attributes:
wsadmin> dumpTeamServer

TeamServerMBean Attributes:
====================

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


// Other 'get' convenience commands include: getCqServerFactory, getTeamServer 
// and getOncrpcServers.


// The next command sets up the variable 'cq' for accessing the CqServerFactoryMBean
// attributes. Note that the variable 't' defined in a previous command is used to 
// obtain a pointer to the TeamServerMBean's cqServerFactory attribute value; the 
// variable 'cq' can then be used to access the attributes in the CqServerFactoryMBean:
wsadmin> set cq [$AdminControl getAttribute $t cqServerFactory]

// Following is a more convenient way to set up the variable 'cq':
wsadmin>set cq [getCqServerFactory]

// The next command retrieves the CqServerFactoryMBean attribute values using the
// 'cq' variable defined previously:
wsadmin> $AdminControl getAttributes $cq
. . . 

// The following command sets up the variable 'os' to use for accessing the list of 
// ONCRPC server MBeans, each of which represents a specific ONCRPC backend server.  
// The command uses one of the convenience methods defined in the teamAdminUtils.jacl 
// script that was 'sourced' at the beginning of this session:
wsadmin> set os [$AdminControl invoke $t getOncrpcServers]
        .   .   .   

        // A list of the running oncrpc backend servers is displayed. Os primeiros 
        // oncrpc server is at index 0 (zero), the second is at index 1, and so on...


// The next command sets up the variable 'o' for accessing the first oncrpc server MBean 
// displayed in the output from the previous command.  This level of MBean attribute 
// access (that is, specific oncrpc server MBeans) is tricky because the backend oncrpc
// server processes are transient and might be dismissed before you can access them.
wsadmin> set o [getOnc 0]      // '0' is the index number of the first backend server
                               //  listed in the output of the previous command. 

// The following command retrieves the MBean attribute values for the CQ oncrpc server 
// defined by the 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}


// The next commands set and then get the recycleServerHttpSessionLimit attribute 
// in the CQ oncrpc server defined previously by the variable 'o':
wsadmin> $AdminControl setAttribute $o recycleServerHttpSessionLimit 501

wsadmin> $AdminControl getAttribute $o recycleServerHttpSessionLimit
     501


// The remaining commands show a few more oncrpc server MBean accesses and their output.
// Remember that the list of ONCRPC servers is transient; using the dump commands such
// as dumpCqServers or dumpAllServers is much more convenient:

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"
       

// Here are examples of what you see when using the convenience dump commands:
wsadmin> dumpAllServers

ONCRPC Server: 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
CQRPC Server: 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
CqServerFactoryMBean Attributes:
==========================
{serverWorkerThreadCount 10}
{recycleServerLifetimeLimit 14400}
{recyclingPeriod 3600}
{recycleServerOncrpcCallLimit 500000}
{recycleServerHttpSessionLimit 500}
{maximumActiveServers 4}
{activeHttpSessionThreshold 40}


wsadmin> dumpAll
     // The output of this command is a dump of all of the MBean attribute values, including
     // all of the currently running backend ONCRPC server processes.

Usando a ferramenta wsadmin para importar e exportar atributos MBean

Use a ferramenta wsadmin com os comandos de conveniência import e export do servidor ClearQuest Web para importar e exportar, respectivamente, os atributos MBean. Estes comandos permitem recuperar e atualizar valores de atributos MBean e fornecer uma maneira simples de capturar configurações específicas. Se o servidor ClearQuest Web não está funcionando corretamente, é possível importar uma configuração conhecida por funcionar capturada anteriormente em tempo real.

É possível editar os arquivos de propriedades usando um editor de texto e, em seguida, importar e exportar esses arquivos em tempo real. É possível comentar quaisquer entradas nos arquivos de propriedades que não precisam ser importados. Certifique-se de seguir as convenções de nomenclatura para os nomes de MBean e de atributos. Para limpar um valor de sequência ao usar o comando importFile, especifique "" ou deixe o valor em branco no arquivo de propriedades que você importar. Não deixe valores numéricos em branco.

// This wsadmin command loads all of the convenience commands and methods,
// including the importFile and exportToFile commands.  These commands 
// enable retrieving and updating MBean attribute values, and a simple 
// way to capture specific configurations.  If the ClearQuest Web server
// (referred to in previous releases as CM Server) is not functioning
// properly, then you can import a previously captured configuration in
// real time. 
wsadmin> source teamAdminUtils.jacl

// Use the exportToFile command if you want to capture a snapshot of 
// the TeamServerMBean and CqServerFactoryMBean MBeans.  Especifique 
// full path name in which to store the file.  You can edit the resulting
// properties file by using a text editor, and import the file by using
// the importFile command.
// Important: You must use forward slashes in the path name for these commands.
wsadmin> exportToFile C:/temp/CmServer.properties

File "C:/temp/CmServer.properties" does not exist, proceeding with export...
Retrieving MBeans...
Exporting TeamServerMBean.sessionReaperThreadDelay...
Exporting TeamServerMBean.cqLoginSessionTimeout...
Exporting TeamServerMBean.cqLoginSessionWaitTimeout...
Exporting TeamServerMBean.sessionObjectDefaultTimeout...
Exporting TeamServerMBean.sessionQueryObjectTimeout...
Exporting TeamServerMBean.sessionRecordObjectTimeout...
Exporting TeamServerMBean.oncrpcBufferLimit...
Exporting TeamServerMBean.oncrpcInterruptLimit...
Exporting TeamServerMBean.ejbBufferLimit...
Exporting TeamServerMBean.cqFulltextSearchPageSize...
Exporting TeamServerMBean.cqFulltextSearchCacheSize...
Exporting TeamServerMBean.cqFulltextSearchRecordHitLimit...
Exporting TeamServerMBean.procureServerInterval...
Exporting TeamServerMBean.maxProcureServerAttempts...
Exporting TeamServerMBean.maxCqSessionsPerUser...
Exporting CqServerFactoryMBean.serverWorkerThreadCount...
Exporting CqServerFactoryMBean.activeHttpSessionThreshold...
Exporting CqServerFactoryMBean.maximumActiveServers...
Exporting CqServerFactoryMBean.recycleServerHttpSessionLimit...
Exporting CqServerFactoryMBean.recycleServerLifetimeLimit...
Exporting CqServerFactoryMBean.recycleServerOncrpcCallLimit...
Exporting CqServerFactoryMBean.recyclingPeriod...

wsadmin> importFile C:/temp/CmServer.properties

File "C:/temp/CmServer.properties" found, proceeding with import...
Importing value '900' into property sessionReaperThreadDelay in MBean TeamServerMBean
    Old value=900
    New value=900
Importing value '1803' into property cqLoginSessionTimeout in MBean TeamServerMBean
    Old value=1803
    New value=1803
Importing value '300' into property cqLoginSessionWaitTimeout in MBean TeamServerMBean
    Old value=300
    New value=300
Importing value '1800' into property sessionObjectDefaultTimeout in MBean TeamServerMBean
    Old value=1800
    New value=1800
   . . .

// If you try to export to a file that already exists, a time stamp is appended to the
// file name that you specify in the command:
wsadmin> exportToFile C:/temp/CmServer.properties

File "C:/temp/CmServer.properties" already exists; appending date to file name.
exportFilePath is now: C:/temp/CmServer.properties_2008-07-09_16-27-11
Retrieving MBeans...
Exporting TeamServerMBean.sessionReaperThreadDelay...

// Here is what a typical exported file looks like:
C:\> type c:\temp\CmServer.properties
# Export of ClearQuest Web server MBean attributes, created: 2008-07-09_16-22-29
#
#
# TeamServerMBean writable attributes
#
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
#
# CqServerFactoryMBean writable attributes
#
CqServerFactoryMBean.serverWorkerThreadCount=10
CqServerFactoryMBean.activeHttpSessionThreshold=40
CqServerFactoryMBean.maximumActiveServers=4
CqServerFactoryMBean.recycleServerHttpSessionLimit=500
CqServerFactoryMBean.recycleServerLifetimeLimit=14400
CqServerFactoryMBean.recycleServerOncrpcCallLimit=500000
CqServerFactoryMBean.recyclingPeriod=3600

Feedback