Server JBoss su Windows Server 2000 o versione successiva

IMPORTANTE

Ulteriori informazioni su Data Workbench Annuncio di fine vita.

Istruzioni dettagliate per l'installazione e la configurazione di Sensor per JBoss Server 4.0.5 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 disponi già del file di installazione di Sensor per il tuo particolare server web, scaricalo (o ottenerlo dal tuo rappresentante di Adobe) prima di iniziare le seguenti procedure.

Le implementazioni J2EE supportate includono:

  • JBoss Server 4.0.5 o successivo 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 JBoss, crea 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 abbia spazio sufficiente per contenere una coda delle dimensioni necessarie.

    C:\VisualSensor

  2. Estrai il contenuto del file di installazione nella directory appena creata. Durante questo passaggio, Sensor installa i seguenti file:

File Descrizione Target Directory
mod_visual_sciences.so Modulo di caricamento del raccoglitore. IBMHttpServer/modules

txlogd

Il programma del trasmettitore.

/usr/local/bin

—OPPURE—

/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 che gli architetti utilizzano 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 è possibile 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.

Modificare il file di configurazione del sensore

La txlogd.conf il file contiene i parametri di configurazione per Sensor.

È necessario modificare questo file per specificare, tra l’altro, le dimensioni e la posizione del file della coda del disco, l’indirizzo di Insight Server e l’ID che verrà allegato ai dati dell’evento prodotti da questo sensore.

Il file di configurazione contiene i parametri richiesti e i parametri facoltativi.

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

Per modificare il file di configurazione Sensor

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

Per modificare il file di configurazione Sensor

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

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

  1. Dal menu Start in Windows, selezionare Accessori > Prompt dei comandi.

  2. Nella finestra del prompt dei comandi, passare alla directory in cui è stato installato Sensor ed eseguire 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 è in esecuzione correttamente, fai clic su Start > Pannello di controllo Campaign > Strumenti di amministrazione > Servizi.

    NOTA

    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 che il suo tipo di avvio è Automatico.
    2. Chiudere il pannello di controllo Servizi.

  4. Per verificare se il trasmettitore ha riscontrato errori durante l'avvio, fai clic su Start > Pannello di controllo Campaign > Strumenti di amministrazione > Visualizzatore eventi per aprire il Visualizzatore eventi.

    1. Nel riquadro a sinistra della finestra Visualizzatore eventi selezionare il registro Applicazioni.
    2. Nel riquadro a destra, cerca gli eventi con "Adobe" nella colonna Origine.
    3. Se si trova un errore da "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, chiudere 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. Esamina il file txtlogd.conf e verifica 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. Utilizzando il pannello di controllo Servizi in Windows, arrestare il trasmettitore.

    4. Elimina il file della coda.

    5. Registra nuovamente Sensor come servizio Windows: dal menu Start in Windows, selezionare Accessori > Prompt dei comandi. Nella finestra del prompt dei comandi, passare alla directory in cui è stato installato Sensor ed eseguire il seguente comando:

      txlog /regserver

Il trasmettitore è progettato per funzionare continuamente. Se si riavvia il computer, il trasmettitore si riavvia automaticamente. Se è necessario avviare e arrestare il trasmettitore manualmente, è possibile farlo utilizzando il pannello di controllo Servizi di Windows.

Aggiungere l'agente di raccolta al server Web

Per i server JBoss, il raccoglitore funziona come filtro nel contenitore servlet.

Per aggiungere il raccoglitore al server web, devi modificare il web.xml come descritto di seguito e riavvia l'applicazione web.

  1. Utilizzando un editor di testo, apri le web.xml file per il server web i cui eventi acquisisce 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. Riavviare il processo del server Web (non è necessario riavviare l'intero computer server, è sufficiente riavviare il processo del server Web). Il raccoglitore viene caricato con il server Web e inizia a raccogliere i dati dell'evento e a scriverli nella coda del disco.

Modificare lo script di avvio

Prima di modificare lo script di avvio, assicurati che la variabile JAVA_HOME sia definita nell’ambiente Windows.

In run.bat file (ad esempio, C:\jboss-4.0.5.GA\bin\run.bat), aggiungi le seguenti righe vicino alla fine del file poco prima delle righe "echo" che precedono il comando di avvio del server JBoss:

set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;C:\jboss-4.0.5.GA\server\default\lib\javax.servlet.jar;C:\VisualSciences\J2EECollector.jar
set JAVA_OPTS=%JAVA_OPTS% -Djava.library.path=C:\VisualSciences

Acquisizione di dati aggiuntivi

È possibile acquisire dati di misurazione aggiuntivi da applicazioni web basate su J2EE utilizzando la funzionalità appendToLog() .

  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