Mehr über die Data Workbench Mitteilung zum Ende der Nutzungsdauer.
Detaillierte Anweisungen zum Installieren und Konfigurieren von Sensor für JBoss Server 4.0.5 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.
Zu den unterstützten J2EE-Implementierungen gehören:
Um Sensor zu installieren und zu konfigurieren, müssen Sie die folgenden Schritte ausführen:
Verfahren zum Extrahieren und Installieren der Programmdateien für Sensor.
Erstellen Sie auf Ihrem JBoss-Server einen Ordner, in dem die Dateien des Sensor-Programms installiert werden sollen. Beachten Sie, dass sich Ihre Datenträgerwarteschlange in diesem Verzeichnis befindet. Stellen Sie daher sicher, dass das gewählte Gerät über ausreichend Speicherplatz verfügt, um eine Warteschlange der benötigten Größe zu speichern.
C:\VisualSensor
Extrahieren Sie den Inhalt der Installationsdatei in das soeben erstellte Verzeichnis. Während dieses Schritts installiert Sensor die folgenden Dateien:
Datei | Beschreibung | Zielverzeichnis |
---|---|---|
mod_visual_sciences.so | Das Wächter-Lademodul. | IBMHttpServer/modules |
txlogd |
Das Transmitter-Programm. | /usr/local/bin --OR-- /usr/local/sbin |
txlogd.conf | Die Konfigurationsdatei für Sensor. | /etc |
trust_ca_cert.pem | Das Zertifikat, das zum Überprüfen des digitalen Zertifikats verwendet wird, das Insight Server während des Verbindungsprozesses präsentiert | /usr/local/visual_sciences |
Das Installationspaket enthält eine Tabellendatei mit dem Namen TestExperiment.xls. Diese Tabelle ist ein Tool, mit dem Architekten ein gesteuertes Experiment konfigurieren. Sensor selbst verwendet diese Datei nicht, daher ist es nicht notwendig, die Datei auf dem Computer zu installieren, auf dem Sensor ausgeführt wird (obwohl Sie dies tun können). Sie können die Datei stattdessen an einen Speicherort kopieren, an dem Ihre Architekten darauf zugreifen können, oder einfach die Datei aus dem Installationspaket extrahieren. Weitere Informationen zu kontrollierten Experimenten finden Sie im Leitfaden zu kontrollierten Experimenten mit Insight.
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.
Bearbeiten der Sensorkonfigurationsdatei
Bearbeiten der Sensorkonfigurationsdatei
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.
Wählen Sie unter Windows im Menü Start die Option Zubehör > Eingabeaufforderung aus.
Navigieren Sie im Eingabeaufforderungsfenster 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 Festplattenwarteschlange und registriert Sensor als Windows-Dienst.
Um sicherzustellen, dass der Transmitter ordnungsgemäß ausgeführt wird, klicken Sie auf Start > Systemsteuerung > Verwaltung > Dienste.
Diese Befehlssequenz variiert je nach verwendeter Windows-Version.
Um zu überprüfen, ob Transmitter beim Start Fehler erhalten hat, klicken Sie auf Start > Systemsteuerung > Verwaltung > Ereignis-Viewer , um die Ereignisanzeige zu öffnen.
Wenn Sie die Prüfung des Anwendungsprotokolls abgeschlossen haben, schließen Sie die Ereignisanzeige.
Stellen Sie sicher, dass der Transmitter die Festplattenwarteschlange (Diskq2000.log) in dem Verzeichnis erstellt hat, in dem Sie die Dateien des Sensor-Programms installiert haben, und dass es sich um die Größe handelt, die Sie im Parameter QueueSize in der Datei txlogd.conf angegeben haben.
Wenn die Warteschlange nicht korrekt erstellt wurde:
Überprüfen Sie die Datei txtlogd.conf und überprüfen Sie, ob der Parameter QueueSize richtig eingestellt ist.
Vergewissern Sie sich, dass auf dem Gerät, auf dem Sie Sensor installiert haben, ausreichend Speicherplatz für eine Datei zur Verfügung steht, die der im Parameter QueueSize angegebenen Größe entspricht.
Beenden Sie den Transmitter über das Bedienfeld Dienste in Windows.
Löschen Sie die Warteschlangendatei.
Registrieren Sie Sensor als Windows-Dienst erneut: Wählen Sie unter Windows im Menü Start die Option Zubehör > Eingabeaufforderung aus. Navigieren Sie im Eingabeaufforderungsfenster zum Ordner, in dem Sie Sensor installiert haben, und führen Sie den folgenden Befehl aus:
txlog /regserver
Der Transmitter ist für eine kontinuierliche Ausführung 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 die Systemsteuerung Dienste in Windows tun.
Bei JBoss-Servern fungiert der Kollektor als Filter im Servlet-Container.
Um den Wächter zu Ihrem Webserver hinzuzufügen, müssen Sie die web.xml wie unten beschrieben und starten Sie Ihre Webanwendung neu.
Öffnen Sie mithilfe eines Texteditors die web.xml Datei für den Webserver, dessen Ereignisse Sensor erfasst.
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>
Bei diesen Zeilen wird zwischen Groß- und Kleinschreibung unterschieden. Geben Sie sie genau so ein, wie sie oben angezeigt werden.
Starten Sie den Webserver-Prozess neu (Sie müssen nicht den gesamten Server neu starten, sondern einfach den Webserver-Prozess neu starten). Der Kollektor wird mit dem Webserver geladen und fängt an, Ereignisdaten zu erfassen und in die Datenträgerwarteschlange zu schreiben.
Bevor Sie das Startskript ändern, stellen Sie sicher, dass die Variable JAVA_HOME in der Windows-Umgebung definiert ist.
Im run.bat -Datei (z. B. C:\jboss-4.0.5.GA\bin\run.bat) die folgenden Zeilen am Ende der Datei direkt vor den "echo"-Zeilen hinzufügen, die dem Startbefehl des JBoss-Servers vorangehen:
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
Mit der Funktion appendToLog() können Sie zusätzliche Messdaten aus J2EE-basierten Webanwendungen erfassen.
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" %>
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.
Wiederholen Sie dieses Verfahren für jede JSP-Seite, von der Sie zusätzliche Daten erfassen möchten.