Show Menu
THEMEN×

Microsoft IIS unter Windows Server 2000 oder höher

Anleitung zum Installieren und Konfigurieren von Sensor for Internet Information Services (IIS) 5.x oder 6.x unter Microsoft Windows Server 2000 oder höher.
Bei Verwendung von IIS 6.x muss die Protokollierung aktiviert sein, damit Sensor ordnungsgemäß funktioniert. Wenn Sie die Protokollierung deaktiviert haben, um die CD/A-ROM zu reduzieren, können Sie die Protokollierung aktivieren, ohne Daten in die Protokolle zu schreiben. Aktivieren Sie dazu die Protokollierung und löschen Sie dann alle Felder auf der Registerkarte Erweitert der Eigenschaften für das W3C-erweiterte Protokolldateiformat. Wenden Sie sich bei Bedarf an den Adobe Consulting Services.
Die Programmdateien für Sensor werden in einer Installationsdatei verpackt, die Sie von der Adobe-Downloadseite erhalten. Wenn Sie noch nicht über die Sensor-Installationsdatei für Ihren jeweiligen Webserver verfügen, laden Sie diese herunter (oder rufen Sie sie von Ihrem Adobe-Kundenbetreuer ab), bevor Sie die folgenden Schritte durchführen.
Um Sensor zu installieren und zu konfigurieren, müssen Sie die folgenden Schritte auf hoher Ebene ausführen:

1. Programmdateien installieren

Beim Ausführen von Sensor unter Windows IIS müssen sich die Programmdateien und die Datei mit der Datenträgerwarteschlange im selben Ordner befinden.
Daher müssen Sie vor der Installation der Programmdateien festlegen, wo Sie die Datenträgerwarteschlange unterhalten möchten, da dort auch die Programmdateien installiert werden müssen.
Verwenden Sie das folgende Verfahren, um die Programmdateien für Sensor zu extrahieren und zu installieren.
  1. Erstellen Sie auf Ihrem Windows-Computer einen Ordner, in dem die Dateien des Sensor-Programms installiert werden sollen. Denken Sie daran, dass sich Ihre Disk-Warteschlange auch in diesem Verzeichnis befindet. Stellen Sie daher sicher, dass das gewählte Gerät über ausreichend Platz verfügt, um eine Warteschlange von der benötigten Größe zu halten.
    Beispiel: C:\VisualSensor
  2. Extrahieren Sie den Inhalt der Installationsdatei in den soeben erstellten Ordner. Während dieses Schritts installiert Sensor die folgenden Dateien:
Datei Beschreibung
EventMessages.dll Ereignis-Viewer-Nachrichten.
qlog.dll Das Sammlermodul (ISAPI-Filter).
TestExperiment.xls
Eine Excel-Tabellenkalkulationsdatei, die Architekten zum Konfigurieren eines kontrollierten Experiments verwenden können.
Sensor verwendet diese Datei nicht.
trust_ca_cert.pem Das Zertifikat, das zum Überprüfen des digitalen Zertifikats verwendet wird, das Insight Server während des Verbindungsprozesses anzeigt.
TXLog.exe Das Transmitterprogramm.
txlogd.conf Die Konfigurationsdatei für den Sensor.
Das Installationspaket enthält eine Tabellendatei mit dem Namen TestExperiment.xls. Diese Tabelle ist ein Tool, mit dem Architekten ein kontrolliertes Experiment konfigurieren können. Sensor selbst verwendet diese Datei nicht, daher ist es nicht notwendig, die Datei auf dem Computer zu installieren, auf dem Sensor läuft (obwohl Sie dies auch tun können). Sie sollten stattdessen die Datei an einen Speicherort kopieren, an dem Ihre Architekten darauf zugreifen oder die Datei nach Bedarf einfach aus dem Installationspaket extrahieren können. Weitere Informationen zum kontrollierten Experimentieren finden Sie im Insight Controlled Experiments Guide.

2. Konfigurationsdatei bearbeiten

Die Datei "txlogd.conf"enthält die Konfigurationsparameter für Sensor.
Sie müssen die Datei bearbeiten, um unter anderem die Größe der Disk-Warteschlange, die Adresse des Insight-Servers und die ID anzugeben, die an die von diesem Sensor erzeugten Daten angehängt wird. Die Konfigurationsdatei enthält die erforderlichen Parameter und optionalen Parameter.
  • Erforderliche Parameter sind Einstellungen, die Sie bei der Installation von Sensor angeben müssen. Ohne diese Einstellungen wird Sensor nicht erfolgreich ausgeführt.
  • Optionale Parameter sind Einstellungen, die standardmäßig auf vordefinierte Werte (die Sie ändern können) oder optionale Funktionen angewendet werden.
So bearbeiten Sie die Konfigurationsdatei des Sensors
  1. Öffnen Sie die <SensorDirectory>/txlogd.conf Datei in einem Texteditor und legen Sie die erforderlichen Parameter sowie die gewünschten optionalen Parameter fest.
    Beschreibungen der Parameter txlogd.conf finden Sie unter Sensor Txlogd.conf-Dateiparameter.
    Beispiele abgeschlossener Konfigurationsdateien finden Sie unter Beispielkonfigurationsdateien für Sensor.
  2. Speichern und schließen Sie die Datei.

3. Starten Sie den Transmitter und erstellen Sie die Disk-Warteschlange

Nachdem Sie die Datei "txlogd.conf"konfiguriert haben, können Sie das Transmitter-Programm starten, es als Windows-Dienst registrieren und die Disk-Warteschlange erstellen.
  1. Wählen Sie unter Windows im Startmenü Zubehör > Eingabeaufforderung.
  2. Navigieren Sie im Fenster mit der Eingabeaufforderung zum Ordner, in dem Sie Sensor installiert haben, und führen Sie den folgenden Befehl aus:
    txlog /regserver
    
    
    Dieser Befehl startet den Transmitter, erstellt die Disk-Warteschlange und registriert Sensor als Windows-Dienst.
  3. Um sicherzustellen, dass der Transmitter ordnungsgemäß ausgeführt wird, klicken Sie auf Start > Systemsteuerung > Verwaltung > Dienste.
    Diese Befehlssequenz kann je nach verwendeter Windows-Version unterschiedlich sein.
    1. Suchen Sie in der Dienstliste den Eintrag für Sensor und vergewissern Sie sich, dass der Status Started und der Starttyp Automatisch ist.
    2. Schließen Sie das Bedienfeld "Dienste".
  4. Um zu überprüfen, ob Transmitter während des Starts Fehler auftraten, klicken Sie auf Start > Systemsteuerung > Verwaltung > Ereignisanzeige, um die Ereignisanzeige zu öffnen.
    Diese Befehlssequenz kann je nach verwendeter Windows-Version unterschiedlich sein.
    1. Wählen Sie im linken Bereich des Fensters "Ereignisanzeige"das Anwendungsprotokoll aus.
    2. Suchen Sie im rechten Bereich nach Ereignissen mit "Adobe"in der Spalte "Quelle".
    3. Wenn Sie eine Fehlermeldung von "Adobe"erhalten, doppelklicken Sie auf den Fehler, um das Fenster "Ereigniseigenschaften"anzuzeigen. Dieses Fenster enthält detaillierte Informationen zum Fehler.
  5. Schließen Sie nach Abschluss der Überprüfung des Anwendungsprotokolls die Ereignisanzeige.
  6. Vergewissern Sie sich, dass der Sender die Disk-Warteschlange (Diskq2000.log) in dem Ordner erstellt hat, in dem Sie die Sensor-Programmdateien installiert haben, und dass diese die Größe hat, die Sie im Parameter QueueSize in der Datei txlogd.conf angegeben haben.
    Wenn die Warteschlange nicht korrekt erstellt wurde:
    1. Überprüfen Sie die Datei "txtlogd.conf"und stellen Sie sicher, dass der Parameter QueueSize korrekt eingestellt ist.
    2. Vergewissern Sie sich, dass auf dem Gerät, auf dem Sie Sensor installiert haben, ausreichend Speicherplatz für eine Datei der im Parameter QueueSize angegebenen Größe zur Verfügung steht.
    3. Beenden Sie den Transmitter über das Bedienfeld "Dienste"in Windows.
    4. Löschen Sie die Warteschlangendatei.
    5. Sensor erneut als Windows-Dienst registrieren: Wählen Sie unter Windows im Startmenü Zubehör > Eingabeaufforderung. Navigieren Sie im Fenster mit der Eingabeaufforderung zum Ordner, in dem Sie Sensor installiert haben, und führen Sie den folgenden Befehl aus:
      txlog /regserver
      
      
Der Transmitter ist für einen kontinuierlichen Betrieb ausgelegt. Wenn Sie den Computer neu starten, wird der Transmitter automatisch neu gestartet. Wenn Sie den Transmitter manuell starten und anhalten müssen, können Sie dies über das Bedienfeld "Dienste"in Windows tun.

Hinzufügen des Sammlers zum Webserver

Bei IIS ist der Collector ein ISAPI-Filter, den Sie Ihrem Webserver in IIS hinzufügen.
  1. Öffnen Sie den IIS Manager mit Start > Verwaltung > Internetinformationsdienste (IIS)-Manager.
  2. Erweitern Sie die Knoten Lokaler Computer und Websites.
  3. Klicken Sie mit der rechten Maustaste auf die Website, der Sie den Collector hinzufügen möchten, und wählen Sie Eigenschaften.
  4. Wählen Sie die Registerkarte ISAPI-Filter und klicken Sie auf Hinzufügen.
  5. Geben Sie im Feld Filtername einen Anzeigenamen für den Filter ein. Der vorgeschlagene Filtername ist "Sensor".
  6. Klicken Sie auf "Durchsuchen", wählen Sie die Datei "qlog.dll"(in dem Ordner, in dem Sie Sensor installiert haben) und klicken Sie auf "OK".
  7. Klicken Sie auf OK, um den Filter hinzuzufügen.
    Nachdem Sie den Filter hinzugefügt haben, ist der Kollektor sofort einsatzbereit und kann Daten erfassen. In der Statusspalte auf der Registerkarte "ISAPI-Filter"des IIS-Managers sollte ein grüner Pfeil nach oben angezeigt werden. Der grüne Pfeil wird möglicherweise erst dann angezeigt, wenn der Traffic tatsächlich durch den Filter fließt. In diesem Fall müssen Sie eine Anforderung an den Webserver senden, um sicherzustellen, dass der Collector ordnungsgemäß funktioniert.
Wenn der grüne Pfeil nach dem Traffic zum Kollektor nicht angezeigt wird, führen Sie die folgenden Schritte aus:
  1. Klicken Sie auf Start > Verwaltung > Ereignis-Viewer, um die Ereignisanzeige auf Fehler zu überprüfen.
    Diese Befehlssequenz kann je nach verwendeter Windows-Version unterschiedlich sein.
  2. Wählen Sie im linken Bereich des Fensters "Ereignisanzeige"das Anwendungsprotokoll aus.
  3. Suchen Sie im rechten Bereich nach Ereignissen mit "Adobe"in der Spalte "Quelle".
  4. Wenn ein Fehler auftritt, doppelklicken Sie auf den Fehler, um das Fenster "Ereigniseigenschaften"anzuzeigen.

Erfassen zusätzlicher Daten

Webseiten werden häufig mithilfe der Programmiersprache ASP (Active Server Pages) strukturiert.
ASP ist eine Microsoft-Technologie, die innerhalb von IIS ausgeführt wird. Wenn ein Browser eine ASP-Datei anfordert, übergibt IIS die Anforderung an die ASP-Engine. Die ASP-Engine liest die ASP-Datei zeilenweise und führt die Skripten in der Datei aus. Schließlich wird die ASP-Datei als einfaches HTML an den Browser zurückgegeben. ASP stellt RESPOND- oder REQUEST-Objekte bereit, die neben anderen Verwendungen auch die Beantwortung oder Anforderung von Benutzerabfragen oder von HTML-Formularen gesendeten Daten ermöglichen.
In bestimmten Fällen möchten Sie die in Formularen eingegebenen Werte möglicherweise nicht an die URL anhängen, die in der Adressleiste des Browsers des Benutzers angezeigt wird oder die im HTML-Code selbst sichtbar ist. Mit einfachem serverseitigen ASP-Skript können Sie Formularfeldnamen und deren entsprechende Werte an die Protokolldatei anhängen, ohne sie im Browser des Benutzers verfügbar zu machen oder in die HTML-Datei einzubetten. Um die tatsächlichen Formularwerte zu erfassen, die in bestimmte Formulare auf Ihrer Website eingegeben wurden, müssen einige Codezeilen hinzugefügt werden, um die Formularwerte an die Protokollanforderung anzuhängen.
Fügen Sie auf der Verarbeitungsseite eines Formulars den folgenden Code hinzu, um die eingegebenen Formularwerte an die Anforderungsdaten anzuhängen (zusätzlich zum Schreiben der gesendeten Formularwerte in eine externe Datenbank oder an einen anderen Speicherort):
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);

Bei diesem Prozess werden die Formularwerte entsprechend der Definition an die Anforderungsdaten für die Formularverarbeitungsseite angehängt. Innerhalb der Protokolldaten stehen die angehängten Werte als Abfragezeichenfolgen der Formularverarbeitungsseite zur Verfügung, wie unten dargestellt. Beispielsweise wären v_1, v_2, v_3 und v_4 nun Abfragezeichenfolgen, die die in die entsprechenden Formularfelder eingegebenen Daten enthalten. Die im vorherigen Beispiel beschriebene Syntax kann für alle zusätzlichen Formularfelder und Werte, die erfasst werden sollen, dupliziert werden:
http://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210

Wenn jedes Formularfeld und jeder Wert erfasst und für die Analyse verfügbar sein sollen, können Sie die folgende Syntax verwenden:
var formvalues = Response.Form; 
Response.AppendToLog(formvalues);

In diesem Beispiel werden alle im HTML vorhandenen Formularfelder zusammen mit ihren jeweiligen Werten als Abfragezeichenfolgen an den Protokolleintrag der Seite "Formularverarbeitung"angehängt. Bitte beachten Sie, dass dies alle ausgeblendeten Felder im Formular einschließen würde.
Die Protokolldaten werden wie in der folgenden Tabelle beschrieben erweitert:
Erfasste Daten
Erklärung
Beispiel
v_1
Mit der Abfragezeichenfolge NAME verknüpfter Wert
v_1=John Smith
v_2
Mit der CITY-Abfragezeichenfolge verknüpfter Wert
v_2=Los Angeles
v_3
Mit der STATE-Abfragezeichenfolge verknüpfter Wert
v_3=Kalifornien
v_4
Mit der ZIP-Abfragezeichenfolge verknüpfter Wert
v_4=90210