Windows Server 2000 或更高版本上的 Tomcat 服务器

重要

阅读有关Data Workbench 生命周期终止公告.

在Windows Server 2000或更高版本下运行的Apache Jakarta Tomcat 4.1或更高版本中安装和配置传感器的详细说明。

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

支持的J2EE实施包括：

  • 在Microsoft Windows Server 2000或更高版本上运行的JBoss Server 4.0.5或更高版本。

要安装和配置传感器，必须执行以下步骤：

安装程序文件

提取和安装传感器程序文件的过程。

  1. 在Tomcat服务器上，创建一个用于安装传感器程序文件的目录。 请记住，您的磁盘队列位于此目录中，因此请确保您选择的设备有足够的空间容纳所需大小的队列。

    C:\VisualSensor

  2. 将安装文件的内容解压缩到刚刚创建的目录中。 在此步骤中，传感器安装以下文件：

文件 描述 目标目录
visual_sciences.dll 收集器负载模块。 在任何目录中。
J2EECollector.jar 收集器加载模块库 WEB-INF/lib

txlogd.exe

发送程序。 在任意目录中
txlogd.conf 传感器配置文件。 在任意目录中
trust_ca_cert.pem 用于验证Insight Server在连接过程中显示的数字证书的证书 在任意目录中
注意

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

编辑传感器配置文件

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

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

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

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

编辑传感器配置文件

  • 打开 /etc/txlogd.conf 文件，并设置所需的参数以及任何所需的可选参数。
  • 保存并关闭该文件。

编辑传感器配置文件

  1. 打开 /etc/txlogd.conf 文件，并设置所需的参数以及任何所需的可选参数。
  2. 保存并关闭该文件。

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

配置txlogd.conf文件后，可以启动发送器程序，将其注册为Windows服务，然后创建磁盘队列。

  1. 从Windows的“开始”菜单中，选择“附件”>“命令提示符”。

  2. 在命令提示符窗口中，导航到安装传感器的目录并执行以下命令：

    txlog /regserver

    此命令启动发送器，创建磁盘队列，并将传感器注册为Windows服务。

  3. 要确认发送器运行正确，请单击开始>控制面板>管理工具>服务。

    注意

    此命令序列可能因您使用的Windows版本而异。

    1. 在服务列表中，找到传感器的条目，并确认其状态为“已启动”且其启动类型为“自动”。
    2. 关闭“服务”控制面板。

  4. 要检查发送器在启动过程中是否遇到任何错误，请单击开始>控制面板>管理工具>事件查看器以打开事件查看器。

    1. 在事件查看器窗口的左窗格中，选择应用程序日志。
    2. 在右侧窗格中，查找“源”列中包含“Adobe”的事件。
    3. 如果从“Adobe”中找到错误，请双击该错误以显示“事件属性”窗口。 此窗口提供有关错误的详细信息。

  5. 检查完应用程序日志后，关闭事件查看器。

  6. 确认发送器已在安装传感器程序文件的目录中创建了磁盘队列(Diskq2000.log)，并且该磁盘队列的大小是您在txlogd.conf文件的QueueSize参数中指定的大小。

    如果队列未正确创建：

    1. 检查txtlogd.conf文件，并验证QueueSize参数是否已正确设置。

    2. 检查安装传感器的设备是否有足够的空间来存放QueueSize参数中指定大小的文件。

    3. 在Windows中使用“服务”控制面板，停止发送器。

    4. 删除队列文件。

    5. 将传感器重新注册为Windows服务：从Windows的“开始”菜单中，选择“附件”>“命令提示符”。 在命令提示符窗口中，导航到安装传感器的目录并执行以下命令：

      txlog /regserver

发射机设计为连续运行。 如果重新启动计算机，则发送器会自动重新启动。 如果需要手动启动和停止发送器，可以使用Windows中的“服务”控制面板执行此操作。

将收集器添加到Web服务器

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

要将收集器添加到Web服务器，您必须编辑 web.xml 文件，然后重新启动Web应用程序。

  1. 使用文本编辑器，打开 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服务器进程（您不必重新启动整个服务器计算机，只需重新启动Web服务器进程）。 收集器随Web服务器一起加载，并开始收集事件数据并将其写入磁盘队列。

修改 Java 库路径

有关将visual_sciences.dll添加到Tomcat Java库路径的说明。

  1. 在Windows服务器上，导航到Tomcat安装目录。 (Tomcat > bin)

  2. 在bin文件夹下，运行Tomcat9w.exe（常用守护程序服务管理器）。

    在Java选项卡的Java选项下，添加新行：

    -Djava.library.path=C:\Sensor directory

    其中 C:\Sensor 目录是包含 visual_sciences.dll 文件。

捕获其他数据

您可以使用appendToLog()功能从基于J2EE的Web应用程序中捕获其他测量数据。

  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页重复此过程。

在此页面上