Adobe Experience League

Windows Server 2000或更高版本上的Tomcat Server

有关安装和配置Sensor for Apache Jakarta Tomcat 4.1或更高版本的详细说明，这些传感器在Windows Server 2000或更高版本下运行。

传感器的程序文件打包在您从Adobe下载站点获得的安装文件中。如果您还没有特定Web服务器的传感器安装文件，请在开始以下步骤之前先下载它（或从Adobe代表处获得它）。

支持的J2EE实现包括：

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

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

安装程序文件

解压并安装传感器程序文件的过程。

在Tomcat服务器上，创建一个用于安装传感器程序文件的目录。请记住，您的磁盘队列位于此目录中，因此请确保您选择的设备有足够的空间容纳所需大小的队列。
```
C:\VisualSensor
```
将安装文件的内容解压缩到刚刚创建的目录中。在此步骤中，传感器会安装以下文件：

File（文件）	描述	目标目录
visual_sciences.dll	收集器负载模块。	在任何目录中。
J2EECollector.jar	收集器加载模块库	WEB-INF/lib
txlogd.exe	发射机程序。	在任意目录中
txlogd.conf	传感器配置文件。	在任意目录中
trust_ca_cert.pem	用于验证Insight Server在连接过程中显示的数字证书的证书	在任意目录中

注意

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

编辑传感器配置文件

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

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

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

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

编辑传感器配置文件

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

编辑传感器配置文件

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

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

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

从Windows的“开始”菜单中，选择“附件”>“命令提示符”。
在命令提示符窗口中，导航到安装了传感器的目录并执行以下命令：
```
txlog /regserver
```
此命令启动发射器、创建磁盘队列并将传感器注册为Windows服务。
要确认发射器是否正确运行，请单击“开始”>“控制面板”>“管理工具”>“服务”。

注意

此命令序列可能因您所使用的Windows版本而异。
1. 在服务列表中，找到传感器条目并确认其状态为“Started（启动）” ，其启动类型为“Automatic（自动）”。
2. 关闭“服务”控制面板。
要检查发射器在启动过程中是否遇到任何错误，请单击“开始”>“控制面板”>“管理工具”>“事件查看器”以打开事件查看器。
1. 在“事件查看器”窗口的左窗格中，选择“应用程序”日志。
2. 在右侧窗格中，查找“源”列中带有“Adobe”的事件。
3. 如果从“Adobe”中找到错误，请双击该错误以显示“活动属性”窗口。此窗口提供有关错误的详细信息。
检查完“应用程序”日志后，关闭“事件查看器”。
验证发射器是否已在安装传感器程序文件的目录中创建了磁盘队列(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应用程序。

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

将以下元素 <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>

注意

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

重新启动Web服务器进程（您不必重新启动整个服务器计算机，只需重新启动Web服务器进程）。收集器加载了Web服务器，开始收集事件数据并将其写入磁盘队列。

修改Java库路径

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

在Windows服务器上，导航到Tomcat安装目录。 (Tomcat > bin)
在bin文件夹下，运行Tomcat9w.exe（常见守护程序服务管理器）。

在Java选项卡的Java选项下，添加新行：
```
-Djava.library.path=C:\Sensor directory
```
其中， C:\Sensor 目录是包含文件的目 visual_sciences.dll 录。

捕获其他数据

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

将以下代码添加到要从中捕获数据的。jsp页的顶部：
```
<%@ page import="com.visualsciences.collector.VSCollector" %> 
```
使用收集器对象的appendToLog()方法将所需的名称——值对追加到所请求的。jsp页的查询字符串中。以下示例将“A=1”和“B=2”附加到/index.jsp页面所请求的。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。
对要从中捕获其他数据的每个。jsp页重复此过程。