Instruções sobre como instalar e configurar o Apache Server 2.0.40, 2.0.42 ou posterior, o Apache Server 2.2 ou o Apache Server 2.4 no Linux, Sun Solaris ou FreeBSD.
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.
Para instalar e configurar o Sensor, execute as seguintes etapas de alto nível:
Os seguintes servidores Apache são suportados:
Embora as instruções para instalar sensores em servidores da Web que executam o Apache Server versões 2.0.40, 2.0.42 ou posterior (32 bits e 64 bits) ou 2.2 sejam as mesmas (exceto quando observado nos procedimentos a seguir), os arquivos de instalação para cada versão são diferentes. Antes de instalar o Sensor, verifique se você recebeu os arquivos de instalação corretos para o Apache Server e as versões do sistema operacional que você está executando.
Procedimento para extrair e instalar os arquivos de programa do Sensor.
Faça logon como o usuário raiz ou como um usuário com autoridade raiz.
Descompacte e descompacte o arquivo de instalação usando o seguinte comando:
No Linux:
tar -zxf installationFilename
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
No Solaris:
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. | IBMHttpServer/modules |
txlogd |
O programa do transmissor. | /usr/local/bin --OU-- /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, 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.
Permissões nos arquivos de programas
Permissões incorretas nos arquivos de programa causam a maioria dos problemas encontrados ao instalar o Sensor. Certifique-se de definir as permissões exatamente como está indicado 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 775 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw-r— r— | chmod 664 |
trust_ca_cert.pem | rw-r— r— | chmod 664 |
Etapas que permitem fazer logon no Sametime Server.
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.
Para editar o arquivo de configuração do sensor
Para editar o arquivo de configuração do sensor
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.
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.
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
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.
Verifique se o transmissor criou a fila de discos no local especificado no parâmetro QueueFile e no 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 HTTP IBM, o coletor é um objeto compartilhado dinâmico que você carrega no processo do servidor Web.
Para adicionar o coletor ao servidor da Web, edite o arquivo httpd.conf como descrito abaixo e reinicie o servidor da Web.
Se o Sensor estiver capturando dados para 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 arquivo httpd.conf para o servidor da Web cujos eventos o Sensor captura.
Adicione as duas linhas a seguir ao final do arquivo:
LoadModule visual_sciences_module modules/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
Essas linhas fazem distinção entre maiúsculas e minúsculas. Digite-os exatamente como aparecem acima.
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.
Verifique se o coletor está coletando dados de eventos e se o transmissor está transmitindo para o servidor Insight de destino.
Para verificar se o transmissor pode enviar dados de evento com êxito ao Insight Server, verifique se o Insight Server de destino está instalado e em execução antes de iniciar o seguinte teste.
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 no qual o Sensor está sendo executado (certifique-se de selecionar uma página que o Sensor esteja monitorando).
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.
Se o sensor não estiver transmitindo os dados com êxito, verifique se:
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 operação geradas pelo transmissor são gravadas no syslog.