WebSphere unter AIX

Detaillierte Anweisungen zum Installieren und Konfigurieren von Sensor für WebSphere 5.x unter AIX 5.1 oder höher.

Die Programm-Dateien 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 Kundenbetreuer ab), bevor Sie die folgenden Schritte durchführen.

Hinweis

Die Sensor für WebSphere-Server unterstützen keine kontrollierte Experimentierung. Informationen zum kontrollierten Experimentieren finden Sie im Handbuch Data Workbench Controlled Experiments.

Installieren der Programm-Dateien

Verfahren zum Extrahieren und Installieren der Programm-Dateien von Sensorto Server Machine.

  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 Programm-Dateien in die in der folgenden Tabelle angegebenen Ordner:

Datei Beschreibung Zielgruppen-Verzeichnis
libvisual_sciences.so Sammlerlastmodul /usr/local/visual_sciences
J2EECollector.jar Bibliotheken des Sammlerladungs-Moduls WebSphere/lib-Ordner
txlogd Transmitter-Programm

/usr/local/bin

--OR--

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

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

Falsche Berechtigungen für die Programm-Dateien 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 Programm-Dateien 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.

Hinweis

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.

Edit the Sensor Configuration file

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.

Beginn des Transmitters und Erstellen der 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 Sender Beginn:

    /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
    
    • Die Option "i"in diesem Befehl Beginn 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 Sie den Sammler auf die 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. hinzufügen Sie die folgenden <filter> und die <filter-mapping> Elemente in die Deskriptordatei ein. 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>
    
    Hinweis

    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 von Ereignis-Daten 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 Beginn des Senders und zur Überprüfung, ob er erfolgreich eine Verbindung zum Insight-Server herstellen und Ereignis-Daten an ihn übertragen kann.

Hinweis

Um zu überprüfen, ob der Transmitter erfolgreich Ereignis-Daten an den Insight-Server senden kann, stellen Sie sicher, dass die Zielgruppe Insight Server 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 Ereignis-Daten an die Zielgruppe Insight Server gesendet werden.

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

    • Der Zielgruppe 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 entspricht dem allgemeinen Namen, der im digitalen Zertifikat der Zielgruppe Insight Server exakt angegeben ist.

Transmitter in Ihr Systemstartskript Hinzufügen

Informationen, die sicherstellen, dass der Transmitter beim Neustart des Webservercomputers automatisch geladen wird.

hinzufügen Sie den folgenden Befehl (der den Transmitter startet) an Ihr Systemstartskript.

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

Dieser Befehl Beginn den Sender 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.

Hinweis

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. Mit der J2EE-Umgebung können Sie Ihre WEBAPP so ändern, dass diese benutzerspezifischen Daten mit unserer Collector-Klasse erfasst werden.

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 Zeichenfolgenparameter der Abfrage an. Dies führt dazu, dass der URI der ursprünglichen Anforderung zusätzliche Abfragen-Zeichenfolgennamenpaare 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. hinzufügen Sie den folgenden Code oben auf der JSP-Seite, von der Sie Daten erfassen möchten:

    <%@ page import="com.visualsciences.collector.VSCollector" %>
    
  2. Verwenden Sie die Methode appendToLog() des Collector-Objekts, um die gewünschten Name-Wert-Paare an die Abfrage-Zeichenfolge der angeforderten JSP-Seite anzuhängen. Im folgenden Beispiel werden "A=1"und "B=2"an die Abfrage-Zeichenfolge 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>
    

    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.

Auf dieser Seite