Show Menu
ARGOMENTI×

WebSphere su AIX

Istruzioni dettagliate per l'installazione e la configurazione del sensore 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 disponete già del file di Sensor installazione per il vostro particolare server Web, scaricatelo (o ottenetelo dal rappresentante Adobe) prima di iniziare le seguenti procedure.
I server Sensor WebSphere non supportano la sperimentazione controllata. Per informazioni sulla sperimentazione controllata, vedere la Guida agli esperimenti controllati di Workbench dati.

Installare i file del programma

Procedura per estrarre e installare i file di programma per Sensoral sul computer server.
  1. Accedete come utente principale o come utente con autorizzazione principale.
  2. Decomprimete e decomprimete il file di installazione utilizzando il seguente comando:
    gunzip installationFilename.tar.gz 
    tar -xf installationFilename.tar
    
    
  3. Copiare i file di programma non imballati nelle directory indicate nella tabella seguente:
File Descrizione Target Directory
libvisual_sciences.so Modulo di carico del collettore /usr/local/visual_sciences
J2EECollector.jar Librerie del modulo 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 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
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 desiderate utilizzare autorizzazioni diverse da quelle consigliate, controllate le informazioni in Sensor UNIX File Permissions (Autorizzazioni file UNIX Sensor), per essere certi di capire come vengono utilizzati questi file.

Modificare il file di configurazione Sensor

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 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.
  • I parametri richiesti sono impostazioni che dovete specificare quando installate Sensor. Senza queste impostazioni, il sensore non viene eseguito correttamente.
  • I parametri facoltativi sono impostazioni predefinite per valori predefiniti (che è possibile modificare) o per abilitare funzioni facoltative.
Per modificare il file di configurazione
  1. Aprite il file /etc/txlogd.conf in un editor di testo e impostate i parametri richiesti, nonché eventuali parametri facoltativi desiderati.
  2. Salvate e chiudete 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 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.
  2. Sul computer in cui è installato Sensor, eseguire il comando seguente per avviare il trasmettitore:
    /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
    
    
    • L'opzione "i" di questo comando avvia il trasmettitore in modalità interattiva. Questa modalità visualizza i messaggi del trasmettitore sullo schermo e consente 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. Verificate che il trasmettitore abbia creato la coda del disco nella posizione specificata nel parametro QueueFile e nella dimensione specificata nel parametro QueueSize.
  4. Se la coda non è stata creata correttamente, digitate Ctrl+C per terminare il trasmettitore, quindi eseguite le seguenti operazioni:
    1. Esaminate il file txtlogd.conf e verificate che i parametri QueueFile e QueueSize siano impostati correttamente.
    2. Verificare che il dispositivo a cui è assegnata la coda di dischi sia operativo e che disponga di spazio sufficiente per contenere un file delle dimensioni specificate nel parametro QueueSize.
    3. Effettuare 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 l'agente di raccolta all'applicazione Web, aggiungete il filtro al descrittore di distribuzione web.xml dell'applicazione Web e riavviate l'applicazione Web.
  1. Utilizzando un editor di testo, aprite il file web.xml per il server Web i cui eventi Sensor acquisiscono.
  2. 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>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 con distinzione tra maiuscole e minuscole. Digitate esattamente come appaiono sopra.
  3. Riavviate 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 del Collector e dei file oggetto condivisi

Procedura per modificare lo script di avvio di Webfera per dichiarare la posizione dei file J2EECollector.jar e libvisual_sciences.so.
  1. Aprite il file setupCmdLine.sh nella directory Webfers /bin.
  2. Dopo la riga che definisce la variabile $WAS_CLASSPATH, aggiungere la riga seguente:
    WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
    
    
  3. Dopo il blocco case che definisce la variabile $WAS_LIBPATH, aggiungere la riga seguente:
    WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
    
    
  4. Save the setupCmdLine.sh file.

Prova del sensore

Procedura per avviare il trasmettitore e verificare che possa connettersi correttamente al server Insight e trasmettergli 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.
  1. Se il trasmettitore non è già in esecuzione, riavviarlo utilizzando il seguente comando:
    /usr/local/bin/txlogd -i -f /etc/txlogd.conf 
    
    
  2. 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).
  3. 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.
  4. 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 è stato specificato ServerAddress utilizzando un nome server, provare a utilizzare il relativo indirizzo IP numerico.
    • Il valore del parametro CertName corrisponde esattamente al nome comune che viene visualizzato sul certificato digitale del server Insight di destinazione.

Aggiungere il trasmettitore allo script di avvio del sistema

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.

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 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 .
  1. Aggiungi il codice seguente nella parte superiore della pagina .jsp da cui vuoi 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 .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.
  3. Ripetete questa procedura per ogni pagina .jsp da cui desiderate acquisire dati aggiuntivi.