Apache Server 1.3.x no Linux, Sun Solaris, FreeBSD ou Mac OS X

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 que você obtém do site de download do 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 representante do Adobe) antes de começar os procedimentos a seguir.

Para instalar e configurar o Sensor, execute as seguintes etapas de alto nível:

Instale os arquivos de Programa

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.

Descompacte 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 do público alvo
mod_visual_sciences.so	O módulo de carregamento do coletor	apachePath/libexec
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

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.

Permissões nos arquivos do Programa

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 755
txlogd	rwx —x —x	chmod 711
txlogd.conf	rw- rw- r—	chmod 664
trust_ca_cert.pem	rw- rw- r—	chmod 664

Edit the Sensor configuration file

O txlogd.conf arquivo 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 discos, o endereço do Insight Server e a ID que será anexada aos dados 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 arquivo /etc/txlogd.conf em um editor de texto e defina os parâmetros necessários, bem como quaisquer parâmetros opcionais desejados.
Salve e feche o arquivo.

Start o transmissor e crie a fila de discos

Instruções para criar a fila de discos depois de configurar o arquivo txlogd.conf.

Se o diretório no qual a fila de discos reside ainda não existir, crie-o. Verifique se o diretório fornece ao módulo coletor e ao programa transmissor acesso de leitura/gravação ao arquivo.
No computador em que o Sensor está instalado, execute o seguinte comando para start do transmissor:
```
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
```
- A opção "i" nesse comando start 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.
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:
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 Web

Para servidores Apache, 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 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
```
OBSERVAÇÃO

Essas linhas fazem distinção entre maiúsculas e 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.

Teste o sensor

Start o transmissor e verifique se ele consegue se conectar com êxito ao Insight Server e transmitir dados do evento para ele.

OBSERVAÇÃO

Para verificar se o transmissor pode enviar dados do evento com êxito ao Insight Server, verifique se o público alvo Insight Server está instalado e em execução antes de começar 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 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 público alvo Insight Server.
Se o sensor não estiver transmitindo os dados com êxito, verifique se:
- O público alvo Insight Server 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 CertName parâmetro corresponde exatamente ao nome comum que aparece no certificado digital do público alvo Insight Server.

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

Informações para garantir que o transmissor seja carregado 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 start o transmissor como um daemon. As mensagens de erro e de operação geradas pelo transmissor são gravadas no syslog.

OBSERVAÇÃO

Alguns usuários do Solaris podem encontrar um erro "não é possível adquirir mutex". Para que o Sensor funcione corretamente nesses sistemas, a seguinte linha 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 utiliza três semáforos para cada instância, o Adobe recomenda que você use 1024 como sua 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; contanto que sejam grandes o suficiente, os programas correrão."