Microsoft IIS su Windows Server 2000 o versione successiva

Istruzioni su come installare e configurare Sensor for Internet Information Services (IIS) 5.x o 6.x in esecuzione in Microsoft Windows Server 2000 o versione successiva.

Quando si utilizza IIS 6.x, la registrazione deve essere abilitata perché il sensore funzioni correttamente. Se la registrazione è stata disabilitata per ridurre l'I/O del disco, è possibile abilitare la registrazione senza scrivere alcun dato nei registri. Per farlo, abilita la registrazione, quindi cancella tutti i campi nella scheda Avanzate delle Proprietà per il formato W3C Extended Log File. Se hai bisogno di assistenza, contatta Adobe Consulting Services.

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.

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

1. Installare i file del programma

Quando si esegue Sensor su Windows IIS, i file del programma e il file della coda del disco devono trovarsi nella stessa directory.

Pertanto, prima di installare i file del programma, è necessario determinare dove si desidera mantenere la coda del disco, perché è anche in questo caso che è necessario installare i file del programma.

Segui la procedura seguente per estrarre e installare i file di programma per Sensor.

  1. Sul computer Windows, creare una directory in cui installare i file del programma Sensor. Tenere presente che la coda del disco si trova anche in questa directory, quindi assicurarsi che il dispositivo scelto abbia spazio sufficiente per contenere una coda delle dimensioni necessarie.

    Ad esempio: C:\VisualSensor

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

File Descrizione
EventMessages.dll Messaggi del Visualizzatore eventi.
qlog.dll Il modulo di raccolta (un filtro ISAPI).
TestExperiment.xls

File di foglio di calcolo Excel che gli architetti possono utilizzare per configurare un esperimento controllato.

Il sensore non utilizza questo file.

trust_ca_cert.pem Certificato utilizzato per convalidare il certificato digitale presentato da Insight Server durante il processo di connessione.
TXLog.exe Il programma del trasmettitore.
txlogd.conf Il file di configurazione Sensor.
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 è 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.

2. Modifica il file di configurazione

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 Sensor

  1. Apri il file <SensorDirectory>/txlogd.conf in un editor di testo e imposta i parametri richiesti ed eventuali parametri facoltativi desiderati.

    Per una descrizione dei parametri txlogd.conf, consulta Parametri del file Sensor Txlogd.conf .

    Per esempi di file di configurazione completati, consulta File di configurazione di esempio del sensore .

  2. Salva e chiudi il file.

3. Avvia il trasmettitore e crea 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.

    NOTA

    Questa sequenza di comandi può variare a seconda della versione di Windows in uso.

    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 IIS, il raccoglitore è un filtro ISAPI aggiunto al server Web in IIS.

  1. Apri IIS Manager utilizzando Start > Strumenti di amministrazione > Gestione Internet Information Services (IIS).

  2. Espandere i nodi Computer locale e Siti Web.

  3. Fare clic con il pulsante destro del mouse sul sito Web a cui si desidera aggiungere il raccoglitore e selezionare Proprietà.

  4. Seleziona la scheda Filtri ISAPI e fai clic su Aggiungi.

  5. Nel campo Nome filtro , immetti un nome visualizzato per il filtro. Il nome del filtro suggerito è "Sensor".

  6. Fare clic su Sfoglia, selezionare il file qlog.dll (che si trova nella directory in cui è stato installato Sensor), quindi fare clic su OK.

  7. Fai clic su OK per aggiungere il filtro.

    Dopo aver aggiunto il filtro, il raccoglitore è immediatamente operativo e pronto per raccogliere i dati. Nella colonna Stato della scheda Filtri ISAPI di IIS Manager deve essere visualizzata una freccia verso l'alto verde. È possibile che la freccia verde non venga visualizzata finché il traffico non scorre effettivamente attraverso il filtro. In questo caso, è necessario inviare una richiesta al server web per confermare che il servizio di raccolta funziona correttamente.

Se la freccia verde non viene visualizzata dopo il flusso del traffico verso il raccoglitore, completa i seguenti passaggi:

  1. Fai clic su Start > Strumenti di amministrazione > Visualizzatore eventi per verificare la presenza di errori nel Visualizzatore eventi.

    NOTA

    Questa sequenza di comandi può variare a seconda della versione di Windows in uso.

  2. Nel riquadro a sinistra della finestra Visualizzatore eventi selezionare il registro applicazioni.

  3. Nel riquadro a destra, cerca gli eventi con "Adobe" nella colonna Origine.

  4. Se si verifica un errore, fare doppio clic sull'errore per visualizzare la finestra Proprietà evento.

Acquisizione di dati aggiuntivi

Le pagine web sono spesso strutturate utilizzando il linguaggio di programmazione ASP (Active Server Pages).

ASP è una tecnologia Microsoft in esecuzione in IIS. Quando un browser richiede un file ASP, IIS passa la richiesta al motore ASP. Il motore ASP legge il file ASP, riga per riga ed esegue gli script nel file. Infine, il file ASP viene restituito al browser come HTML normale. ASP fornisce oggetti RESPOND o REQUEST che, oltre ad altre utilità, consentono la risposta o la richiesta di query utente o dati inviati da moduli HTML.

In alcuni casi, è possibile che non si desideri aggiungere i valori immessi nei moduli all’URL visualizzato nella barra degli indirizzi del browser di un utente o visualizzabile all’interno del codice HTML stesso. Uno script ASP semplice lato server consente di aggiungere al file di registro i nomi dei campi del modulo e i relativi valori senza renderli disponibili nel browser dell’utente o incorporarli nel file HTML. Per acquisire i valori effettivi del modulo immessi in particolari moduli all’interno del sito web, è necessario aggiungere alcune righe di codice per aggiungere i valori del modulo alla richiesta di registro.

Nella pagina di elaborazione di un modulo, includere il codice seguente per aggiungere i valori del modulo immesso ai dati della richiesta (oltre a scrivere i valori del modulo inviato in un database esterno o in un altro percorso):

var sName= Request.Form("Name");
var sCity= Request.Form("City");
var sState= Request.Form("State");
var sZip= Request.Form("Zip");

Response.AppendToLog("&v_1=" +  sName);
Response.AppendToLog("&v_2=" +  sCity);
Response.AppendToLog("&v_3=" +  sState);
Response.AppendToLog("&v_4=" +  sZip);

Questo processo aggiunge i valori del modulo come definiti ai dati della richiesta per la pagina Elaborazione del modulo. All’interno dei dati di registro, i valori aggiunti sarebbero disponibili come stringhe di query nella pagina Elaborazione modulo, come illustrato di seguito. Ad esempio, v_1, v_2, v_3 e v_4 sono stringhe di query contenenti i dati immessi nei campi modulo appropriati. La sintassi descritta nell’esempio precedente può essere duplicata per tutti i campi e i valori modulo aggiuntivi che si desidera acquisire:

https://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210

Se si desidera acquisire e rendere disponibili per l’analisi tutti i campi e i valori del modulo, è possibile utilizzare la sintassi seguente:

var formvalues = Response.Form;
Response.AppendToLog(formvalues);

Questo esempio prende tutti i campi modulo presenti all’interno di HTML insieme ai rispettivi valori e li aggiunge come stringhe di query alla voce di registro per la pagina Elaborazione modulo. Tieni presente che questo includerebbe tutti i campi nascosti presenti all’interno del modulo.

I dati del registro vengono aumentati come descritto nella tabella seguente:

Dati raccolti Spiegazione Esempio
v_1 Valore associato alla stringa di query NAME v_1=John Smith
v_2 Valore associato alla stringa di query CITY v_2=Los Angeles
v_3 Valore associato alla stringa di query STATE v_3=California
v_4 Valore associato alla stringa di query ZIP v_4=90210

In questa pagina