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

在此页面上