Show Menu
ARGOMENTI×

Server Tomcat su Windows Server 2000 o versione successiva

Istruzioni dettagliate per l'installazione e la configurazione del sensore per Apache Jakarta Tomcat 4.1 o versione successiva in esecuzione in 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.
Le implementazioni J2EE supportate includono:
  • JBoss Server 4.0.5 o versione successiva in esecuzione su Microsoft Windows Server 2000 o versione successiva.
Per installare e configurare Sensor, devi eseguire le seguenti operazioni:

Installare i file del programma

Procedura per estrarre e installare i file di programma per Sensor.
  1. Sul server Tomcat, create una directory in cui installare i file del programma Sensor. Tenere presente che la coda del disco si trova in questa directory, quindi assicurarsi che il dispositivo scelto disponga di spazio sufficiente per contenere una coda delle dimensioni necessarie.
    C:\VisualSensor
    
    
  2. Estrarre il contenuto del file di installazione nella directory appena creata. Durante questo passaggio, Sensor installa i file seguenti:
File Descrizione Target Directory
visual_sciences.dll Modulo di caricamento del raccoglitore. In qualsiasi directory.
J2EECollector.jar Librerie del modulo di caricamento del raccoglitore WEB-INF/lib
txlogd.exe
Il programma del trasmettitore. In qualsiasi directory
txlogd.conf Il file di configurazione Sensor. In qualsiasi directory
trust_ca_cert.pem Certificato utilizzato per convalidare il certificato digitale presentato da Insight Server durante il processo di connessione In qualsiasi directory
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.

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. Dal menu Start in Windows, selezionate Accessori > Prompt dei comandi.
  2. Nella finestra del prompt dei comandi, andate alla directory in cui avete installato Sensor ed eseguite il seguente comando:
    txlog /regserver
    
    
    Questo comando avvia il trasmettitore, crea la coda del disco e registra Sensor come servizio Windows.
  3. Per confermare che il trasmettitore funziona correttamente, fate clic su Start > Pannello di controllo > Strumenti di amministrazione > Servizi.
    Questa sequenza di comandi può variare a seconda della versione di Windows in uso.
    1. Nell'elenco dei servizi, individuare la voce per Sensor e confermare che il suo stato è Avviato e il suo tipo di avvio è Automatico.
    2. Chiudere il pannello di controllo Servizi.
  4. Per verificare se il trasmettitore ha riscontrato degli errori durante l’avvio, fate clic su Start > Pannello di controllo > Strumenti di amministrazione > Visualizzatore eventi per aprire il visualizzatore eventi.
    1. Nel riquadro a sinistra della finestra Visualizzatore eventi, selezionate il registro Applicazioni.
    2. Nel riquadro a destra, cercate gli eventi con "Adobe" nella colonna Sorgente.
    3. Se si verifica un errore in "Adobe", fare doppio clic sull'errore per visualizzare la finestra Proprietà evento. Questa finestra fornisce informazioni dettagliate sull'errore.
  5. Al termine dell'esame del registro Applicazioni, chiudete il visualizzatore eventi.
  6. Verificare che il trasmettitore abbia creato la coda del disco (Diskq2000.log) nella directory in cui sono stati installati i file del programma Sensor e che si tratti della dimensione specificata nel parametro QueueSize nel file txlogd.conf.
    Se la coda non è stata creata correttamente:
    1. Esaminate il file txtlogd.conf e verificate che il parametro QueueSize sia impostato correttamente.
    2. Verificare che il dispositivo su cui è installato Sensor disponga di spazio sufficiente per contenere un file delle dimensioni specificate nel parametro QueueSize.
    3. Con il pannello di controllo Servizi in Windows, arrestare il trasmettitore.
    4. Eliminare il file della coda.
    5. Registrare nuovamente il sensore come servizio Windows: dal menu Start in Windows, selezionate Accessori > Prompt dei comandi. Nella finestra del prompt dei comandi, andate alla directory in cui avete installato Sensor ed eseguite il seguente comando:
      txlog /regserver
      
      
Il trasmettitore è progettato per funzionare in modo continuo. Se si riavvia il computer, il trasmettitore si riavvia automaticamente. Se è necessario avviare e arrestare manualmente il trasmettitore, è possibile farlo utilizzando il pannello di controllo Servizi in Windows.

Aggiungere l'agente di raccolta al server Web

Per i server JBoss, l'agente di raccolta funziona come un filtro nel contenitore servlet.
Per aggiungere l’agente di raccolta al server Web, è necessario modificare il web.xml file come descritto di seguito e riavviare l’applicazione Web.
  1. Utilizzando un editor di testo, aprite il web.xml file per il server Web i cui eventi Sensor acquisisce.
  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 il processo del server Web (non è necessario riavviare l'intero computer del server, ma è sufficiente riavviare il processo del server Web). L'agente di raccolta viene caricato con il server Web e inizia a raccogliere i dati dell'evento e a scriverli nella coda del disco.

Modifica del percorso della libreria Java

Istruzioni per l'aggiunta di visual_sciences.dll al percorso della libreria Tomcat java.
  1. Nel server Windows, andate alla directory di installazione Tomcat. (Tomcat > bin)
  2. In cartella bin, eseguire Tomcat9w.exe (comune gestore di servizi daemon).
    Nella scheda Java, in Opzioni Java, aggiungere una nuova riga:
    -Djava.library.path=C:\Sensor directory
    
    
    Dove la C:\Sensor directory è la directory contenente il visual_sciences.dll file.

Acquisizione di dati aggiuntivi

È possibile acquisire dati di misurazione aggiuntivi dalle applicazioni Web basate su J2EE utilizzando la funzionalità appendToLog().
  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.