Istruzioni dettagliate per l'installazione e la configurazione del sensore per le implementazioni J2EE eseguite su RedHat Linux 7.x o versioni successive, Sun Solaris SPARC 2.6 o versioni successive, o Sun Solaris x86 9 o versioni successive.
I file di programma per Sensor vengono assemblati in un file di installazione ottenuto dal sito di download di Adobe. Se non disponete già del file di installazione Sensor per il vostro particolare server Web, scaricatelo (o ottenetelo dal rappresentante Adobe) prima di iniziare le seguenti procedure.
Le implementazioni J2EE supportate includono:
Per installare e configurare Sensor, devi eseguire le seguenti operazioni:
Procedura per estrarre e installare i file di programma per Sensor.
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 caricamento del raccoglitore. | IBMHttpServer/module |
txlogd |
Il programma del trasmettitore. | /usr/local/bin —OR— /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 775 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- r— r— | chmod 664 |
trust_ca_cert.pem | rw- r— r— | chmod 664 |
Il txlogd.conf file contiene i parametri di configurazione per Sensor.
È necessario modificare questo file per specificare, tra le altre cose, le dimensioni e la posizione del file della coda del disco, l'indirizzo del server di Insight e l'ID che verrà allegato ai dati dell'evento prodotti da questo sensore.
Il file di configurazione contiene i parametri obbligatori e i parametri facoltativi.
Per modificare il file di configurazione Sensor
Per modificare il file di configurazione Sensor
Dopo aver configurato il file txlogd.conf, potete avviare il programma di trasmettitore, registrarlo come servizio Windows e creare la coda del disco.
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.
Per ulteriori informazioni sulle autorizzazioni richieste dai file della coda del disco, vedere Autorizzazioni per i file UNIX Sensor.
Sul computer in cui è installato Sensor, eseguire il comando seguente per avviare il trasmettitore:
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
Per ulteriori informazioni sulle opzioni che potete utilizzare quando avviate il trasmettitore, consultate Opzioni della riga di comando del trasmettitore sensore.
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 httpd.conf file 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.conffile per il server Web i cui eventi Sensor acquisiscono.
Aggiungete i seguenti <filter>
elementi e <filter-mapping>
elementi al file descrittore. Se non avete installato txlogd.conf nella directory /etc, dovete immettere il percorso corretto per questo file nell' <param-value>
elemento:
<filter>
<filter-name>VSCollectorFilter</filter-name>
<description></description>
<filter-class>
com.visualsciences.collector.VSCollectorFilter
</filter-class>
<init-param>
<param-name>configPath</param-name>
<param-value>/etc/txlogd.conf</param-value>
<description></description>
</init-param>
</filter>
<filter-mapping>
<filter-name>VSCollectorFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
Queste righe sono con distinzione tra maiuscole e minuscole. Digitate esattamente come appaiono sopra.
Riavviate il processo del server Web (non è necessario riavviare l'intero computer del server, ma è sufficiente riavviare il processo del server Web). L'agente di raccolta viene caricato con il server Web e inizia a raccogliere i dati dell'evento e a scriverli nella coda del disco.
Verificate che il raccoglitore raccolga i dati dell'evento e che il trasmettitore li trasmetta al server di insight di destinazione.
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, verificare che:
Informazioni sul caricamento automatico del trasmettitore nello script di avvio del sistema.
Per fare in modo che il trasmettitore si carichi automaticamente al riavvio del server Web, aggiungere 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 operativi ed di errore generati dal trasmettitore sono scritti syslog.
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."
I sensori per tutte le piattaforme possono raccogliere qualsiasi dato disponibile nelle intestazioni di richiesta e risposta HTTP.
I sensori per la piattaforma J2EE forniscono un meccanismo per la raccolta di dati non disponibili su altre piattaforme. Il raccoglitore per la piattaforma J2EE (raccoglitore J2EE) si trova sul livello dell'applicazione, che consente di raccogliere dati sensibili che sono disponibili solo per l'applicazione e non devono essere esposti tramite tag di pagina o nelle intestazioni.
Mentre i tag pagina e la modifica dell’intestazione possono nascondere i dati, possono comunque essere consultati da chi esamina il codice sorgente di una pagina o osserva le intestazioni utilizzando gli strumenti plug-in del browser.
Ad esempio, il raccoglitore J2EE può essere utilizzato per acquisire i dati del costo per clic (CPC) per i collegamenti visualizzati su una pagina, le informazioni sul partner sensibile su una pagina e molti altri punti dati. L'ambiente J2EE facilita la modifica dell'APP WEBAPP per acquisire i dati personalizzati utilizzando la nostra classe di raccoglitori.
Quando un sensore per la piattaforma J2EE riceve una richiesta, richiama una classe Collector che importa la funzione appendToLog. La funzione appendToLog aggiunge alla richiesta iniziale i parametri della stringa di query specificati nella funzione appendToLog. Questo determina l'URI della richiesta iniziale contenente coppie nome-valore della stringa di query aggiuntive che corrispondono ai nomi e ai valori dei dati acquisiti. Ad esempio, CPC=20 viene aggiunto alla richiesta iniziale quando il valore di una particolare posizione annuncio o collegamento click-through è 20 centesimi. Insight Server elabora questi valori nel dataset per l'analisi. Un ulteriore vantaggio di questa metodologia di raccolta è dato dal fatto che consente la raccolta di dati aggiuntivi senza creare voci di registro aggiuntive, come potrebbe essere creato utilizzando le metodologie per l'assegnazione dei tag alle pagine.
Per ulteriori informazioni sull'elaborazione, vedere la Guida alla configurazione del set di dati.
Per acquisire dati aggiuntivi da una pagina
Aggiungete il codice seguente nella parte superiore della pagina .jsp da cui desiderate acquisire i dati:
<%@ page import="com.visualsciences.collector.VSCollector" %>
Utilizzare il metodo appendToLog() dell'oggetto Collector per aggiungere le coppie nome-valore desiderate alla stringa di query della pagina .jsp richiesta. L’esempio seguente aggiunge "A=1" e "B=2" alla stringa di query della pagina .jsp richiesta per la pagina /index.jsp:
<html>
<body>
<h1>Hello World</h1>
<%
VSCollector collector = new VSCollector(request, response);
collector.appendToLog("A", "1");
collector.appendToLog("B", "2");
%>
</body>
</html>
L'URI della richiesta risultante è /index.jsp?A=1&B=2.
Ripetete questa procedura per ogni pagina .jsp da cui desiderate acquisire dati aggiuntivi.