Show Menu
THEMEN×

WebSphere unter AIX

Detaillierte Anweisungen zum Installieren und Konfigurieren von Sensor für WebSphere 5.x unter AIX 5.1 oder höher.
Die Programmdateien für Sensor werden in einer Installationsdatei gepackt, die Sie von der Adobe-Download-Site erhalten. Wenn Sie noch nicht über die Sensor Installationsdatei für den jeweiligen Webserver verfügen, laden Sie diese herunter (oder rufen Sie sie von Ihrem Adobe-Kundenbetreuer ab), bevor Sie die folgenden Schritte durchführen.
Die Sensor für WebSphere-Server unterstützen keine kontrollierte Experimentierung. Weitere Informationen zur kontrollierten Experimentierung finden Sie im Handbuch Data Workbench Controlled Experiments.

Programmdateien installieren

Verfahren zum Extrahieren und Installieren der Programmdateien für Sensor auf dem Servercomputer.
  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:
    gunzip installationFilename.tar.gz 
    tar -xf installationFilename.tar
    
    
  3. Kopieren Sie die entpackten Programmdateien in die in der folgenden Tabelle angegebenen Ordner:
Datei Beschreibung Zielverzeichnis
libvisual_sciences.so Sammlerlastmodul /usr/local/visual_sciences
J2EECollector.jar Bibliotheken des Sammlerladungs-Moduls WebSphere/lib-Ordner
txlogd Das Transmitterprogramm
/usr/local/bin
--ODER--
/usr/local/sbin
txlogd.conf Die Konfigurationsdatei des Sensors /etc
trust_ca_cert.pem Das Zertifikat, mit dem das digitale Zertifikat validiert 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 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 ausgeführt wird (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.
Berechtigungen in den Programmdateien
Falsche Berechtigungen für die Programmdateien verursachen die meisten Probleme bei der Installation von Sensor.
Bitte stellen Sie sicher, dass Sie die Berechtigungen genau wie in diesem Abschnitt angegeben einstellen.
Standardmäßig haben die Programmdateien in der tar-Datei die folgenden Berechtigungen. Je nachdem, wie Ihr System konfiguriert ist, können diese Einstellungen beim Extrahieren der Dateien geändert (nicht maskiert) werden.
Um die Berechtigungen auf die empfohlenen Standardeinstellungen zurückzusetzen, verwenden Sie die folgenden chmod-Befehle.
Vergewissern Sie sich, dass die Ordner, in denen Sie die Dateien installiert haben, mindestens diese Zugriffsebene zulassen.
Datei
Standardberechtigungen
chmod, Befehl
libvisual_sciences.so
rwx —x —x
chmod 711
J2EECollector.jar
rw- rw- r—
chmod 664
txlogd
rwx —x —x
chmod 711
txlogd.conf
rw- rw- r—
chmod 664
trust_ca_cert.pem
rw- rw- r—
chmod 664
Wenn Sie andere als die empfohlenen Standardberechtigungen verwenden möchten, lesen Sie die Informationen in den Sensor-UNIX-Dateiberechtigungen, um sicherzustellen, dass Sie wissen, wie diese Dateien verwendet werden.

Bearbeiten der Datei "Sensor-Konfiguration"

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
  1. Öffnen Sie die Datei /etc/txlogd.conf in einem Texteditor und legen Sie die erforderlichen Parameter sowie die gewünschten optionalen Parameter fest.
  2. Speichern und schließen Sie die Datei.

Starten Sie den Transmitter und erstellen Sie die Disk-Warteschlange

Verfahren zum Erstellen der Disk-Warteschlange, nachdem Sie die Datei "txlogd.conf"konfiguriert haben.
  1. Wenn der Ordner, in dem sich die Disk-Warteschlange befindet, noch nicht vorhanden ist, erstellen Sie ihn. Stellen Sie sicher, dass der Ordner sowohl dem Sammlermodul als auch dem Transmitter-Programm Lese-/Schreibzugriff auf die Datei bietet.
  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 Transmittermeldungen 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.
  3. Überprüfen Sie, ob der Transmitter die Disk-Warteschlange an dem im Parameter QueueFile angegebenen Speicherort und in 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 stellen Sie sicher, dass die Parameter "QueueFile"und "QueueSize"korrekt eingestellt sind.
    2. Vergewissern Sie sich, dass das Gerät, dem die Disk-Warteschlange zugewiesen ist, betriebsbereit ist und über ausreichend Speicherplatz verfügt, um eine Datei der im Parameter QueueSize angegebenen Größe aufzunehmen.
    3. Nehmen Sie alle erforderlichen Korrekturen vor und wiederholen Sie diesen Vorgang.

Hinzufügen des Sammlers zur Webanwendung

Bei WebSphere-Servern fungiert der Collector als Filter im Servlet-Container.
Um den Collector der Webanwendung hinzuzufügen, fügen Sie den Filter dem Web.xml-Bereitstellungsdeskriptor der Webanwendung hinzu und starten Sie die Webanwendung neu.
  1. Öffnen Sie in einem Texteditor die Datei "web.xml"für den Webserver, dessen Ereignisse Sensor erfasst.
  2. Fügen Sie der Deskriptordatei die folgenden Elemente <filter> und <filter-mapping> Elemente hinzu. Wenn Sie txlogd.conf nicht im Ordner /etc installiert haben, müssen Sie den richtigen Pfad zu dieser Datei im <param-value> Element eingeben.
    <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 ist die Groß-/Kleinschreibung zu beachten. Geben Sie sie genau so ein, wie sie oben angezeigt werden.
  3. Starten Sie die Webanwendung neu. Der Collector wird mit der Anwendung geladen und beginnt mit der Erfassung der Ereignisdaten und dem Schreiben in die Disk-Warteschlange.

Speicherort der Sammlungs- und freigegebenen Objektdateien deklarieren

Verfahren zum Bearbeiten des Websphere-Startskripts, 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. Save the setupCmdLine.sh file.

Sensor testen

Verfahren zum Starten des Senders und zur Überprüfung, ob er erfolgreich eine Verbindung zum Insight-Server herstellen und Ereignisdaten an ihn übertragen kann.
Um zu überprüfen, ob der Transmitter Ereignisdaten erfolgreich an den Insight-Server senden kann, stellen Sie sicher, dass der Insight-Zielserver installiert und ausgeführt wird, bevor Sie den folgenden Test starten.
  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 gesendet 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 die Daten nicht erfolgreich übermittelt, überprüfen Sie, ob:
    • Das Ziel Insight Server wird ausgeführt.
    • Die Parameter ServerAddress und ServerPort werden in txtlogd.conf korrekt eingestellt. Wenn Sie "ServerAddress"unter einem Servernamen angegeben haben, versuchen Sie stattdessen, die zugehörige numerische IP-Adresse zu verwenden.
    • Der Wert des CertName-Parameters stimmt exakt mit dem allgemeinen Namen überein, der im digitalen Zertifikat des Ziel-Insight-Servers angezeigt wird.

Den Transmitter zu Ihrem Systemstartskript hinzufügen

Informationen, die sicherstellen, dass der Transmitter beim Neustart des Webservercomputers automatisch geladen wird.
Fügen Sie dem Systemstartskript den folgenden Befehl hinzu (der den Transmitter startet).
/usr/local/bin/txlogd -f /etc/txlogd.conf

Dieser Befehl startet den Transmitter als Daemon. Die vom Sender erzeugten 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 -Antwort-Headern verfügbar sind.
Die Sensoren für die J2EE-Plattform bieten einen Mechanismus zur Erfassung von Daten, die auf anderen Plattformen nicht verfügbar sind. Der Collector für die J2EE-Plattform (J2EE Collector) sitzt auf der Anwendungsebene, wodurch vertrauliche Daten gesammelt werden können, die nur für die Anwendung verfügbar sind und nicht über Seiten-Tagging oder in den Headern verfügbar sein sollten.
Die Daten können zwar durch Seiten-Tags und die Änderung der Kopfzeile ausgeblendet werden, stehen aber dennoch denjenigen zur Verfügung, die den Quellcode einer Seite prüfen oder die Kopfzeilen mithilfe der Browser-Plugin-Tools betrachten.
Der J2EE-Collector kann beispielsweise zur Erfassung von CPC-Daten (Cost per Click) für Links verwendet werden, die auf einer Seite angezeigt werden, sowie für sensible Partnerinformationen auf einer Seite und viele andere Datenpunkte. Die J2EE-Umgebung ermöglicht es Ihnen, Ihre WEBAPP zu ändern, um diese benutzerspezifischen Daten mit unserer Collector-Klasse zu erfassen.
Wenn ein Sensor für die J2EE-Plattform eine Anforderung empfängt, ruft er eine Collector-Klasse auf, die die Funktion appendToLog importiert. Die Funktion appendToLog hängt an die ursprüngliche Anforderung die in der Funktion appendToLog angegebenen Abfragezeichenfolgenparameter an. Dies ergibt den URI der ursprünglichen Anforderung, der zusätzliche Paare aus Name und Wert der Abfragezeichenfolge enthält, die den Namen und Werten der erfassten Daten entsprechen. Beispiel: CPC=20 wird an die ursprüngliche Anforderung 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 ohne Erstellung zusätzlicher Protokolleinträge ermöglicht, da diese möglicherweise mit Seitenmarkierungsmethoden erstellt werden.
Weitere Informationen zur Verarbeitung finden Sie im Handbuch zur Konfiguration von Datasets .
  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 wird der Abfragezeichenfolge der angeforderten JSP-Seite für die Seite /index.jsp die Zeichenfolge "A=1"und "B=2"angefügt:
    <html> 
    <body> 
      <h1>Hello World</h1> 
      <% 
        VSCollector collector = new VSCollector(request, response); 
        collector.appendToLog("A", "1"); 
        collector.appendToLog("B", "2"); 
      %> 
    </body> 
    </html>
    
    
    Die resultierende Anforderungs-URI lautet /index.jsp?A=1&B=2.
  3. Wiederholen Sie diesen Vorgang für jede JSP-Seite, von der Sie zusätzliche Daten erfassen möchten.