O CFMX for J2EE e seus arquivos XML
Para você que instalou a versão J2EE do ColdFusion MX (6,6.1) (do zero, sem upgrade do serial number, a partir da versão Standard), é bem provável que tenha notado a presença (e porque não dizer também, a ausência) de algumas opções, no CFAdministrator. A chamada “Server configuration”, habilita algumas opções que não estão disponíveis na versão “J2EE Configuration”, também conhecida como “Multiserver Configuration**”, e caso você tenha escolhido este tipo de instalação, opções como CFSTAT, Maximum Number of Simultaneous Requests, Enable Whitespace Management, provavelmente não aparecerão no administrador do CF; anyway, antes que o seu cabelo fique em pé de preocupação por pensar em ter feito alguma coisa errada durante a instalação, aqui vai a dica: não se desespere!
Bom, só para relembrar, o ColdFusion MX, nada mais é, do que uma aplicação java (servlet), capaz de ser executado em servidores J2EE; como é de conhecimento de todos, servidores e aplicações que seguem esse padrão, possuem opções que geralmente são configuradas via arquivos XML; e isso também acontece com a versão J2EE do ColdFusion MX. Em outras palavras, essas opções não sumiram, apenas mudaram de lugar… ;o)
Tendo conhecimento disso e antes de continuar a leitura deste artigo, tenha em mente uma coisa: antes de fazer qualquer tipo de alteração nesses arquivos, faça backup dos mesmos, a não ser que definitivamente você queira se ver com os cabelos em pé, de desespero!Com relação às opções, vamos à cada uma delas:
1. CFSTAT- O CFSTAT é uma espécie de monitorador do servidor ColdFusion, capaz de fornecer informações de como está a performance do mesmo, exibindo as mais variadas estatísticas, estas que são importantes, inclusive na hora de efetuar ajustes finos de performance e tunning no application server. Para poder utiliza-lo, é preciso antes de mais nada, habilitá-lo no CFAdministrator na opção Debugging Settings, quando feita a instalação “Server configuration”.
O CFSTAT não está disponível na “J2EE Configuration”; em seu lugar é possível usar uma ferramenta do próprio JRun que possui a mesma finalidade, com alguns opcionais que o CFSTAT não possui: com o JRun Metrics*, é possível ter em um arquivo de log, todas as estatísticas do servidor CFMX, incluindo informações sobre a utilização de memória, e de quebra, ainda é possível customizar o formato dessas informações. (Referência 1)Para habilitar esta opção, é necesário alterar o arquivo jrun.xml que está em {root Jrun}\servers\{InstanciaCF}\SERVER-INF: Dentro da tag <service class=”jrunx.logger.LoggerService” name=”LoggerService”>Modifique as seguintes entradas:
<attribute name=”metricsEnabled”>true</attribute>
<attribute name=”metricsLogFrequency”>10</attribute>
2. Maximum Number of Simultaneous Requests - Esta opção determina ao ColdFusion, atender de forma simultânea, um certo número de threads (requisições). Este item que se encontra no menu Settings na opção “Server configuration”, em nosso caso, está disponível para ser modificada também no arquivo jrun.xml que está em {root Jrun}\servers\{InstanciaCF}\SERVER-INF: O atributo que nos interessa é exatamente esse:
<attribute name=”activeHandlerThreads”>20</attribute>
Simplesmente altere-o para o número que melhor atende a demanda do seu servidor (Referência 2).3. Enable Whitespace Management - Configurado também a partir do CFAdministrator, esta opção agora está acessível no arquivo neo-runtime.xml que fica em {root Jrun}\servers\{InstanciaCF}\cfusion-ear\cfusion-war\WEB-INF\cfusion\libPara habilitá-lo, apenas altere o primeiro atributo “boolean” que aparece, para true como está no exemplo abaixo:
<wddxPacket version=’1.0′>
<header/>
<data>
<array length=’11′>
<boolean value=’true’/>
(Referência 3)
E para finalizar, gostaria de recomendar a leitura de um TechNote muito interessante, que descreve em detalhes, mais arquivos que são específicos na configuração do ColdFusion MX, para ambientes em que ele foi instalado, usando a opção “J2EE Configuration”: Purpose and location of XML configuration files used in ColdFusion MX.
NOTAS
* Está opção, também está disponível em servidores que optaram pela instalação do tipo “Server configuration”.** Apesar de ser uma variante da “J2EE configuration”, a versão 7 do CFMX, passou a habilitar alguns itens como Maximum Number of Simultaneous Requests e Enable Whitespace Management, que em versões anteriores do MX não estão disponíveis. O CFSTAT não se encontra disponível para este tipo de instalação.
REFERÊNCIAS
1. http://www.macromedia.com…
2. http://cfguru.daemon.com.au…
3. http://www.macromedia.com…