Configurando o Canal de Dados do Agente

Em alguns cenários, pode ser necessário fornecer armazenamento em buffer entre o agente e o Agent Controller. O armazenamento em buffer é feito utilizando-se um canal de dados entre o agente e o Agent Controller. Os canais de dados são desejáveis em situações em que o desempenho do agente é muito importante. Sem um buffer, é possível que o agente possa ficar bloqueado ao executar saída, pois o cliente de teste pode não conseguir processar a saída tão rapidamente quanto o necessário.

O canal de dados é configurado com o elemento <Agente> no arquivo de configuração do plug-in que contém o agente. Por exemplo, o canal de dados do Java Profiling Agent é configurado alterando seu elemento <Agent> em plugins/org.eclipse.tptp.platform.collection.framework_<version>/config/pluginconfig.xml.

Para modificar o elemento <Agent> no arquivo de configuração:

  1. Localize o arquivo de configuração que contém o elemento a ser modificado. O arquivo será o serviceconfig.xml ou o pluginconfig.xml do plug-in que contém o agente. Consulte a tarefa relacionada.
  2. Abra-o em um editor e procure o elemento <Agente>.
  3. Modifique o valor do atributo dataChannelSize.
    Exemplo:
    As Informações a Seguir Aplicam-se ao Windows. Para especificar que um canal de dados de 64 megabytes deve ser utilizado quando o Profiling Agent Java estiver traçando perfis ativamente, altere o valor do atributo dataChannelSize para 64 MB.
    <Agent name="Java Profiling Agent" type="Profiler" 
    dataChannelSize="64MB">
    </Agent>

    As informações a seguir aplicam-se ao Linux. No Linux, o tamanho máximo do canal de dados é limitado pelo tamanho máximo da memória compartilhada do sistema. Essa definição de configuração está localizada em /proc/sys/kernel/shmmax. O canal de dados não poderá ser criado se o valor do atributo dataChannelSize for maior que o especificado em /proc/sys/kernel/shmmax.

    As informações a seguir aplicam-se ao Solaris. No Solaris, o tamanho máximo do canal de dados é limitado pelo tamanho da memória compartilhada do sistema. A definição de configuração está localizada em /etc/system no atributo shmmax. O canal de dados não será criado se o valor do atributo dataChannelSize for maior que o atributo shmmax especificado em /etc/system. Se esse atributo não existir, seu valor será assumido como 1 MB, por padrão.

    As informações a seguir aplicam-se ao HP-UX. No HP-UX, o tamanho máximo do canal de dados é limitado pelo tamanho da memória compartilhada do sistema. A definição de configuração está localizada em /etc/conf/master.d/core-hpux no atributo shmmax. O canal de dados não será criado se o valor do atributo dataChannelSize for maior que o atributo shmmax especificado em /etc/conf/master.d/core-hpux. Se esse arquivo ou atributo não existir, seu valor será assumido como 64 MB, por padrão.

    As informações a seguir aplicam-se ao AIX. No AIX, o tamanho máximo do canal de dados é limitado pelo tamanho máximo da memória compartilhada do sistema, fixado em 256 MB. O canal de dados não será criado se o valor do atributo dataChannelSize for maior que 256 MB.

    As informações a seguir aplicam-se ao z/OS. No z/OS, o tamanho máximo do canal de dados é limitado pelo tamanho máximo do segmento de memória compartilhada do sistema. Essa definição de configuração está localizada no parâmetro IPCSHMMPAGES no membro MVS BPXPRMxx parmlib. O valor de IPCSHMMPAGES deve ser definido para o número máximo de páginas de 4 K que o canal de dados pode ter. Por exemplo, se dataChannelSize for definido para 32 M no serviceconfig.xml, então, IPCSHMMPAGES deverá ser definido para um valor maior que 8192. O canal de dados não poderá ser criado se o valor do atributo dataChannelSize for maior que 4 K vezes o valor de IPCSHMMPAGES.

    Para que o Agent Controller se comunique com vários agentes simultaneamente, o parâmetro IPCSHMNSEGS no membro parmlib MVS BPXPRMxx deve ser definido com um valor apropriado. O parâmetro IPCSHMNSEGS especifica o número máximo de segmentos de memória compartilhada ou de canais de dados conectados para cada espaço de endereço. O valor padrão é 10. Um valor de 50 permitirá que 50 agentes comuniquem-se com o Agent Controller simultaneamente.

Tarefas Relacionadas
Localizando os Arquivos de Configuração
Administrando o Agent Controller
 


(C) Direitos Autorais IBM Corporation 2000, 2006. Todos os direitos reservados.