有关安装和配置Sensor for Apache Jakarta Tomcat 4.1或更高版本的详细说明,这些传感器在Windows Server 2000或更高版本下运行。
传感器的程序文件打包在您从Adobe下载站点获得的安装文件中。 如果您还没有特定Web服务器的传感器安装文件,请在开始以下步骤之前先下载它(或从Adobe代表处获得它)。
支持的J2EE实现包括:
要安装和配置传感器,必须执行以下步骤:
解压并安装传感器程序文件的过程。
在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等。
配置文件包含必需参数和可选参数。
编辑传感器配置文件
编辑传感器配置文件
配置txlogd.conf文件后,可启动发射器程序,将其注册为Windows服务,并创建磁盘队列。
从Windows的“开始”菜单中,选择“附件”>“命令提示符”。
在命令提示符窗口中,导航到安装了传感器的目录并执行以下命令:
txlog /regserver
此命令启动发射器、创建磁盘队列并将传感器注册为Windows服务。
要确认发射器是否正确运行,请单击“开始”>“控制面板”>“管理工具”>“服务”。
此命令序列可能因您所使用的Windows版本而异。
要检查发射器在启动过程中是否遇到任何错误,请单击“开始”>“控制面板”>“管理工具”>“事件查看器”以打开事件查看器。
检查完“应用程序”日志后,关闭“事件查看器”。
验证发射器是否已在安装传感器程序文件的目录中创建了磁盘队列(Diskq2000.log),以及它是您在txlogd.conf文件的QueueSize参数中指定的大小。
如果队列未正确创建:
检查txtlogd.conf文件并验证QueueSize参数设置是否正确。
检查您安装传感器的设备是否有足够的可用空间来容纳QueueSize参数中指定大小的文件。
使用Windows中的“服务”控制面板,停止发射器。
删除队列文件。
将传感器重新注册为Windows服务:从Windows的“开始”菜单中,选择“附件”>“命令提示符”。 在命令提示符窗口中,导航到安装了传感器的目录并执行以下命令:
txlog /regserver
该发射器设计为连续运行。 如果重新启动计算机,则发射器会自动重新启动。 如果需要手动启动和停止发射器,可以使用Windows中的“服务”控制面板执行此操作。
对于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服务器,开始收集事件数据并将其写入磁盘队列。
有关将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页重复此过程。