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:
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.
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
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. |
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.
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.
Per modificare il file di configurazione Sensor
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 .
Salva e chiudi il file.
Dopo aver configurato il file txlogd.conf, è possibile avviare il programma del trasmettitore, registrarlo come servizio Windows e creare la coda del disco.
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
Questo comando avvia il trasmettitore, crea la coda del disco e registra Sensor come servizio Windows.
Per confermare che il trasmettitore è in esecuzione correttamente, fai clic su Start > Pannello di controllo Campaign > Strumenti di amministrazione > Servizi.
Questa sequenza di comandi può variare a seconda della versione di Windows in uso.
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.
Questa sequenza di comandi può variare a seconda della versione di Windows in uso.
Al termine dell'esame del registro Applicazioni, chiudere il Visualizzatore eventi.
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:
Esamina il file txtlogd.conf e verifica che il parametro QueueSize sia impostato correttamente.
Verificare che il dispositivo su cui è installato Sensor disponga di spazio sufficiente per contenere un file delle dimensioni specificate nel parametro QueueSize.
Utilizzando il pannello di controllo Servizi in Windows, arrestare il trasmettitore.
Elimina il file della coda.
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.
Per IIS, il raccoglitore è un filtro ISAPI aggiunto al server Web in IIS.
Apri IIS Manager utilizzando Start > Strumenti di amministrazione > Gestione Internet Information Services (IIS).
Espandere i nodi Computer locale e Siti Web.
Fare clic con il pulsante destro del mouse sul sito Web a cui si desidera aggiungere il raccoglitore e selezionare Proprietà.
Seleziona la scheda Filtri ISAPI e fai clic su Aggiungi.
Nel campo Nome filtro , immetti un nome visualizzato per il filtro. Il nome del filtro suggerito è "Sensor".
Fare clic su Sfoglia, selezionare il file qlog.dll (che si trova nella directory in cui è stato installato Sensor), quindi fare clic su OK.
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:
Fai clic su Start > Strumenti di amministrazione > Visualizzatore eventi per verificare la presenza di errori nel Visualizzatore eventi.
Questa sequenza di comandi può variare a seconda della versione di Windows in uso.
Nel riquadro a sinistra della finestra Visualizzatore eventi selezionare il registro applicazioni.
Nel riquadro a destra, cerca gli eventi con "Adobe" nella colonna Origine.
Se si verifica un errore, fare doppio clic sull'errore per visualizzare la finestra Proprietà evento.
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 |