Arquivos de Configuração do Agent Controller

A configuração do Agent Controller é especificada por dois conjuntos de arquivos de configuração. O primeiro conjunto é a configuração base que descreve as configurações padrão do mecanismo. O segundo conjunto é a configuração de plug-in que descreve as configurações especificadas pelo aplicativo do mecanismo. Este documento descreve os detalhes de cada configuração e como gravar extensões de configuração.

O diretório <diretório de instalação> referido neste documento corresponde ao caminho onde o Agent Controller é descompactado. Este diretório é chamado também de %RASERVER_HOME% nos arquivos de configuração.

Configuração Base

A configuração base consiste no arquivo <diretório de instalação>/config/serviceconfig.xml que é construído utilizando o esquema XML <diretório de instalação>/config/serviceconfig.xsd. Isto especifica as configurações padrão, tais como variáveis de ambiente do sistema, configurações do aplicativo e conectividade do Agent Controller. A configuração base estará disponível para todas as configurações e será carregada quando o serviço de mecanismo for iniciado. Os desenvolvedores de aplicativos não devem modificar este arquivo de configuração base, pois todas as alterações na configuração base serão globais. As configurações de plug-in (descritas abaixo) devem ser utilizadas para especificar as configurações específicas do aplicativo.

Configuração de Plug-in

Cada aplicativo definido pelo usuário deve ter seu arquivo de configuração e dependências colocados no diretório de plug-in <diretório de instalação>/plugin/<nome de plug-in> em que <nome de plug-in> é um nome exclusivo que identifica o aplicativo. O arquivo de configuração de plug-in pluginconfig.xml deve ser colocado no subdiretório config do diretório de plug-in. Normalmente, os arquivos JAR são colocados no subdiretório lib do diretório de plug-in. Os desenvolvedores podem utilizar o esquema XML <diretório de instalação>/config/pluginconfig.xsd para ajudar a construir o arquivo de configuração de plug-in.

Elementos e Atributos

Elemento: AgentControllerConfiguration
Este é o elemento raiz da configuração base. As configurações são utilizadas para iniciar o serviço de mecanismo.

Utilizado por: Configuração Base

Subelementos: AgentControllerEnvironment, Aplicativo, Hosts, Serviço, Agente, Opção, Plug-in

Atributos:
activeConfiguration
especificar a configuração que deverá ser carregada na inicialização do mecanismo
filePort
especificar a porta na qual o serviço de transferência de arquivos do Agent Controller é atendido. O valor padrão é 10005.
isDataMultiplexed
especificar se o traçado de perfil e os dados de log devem ser transmitidos pelo canal de controle do Agent Controller. Por padrão, o canal de dados utiliza uma porta arbitrária para transmissão de dados e pode ser bloqueada pela existência de um firewall. A transferência de dados pelo canal de controle permitirá que um conjunto de portas predefinidas seja aberto para pedidos de conexão de entrada por meio de um firewall. Essas portas incluem a porta padrão 10002, a porta segura 1003 e a porta do servidor de arquivos 10005. O valor padrão deste atributo é falso.
jvm
caminho completo da biblioteca de tempo de execução de Java Virtual Machine (jvm.dll ou libjvm.so)
loggingDetail
ativar o log do número de linha do mecanismo se HIGH estiver especificado
loggingDirectory
diretório em que o arquivo de log do mecanismo servicelog.log é criado
loggingLevel
filtro de severidade para mensagens de log
porta
porta do mecanismo para atendimento da conexão não segura do cliente de entrada
processPolling
especificar se a verificação ativa do status do processo está ou não ativada. Este atributo é utilizado principalmente em sistemas Windows para garantir que o Agent Controller seja notificado sempre que um processo for concluído. O valor padrão é verdadeiro.
securedPort
porta de mecanismo para atendimento de conexão segura do cliente de entrada
versão
versão do mecanismo

Elemento: PluginConfiguration
Este é o elemento raiz da configuração de plug-in. As configurações são carregadas depois que a configuração base for carregada.

Utilizado por: Configuração de Plug-in

Subelementos: AgentControllerEnvironment, Aplicativo, Serviço, Agente, Opção

Atributos:
requer
uma lista de nome(s) de plug-ins separados por vírgula da qual está configuração depende

Elemento: AgentControllerEnvironment
Este é um marcador da(s) variável(is) de ambiente global contribuídas por esta configuração. Elas são publicadas no sistema e estão disponíveis para todas as outras configurações, incluindo a configuração base.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Variável

Atributos:
configuração
nome da configuração em que as variáveis de ambiente devem ser incluídas

Elemento: Aplicativo
Este é um marcador do ambiente específico do aplicativo. As configurações internas são visíveis apenas neste aplicativo específico.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Variável, Parâmetro

Atributos:
configuração
nome da configuração em que o aplicativo deverá ser incluído
executável
nome do aplicativo, os clientes devem utilizar esse nome para identificar este aplicativo
caminho
o caminho completo, real do programa no qual este aplicativo deve ser executado
local
diretório de trabalho deste aplicativo
extensões
o nome da configuração na qual o mesmo aplicativo já está definido; isto incluirá as configurações atuais no início da página

Elemento: Hosts
Este é um marcador das informações do host. Isto é utilizado pelo mecanismo para permitir / não permitir que determinado(s) host(s) se conecte(m).

Utilizado por: AgentControllerConfiguration

Subelementos: Permitir, Negar

Atributos:
configuração
nome da configuração na qual essas informações de host são utilizadas

Elemento: Permitir
Isto especifica qual(is) host(s) têm permissão para conectar ao mecanismo.

Utilizado por: Hosts

Atributos:
host
nome ou endereço IP do host
rede
sub-rede
máscara
máscara de sub-rede
Elemento: Negar
Isto especifica qual(is) host(s) não têm permissão para conectar ao mecanismo.

Utilizado por: Hosts

Atributos:
host
nome ou endereço IP do host
rede
sub-rede
máscara
máscara de sub-rede

Elemento: Serviço
Isto especifica qual módulo definido pelo usuário deverá ser carregado na inicialização do mecanismo.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Opção

Atributos:
configuração
nome da configuração na qual este serviço deverá ser carregado
nome
nome do serviço
caminho
o caminho completo da biblioteca de carregamento dinâmico


Elemento: Agente
Isto especifica informações específicas do agente.

Utilizado por: AgentControllerConfiguration, PluginConfiguration

Subelementos: Opção

Atributos:
configuração
nome da configuração na qual esta configuração de agente é utilizada
nome
nome do agente
tipo
tipo do agente
dataChannelSize
quantidade de memória compartilhada a ser alocada para comunicação entre processos
logFile
caminho completo do arquivo de log que grava as mensagens enviadas pelo agente
cliente
especificar se este agente é dinâmico ou headless
Elemento: Opção
Isto é utilizado para armazenar um par nome-valor. Utilizado por: AgentControllerConfiguration, PluginConfiguration, Serviço, Agente Atributos:
nome
nome da opção (p. ex. espaço de nomes)
tipo
tipo da opção (p. ex. nome da opção)
valor
valor da opção


Elemento: Plug-in
Isto especifica o diretório a ser consultado para obter as configurações de plug-in

Utilizado por: AgentControllerConfiguration

Atributos:
caminho
diretório completo a ser consultado para obter as configurações de plug-in

Elemento: Variável
Variável do ambiente.

Utilizado por: Aplicativo, AgentControllerEnvironment

Atributos:
nome
nome da variável de ambiente (por ex. CLASSPATH)
valor
valor da variável de ambiente
posição
especificar se este valor deve ser anexado, incluído ou substituir o valor existente
Elemento: Parâmetro
Parâmetro do programa.

Utilizado por: Aplicativo

Atributos:
valor
valor do parâmetro do programa
posição
especificar se este parâmetro deve ser anexado, incluído ou substituir o parâmetro existente



(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.