IBM HTTP Server su AIX 5.1 o versione successiva

Istruzioni su come installare e configurare il server IBM HTTP su IBM AIX 5.1 o versione successiva in esecuzione in Microsoft Windows Server 2000 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 installazione Sensor per il vostro particolare server Web, scaricatelo (o ottenetelo dal rappresentante Adobe) prima di iniziare le seguenti procedure.

Per installare e configurare Sensor, devi eseguire i seguenti passaggi di alto livello:

Installare i file del programma

Sul server IBM AIX, crea una directory in cui installare i file del programma Sensor. Tenere presente che la coda del disco risiede anche in questa directory, quindi assicurarsi che il dispositivo scelto disponga di spazio sufficiente per contenere una coda delle dimensioni necessarie.

  1. Accedete come utente principale o come utente con autorizzazione principale.

  2. Decomprimete e decomprimete il file di installazione utilizzando il seguente comando:

    tar -zxf installationFilename
    
  3. 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
Nota

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

Nota

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

Modificare il file di configurazione Sensor

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.

  • 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 Sensor

  • Aprite il /etc/txlogd.conf file in un editor di testo e impostate i parametri richiesti, nonché eventuali parametri opzionali desiderati.
  • Salvate e chiudete il file.

Per modificare il file di configurazione Sensor

  1. Aprite il /etc/txlogd.conf file in un editor di testo e impostate i parametri richiesti, nonché eventuali parametri opzionali desiderati.
  2. Salvate e chiudete il file.

Avviare il trasmettitore e creare la coda del disco

Dopo aver configurato il file txlogd.conf, potete avviare il programma di trasmettitore, registrarlo come servizio Windows e creare la coda del disco.

  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.

    Per ulteriori informazioni sulle autorizzazioni richieste dai file della coda del disco, vedere Autorizzazioni per i file UNIX Sensor.

  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.

    Per ulteriori informazioni sulle opzioni che potete utilizzare quando avviate il trasmettitore, consultate Opzioni della riga di comando del trasmettitore sensore.

  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'app Web, aprite il file web.xml per il server Web i cui eventi vengono acquisiti da Sensor.

Se Sensor sta acquisendo dati per più server Web sul computer server, è necessario eseguire la procedura seguente per ciascun server Web.

  1. Utilizzando un editor di testo, aprite il file httpd.conf 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>
    
    Nota

    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

Modificate lo script di avvio di Webfers 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. Salvate il file setupCmdLine.sh.

Prova del sensore

Verificate che il raccoglitore raccolga i dati dell'evento e che il trasmettitore li trasmetta al server di insight di destinazione.

Nota

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, verificare 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 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 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.

Nota

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:

  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.

In questa pagina