Istruzioni dettagliate per l'installazione e la configurazione del sensore per un server Apache 1.3.x su RedHat Linux 7.x o versioni successive, SUSE Linux 9.x o versioni successive, Sun Solaris SPARC 2.6 o versioni successive, Sun Solaris x86 9 o versioni successive, FreeBSD 4 o versioni successive o Mac OS X PowerPC.
I file di programma per Sensor sono pacchetti in un file di installazione che si ottiene dal sito di download del Adobe . Se non disponete già del file di installazione Sensor per il vostro particolare server Web, scaricatelo (o ottenetelo dal rappresentante del Adobe ) prima di iniziare le seguenti procedure.
Per installare e configurare Sensor, devi eseguire i seguenti passaggi di alto livello:
Istruzioni per estrarre e installare i file di programma per Sensor al computer server.
Accedete come utente principale o come utente con autorizzazione principale.
Decomprimete e decomprimete il file di installazione utilizzando il seguente comando:
In Linux:
tar -zxf installationFilename.tar.gz
Su Solaris:
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
Copiare i file di programma non imballati nelle directory indicate nella tabella seguente:
File | Descrizione | Target Directory |
---|---|---|
mod_visual_sciences.so | Modulo di carico del collettore | apachePath/libexec |
txlogd |
Il programma del trasmettitore | /usr/local/bin --O-- /usr/local/sbin |
txlogd.conf | Il file di configurazione Sensor | /etc |
trust_ca_cert.pem | Certificato utilizzato per convalidare il certificato digitale presentato da Insight Server durante il processo di connessione | /usr/local/visual_sciences |
Il pacchetto di installazione contiene un foglio di calcolo denominato TestExperiment.xls. Questo foglio di calcolo è uno strumento che gli architetti usano per configurare un esperimento controllato. Il sensore stesso non utilizza questo file, quindi non è necessario installare il file sul computer in cui è in esecuzione Sensor (anche se potete scegliere di farlo). Potreste desiderare, invece, copiare il file in una posizione in cui gli architetti possano accedervi o semplicemente estrarre il file dal pacchetto di installazione in base alle esigenze. Per ulteriori informazioni sulla sperimentazione controllata, consulta la Guida agli esperimenti controllati di Insight.
Autorizzazioni sui file del programma
Autorizzazioni errate sui file del programma causano la maggior parte dei problemi incontrati durante l'installazione del sensore.
Accertatevi di impostare le autorizzazioni esattamente come indicato in questa sezione.
Per impostazione predefinita, i file di programma nel file tar hanno le seguenti autorizzazioni. A seconda della configurazione del sistema, queste impostazioni potrebbero essere modificate (non mascherate) al momento dell’estrazione dei file. Per ripristinare le autorizzazioni alle impostazioni predefinite consigliate, utilizzate i comandi chmod riportati di seguito. Verificate che le directory in cui avete installato i file consentano almeno questo livello di accesso.
File | Autorizzazioni predefinite | chmod, comando |
---|---|---|
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 |
Il txlogd.conf file contiene i parametri di configurazione per Sensor.
È necessario modificare il file per specificare, tra l'altro, le dimensioni della coda del disco, l'indirizzo del server di Insight e l'ID che verrà allegato ai dati prodotti da questo sensore.
Il file di configurazione contiene i parametri obbligatori e i parametri facoltativi.
Per modificare il file di configurazione Sensor
Istruzioni per creare la coda del disco dopo aver configurato il file txlogd.conf.
Se la directory in cui risiede la coda del disco non esiste già, crearla. Verificate che la directory fornisca sia il modulo di raccolta che il programma di trasmettitore con accesso in lettura/scrittura al file.
Sul computer in cui è installato Sensor, eseguire il comando seguente per avviare il trasmettitore:
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
Verificate che il trasmettitore abbia creato la coda del disco nella posizione specificata nel parametro QueueFile e nella dimensione specificata nel parametro QueueSize.
Se la coda non è stata creata correttamente, digitate Ctrl+C per terminare il trasmettitore, quindi eseguite le seguenti operazioni:
Per i server Apache, l'agente di raccolta è un oggetto condiviso dinamico caricato nel processo del server Web.
Per aggiungere l'agente di raccolta al server Web, è necessario modificare il file httpd.conf come descritto di seguito e riavviare il server Web.
Se Sensor sta acquisendo dati per più server Web sul computer server, è necessario eseguire la procedura seguente per ciascun server Web.
Utilizzando un editor di testo, aprite il httpd.conf file per il server Web i cui eventi Sensor acquisisce.
Aggiungete le righe seguenti alla fine del file:
LoadModule visual_sciences_module libexec/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
AddModule mod_visual_sciences.c
Queste righe sono con distinzione tra maiuscole e minuscole. Digitate esattamente come appaiono sopra.
Riavviate il server Web. L'agente di raccolta viene caricato con il server Web e inizierà a raccogliere i dati dell'evento e a scriverli nella coda del disco.
Avviate il trasmettitore e verificate che possa connettersi correttamente al server Insight e trasmettervi i dati dell'evento.
Per verificare che il trasmettitore possa inviare correttamente i dati dell'evento al server di Insight, accertatevi che il server di Insight di destinazione sia installato ed in esecuzione prima di iniziare il test seguente.
Se il trasmettitore non è già in esecuzione, riavviarlo utilizzando il seguente comando:
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
Aprite un browser (su qualsiasi computer) e richiedete una pagina dal server Web su cui è in esecuzione Sensor (accertatevi di selezionare una pagina che il sensore sta monitorando).
Dopo aver inviato la richiesta, controllate la console del trasmettitore per i messaggi che indicano l'invio dei dati dell'evento al server di visualizzazione di destinazione.
Se Sensor non trasmette correttamente i dati, verifica che:
Il server di destinazione Insight è in esecuzione.
I parametri ServerAddress e ServerPort sono impostati correttamente in txtlogd.conf.
Se avete specificato ServerAddress con un nome server, provate a utilizzare il relativo indirizzo IP numerico. Il valore del CertName parametro corrisponde esattamente al nome comune visualizzato sul certificato digitale del server di insight di destinazione.
Informazioni per garantire che il trasmettitore si carichi automaticamente al riavvio del server Web.
Aggiungete il seguente comando (che avvia il trasmettitore) allo script di avvio del sistema.
/usr/local/bin/txlogd -f /etc/txlogd.conf
Questo comando avvia il trasmettitore come un demone. I messaggi di funzionamento e di errore generati dal trasmettitore vengono scritti in syslog.
Alcuni utenti di Solaris potrebbero riscontrare un errore "impossibile acquisire mutex". Affinché il sensore funzioni correttamente su questi sistemi, è necessario aggiungere o modificare la seguente riga nel file /etc/system:
semsys:seminfo_semmnu=1024
L'impostazione predefinita di Solaris è 60. In base ai test condotti con Sensor, che utilizza tre semafori per ogni istanza, Adobe consiglia di usare 1024 come impostazione. Questo numero è sufficientemente elevato da consentire il funzionamento del sensore insieme ad altre applicazioni sul server che possono richiedere dei semafori, ma non influisce sulle prestazioni. Per sostenere questa raccomandazione, si prega di notare che Adrian Cockcroft ha dichiarato quanto segue nel suo libro Sun Performance and Tuning (Prentice Hall, ottobre 1994): "I database tendono a utilizzare un sacco di memoria condivisa e di impostazioni del semaforo. che non incidono sulle prestazioni; fintanto che sono abbastanza grandi, i programmi funzioneranno."