AIX 上的 WebSphere

有关为在AIX 5.1或更高版本上运行的WebSphere 5.x安装和配置传感器的详细说明。

Sensor的程序文件将打包在从Adobe下载站点获取的安装文件中。 如果您还没有特定Web服务器的Sensor安装文件,请先下载该文件(或从Adobe代表处获取),然后再开始执行以下步骤。

注意

WebSphere服务器的Sensor不支持对照实验。 有关对照实验的信息,请参阅​Data Workbench对照实验指南。

安装程序文件

将Sensor的程序文件解压缩并安装到服务器计算机的过程。

  1. 以根用户或具有根权限的用户身份登录。

  2. 使用以下命令解压缩并解压缩安装文件:

    gunzip installationFilename.tar.gz
    tar -xf installationFilename.tar
    
  3. 将解压缩的程序文件复制到下表中标识的目录:

文件 描述 目标目录
libvisual_sciences.so 集电器负载模块 /usr/local/visual_sciences
J2EECollector.jar 收集器加载模块库 WebSphere /lib目录
txlogd 发射机程序

/usr/local/bin

--或者--

/usr/local/sbin

txlogd.conf 传感器配置文件 /等
trust_ca_cert.pem 用于验证Insight Server在连接过程中显示的数字证书的证书 /usr/local/visual_sciences
注意

安装包包含一个名为TestExperience.xls的电子表格文件。 此电子表格是一种用于架构师配置受控实验的工具。 传感器本身不使用此文件,因此不必在运行传感器的计算机上安装该文件(尽管您可以选择这样做)。 您可能希望将文件复制到架构师可以访问的位置,或者根据需要从安装包中提取文件。 有关对照实验的更多信息,请参阅《Insight对照实验指南》。

对程序文件的权限

对程序文件的权限不正确会导致安装传感器时遇到的大多数问题。

请确保您完全按照此部分中的说明设置权限。

默认情况下,tar文件中的程序文件具有以下权限。 根据您的系统配置方式,在提取文件时,可能会更改(未屏蔽)这些设置。

要将权限重置为建议的默认设置,请使用下面的chmod命令。

注意

检查已安装文件的目录是否至少允许此级别的访问。

文件 默认权限 chmod命令
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

如果要使用除推荐默认值之外的其他权限,请查看传感器UNIX文件权限中的信息,以确保您了解这些文件的使用方式。

编辑传感器配置文件

txlogd.conf文件包含传感器的配置参数。

您必须编辑文件以指定磁盘队列的大小、Insight Server的地址以及将附加到此传感器生成数据的ID等内容。

配置文件包含必需的参数和可选参数。

  • 必需参数是安装传感器时必须指定的设置。 如果没有这些设置,传感器将无法成功运行。
  • 可选参数是默认设置,用于预定义值(您可以修改)或启用可选功能。

编辑配置文件

  1. 在文本编辑器中打开/etc/txlogd.conf文件,并设置所需参数以及任何所需的可选参数。
  2. 保存并关闭该文件。

启动发送器并创建磁盘队列

配置txlogd.conf文件后创建磁盘队列的过程。

  1. 如果磁盘队列所在的目录不存在,请创建该目录。 确保目录为收集器模块和发送器程序提供对文件的读/写访问权限。

  2. 在安装传感器的计算机上,执行以下命令以启动发送器:

    /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
    
    • 此命令中的“i”选项以交互模式启动发送器。 此模式在屏幕上显示发送器消息,还允许您使用键盘命令与发送器进行交互。
    • “c”选项将指导发送器创建磁盘队列。
    • “f”选项指定配置文件的位置。
  3. 验证发送器是否已在QueueFile参数中指定的位置和QueueSize参数中指定的大小中创建磁盘队列。

  4. 如果队列未正确创建,请按Ctrl+C终止发送器,然后执行以下操作:

    1. 检查txtlogd.conf文件,并验证QueueFile和QueueSize参数是否已正确设置。
    2. 检查为其分配磁盘队列的设备是否运行正常,并有足够的空间来存放QueueSize参数中指定大小的文件。
    3. 进行任何必要的更正并重复此过程。

将收集器添加到Web应用程序

对于WebSphere服务器,收集器在Servlet容器中用作过滤器。

要将收集器添加到Web应用程序,请将过滤器添加到Web应用程序的web.xml部署描述符,然后重新启动Web应用程序。

  1. 使用文本编辑器,打开Sensor捕获其事件的Web服务器的web.xml文件。

  2. 将以下<filter><filter-mapping>元素添加到描述符文件中。 如果未在/etc目录中安装txlogd.conf,则需要在<param-value>元素中输入此文件的正确路径。

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

    这些行区分大小写。 完全按上面显示的方式键入它们。

  3. 重新启动Web应用程序。 收集器随应用程序一起加载,并将开始收集事件数据并将其写入磁盘队列。

声明收集器和共享对象文件的位置

编辑Websphere启动脚本以声明J2EECollector.jar和libvisual_sciences.so文件的位置的过程。

  1. 在Websphere /bin目录中打开setupCmdLine.sh文件。

  2. 在定义$WAS_CLASSPATH变量的行后,添加以下行:

    WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
    
  3. 在定义$WAS_LIBPATH变量的大小写块之后,添加以下行:

    WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
    
  4. 保存setupCmdLine.sh文件。

测试传感器

启动发送器并验证它是否可以成功连接到Insight Server并将事件数据发送到它的过程。

注意

要验证发送器是否可以将事件数据成功发送到Insight Server,请确保目标Insight Server已安装并正在运行,然后才能开始进行以下测试。

  1. 如果发送器尚未运行,请使用以下命令重新启动它:

    /usr/local/bin/txlogd -i -f /etc/txlogd.conf
    
  2. 打开浏览器(在任何计算机上),并从运行传感器的Web服务器中请求一个页面(确保选择传感器正在监视的页面)。

  3. 发出请求后,检查发送器的控制台中是否有消息,指示发送器正在向目标Insight Server发送事件数据。

  4. 如果传感器未成功传输数据,请验证:

    • 目标Insight Server正在运行。
    • 在txtlogd.conf中正确设置了ServerAddress和ServerPort参数。 如果您使用服务器名称指定了ServerAddress ,请尝试改用其数字IP地址。
    • CertName参数的值与目标Insight Server的数字证书上显示的通用名称完全匹配。

将发送器添加到系统启动脚本

此信息可确保在重新启动Web服务器计算机时自动加载发送器。

将以下命令(用于启动发送器)添加到系统启动脚本。

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

此命令将发送器作为守护程序启动。 发送器生成的操作和错误消息将写入系统日志。

捕获其他数据

所有平台的传感器都可以收集HTTP请求和响应标头中可用的任何数据。

J2EE平台的传感器提供了一种收集其他平台上不可用数据的机制。 J2EE平台(J2EE收集器)的收集器位于应用程序层上,这样它便能够收集仅可用于应用程序且不应通过页面标记或标头公开的敏感数据。

注意

虽然页面标记和标题修改可以隐藏数据,但对于那些检查页面源代码或使用浏览器插件工具查看标题的用户而言,仍然可以使用这些数据。

例如,J2EE收集器可用于捕获页面上显示的链接的每次点击成本(CPC)数据、页面上的敏感合作伙伴信息以及许多其他数据点。 J2EE环境使您能够轻松修改WEBAPP,以便使用我们的收集器类捕获此自定义数据。

当J2EE平台的传感器收到请求时,它将调用一个用于导入appendToLog函数的收集器类。 appendToLog函数将在appendToLog函数中指定的查询字符串参数附加到初始请求。 这会导致初始请求的URI包含与正在捕获的数据的名称和值对应的其他查询字符串名称 — 值对。 例如,当特定广告投放或点进链接的值为20美分时,CPC=20会附加到初始请求中。 Insight Server会将这些值处理到数据集中以进行分析。 此收集方法的另一个好处是它允许收集其他数据,而不会创建额外的日志条目,使用页面标记方法可能会创建这些日志条目。

有关处理的更多信息,请参阅​《数据集配置指南》

  1. 将以下代码添加到要从中捕获数据的.jsp页的顶部:

    <%@ page import="com.visualsciences.collector.VSCollector" %>
    
  2. 使用收集器对象的appendToLog()方法将所需的名称 — 值对附加到所请求的.jsp页的查询字符串。 以下示例将“A=1”和“B=2”附加到所请求的.jsp页面的/index.jsp页面查询字符串中:

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

    生成的请求URI为/index.jsp?A=1&B=2。

  3. 对要从中捕获其他数据的每个.jsp页重复此过程。

在此页面上