您可以通过设置可用的 MBean 属性来定制 IBM® Rational® ClearQuest® Web 服务器。
注意: 请勿修改任何 MBean 属性,除非这些属性记录为可修改,且带有 [W] 编写注释,或者 IBM 支持人员指示您执行此操作。修改只读 [R] 或未记录的 MBean 属性可能影响系统性能。
属性按其驻留的 MBean 进行分类。您可以检索以 [R] 表示可读取的所有参数。可以修改的参数以 [W] 表示可以写入。您可以通过使用 IBM WebSphere® Application Server wsadmin 命令行实用程序,用 Jacl 命令访问这些属性。teamAdminUtils.jacl 文件提供了 Jacl 命令、语法和功能的示例。您还可以通过使用“站点配置”对话框来修改 ClearQuest Web 服务器的某些 MBean 属性。
仅当 ClearQuest Web 服务器正在运行时,才能更改可修改的 MBean 参数。更改立即生效,而无需重新启动服务器进程。对管理后端“开放网络计算远程过程调用”(ONC RPC) 服务器进程启动的 MBean 属性的更改不会影响已启动的后端 ONC RPC 进程。只有新的后端 ONC RPC 服务器进程才会采用新设置。
在 ClearQuest Web 服务器启动时创建了两个 MBean:TeamServerMBean,它保留 ClearQuest Web 服务器配置属性,以及 CqServerFactoryMBean,它保留 ClearQuest 受管连接工厂属性。
ClearQuest 受管连接工厂是负责启动一个或多个多线程 ClearQuest ONC RPC 后端服务器进程的 ClearQuest Web 服务器组件。由于每个 ClearQuest RPC 进程是多线程的,所以它可以处理来自多个不同凭证的请求。ClearQuest 受管连接工厂自动对每个 ClearQuest RPC 进程执行生命周期管理。
ClearQuest Web 服务器包括以下 MBean。
- TeamServerMBean
TeamServerMBean 持有与整个 ClearQuest Web 服务器行为相关的属性。专门用于控制 ClearQuest 服务器工厂工作方式的属性存储在 CqServerFactoryMBean 服务器工厂中。
- cqFulltextSearchCacheSize[R,W] - 对于单次全文搜索,保存在 ClearQuest 核心中的记录命中数。此值用于覆盖 ClearQuest 核心采用的缺省行为。
此属性的缺省值为 0,这向 ClearQuest Web 服务器表示,此值未设置,不应用于覆盖 ClearQuest 核心的缺省设置。如果是正数值,将会覆盖 ClearQuest 核心的缺省设置。
- cqFulltextSearchPageSize[R,W] - 对于单次全文搜索,ClearQuest 核心中某页全文搜索结果中的记录命中数。此值用于覆盖 ClearQuest 核心采用的缺省行为。
此属性的缺省值为 0,这向 ClearQuest Web 服务器表示,此值未设置,不应用于覆盖 ClearQuest 核心的缺省设置。正数值将覆盖 ClearQuest 核心的缺省设置。
- cqFulltextSearchRecordHitLimit[R,W] - 对于单次全文搜索,一个 Web Service 调用中返回的记录命中的最大数目;同时也是可在应用程序服务器中高速缓存的命中数。缺省值是 100。
- cqLoginSessionTimeout[R,W] - ClearQuest 登录会话在超时前将持续的时间(以秒为单位)。缺省值是 1800 秒(30 分钟)。每个 ClearQuest 会话会占用一个数据库连接,所以将此值设置得过高可能会导致占用资源的时间比需要的时间长。请勿更改缺省值。
- cqLoginSessionWaitTimeout[R,W] - 线程为获取 Rational ClearQuest 登录会话而应该等待的时间(以秒为单位)。缺省值为 300 秒。
- cqServerFactory[R] - ClearQuest J2C 连接工厂 MBean 的对象名。
- cqUserDBListSecureAccess[R,W] - 指示在用户尝试利用无效凭证登录 ClearQuest Web 时是否能够看到数据库列表。缺省值为 False,指示如果用户尝试利用无效的凭证登录,那么可以看到数据库列表。如果该值设置为 True,那么将启用用户认证,这样在用户尝试使用无效的凭证登录时,将阻止用户查看数据库列表。
- ejbBufferLimit[R,W] - EJB 调用将返回的最大对象数。缺省值是 100。
- keepAliveInterval[R,W] - 如果设置为大于 0(零)秒的值,那么在此指定的周期性时间间隔内若是没有发送任何流量,ClearQuest Web 服务器将按此时间间隔在客户端和后端服务器组件之间发出保持活动状态的消息。这是旨在确保在没有除去了底层套接字的基础结构时,可以完成长期运行的 ClearQuest 查询。
此值应该比套接字超时值至少小 10 秒。缺省值是 300 秒(5 分钟)。
- largeReadSocketTimeoutMultiplier[R,W] - 一个乘法器,应用于在中间层和后端服务器组件之间的套接字上为某些长时间运行的操作显示的超时值。缺省值为 4,表示显示的套接字超时值是显示的后端服务器工厂缺省套接字超时值的四倍。该乘法器仅适用于某些操作。请勿更改该值,除非 IBM 支持人员指示您这样做。
- maxCqSessionsPerUser[R,W] - 将在单个会话中为每个用户创建的 ClearQuest 会话的最大数目。缺省值是 2;最小值是 1。
- maxProcureServerAttempts[R,W] - 将异常返回给受管连接池之前允许获取后端 ONC RPC 服务器的最大尝试次数。缺省值是 6;必须大于等于 2。
- mediumReadSocketTimeoutMultiplier[R,W] - 一个乘法器,应用于在中间层和后端服务器组件之间的套接字上为某些长时间运行的操作显示的超时值。缺省值为 2,表示显示的套接字超时值是显示的后端服务器工厂缺省套接字超时值的两倍。该乘法器仅适用于某些操作。请勿更改该值,除非 IBM 支持人员指示您这样做。
- numberOfActiveSessions[R] - 此服务器当前正在处理的活动会话数。
- numberOfHttpSessionsCreated[R] - 此服务器已处理的会话总数。
- oncrpcBufferLimit[R,W] - 单个 ONC RPC 调用返回的对象的最大数目。缺省值是 100。
- oncrpcInterruptLimit[R,W] - 单个用户请求返回的对象的最大数目。缺省值是 1000。
- oncrpcServers[R] - 当前运行的 ONC RPC 服务器 MBean 的对象名。
- procureServerInterval[R,W] - 尝试获取服务器时,将异常返回给受管连接池之前允许请求线程等待的总时间(以秒为单位)。缺省值是 60 秒。
- sessionObjectDefaultTimeout[R,W] - 对象将在会话中停留的缺省时间(以秒为单位)。缺省值是 1800 秒(30 分钟)。必须大于等于 0。
- sessionQueryObjectTimeout[R,W] - 尚未交付新的或已修改的查询或查询文件夹时,ClearQuest 登录会话在超时前持续的时间。该值不能小于 cqLoginSessionTimeout 值。
缺省值是 1800 秒(30 分钟)。该值将覆盖 sessionObjectDefaultTimeout 定义的值。
- sessionRecordObjectTimeout[R,W] - 存在尚未交付的新创建的或已修改的记录时,ClearQuest 登录会话在超时前持续的时间。 该值不能小于 cqLoginSessionTimeout 值。
缺省值是 10,800 秒(3 小时)。该值将覆盖 sessionObjectDefaultTimeout 定义的值。
- sessionReaperThreadDelay[R,W] - 会话切割线程的时间延迟(以秒为单位)。缺省值是 900 秒(15 分钟)。取值范围是从 300 到 1800 秒。如果要求很高的虚拟内存,您可能要将该值减小。如果占用过多的 CPU 资源,您可能要将该值增大。
- totalNumberOfOncrpcServers[R] - 当前在所有 Rational ClearQuest 连接工厂实例中运行的后端 RPC 服务器的数量。
- totalOncrpcCallCount[R] - 自服务器启动以来进行的 oncrpc 调用总数。
- totalWebServiceCallCount[R] - 自服务器启动以来进行的 Web Service 调用总数。
- versionNumber[R] - ClearQuest Web 服务器产品版本号,以使用句点分隔的字符串值表示。例如,7.1.0.1。
- CqServerFactoryMBean
该 MBean 持有与 ClearQuest 受管连接工厂相关的配置属性。ClearQuest 受管连接工厂启动并管理与 ClearQuest 核心通信的 ClearQuest ONC RPC 后端进程。
该 MBean 中的属性不会像 TeamServerMBean 中特定于 ClearQuest 的某些属性一样影响 ClearQuest 的一般行为。而是该 MBean 中的属性控制工厂的行为并管理它启动的 ClearQuest ONC RPC 后端进程。对于新启动的后端进程,对该 MBean 的更改会立即生效(现有后端进程不受影响);无需重新启动服务器进程。
- activeHttpSessionThreshold[R,W] - 活动后端 ClearQuest ONC RPC 服务器上的活动 HTTP 会话数,如果超出此值,可能会使此受管连接工厂启动另一个后端 ClearQuest ONC RPC 服务器。缺省值是 30。
- cqrpcAbandonedProcessCleanupEnabled[R,W] - 指示 ClearQuest Web 服务器是否将启动清除过程,此过程将终止任何丢弃的 ClearQuest RPC 进程。
缺省值是 TRUE。
- cqrpcAbandonedProcessCleanupInterval[R,W] - ClearQuest Web 服务器启动清除过程以终止任何丢弃的 ClearQuest RPC 进程所采用的周期性时间间隔的时间长度(分钟)。缺省值是 30 分钟。值必须大于等于 0。时间间隔的值采用最接近的 2 的幂。值为 0 表示时间间隔设置为 2。
- maximumActiveServers[R,W] - 此受管连接工厂允许的活动后端 ClearQuest ONC RPC 服务器的最大数目。缺省值是 10。
- recycleServerHttpSessionLimit[R,W] - 此受管连接工厂重新启动后端 ClearQuest ONC RPC 服务器前该服务器将处理的 HTTP 会话数。
缺省值是 200。值为 0 表示不应该检查此限制。
- recycleServerLifetimeLimit[R,W] - 此受管连接工厂重新启动后端 ClearQuest ONC RPC 服务器前该服务器可运行的最长生存期(以秒为单位)。缺省值是 86,400 秒(24 小时)。
值为 0 表示将不检查此限制。
- recycleServerOncrpcCallLimit[R,W] - 此受管连接工厂重新启动后端 ClearQuest ONC RPC 服务器前该服务器将处理的 ONC RPC 请求的最大数目。缺省值是 100,000。值为 0 表示将不检查此限制。
- recyclingPeriod[R,W] - 此受管连接工厂进行终止之前允许正在重新启动的后端 ClearQuest ONC RPC 服务器完成所有未解决的会话工作的时间(以秒为单位)。正在重新启动的 ClearQuest ONC RPC 后端服务器的状态将是 2(正在停止)。缺省值是 1800 秒(30 分钟)。
必须大于 0。
- remoteChartReportServerHostName[R,W] - 仅适用于 UNIX 系统和 Linux。
指定用于处理图表和报告请求的 Windows ClearQuest Web 服务器的主机名。缺省值是 ""(空字符串/未设置)。
- remoteChartReportServerPort[R,W] - 仅适用于 UNIX 系统和 Linux。
指定用于处理图表和报告请求的 Windows ClearQuest Web 服务器的端口号。缺省值是 0。
- serverWorkerThreadCount[R,W] - 后端 ClearQuest ONC RPC 服务器将用于处理入局请求的线程数。缺省值是 30。
- OncrpcServerMBean:
对于 ClearQuest 受管连接工厂启动的每个 ONC RPC 后端进程,将创建 CqOncrpcServerMBean 的实例。
每个 MBean 都包含在基本 OncrpcServerMBean 中定义的值(请注意基本 OncrpcServerMBean 从不实例化)。每个服务器进程 MBean 仅在其表示的进程正在 ClearQuest Web 服务器系统上运行时才存在。该进程终止时,表示该进程的 MBean 也会终止。以下是所有服务器进程 MBean 中的基本属性:
- hostname[R] - 运行后端 ONC RPC 服务器的主机的名称。
- oncrpcCalls[R] - 后端 ONC RPC 服务器已处理的 ONC RPC 调用总数。
- port[R] - 后端 ONC RPC 服务器正在侦听的整数端口号。
- serverId[R] - 后端 ONC RPC 服务器的唯一标识。
- serverStartTime[R] - 后端 ONC RPC 服务器启动的时间戳记。此数值为自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。
- serverState[R] - 后端 ONC RPC 服务器的当前状态,用整数表示(0=已停止,1=正在运行,2=正在停止,3=死机)。
- serverStoppingTime[R] - 后端 ONC RPC 服务器进入“正在停止 (2)”状态的时间戳记。此数值为自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。
- serverStopTime[R] - 后端 ONC RPC 服务器进入“已停止 (0)”或“死机 (3)”状态的时间戳记。此数值为自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。
- serverType[R] - 后端 ONC RPC 服务器的类型
(Rational ClearCase®)。
- CqOncrpcServerMBean
对于 ClearQuest 受管连接工厂启动的每个 ClearQuest ONC RPC 后端进程,将创建 CqOncrpcServerMBean MBean 的实例。该实例仅在其表示的 ClearQuest ONC RPC 后端进程正在 ClearQuest Web 服务器系统上运行时才存在。一旦该进程终止,表示该进程的 MBean 也会终止。
CqOncrpcServerMBean 是 OncrpcServerMBean 的扩展。每个 CqOncrpcServerMBean 都包含 OncrpcServerMBean 定义的所有值以及以下其他值:
- activeHttpSessions[R] - 后端 ClearQuest ONC RPC 服务器正在处理的活动 HTTP 会话的当前数目。
- activeStatefulHttpSessions[R] - 后端 ClearQuest ONC RPC 服务器正在处理的有状态 HTTP 会话的当前数目。
- recycleReasonCode[R] - 指示重新启动后端 ClearQuest ONC RPC 服务器的原因的原因码(用整数表示)。
- 1=RECYCLE_TIME_LIMIT_EXCEEDED
- 2=ONCRPC_CALL_LIMIT_EXCEEDED
- 3=SESSION_LIMIT_EXCEEDED
- recycleServerHttpSessionLimit[R,W] - 后端 ClearQuest ONC
RPC 服务器在重新启动前将处理的最大会话数。将使用 CqServerFactoryMBean 中的 recycleServerHttpSessionLimit 属性值对缺省值进行初始设置。只能在正在运行的 ClearQuest ONC RPC 后端服务器上进行设置。请注意,所有 ONC RPC 后端服务器进程都不稳定。如果运行的 ClearQuest ONC RPC 服务器在尝试更改值的时候被 ClearQuest 受管连接工厂终止,那么在该服务器上设置值的操作会失败。
- totalHttpSessions[R] - 后端 ClearQuest ONC RPC 服务器已处理的 HTTP 会话总数。
- workerThreadCount[R] - 后端 ClearQuest ONC RPC 服务器正用于处理请求的线程数。