WebLogic Server no Windows Server 2000 ou posterior

IMPORTANTE

Leia mais sobre Datas Workbench Anúncio do fim da vida útil.

Instruções detalhadas para instalar e configurar o Sensor para o WebLogic Server 6.x ou posterior em execução no Microsoft Windows Server 2000 ou posterior.

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

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

Instalar os arquivos do programa

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

  1. No WebLogic Server, crie um diretório no qual instale os arquivos de programa do Sensor. Lembre-se de que sua fila de discos reside 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 acabou de criar. Durante essa 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 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, você pode querer copiar o arquivo para um local onde seus arquitetos possam acessá-lo ou simplesmente extrair o arquivo do pacote de instalação, conforme necessário. Para obter mais informações sobre experimentação controlada, consulte o Guia de experimentos controlados do Insight.

Editar o arquivo de configuração do sensor

O txlogd.conf 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 da fila de discos, o endereço do servidor Insight e a ID que será anexada aos dados do evento produzidos por esse sensor.

O arquivo de configuração contém parâmetros obrigatórios e parâmetros 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 que assumem o padrão de valores predefinidos (que podem ser modificados) ou ativam recursos opcionais.

Para editar o arquivo de configuração do Sensor

  • Abra o /etc/txlogd.conf em um editor de texto e defina os parâmetros obrigató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 em um editor de texto e defina os parâmetros obrigatórios, bem como quaisquer parâmetros opcionais desejados.
  2. Salve e feche o arquivo.

Inicie o transmissor e crie a fila de discos

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

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

  2. Na janela da tela de comandos, navegue até o diretório em que o Sensor foi instalado e execute o seguinte comando:

    txlog /regserver
    

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

  3. Para confirmar que 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ê estiver usando.

    1. Na lista de serviços, localize a entrada do Sensor e confirme se seu status é Iniciado e se seu tipo de inicialização é Automático.
    2. Feche o painel de controle Serviços .
  4. Para verificar se o transmissor apresentou algum erro 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 log de Aplicativos.
    2. No painel direito, procure por eventos com "Adobe" na coluna Origem.
    3. Se você encontrar um erro de "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 é o 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 armazenar um arquivo do tamanho especificado no parâmetro QueueSize .

    3. Usando o painel de controle 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 em que o Sensor foi instalado 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 precisar iniciar e parar o transmissor manualmente, faça isso usando o Painel de controle dos 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 seu servidor da Web, você deve editar o web.xml conforme descrito abaixo e reinicie seu aplicativo web.

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

  2. Adicione o seguinte <filter> e <filter-mapping> elementos para o arquivo descritor. Se você não instalou o txlogd.conf no diretório /etc, é necessário inserir 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 diferenciam maiúsculas de minúsculas. Digite-os exatamente como aparecem acima.

  3. Reinicie o processo do servidor da Web (não é necessário reiniciar o computador do servidor inteiro, simplesmente reiniciar o processo do servidor da Web). O coletor é carregado com o servidor da Web e começa a coletar dados do evento e gravá-los na fila do disco.

Modificar o script de inicialização

Instruções para modificação do script de inicialização.

No script usado para iniciar o WebLogic (por exemplo, C:\bea\user_projects\mydomain\startServer.cmd), edite a linha "set JAVA_OPTIONS=" para definir a definição java.library.path para o diretório que contém o arquivo visual_sciences.dll.

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

Capturando dados adicionais

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

  1. Adicione o seguinte código à parte superior da página .jsp da qual 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 à sequência de consulta da página .jsp solicitada. O exemplo a seguir anexa "A=1" e "B=2" à sequência 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 da 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