通过修改 CSA 应用程序的 WAR 文件中的上下文参数，管理员可以进一步配置 Client System Analyzer (CSA)。
|
参数名 |
说明 |
默认值 |
|---|---|---|
| alertWhenDone | 如果设置为 true，则显示消息，指示已执行该小程序。 | false |
| appletJAR | JAR 文件的名称 | CSA.jar |
| application |
与此 CSA 实例关联的应用程序的名称。如果未指定应用程序，此 CSA 实例所收集的客户机将没有应用程序。 |
无 |
| autoRedir | 在设置为“true”的情况下，如果已将 JVM 设置为 JInitiator，但客户机没有安装相应版本的 JInitiator，CSA JSP 页就会自动切换为使用 Sun JVM。 | false |
| bwTestFile | 在带宽测试期间从服务器上下载的文件的名称。 |
CSA.mb (随附于 Grid Control 应用程序中的 CSA) |
| bwTestMsec | 小程序在带宽测试上应花费的时间。小程序将通过累计此时间间隔内所能下载的字节数来计算带宽 | 200 毫秒 |
| classid |
OBJECT 标记的“classid”字段。此参数仅在 JVM 设置为“JInitiator”的情况下适用。Sun 的 classid 是“clsid:8AD9C840-044E-11D1-B3E9-00805F499D93” |
none - 如果 JVM 设置为“JInitiator”，则必须设置此字段，否则将予以忽略 |
| codebase | OBJECT 标记的 codebase 字段。此参数仅在 JVM 设置为“KInitator”的情况下适用。 | Sun 的默认值是 http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0 |
| classid |
OBJECT 标记的“classid”字段。此参数仅在 JVM 设置为“JInitiator”的情况下适用。Sun 的 classid 是“clsid:8AD9C840-044E-11D1-B3E9-00805F499D93” |
none - 如果 JVM 设置为“JInitiator”，则必须设置此字段，否则将予以忽略 |
| collectCookie | 所要收集的 cookie 的名称列表。此参数是一个用逗号分隔的 cookie 名称列表。只有当前浏览器中的当前 OS 用户的 cookie 才予以收集。管理员可以指定“*”以收集当前浏览器的当前所有用户的 cookie。 | 如果此字段不存在，则不收集任何 cookie。 |
| cookieDomain | CSA cookie 的域。 | 如果未设置 cookie 的域或路径，就会禁用 cookie。 |
| cookieMaxAge | cookie 在客户机上的最长存留时间 (以秒计)。 | 默认值为 1 年 |
| cookiePath | CSA cookie 的路径 | 如果未设置域或路径，就会禁用 cookie。 |
| customClass | 用于收集定制数据的类的名称 (见下文) | none - 默认操作是不执行任何定制代码 |
| customKey1 customKey2 customKey3 |
三个定制密钥的值。对于由 CSA JSP 页使用此部署描述符所做的所有客户机收集，其定制密钥都使用这些值。这些值可被定制代码覆盖。 | 如果未指定定制密钥值，则不会进行任何收集 (除非由定制代码收集) |
| descriptionFile | 包含部署页中所显示的说明的文本文件路径。此文件的内容应为 HTML 格式的文本。 | 无 |
| destURL | 指定目标 URL。这是 CSA JSP 页上的“继续”按钮所链接的 URL。 | 如果未指定 destURL，“继续”按钮就会将用户转至引用页。如果没有引用页，则不显示“继续”按钮。 |
| destURLResultsParam | 指定要添加至“目标 URL”，用于指示客户机相容性级别的 URL 参数的名称。例如，如果值为“相容性”，而客户机的总体相容性级别为“严重”，则参数“相容性=严重”就会添加到目标 URL 上。 | Sun |
| JVM | 此参数决定了将要使用的 JVM 类型。如果值为“Sun”，JSP 页就会将浏览器定向到使用 Sun JVM。如果值为“Oracle”，此页就会将浏览器定向到使用 Oracle Jinitiator。如果值为“any”，JSP 将取消标准“applet”标记，从而让客户机使用浏览器所插入的任何一个 JVM。 | Sun |
| maxExecInterval | 添加到 CSA cookie 有效负载上的参数。当重定向逻辑读取 cookie 时，如果 cookie 的时间戳超过了当前时间，就会重新部署小程序。此参数可被重定向 JSP/过滤器中的“csa_execInterval”上下文参数覆盖 | 90 天 |
| maxFileSize | 在一次请求中可发送给接收方的最大数据量 (以 KB 计)。如果发送的数据大小超出了此限制，此请求就会被拒绝，而任何已写入硬盘驱动器的数据都将予以删除。 | 100 |
| maxOutptFiles | XML OutputDir 中可存在的最大输出文件数量。 |
100 |
| outputDir | 用于写入 CSA 配置 xml 文件的目录。小程序页和接收方页都必须读取此参数，而此参数对于两个页也必须相同 | 默认情况下，输出文件将写入应用程序根目录的“csa_results”子目录中 (前提是应用程序根目录存在，且子目录存在或能予以创建)。建议不要使用此参数的默认值。 |
| outputEnabled | 允许或禁止创建输出 XML 文件。此参数同时适用于前面两个页 |
默认情况下，创建的 XML 文件将存储到 XMLOutputDir 中。 |
| pluginspage | 用于将用户定向到 Netscape 下的 JVM 安装程序，原因是 Netscape 不支持自动安装。此参数仅在 JVM 是 Jinitiator 的情况下适用。Sun 的默认值是 http://java.sun.com/products/plugin/index.html#download | none - 如果 JVM 设置为“JInitiator”，则必须设置此字段，否则将予以忽略 receiver |
| receiver |
小程序应将收集的数据发送至该 URL。 注：在设置此参数时，管理员必须确保接收方的版本与小程序的版本相同 |
默认为在 CSA JSP 页所在的同一路径中查找“CSAr.jsp” |
| ruleFile | 相对于 Web 应用程序的根目录，在服务器上指定所要评估的规则所在文件的路径 | rules.xml |
| script | 指定一个在被代理标记为上载前可在 CSA XML 文件上运行的脚本 (由管理员提供)。 | none - 如果未指定脚本，则不会运行任何脚本 |
| type | OBJECT 标记的“type”字段，它由 CSA JSP 页提供，用于部署小程序。只有在 JVM 设置为“JInitiator”的情况下，此参数才适用。如果 JVM 设置为“Sun”，则类型为“application/x-java-applet” | none - 如果 JVM 设置为“JInitiator”，则必须设置此字段，否则将予以忽略 |
| viewData | 如果设置为 true，当所收集的数据发送到服务器后，此参数允许最终用户查看这些数据。 | false |
除了这些参数外，还可以配置 CSA 重定向参数。通过使用 servlet 过滤器或通过在其他某些页上包含 CSA 重定向 JSP 文件，即可启用重定向功能。为使重定向功能生效，以下上下文参数必须可用。
|
参数名 |
说明 |
默认值 |
|---|---|---|
| csa_csaURL | 作为用户重定向目标的 CSA JSP 页的 URL。 | 无默认值：必须设置此值，否则重定向功能将无效 |
| csa_execInterval | 执行 CSA 的时间间隔 (以秒计)。如果 cookie 的存在时间与当前服务器时间之间的差值超过了 execInterval 的值，就会对用户进行重定向。 |
none。如果未设置 execInterval，则只有在存在 CSA cookie 的情况下，才会对用户进行重定向 |
| csa_redirectURL | 在执行 CSA 后，作为用户重定向目标的 URL |
none：如果未设置此参数，用户将被定向至原来请求的页 |
| csa_UIMode |
0 - 同步 (在当前浏览器窗口中) 1 - 异步，可见 2 - 异步，不可见 |
同步 |
注：如果管理员利用 CSA servlet 过滤器启用了重定向功能，则必须以过滤器初始化参数的形式提供上面所示的参数 (UIMode 参数除外；servlet 过滤器不要求此参数)。
在某些情况下，不同的应用程序可能会要求不同的参数集。例如，两个不同的应用程序可能会有不同的规则集和定制代码，而管理员可能希望将它们与不同的 CSA 收集器目标进行关联。在这种情况下，管理员可以利用“<应用程序名> ruleFile”、“<应用程序名> appletJar”等上下文参数为某个应用程序指定 ruleFile、appletJar、script 及 outputDir 参数。如果是作为上下文参数或通过 URL 指定了某个应用程序，就会使用此应用程序特定的参数值执行 CSA。如果未指定应用程序或未覆盖应用程序的某个参数，则使用默认参数。
上表中指定的某些参数也可作为 URL 参数来指定。如果在 URL 上指定“application”参数，就会使用与该应用程序关联的上下文参数，而非默认参数。如果在 URL 上指定了某个参数，此参数就会覆盖在 CSA 应用程序部署描述符中所指定的相应参数值，而在指定应用程序的情况下，它还将覆盖此上下文参数面向该应用程序的特定值。
可以在 URL 上指定的参数为：customKey1-3、alertWhenDone、application、autoRedir、bwTestMsec、JVM、uiMode。
版权所有 © 1996，2007，Oracle。保留所有权利。