IBM HTTP-Server unter AIX 5.1 oder höher

Anweisungen zum Installieren und Konfigurieren des IBM HTTP-Servers unter IBM AIX 5.1 oder höher, der unter Microsoft Windows Server 2000 oder höher ausgeführt wird.

Die Programmdateien für Sensor werden in einer Installationsdatei zusammengefasst, die Sie von der Adobe-Download-Site erhalten. Wenn Sie noch nicht über die Installationsdatei für den Sensor für Ihren Webserver verfügen, laden Sie sie herunter (oder rufen Sie sie von Ihrem Kundenbetreuer ab), bevor Sie mit den folgenden Verfahren beginnen.

Um Sensor zu installieren und zu konfigurieren, müssen Sie die folgenden allgemeinen Schritte ausführen:

Installieren der Programmdateien

Erstellen Sie auf Ihrem IBM AIX-Server einen Ordner, in dem Sie die Programmdateien für Sensor installieren können. Beachten Sie, dass sich Ihre Datenträgerwarteschlange auch in diesem Verzeichnis befindet. Stellen Sie daher sicher, dass das gewählte Gerät über ausreichend Speicherplatz verfügt, um eine Warteschlange mit der benötigten Größe zu speichern.

1. Melden Sie sich als Root-Benutzer oder als Benutzer mit Root-Berechtigung an.

2. Dekomprimieren und entpacken Sie die Installationsdatei mit dem folgenden Befehl:

   tar -zxf installationFilename
   

3. Kopieren Sie die entpackten Programmdateien in die in der folgenden Tabelle angegebenen Verzeichnisse:

Berechtigungen für die Programmdateien

Bearbeiten der Datei für die Sensor-Konfiguration

Die txlogd.conf enthält die Konfigurationsparameter für Sensor.

Sie müssen diese Datei bearbeiten, um unter anderem die Größe und den Speicherort der Warteschlangendatei der Festplatte, die Adresse des Insight-Servers und die ID anzugeben, die an die von diesem Sensor erzeugten Ereignisdaten angehängt werden.

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 vordefinierte Werte enthalten (die Sie ändern können) oder optionale Funktionen aktivieren.

Bearbeiten der Sensorkonfigurationsdatei

• Öffnen Sie die /etc/txlogd.conf in einem Texteditor speichern und die erforderlichen Parameter sowie die gewünschten optionalen Parameter festlegen.
• Speichern und schließen Sie die Datei.

Bearbeiten der Sensorkonfigurationsdatei

1. Öffnen Sie die /etc/txlogd.conf in einem Texteditor speichern und die erforderlichen Parameter sowie die gewünschten optionalen Parameter festlegen.
2. Speichern und schließen Sie die Datei.

Starten Sie den Transmitter und erstellen Sie die Festplattenwarteschlange.

Nachdem Sie die Datei txlogd.conf konfiguriert haben, können Sie das Transmitter-Programm starten, sie als Windows-Dienst registrieren und die Disk-Warteschlange erstellen.

1. Wenn der Ordner, in dem sich die Warteschlange befindet, noch nicht vorhanden ist, erstellen Sie ihn. Stellen Sie sicher, dass der Ordner sowohl dem Collector-Modul als auch dem Transmitter-Programm Lese-/Schreibzugriff auf die Datei bietet.

   Weitere Informationen zu den Berechtigungen, die für die Dateiwarteschlangendateien erforderlich sind, finden Sie unter Berechtigungen für Sensor-UNIX-Dateien .

2. Führen Sie auf dem Computer, auf dem Sensor installiert ist, den folgenden Befehl aus, um den Transmitter zu starten:

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • Die Option "i"in diesem Befehl startet den Transmitter im "interaktiven Modus". Dieser Modus zeigt Transmitter-Nachrichten auf dem Bildschirm an und ermöglicht Ihnen auch die Interaktion mit dem Transmitter mithilfe von Tastaturbefehlen.
   • Die Option "c"weist den Sender an, die Datenträgerwarteschlange zu erstellen.
   • Die Option "f"gibt den Speicherort der Konfigurationsdatei an.

   Weitere Informationen zu den Optionen, die Sie beim Starten des Senders verwenden können, finden Sie unter Befehlszeilenoptionen für Sensor-Transmitter .

3. Stellen Sie sicher, dass der Transmitter die Festplattenwarteschlange an dem im Parameter QueueFile angegebenen Speicherort und der im Parameter QueueSize angegebenen Größe erstellt hat.

4. Wenn die Warteschlange nicht korrekt erstellt wurde, drücken Sie Strg+C, um den Transmitter zu beenden, und führen Sie dann die folgenden Schritte aus:

   1. Überprüfen Sie die Datei txtlogd.conf und überprüfen Sie, ob die Parameter QueueFile und QueueSize richtig eingestellt sind.
   2. Überprüfen Sie, ob das Gerät, dem die Festplattenwarteschlange zugewiesen ist, betriebsbereit ist und über ausreichend Speicherplatz verfügt, um eine Datei mit der im Parameter QueueSize angegebenen Größe zu speichern.
   3. Nehmen Sie die notwendigen Korrekturen vor und wiederholen Sie diesen Vorgang.

Hinzufügen des Sammlers zur Webanwendung

Bei WebSphere-Servern fungiert der Kollektor als Filter im Servlet-Container.

Um den Wächter zu Ihrer Web-App hinzuzufügen, öffnen Sie die Datei web.xml für den Webserver, dessen Ereignisse Sensor erfasst.

Wenn Sensor Daten für mehrere Webserver auf dem Servercomputer erfasst, müssen Sie für jeden Webserver das folgende Verfahren durchführen.

1. Öffnen Sie mithilfe eines Texteditors die Datei "httpd.conf"für den Webserver, dessen Ereignisse Sensor erfasst.

2. Fügen Sie Folgendes hinzu: <filter> und <filter-mapping> -Elemente in die Deskriptordatei ein. Wenn Sie txlogd.conf nicht im Verzeichnis /etc installiert haben, müssen Sie den richtigen Pfad zu dieser Datei im <param-value> -Element.

   <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>
   

   HINWEIS

   Bei diesen Zeilen wird zwischen Groß- und Kleinschreibung unterschieden. Geben Sie sie genau so ein, wie sie oben angezeigt werden.

3. Starten Sie die Webanwendung neu. Der Kollektor wird mit der Anwendung geladen und beginnt mit der Erfassung von Ereignisdaten und dem Schreiben in die Datenträgerwarteschlange.

Speicherort der Sammlungs- und freigegebenen Objektdateien deklarieren

Bearbeiten Sie das Websphere-Startskript, um den Speicherort der Dateien J2EECollector.jar und libvisual_sciences.so zu deklarieren.

1. Öffnen Sie die Datei setupCmdLine.sh im Ordner Websphere /bin .

2. Fügen Sie nach der Zeile, die die Variable $WAS_CLASSPATH definiert, die folgende Zeile hinzu:

   WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
   

3. Fügen Sie nach dem Fallblock, der die Variable $WAS_LIBPATH definiert, die folgende Zeile hinzu:

   WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
   

4. Speichern Sie die Datei setupCmdLine.sh .

Testen des Sensors

Vergewissern Sie sich, dass der Sammler Ereignisdaten erfasst und der Sender sie an den Ziel-Insight Server sendet.

1. Wenn der Transmitter noch nicht ausgeführt wird, starten Sie ihn mit dem folgenden Befehl neu:

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf
   

2. Öffnen Sie einen Browser (auf einem beliebigen Computer) und fordern Sie eine Seite vom Webserver an, auf dem Sensor ausgeführt wird (wählen Sie unbedingt eine Seite aus, die von Sensor überwacht wird).

3. Nachdem Sie die Anforderung ausgegeben haben, überprüfen Sie die Konsole des Senders auf Meldungen, die darauf hinweisen, dass Ereignisdaten an den Ziel-Insight Server gesendet werden.

4. Wenn Sensor Daten nicht erfolgreich übermittelt, überprüfen Sie, ob:

   • Der Insight Server-Zielserver wird ausgeführt.
   • Die Parameter ServerAddress und ServerPort werden in txtlogd.conf korrekt festgelegt. Wenn Sie "ServerAddress"mit einem Servernamen angegeben haben, versuchen Sie stattdessen, die zugehörige numerische IP-Adresse zu verwenden.
   • Der Wert des CertName-Parameters entspricht dem allgemeinen Namen, der im digitalen Zertifikat des Ziel-Insight-Servers exakt angezeigt wird.

Hinzufügen des Transmitters zum Systemstartskript

Informationen zum automatischen Laden des Senders in Ihr System-Startskript.

Um sicherzustellen, dass der Transmitter beim Neustart des Webserver-Computers automatisch geladen wird, fügen Sie den folgenden Befehl (der den Transmitter startet) zu Ihrem Systemstartskript hinzu:

/usr/local/bin/txlogd -f /etc/txlogd.conf

Dieser Befehl startet den Transmitter als Daemon. Vom Transmitter generierte Betriebs- und Fehlermeldungen werden in syslog geschrieben.

Erfassen zusätzlicher Daten

Sensoren für alle Plattformen können alle Daten erfassen, die in den HTTP-Anforderungs- und Antwortheadern verfügbar sind.

Die Sensoren für die J2EE-Plattform bieten einen Mechanismus zum Erfassen von Daten, die auf anderen Plattformen nicht verfügbar sind. Der Kollektor für die J2EE-Plattform (J2EE Collector) befindet sich auf der Anwendungsebene, wodurch er sensible Daten erfassen kann, die nur für die Anwendung verfügbar sind und nicht über Seiten-Tagging oder in den Kopfzeilen verfügbar gemacht werden sollten.

Beispielsweise kann der J2EE-Sammler zur Erfassung von CPC-Daten (Cost per Click) für Links verwendet werden, die auf einer Seite angezeigt werden, sowie für vertrauliche Partnerinformationen auf einer Seite und viele andere Datenpunkte. Die J2EE-Umgebung erleichtert es Ihnen, Ihre WEBAPP zu ändern, um diese benutzerdefinierten Daten mithilfe unserer Sammlerklasse zu erfassen.

Wenn ein Sensor für die J2EE-Plattform eine Anforderung erhält, ruft er eine Sammlerklasse auf, die die Funktion appendToLog importiert. Die Funktion appendToLog hängt an die ursprüngliche Anfrage die in der Funktion appendToLog angegebenen Abfragezeichenfolgenparameter an. Dies führt zur URI der ursprünglichen Anfrage, die zusätzliche Name-Wert-Paare der Abfragezeichenfolge enthält, die den Namen und Werten der erfassten Daten entsprechen. Beispielsweise würde CPC=20 an die ursprüngliche Anfrage angehängt, wenn der Wert einer bestimmten Anzeigenplatzierung oder eines Clickthrough-Links 20 Cent beträgt. Insight Server verarbeitet diese Werte zur Analyse in den Datensatz. Ein weiterer Vorteil dieser Erfassungsmethodik besteht darin, dass sie die Erfassung zusätzlicher Daten ermöglicht, ohne zusätzliche Protokolleinträge zu erstellen, wie dies möglicherweise mithilfe von Methoden zum Taggen von Seiten möglich ist.

Weitere Informationen zur Verarbeitung finden Sie im Handbuch zur Datensatzkonfiguration .

So erfassen Sie zusätzliche Daten von einer Seite:

1. Fügen Sie oben auf der JSP-Seite, von der Sie Daten erfassen möchten, den folgenden Code hinzu:

   <%@ page import="com.visualsciences.collector.VSCollector" %>
   

2. Verwenden Sie die Methode appendToLog() des Collector-Objekts, um die gewünschten Name-Wert-Paare an die Abfragezeichenfolge der angeforderten .jsp-Seite anzuhängen. Im folgenden Beispiel werden "A=1"und "B=2"an die Abfragezeichenfolge der angeforderten .jsp-Seite für die Seite /index.jsp angehängt:

   <html>
   <body>
     <h1>Hello World</h1>
     <%
       VSCollector collector = new VSCollector(request, response);
       collector.appendToLog("A", "1");
       collector.appendToLog("B", "2");
     %>
   </body>
   </html>
   

   Der resultierende Anfrage-URI lautet /index.jsp?A=1&B=2.

3. Wiederholen Sie dieses Verfahren für jede JSP-Seite, von der Sie zusätzliche Daten erfassen möchten.