Ulteriori informazioni su Data Workbench Annuncio di fine vita.
Istruzioni dettagliate per l'installazione e la configurazione di Sensor per WebSphere 5.x in esecuzione su AIX 5.1 o versione successiva.
I file di programma per Sensor vengono assemblati in un file di installazione ottenuto dal sito di download di Adobe. Se non disponi già del Sensor file di installazione per il server Web specifico, scaricarlo (o ottenerlo dal rappresentante di Adobe) prima di iniziare le procedure seguenti.
La Sensor per i server WebSphere non supporta la sperimentazione controllata. Per informazioni sulla sperimentazione controllata, consulta la sezione Guida agli esperimenti controllati da Data Workbench.
Procedura per estrarre e installare i file di programma per Sensorto nel computer server.
Accedi come utente principale o come utente con autorità radice.
Decomprimi e decomprimi il file di installazione utilizzando il seguente comando:
gunzip installationFilename.tar.gz
tar -xf installationFilename.tar
Copia i file di programma decompattati nelle directory identificate nella tabella seguente:
File | Descrizione | Target Directory |
---|---|---|
libvisual_sciences.so | Modulo di carico del collettore | /usr/local/visual_sciences |
J2EECollector.jar | Le librerie dei moduli di caricamento del raccoglitore | Directory WebSphere /lib |
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 file di foglio di calcolo denominato TestExperiment.xls. Questo foglio di calcolo è uno strumento che gli architetti utilizzano 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 si può scegliere di farlo). È invece possibile copiare il file in un percorso in cui gli architetti possono 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 da Insight.
Autorizzazioni sui file del programma
Autorizzazioni errate sui file di programma causano la maggior parte dei problemi incontrati durante l'installazione di Sensor.
Assicurati 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) durante l’estrazione dei file.
Per ripristinare le autorizzazioni alle impostazioni predefinite consigliate, utilizza i comandi chmod riportati di seguito.
Controlla che le directory in cui hai installato i file consentano almeno questo livello di accesso.
File | Autorizzazioni predefinite | comando chmod |
---|---|---|
libvisual_sciences.so | rwx —x —x | chmod 711 |
J2EECollector.jar | rw- rw- r— | chmod 664 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- r— | chmod 664 |
trust_ca_cert.pem | rw- rw- r— | chmod 664 |
Se si desidera utilizzare autorizzazioni diverse dalle impostazioni predefinite consigliate, esaminare le informazioni contenute in Autorizzazioni file UNIX di Sensor, per essere certi di comprendere come vengono utilizzati questi file.
Il file txlogd.conf contiene i parametri di configurazione per Sensor.
È necessario modificare il file per specificare, tra l’altro, le dimensioni della coda del disco, l’indirizzo di Insight Server e l’ID che verrà allegato ai dati prodotti da questo sensore.
Il file di configurazione contiene i parametri richiesti e i parametri facoltativi.
Per modificare il file di configurazione
Procedura per creare la coda del disco, dopo aver configurato il file txlogd.conf.
Se la directory in cui si trova la coda del disco non esiste già, crearla. Assicurati che la directory offra sia il modulo di raccolta che il programma del trasmettitore con accesso in lettura/scrittura al file.
Sul computer in cui è installato Sensor, eseguire il seguente comando per avviare il trasmettitore:
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
Verificare che il trasmettitore abbia creato la coda del disco nella posizione specificata nel parametro QueueFile e delle dimensioni specificate nel parametro QueueSize.
Se la coda non è stata creata correttamente, digita Ctrl+C per terminare il trasmettitore, quindi procedi come segue:
Per i server WebSphere, il raccoglitore funziona come filtro nel contenitore servlet.
Per aggiungere il raccoglitore all'applicazione Web, aggiungi il filtro al descrittore di distribuzione web.xml dell'applicazione Web e riavvia l'applicazione Web.
Utilizzando un editor di testo, apri il file web.xml per il server web i cui eventi vengono acquisiti da Sensor.
Aggiungi quanto segue <filter>
e <filter-mapping>
al file descrittore. Se non hai installato txlogd.conf nella directory /etc, devi immettere il percorso corretto di questo file nel <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>C:/VisualSensor/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 sensibili all’uso di maiuscole e minuscole. Digitali esattamente come appaiono sopra.
Riavvia l'applicazione Web. Il raccoglitore viene caricato con l'applicazione e inizierà a raccogliere i dati dell'evento e a scriverli nella coda del disco.
Procedura per modificare lo script di avvio di Websphere per dichiarare la posizione dei file J2EECollector.jar e libvisual_sciences.so.
Apri il file setupCmdLine.sh nella directory Websphere /bin.
Dopo la riga che definisce la variabile $WAS_CLASSPATH , aggiungi la seguente riga:
WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
Dopo il blocco Case che definisce la variabile $WAS_LIBPATH, aggiungi la seguente riga:
WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
Salva il setupCmdLine.sh file.
Procedura per avviare il trasmettitore e verificare che possa connettersi correttamente a Insight Server e trasmettergli i dati dell’evento.
Per verificare che il trasmettitore possa inviare correttamente i dati dell’evento a Insight Server, assicurati che Insight Server 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
Apri un browser (su qualsiasi computer) e richiedi una pagina dal server web su cui è in esecuzione Sensor (assicurati di selezionare una pagina che Sensor sta monitorando).
Dopo aver effettuato la richiesta, controlla nella console del trasmettitore i messaggi che indicano che sta inviando dati evento a Insight Server di destinazione.
Se il sensore non trasmette correttamente i dati, verifica che:
Informazioni per garantire che il trasmettitore venga caricato automaticamente al riavvio del server Web.
Aggiungi 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 daemon. I messaggi di funzionamento ed errore generati dal trasmettitore vengono scritti nel registro di sistema.
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 che non è disponibile su altre piattaforme. Il raccoglitore per la piattaforma J2EE (J2EE Collector) si trova sul livello dell'applicazione, che gli consente di raccogliere dati sensibili disponibili solo per l'applicazione e che non devono essere esposti tramite tag di pagina o nelle intestazioni.
Anche se i tag pagina e la modifica dell’intestazione possono nascondere i dati, sono comunque disponibili per coloro che esaminano il codice sorgente di una pagina o guardano le intestazioni utilizzando gli strumenti plug-in del browser.
Ad esempio, il raccoglitore J2EE può essere utilizzato per acquisire i dati di costo per clic (CPC) per i collegamenti visualizzati su una pagina, le informazioni sensibili dei partner su una pagina e molti altri punti di dati. L’ambiente J2EE ti consente di modificare facilmente la tua WEBAPP per acquisire questi dati personalizzati utilizzando la nostra classe Collector.
Quando un sensore per la piattaforma J2EE riceve una richiesta, richiama una classe di raccolta 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 corrispondenti ai nomi e ai valori dei dati che vengono acquisiti. Ad esempio, CPC=20 verrebbe aggiunto alla richiesta iniziale quando il valore di un particolare posizionamento di annunci o collegamento click-through è di 20 centesimi. Insight Server elabora questi valori nel set di dati per l’analisi. Un ulteriore vantaggio di questa metodologia di raccolta è che consente la raccolta di dati aggiuntivi senza creare voci di registro aggiuntive, come potrebbe essere creato utilizzando le metodologie di assegnazione tag delle pagine.
Per ulteriori informazioni sull’elaborazione, consulta la sezione Guida alla configurazione del set di dati.
Aggiungi il codice seguente nella parte superiore della pagina .jsp da cui desideri 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 richiesta .jsp 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 di richiesta risultante è /index.jsp?A=1&B=2.
Ripeti questa procedura per ogni pagina .jsp da cui desideri acquisire dati aggiuntivi.