JBoss-Server unter Windows Server 2000 oder höher

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:

• JBoss Server 4.0.5 oder höher, der auf Microsoft Windows Server 2000 oder höher ausgeführt wird.

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

Installieren der Programmdateien

Verfahren zum Extrahieren und Installieren der Programmdateien für Sensor.

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

2. Extrahieren Sie den Inhalt der Installationsdatei in das soeben erstellte Verzeichnis. Während dieses Schritts installiert Sensor die folgenden Dateien:

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. Wählen Sie unter Windows im Menü Start die Option Zubehör > Eingabeaufforderung aus.

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

3. Um sicherzustellen, dass der Transmitter ordnungsgemäß ausgeführt wird, klicken Sie auf Start > Systemsteuerung > Verwaltung > Dienste.

   HINWEIS

   Diese Befehlssequenz variiert je nach verwendeter Windows-Version.

   1. Suchen Sie in der Dienstliste den Eintrag für Sensor und bestätigen Sie, dass sein Status Gestartet und sein Starttyp Automatisch lautet.
   2. Schließen Sie die Systemsteuerung "Dienste".

4. Um zu überprüfen, ob Transmitter beim Start Fehler erhalten hat, klicken Sie auf Start > Systemsteuerung > Verwaltung > Ereignis-Viewer , um die Ereignisanzeige zu öffnen.

   1. Wählen Sie im linken Bereich des Fensters Ereignis-Viewer das Protokoll Anwendungen aus.
   2. Suchen Sie im rechten Bereich nach Ereignissen mit "Adobe"in der Quellspalte.
   3. Doppelklicken Sie auf die Fehlermeldung "Adobe", um das Fenster Ereigniseigenschaften anzuzeigen. In diesem Fenster erhalten Sie detaillierte Informationen zum Fehler.

5. Wenn Sie die Prüfung des Anwendungsprotokolls abgeschlossen haben, schließen Sie die Ereignisanzeige.

6. 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:

   1. Überprüfen Sie die Datei txtlogd.conf und überprüfen Sie, ob der Parameter QueueSize richtig eingestellt ist.

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

   3. Beenden Sie den Transmitter über das Bedienfeld Dienste in Windows.

   4. Löschen Sie die Warteschlangendatei.

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

Hinzufügen des Sammlers zum Webserver

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.

1. Öffnen Sie mithilfe eines Texteditors die web.xml Datei 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 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.

Ändern des Startskripts

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

Erfassen zusätzlicher Daten

Mit der Funktion appendToLog() können Sie zusätzliche Messdaten aus J2EE-basierten Webanwendungen erfassen.

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.