WebSphere su AIX

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.

Installare i file del programma

Procedura per estrarre e installare i file di programma per Sensorto nel computer server.

1. Accedi come utente principale o come utente con autorità radice.

2. Decomprimi e decomprimi il file di installazione utilizzando il seguente comando:

   gunzip installationFilename.tar.gz
   tar -xf installationFilename.tar
   

3. Copia i file di programma decompattati nelle directory identificate nella tabella seguente:

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.

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.

Modifica il file di configurazione del sensore

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.

• I parametri richiesti sono impostazioni che è necessario specificare quando si installa Sensor. Senza queste impostazioni, il sensore non viene eseguito correttamente.
• I parametri facoltativi sono impostazioni predefinite per valori predefiniti (che è possibile modificare) o per l’abilitazione di funzionalità facoltative.

Per modificare il file di configurazione

1. Apri il file /etc/txlogd.conf in un editor di testo e imposta i parametri richiesti ed eventuali parametri facoltativi desiderati.
2. Salva e chiudi il file.

Avviare il trasmettitore e creare la coda del disco

Procedura per creare la coda del disco, dopo aver configurato il file txlogd.conf.

1. 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.

2. Sul computer in cui è installato Sensor, eseguire il seguente comando per avviare il trasmettitore:

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • L'opzione "i" in questo comando avvia il trasmettitore in modalità interattiva. Questa modalità visualizza i messaggi del trasmettitore sullo schermo e consente inoltre di interagire con il trasmettitore utilizzando i comandi della tastiera.
   • L'opzione "c" indirizza il trasmettitore a creare la coda del disco.
   • L'opzione "f" specifica la posizione del file di configurazione.

3. Verificare che il trasmettitore abbia creato la coda del disco nella posizione specificata nel parametro QueueFile e delle dimensioni specificate nel parametro QueueSize.

4. Se la coda non è stata creata correttamente, digita Ctrl+C per terminare il trasmettitore, quindi procedi come segue:

   1. Esamina il file txtlogd.conf e verifica che i parametri QueueFile e QueueSize siano impostati correttamente.
   2. Verificare che il dispositivo a cui è assegnata la coda del disco sia operativo e che disponga di spazio sufficiente per contenere un file delle dimensioni specificate nel parametro QueueSize.
   3. Apportare le correzioni necessarie e ripetere la procedura.

Aggiungere l'agente di raccolta all'applicazione Web

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.

1. Utilizzando un editor di testo, apri il file web.xml per il server web i cui eventi vengono acquisiti da Sensor.

2. 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>
   

   NOTA

   Queste righe sono sensibili all’uso di maiuscole e minuscole. Digitali esattamente come appaiono sopra.

3. 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.

Dichiarare la posizione dell’agente di raccolta e dei file di oggetto condiviso

Procedura per modificare lo script di avvio di Websphere per dichiarare la posizione dei file J2EECollector.jar e libvisual_sciences.so.

1. Apri il file setupCmdLine.sh nella directory Websphere /bin.

2. Dopo la riga che definisce la variabile $WAS_CLASSPATH , aggiungi la seguente riga:

   WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
   

3. Dopo il blocco Case che definisce la variabile $WAS_LIBPATH, aggiungi la seguente riga:

   WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
   

4. Salva il setupCmdLine.sh file.

Test del sensore

Procedura per avviare il trasmettitore e verificare che possa connettersi correttamente a Insight Server e trasmettergli i dati dell’evento.

1. Se il trasmettitore non è già in esecuzione, riavviarlo utilizzando il seguente comando:

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf
   

2. 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).

3. Dopo aver effettuato la richiesta, controlla nella console del trasmettitore i messaggi che indicano che sta inviando dati evento a Insight Server di destinazione.

4. Se il sensore non trasmette correttamente i dati, verifica che:

   • Target Insight Server è in esecuzione.
   • I parametri ServerAddress e ServerPort sono impostati correttamente in txtlogd.conf. Se ServerAddress è stato specificato utilizzando un nome server, provare a utilizzare il relativo indirizzo IP numerico.
   • Il valore del parametro CertName corrisponde esattamente al nome comune visualizzato nel certificato digitale di Target Insight Server.

Aggiungi il trasmettitore allo script di avvio del sistema

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.

Acquisizione di dati aggiuntivi

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.

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.

1. Aggiungi il codice seguente nella parte superiore della pagina .jsp da cui desideri acquisire i dati:

   <%@ page import="com.visualsciences.collector.VSCollector" %>
   

2. 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.

3. Ripeti questa procedura per ogni pagina .jsp da cui desideri acquisire dati aggiuntivi.