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 file di installazione Sensor per un particolare server Web, scaricalo (o ottienilo dal rappresentante di Adobe) prima di iniziare le procedure seguenti.

NOTA

I server Sensor per WebSphere non supportano la sperimentazione controllata. Per informazioni sulla sperimentazione controllata, vedere la Guida agli esperimenti controllati da Data Workbench.

Installa i file di 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:

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
NOTA

Il pacchetto di installazione contiene un file di foglio di calcolo denominato TestExperiment.xls. Questo foglio di calcolo è uno strumento utilizzato dagli architetti 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.

NOTA

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.

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 i seguenti elementi <filter> e <filter-mapping> al file descrittore. Se non hai installato txlogd.conf nella directory /etc, devi immettere il percorso corretto di questo file nell'elemento <param-value> .

    <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 file setupCmdLine.sh.

Test del sensore

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

NOTA

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.

  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.

NOTA

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, vedere la 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.

In questa pagina