Netscape Enterprise em Linux ou Solaris

Instruções para instalar e configurar o Sensor na família de servidores Web que evoluíram do Netscape Enterprise Web Server original em execução em máquinas Linux ou Solaris. Inclui Netscape Enterprise, iPlanet, Sun ONE e Sun Java System Servers no Linux ou Solaris.

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.

O sensor oferece suporte aos seguintes servidores em execução no RedHat Linux 7.x ou posterior ou no Sun Solaris SPARC 2.6 ou posterior:

• Netscape Enterprise Server 3.6 ou posterior
• iPlanet Web Server 4.0 ou posterior

O sensor é compatível com esses servidores em execução no RedHat Linux 7.x ou posterior ou no Sun Solaris 8.x ou posterior:

• Sun ONE Web Server 6.0 ou posterior
• Sun Java System Web Server 6.1 ou posterior

O sensor é compatível com esses servidores em execução no Sun Solaris x86 9 ou posterior:

• Sun Java System Web Server 6.1 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. Faça logon como o usuário raiz ou como um usuário com autoridade raiz.

2. Descompacte e descompacte o arquivo de instalação usando o seguinte comando:

   gunzip installationFilename.tar.gz 
   
       tar -xf installationFilename.tar
   

3. Copie os arquivos de programa descompactados para os diretórios identificados na tabela a seguir:

Permissões nos arquivos de programas

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. Se o diretório no qual a fila de discos reside ainda não existir, crie-o. Certifique-se de que o diretório fornece ao módulo coletor e ao programa transmissor acesso de leitura/gravação ao arquivo.

   Para obter mais informações sobre as permissões exigidas pelos arquivos de fila de disco, consulte Permissões de arquivo UNIX do sensor.

2. No computador em que o Sensor está instalado, execute o seguinte comando para iniciar o transmissor:

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • A opção "i" neste comando inicia o transmissor no "modo interativo". Esse modo exibe mensagens do transmissor na tela e também permite que você interaja com o transmissor usando comandos do teclado.
   • A opção "c" direciona o transmissor para criar a fila de discos.
   • A opção "f" especifica o local do arquivo de configuração.

   Para obter informações adicionais sobre as opções que podem ser usadas ao iniciar o transmissor, consulte Opções de linha de comando do transmissor de sensor.

3. Verifique se o transmissor criou a fila de discos no local especificado no parâmetro QueueFile e no tamanho especificado no parâmetro QueueSize.

4. Se a fila não tiver sido criada corretamente, digite Ctrl+C para encerrar o transmissor e faça o seguinte:

   1. Examine o arquivo txtlogd.conf e verifique se os parâmetros QueueFile e QueueSize estão definidos corretamente.
   2. Verifique se o dispositivo ao qual a fila de discos está atribuída está operacional e tem espaço suficiente disponível para reter um arquivo do tamanho especificado no parâmetro QueueSize.
   3. Faça as correções necessárias e repita este procedimento.

Adicionar o coletor ao servidor AOL

Para o AOLServer, o coletor é um objeto compartilhado dinâmico que você carrega no processo do servidor da Web.

Para adicionar o coletor ao servidor AOL, edite o arquivo de configuração do servidor conforme descrito abaixo e reinicie o servidor AOL. Normalmente, o arquivo de configuração do servidor é chamado nsd.tcl e está localizado no diretório onde o AOL Server está instalado.

1. Abra o arquivo de configuração em um editor de texto e localize a seguinte seção:

   ns_section "ns/server/${servername}/modules" 
   

2. Adicione a seguinte linha. (Adicione como uma única declaração. Ignorar quebra automática de linha mostrada abaixo.)

   ns_param aol_visual_sciences /usr/local/aolserver/visual_sciences/aol_visual_sciences.so 
   

3. Crie uma nova seção da seguinte forma:

   ns_section "ns/server/${servername}/module/aol_visual_sciences"
   

4. Para esta nova seção, adicione a linha:

   ns_param    VisualSciencesConfig    /etc/txlogd.conf
   

   OBSERVAÇÃO

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

5. Reinicie o servidor AOL. O coletor é carregado e começará a coletar dados de eventos e gravá-los na fila de discos.

Teste o sensor

Verifique se o coletor está coletando dados de eventos e se o transmissor está transmitindo para o servidor Insight de destino.

1. Se o transmissor ainda não estiver em execução, reinicie-o usando o seguinte comando:

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf 
   

2. Abra um navegador (em qualquer máquina) e solicite uma página do servidor da Web no qual o Sensor está sendo executado (certifique-se de selecionar uma página que o Sensor esteja monitorando).

3. Depois de emitir a solicitação, verifique se há mensagens no console do transmissor indicando que ele está enviando dados do evento para o Insight Server de destino.

4. Se o sensor não estiver transmitindo os dados com êxito, verifique se:

   • O Servidor Insight de destino está em execução.
   • Os parâmetros ServerAddress e ServerPort estão definidos corretamente em txtlogd.conf. Se você especificou ServerAddress usando um nome de servidor, tente usar seu endereço IP numérico.
   • O valor do parâmetro CertName corresponde exatamente ao nome comum que aparece no certificado digital do Insight Server de destino.

Adicione o transmissor ao script de inicialização do sistema

Informações sobre como carregar automaticamente o transmissor para o script de inicialização do sistema.

Para garantir que o transmissor seja carregado automaticamente quando a máquina do servidor Web for reiniciada, adicione o seguinte comando (que inicia o transmissor) ao script de inicialização do sistema:

/usr/local/bin/txlogd -f /etc/txlogd.conf

Esse comando inicia o transmissor como um daemon. As mensagens de erro e de funcionamento geradas pelo transmissor são gravadas syslog.

A configuração padrão do Solaris é 60. Com base nos testes realizados com o Sensor, que utiliza três semáforos para cada instância, a Adobe recomenda usar o 1024 como configuração. Esse número é alto o suficiente para que o Sensor funcione junto com quaisquer outros aplicativos no servidor que possam exigir pontos-e-vírgulas, mas não afeta o desempenho. Para apoiar esta recomendação, observe que Adrian Cockcroft declarou o seguinte em seu livro Sun Performance and Tuning (Prentice Hall, outubro de 1994): "Os bancos de dados tendem a usar muita memória compartilhada e configurações de semáforo. Estes não afetam o desempenho; enquanto forem suficientemente grandes, os programas serão executados."