Leia mais sobre Datas Workbench Anúncio do fim da vida útil.
Instruções detalhadas para instalar e configurar o Sensor para um Apache Server 1.3.x no RedHat Linux 7.x ou posterior, SUSE Linux 9.x ou posterior, Sun Solaris SPARC 2.6 ou posterior, Sun Solaris x86 9 ou posterior, FreeBSD 4 ou posterior ou Mac OS X PowerPC.
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, você deve executar as seguintes etapas de alto nível:
Instruções para extrair e instalar os arquivos de programa do Sensor na máquina do servidor.
Faça logon como o usuário raiz ou como um usuário com autoridade raiz.
Descomprima e descompacte o arquivo de instalação usando o seguinte comando:
No Linux:
tar -zxf installationFilename.tar.gz
No Solaris:
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
Copie os arquivos de programa descompactados para os diretórios identificados na tabela a seguir:
Arquivo | Descrição | Diretório de destino |
---|---|---|
mod_visual_sciences.so | O módulo de carregamento do coletor | apachePath/libexec |
txlogd |
O programa transmissor | /usr/local/bin --OR-- /usr/local/sbin |
txlogd.conf | O arquivo de configuração do sensor | /etc |
trust_ca_cert.pem | O certificado usado para validar o certificado digital que o Insight Server apresenta durante o processo de conexão | /usr/local/visual_sciences |
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.
Permissões nos arquivos do programa
Permissões incorretas nos arquivos do programa causam a maioria dos problemas encontrados ao instalar o Sensor.
Certifique-se de definir as permissões exatamente como declarado nesta seção.
Por padrão, os arquivos de programa no arquivo tar têm as seguintes permissões. Dependendo de como seu sistema está configurado, essas configurações podem ser alteradas (não mascaradas) ao extrair os arquivos. Para redefinir as permissões para as configurações padrão recomendadas, use os comandos chmod abaixo. Verifique se os diretórios nos quais você instalou os arquivos permitem pelo menos esse nível de acesso.
Arquivo | Permissões padrão | comando chmod |
---|---|---|
mod_visual_sciences.so | rwx r-x r-x | chmod 755 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- r— | chmod 664 |
trust_ca_cert.pem | rw- rw- r— | chmod 664 |
O txlogd.conf contém os parâmetros de configuração do Sensor.
Você deve editar o arquivo para especificar, entre outras coisas, o tamanho da fila de disco, o endereço do servidor Insight e a ID que será anexada aos dados produzidos por esse sensor.
O arquivo de configuração contém parâmetros obrigatórios e parâmetros opcionais.
Para editar o arquivo de configuração do Sensor
Instruções para criar a fila do disco depois de configurar o arquivo txlogd.conf.
Se o diretório em que está a fila de discos ainda não existir, crie-o. Certifique-se de que o diretório forneça o módulo coletor e o programa transmissor com acesso de leitura/gravação ao arquivo.
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
Verifique se o transmissor criou a fila de discos no local especificado no parâmetro QueueFile e do tamanho especificado no parâmetro QueueSize.
Se a fila não tiver sido criada corretamente, digite Ctrl+C para encerrar o transmissor e faça o seguinte:
Para servidores Apache, o coletor é um objeto compartilhado dinâmico que você carrega no processo do servidor da Web.
Para adicionar o coletor ao seu servidor da Web, edite o arquivo httpd.conf conforme descrito abaixo e reinicie o servidor da Web.
Se o Sensor estiver capturando dados de vários servidores da Web no computador servidor, você deverá executar o seguinte procedimento para cada servidor da Web.
Usando um editor de texto, abra o httpd.conf arquivo para o servidor da Web cujos eventos o Sensor captura.
Adicione as seguintes linhas ao final do arquivo :
LoadModule visual_sciences_module libexec/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
AddModule mod_visual_sciences.c
Essas linhas diferenciam maiúsculas de minúsculas. Digite-os exatamente como aparecem acima.
Reinicie o servidor da Web. O coletor é carregado com o servidor da Web e começará a coletar dados do evento e gravá-los na fila do disco.
Inicie o transmissor e verifique se ele pode se conectar com êxito ao Servidor Insight e transmitir dados do evento para ele.
Para verificar se o transmissor pode enviar dados de evento com êxito para o servidor Insight, verifique se o servidor Insight de destino está instalado e em execução antes de iniciar o teste a seguir.
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
Abra um navegador (em qualquer máquina) e solicite uma página do servidor da Web em que o Sensor está sendo executado (certifique-se de selecionar uma página que o Sensor esteja monitorando).
Depois de emitir a solicitação, verifique o console do transmissor quanto a mensagens indicando que ele está enviando dados do evento para o servidor Insight de destino.
Se o sensor não estiver transmitindo os dados com êxito, verifique se:
O Servidor Insight de destino está em execução.
O ServerAddress e ServerPort sã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 da variável CertName corresponde exatamente ao nome comum que aparece no certificado digital do servidor Insight de destino.
Informações para garantir que o transmissor carregue automaticamente quando a máquina do servidor da 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. Mensagens de erro e operacionais geradas pelo transmissor são gravadas no syslog.
Alguns usuários do Solaris podem encontrar um erro "não é possível adquirir mutex". Para que o Sensor funcione corretamente nesses sistemas, a linha a seguir precisa ser adicionada ou editada no arquivo /etc/system:
semsys:seminfo_semmnu=1024
A configuração padrão do Solaris é 60. Com base nos testes realizados com o Sensor, que usa três semáforos para cada instância, o Adobe recomenda usar 1024 como configuração. Esse número é alto o suficiente para que o Sensor funcione junto com outros aplicativos no servidor que possam exigir semáforos, mas não afeta o desempenho. Para apoiar esta recomendação, por favor note 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. Não afetam o desempenho; desde que sejam suficientemente grandes, os programas serão executados."