Servidor Tomcat no Windows Server 2000 ou posterior

Instruções detalhadas para a instalação e configuração do Sensor para o Apache Jakarta Tomcat 4.1 ou posterior em execução no Windows Server 2000 ou posterior.

Os arquivos de programa do Sensor são empacotados em um arquivo de instalação que você obtém do site de download da Adobe. Se você ainda não tiver o arquivo de instalação do Sensor para seu servidor Web específico, baixe-o (ou obtenha-o do seu representante da Adobe) antes de começar os procedimentos a seguir.

As implementações J2EE suportadas incluem:

  • JBoss Server 4.0.5 ou posterior em execução no Microsoft Windows Server 2000 ou posterior.

Para instalar e configurar o Sensor, execute as seguintes etapas:

Instale os arquivos de programa

Procedimento para extrair e instalar os arquivos de programa do Sensor.

  1. No servidor Tomcat, crie um diretório no qual os arquivos de programa Sensor serão instalados. Lembre-se de que sua fila de discos está nesse diretório, portanto, verifique se o dispositivo escolhido tem espaço suficiente para manter uma fila do tamanho necessário.

    C:\VisualSensor
    
  2. Extraia o conteúdo do arquivo de instalação para o diretório que você acabou de criar. Durante esta etapa, o Sensor instala os seguintes arquivos:

Arquivo Descrição Diretório de destino
visual_sciences.dll O módulo de carregamento do coletor. Em qualquer diretório.
J2EECollector.jar As bibliotecas do módulo de carregamento do coletor WEB-INF/lib

txlogd.exe

O programa do transmissor. Em qualquer diretório
txlogd.conf O arquivo de configuração do sensor. Em qualquer diretório
trust_ca_cert.pem O certificado usado para validar o certificado digital que o Insight Server apresenta durante o processo de conexão Em qualquer diretório
Observação

O pacote de instalação contém um arquivo de planilha chamado TestExperiment.xls. Esta planilha é uma ferramenta que os arquitetos usam para configurar um experimento controlado. O próprio sensor não usa esse arquivo, portanto, não é necessário instalar o arquivo na máquina em que o Sensor está sendo executado (embora você possa optar por fazê-lo). Em vez disso, copie o arquivo para um local onde seus arquitetos possam acessá-lo ou simplesmente extraia o arquivo do pacote de instalação, conforme necessário. Para obter mais informações sobre a experimentação controlada, consulte o Guia de Experimentos Controlados Insight.

Edite o arquivo de configuração do sensor

O txlogd.conf arquivo contém os parâmetros de configuração do Sensor.

É necessário editar esse arquivo para especificar, entre outras coisas, o tamanho e o local do arquivo de fila de disco, o endereço do Insight Server e a ID que será anexada aos dados de evento produzidos por esse sensor.

O arquivo de configuração contém parâmetros obrigatórios e opcionais.

  • Parâmetros obrigatórios são configurações que você deve especificar ao instalar o Sensor. Sem essas configurações, o sensor não é executado com êxito.
  • Parâmetros opcionais são configurações padrão para valores predefinidos (que podem ser modificados) ou habilitam recursos opcionais.

Para editar o arquivo de configuração do sensor

  • Abra o /etc/txlogd.conf arquivo em um editor de texto e defina os parâmetros necessários, bem como quaisquer parâmetros opcionais desejados.
  • Salve e feche o arquivo.

Para editar o arquivo de configuração do sensor

  1. Abra o /etc/txlogd.conf arquivo em um editor de texto e defina os parâmetros necessários, bem como quaisquer parâmetros opcionais desejados.
  2. Salve e feche o arquivo.

Inicie o transmissor e crie a fila de discos

Depois de configurar o arquivo txlogd.conf, você pode iniciar o programa transmissor, registrá-lo como um serviço do Windows e criar a fila de discos.

  1. No menu Iniciar do Windows, selecione Acessórios > Prompt de comando.

  2. Na janela da tela de comandos, navegue até o diretório no qual você instalou o Sensor e execute o seguinte comando:

    txlog /regserver
    

    Esse comando inicia o transmissor, cria a fila de discos e registra o Sensor como um serviço do Windows.

  3. Para confirmar se o transmissor está sendo executado corretamente, clique em Iniciar > Painel de controle > Ferramentas administrativas > Serviços.

    Observação

    Essa sequência de comando pode variar dependendo da versão do Windows que você está usando.

    1. Na lista de serviços, localize a entrada Sensor e confirme se seu status é Iniciado e seu tipo de inicialização é Automático.
    2. Feche o painel de controle Serviços.
  4. Para verificar se o transmissor apresentou erros durante a inicialização, clique em Iniciar > Painel de controle > Ferramentas administrativas > Visualizador de eventos para abrir o Visualizador de eventos.

    1. No painel esquerdo da janela Visualizador de eventos, selecione o registro Aplicativos.
    2. No painel direito, procure eventos com "Adobe" na coluna Origem.
    3. Se encontrar um erro em "Adobe", clique duas vezes no erro para exibir a janela Propriedades do evento. Esta janela fornece informações detalhadas sobre o erro.
  5. Quando terminar de examinar o log de Aplicativos, feche o Visualizador de Eventos.

  6. Verifique se o transmissor criou a fila de discos (Diskq2000.log) no diretório onde você instalou os arquivos de programa do Sensor e se é do tamanho especificado no parâmetro QueueSize no arquivo txlogd.conf.

    Se a fila não tiver sido criada corretamente:

    1. Examine o arquivo txtlogd.conf e verifique se o parâmetro QueueSize está definido corretamente.

    2. Verifique se o dispositivo no qual você instalou o Sensor tem espaço suficiente disponível para manter um arquivo do tamanho especificado no parâmetro QueueSize.

    3. Usando o painel de controle de serviços no Windows, pare o transmissor.

    4. Exclua o arquivo da fila.

    5. Registre novamente o Sensor como um serviço do Windows: no menu Iniciar do Windows, selecione Acessórios > Prompt de comando. Na janela da tela de comandos, navegue até o diretório no qual você instalou o Sensor e execute o seguinte comando:

      txlog /regserver
      

O transmissor foi projetado para funcionar continuamente. Se você reiniciar a máquina, o transmissor será reiniciado automaticamente. Se você precisar iniciar e parar o transmissor manualmente, poderá fazê-lo usando o painel de controle Serviços no Windows.

Adicionar o Coletor ao Servidor Web

Para servidores JBoss, o coletor opera como um filtro no contêiner de servlet.

Para adicionar o coletor ao servidor da Web, edite o web.xml arquivo conforme descrito abaixo e reinicie o aplicativo da Web.

  1. Usando um editor de texto, abra o web.xml arquivo para o servidor da Web cujos eventos o Sensor captura.

  2. Adicione os seguintes elementos <filter> e <filter-mapping> ao arquivo do descritor. Se você não instalou txlogd.conf no diretório /etc, é necessário digitar o caminho correto para esse arquivo no <param-value> elemento:

    <filter> 
      <filter-name>VSCollectorFilter</filter-name> 
      <description></description> 
      <filter-class> 
          com.visualsciences.collector.VSCollectorFilter 
        </filter-class> 
      <init-param> 
        <param-name>configPath</param-name> 
        <param-value>C:/VisualSensor/txlogd.conf</param-value> 
      <description></description> 
      </init-param> 
    </filter> 
    
    <filter-mapping> 
      <filter-name>VSCollectorFilter</filter-name> 
      <url-pattern>/*</url-pattern> 
    </filter-mapping> 
    
    Observação

    Essas linhas fazem distinção entre maiúsculas e minúsculas. Digite-os exatamente como aparecem acima.

  3. Reinicie o processo do servidor da Web (você não precisa reinicializar o computador inteiro do servidor, simplesmente reinicie o processo do servidor da Web). O coletor é carregado com o servidor da Web e começa a coletar dados de eventos e gravá-los na fila de discos.

Modificar o caminho da biblioteca Java

Instruções para adicionar o visual_sciences.dll ao caminho da biblioteca java do Tomcat.

  1. No servidor Windows, navegue até o diretório de instalação do Tomcat. (Tomcat > bin)

  2. Em bin folder, execute Tomcat9w.exe (Common daemon service manager).

    Na guia Java, em Opções Java, adicione uma nova linha:

    -Djava.library.path=C:\Sensor directory
    

    Onde o C:\Sensor diretório é o diretório que contém o visual_sciences.dll arquivo.

Captura de dados adicionais

Você pode capturar dados de medição adicionais de aplicativos da Web baseados em J2EE usando a funcionalidade appendToLog().

  1. Adicione o seguinte código à parte superior da página .jsp da qual você deseja capturar dados:

    <%@ page import="com.visualsciences.collector.VSCollector" %> 
    
  2. Use o método appendToLog() do objeto coletor para anexar os pares de nome-valor desejados à string de consulta da página .jsp solicitada. O exemplo a seguir anexa "A=1" e "B=2" à string de consulta da página .jsp solicitada para a página /index.jsp:

    <html> 
    <body> 
      <h1>Hello World</h1> 
      <% 
        VSCollector collector = new VSCollector(request, response); 
        collector.appendToLog("A", "1"); 
        collector.appendToLog("B", "2"); 
      %> 
    </body> 
    </html> 
    

    O URI de solicitação resultante é /index.jsp?A=1&B=2.

  3. Repita esse procedimento para cada página .jsp da qual deseja capturar dados adicionais.

Nesta página