您可以設定可用的 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 參數。不需要重新啟動伺服器處理程序,變更會立即生效。對於控管後端 Open Network Computing Remote Procedure Call (ONC RPC) 伺服器處理程序啟動的 MBean 屬性所做的變更,不會影響已啟動的後端 ONC RPC 處理程序。只有新的後端 ONC RPC 伺服器處理程序才會使用新的設定。
ClearQuest Web 伺服器啟動時會建立兩個 MBean:TeamServerMBean 用來保留 ClearQuest Web 伺服器配置屬性,而 CqServerFactoryMBean 用來保留 ClearQuest 受管理 Connection Factory 屬性。
ClearQuest 受管理 Connection Factory 是 ClearQuest Web 伺服器元件,負責啟動一個以上的多執行緒 ClearQuest ONC RPC 後端伺服器處理程序。因為每一個 ClearQuest RPC 處理程序都是多執行緒,所以可以處理來自許多不同認證的要求。ClearQuest 受管理 Connection Factory 會對每一個 ClearQuest RPC 處理程序自動執行生命週期管理。
ClearQuest Web 伺服器包括下列 MBean。
- TeamServerMBean
TeamServerMBean 保留與整體 ClearQuest Web 伺服器行為相關的屬性。控制 ClearQuest 伺服器 Factory 運作方式的特定屬性儲存在 CqServerFactoryMBean 伺服器 Factory 中。
- cqFulltextSearchCacheSize[R,W] - 針對單一全文搜尋儲存在 ClearQuest 核心程式中的記錄命中數。這個值是用來置換 ClearQuest 核心程式所採用的預設行為。
這個屬性的預設值是 0,向 ClearQuest Web 伺服器表示這個值未設定,不應用來置換 ClearQuest 核心程式的預設值。正值會置換 ClearQuest 核心程式的預設值。
- cqFulltextSearchPageSize[R,W] - 針對單一全文搜尋,於 ClearQuest 核心程式中一頁全文搜尋結果的記錄命中數。這個值是用來置換 ClearQuest 核心程式所採用的預設行為。
這個屬性的預設值是 0,向 ClearQuest Web 伺服器表示這個值未設定,不應用來置換 ClearQuest 核心程式的預設值。正值會置換 ClearQuest 核心程式的預設值。
- cqFulltextSearchRecordHitLimit[R,W] - 針對單一全文搜尋,一個 web 服務呼叫所傳回的相符記錄數目上限;亦指應用程式伺服器可快取的相符數。預設值是 100。
- cqLoginSessionTimeout[R,W] - ClearQuest 登入階段作業在逾時之前的持續時間秒數。預設值是 1800 秒(30 分鐘)。每一個 ClearQuest 階段作業都會使用一個資料庫連線,因此這個值設定太高可能會耗用太久的資源。請勿變更預設值。
- cqLoginSessionWaitTimeout[R,W] - 執行緒取得 Rational ClearQuest 登入階段作業的應等待時間秒數。預設值是 300 秒。
- cqServerFactory[R] - ClearQuest、J2C Connection Factory MBean 的物件名稱。
- cqUserDBListSecureAccess[R,W] - 指出當使用者嘗試使用無效的認證登入 ClearQuest Web 時,他們是否可以看見資料庫的清單。預設值是 false,表示如果使用者嘗試使用無效的認證登入,他們可以看見資料庫清單。如果此值設為 true,則會啟用使用者鑑別,如果使用者嘗試使用無效的認證登入,則不會讓他們看見資料庫清單。
- ejbBufferLimit[R,W] - 會由 EJB 呼叫傳回的物件數上限。預設值是 100。
- keepAliveInterval[R,W] - 如果設為大於 0(零)秒的值,且在指定的定期間隔未曾傳送資料流量,則 ClearQuest Web 伺服器會於該間隔在用戶端與後端伺服器元件之間發出保留作用中訊息。此設計旨在確保長時間執行的 ClearQuest 查詢可以完成,而不需要在基礎架構中移除基礎 Socket。
這個值應該至少為 10 秒,小於 Socket 逾時值。預設值是 300 秒(5 分鐘)。
- largeReadSocketTimeoutMultiplier[R,W] - 針對某些長時間執行的作業,套用到中間層與後端伺服器元件之間的 Socket 上之讀取逾時值的乘數。預設值 4 表示讀取 Socket 逾時值,是後端伺服器原廠預設讀取 Socket 逾時值的四倍。這個乘數只適用於某些作業。除非「IBM 支援中心」指示您變更這個值,否則請不要這樣做。
- maxCqSessionsPerUser[R,W] - 在單一階段作業中,會對每一個使用者建立的 ClearQuest 階段作業數上限。預設值是 2;最小值為 1。
- maxProcureServerAttempts[R,W] - 在傳回異常狀況給受管理的連線儲存區之前,允許取得後端 ONC RPC 伺服器的嘗試次數上限。預設值是 6;必須大於或等於 2。
- mediumReadSocketTimeoutMultiplier[R,W] - 針對某些長時間執行的作業,套用到中間層與後端伺服器元件之間的 Socket 上之讀取逾時值的乘數。預設值 2 表示讀取 Socket 逾時值,是後端伺服器原廠預設讀取 Socket 逾時值的兩倍。這個乘數只適用於某些作業。除非「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 Connection Factory 實例中執行的後端 RPC 伺服器數。
- totalOncrpcCallCount[R] - 自伺服器啟動以來,所發出的 oncrpc 呼叫總數。
- totalWebServiceCallCount[R] - 自伺服器啟動以來,所產生的 Web 服務呼叫總數。
- versionNumber[R] - ClearQuest Web 伺服器產品版本號碼,以字串值表示,並用句點區隔。例如:7.1.0.1。
- CqServerFactoryMBean
這個 MBean 會保留與 ClearQuest 受管理 Connection Factory 相關的配置屬性。ClearQuest 受管理 Connection Factory 會啟動並管理與 ClearQuest 核心程式進行通訊的 ClearQuest ONC RPC 後端處理程序。
這個 MBean 中的屬性如同 TeamServerMBean 中的部分 ClearQuest 專屬屬性一樣,並不會影響 ClearQuest 一般行為。相反地,這個 MBean 中的屬性會控制 Factory 的行為,以及其啟動的 ClearQuest ONC RPC 後端處理程序的管理作業。對於剛啟動的後端程序來說,針對這個 MBean 所做的變更會立即生效(現有的後端程序不會受到影響);您不需要重新啟動伺服器處理程序。
- activeHttpSessionThreshold[R,W] - 在作用中後端 ClearQuest ONC RPC 伺服器中的作用中 HTTP 階段作業數,如果超出,這個受管理 Connection Factory 可能會啟動另一個後端 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] - 這個受管理 Connection Factory 允許的作用中後端 ClearQuest ONC RPC 伺服器數目上限。預設值是 10。
- recycleServerHttpSessionLimit[R,W] - 在由這個受管理 Connection Factory 重新啟動之前,後端 ClearQuest ONC RPC 伺服器會處理的 HTTP 階段作業數。預設值是 200。零的值表示不應檢查這項限制。
- recycleServerLifetimeLimit[R,W] - 在由這個受管理 Connection Factory 重新啟動之前,後端 ClearQuest ONC RPC 伺服器可執行的生命期限上限(以秒為單位)。預設值是 86,400 秒(24 小時)。零的值表示不檢查這項限制。
- recycleServerOncrpcCallLimit[R,W] - 在由這個受管理 Connection Factory 重新啟動之前,後端 ClearQuest ONC RPC 伺服器會處理的 ONC RPC 要求數上限。預設值是 100,000。零的值表示不檢查這項限制。
- recyclingPeriod[R,W] - 在由這個受管理 Connection Factory 終止之前,允許重新啟動後端 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 受管理 Connection Factory 啟動的每一個 ONC RPC 後端處理程序,會各建立一個 CqOncrpcServerMBean 的實例。
每一個 MBean 皆包含基本 OncrpcServerMBean 中定義的值(請注意,基本 OncrpcServerMBean 永遠不會實例化)。只有當每一個伺服器處理程序 MBean 所代表的處理程序在 ClearQuest Web 伺服器系統上執行時,MBean 才會存在。當該程序終止時,代表該程序的 MBean 也會終止。下列是所有伺服器程序 MBean 中的基本屬性:
- hostname[R] - 在其中執行後端 ONC RPC 伺服器的主機名稱。
- oncrpcCalls[R] - 後端 ONC RPC 伺服器已處理的 ONC RPC 呼叫總數。
- port[R] - 後端 ONC RPC 伺服器接聽的整數埠號。
- serverId[R] - 後端 ONC RPC 伺服器的唯一 ID。
- serverStartTime[R] - 代表後端 ONC RPC 伺服器啟動時的時間戳記。此值是指格林威治標準時間 1970 年 1 月 1 日 0 點以後的毫秒數。
- serverState[R] - 後端 ONC RPC 伺服器的現行狀態,以整數表示(0=已停止,1=執行中,2=停止中,3=已失效)。
- serverStoppingTime[R] - 代表後端 ONC RPC 伺服器進入 STOPPING (2) 狀態時的時間戳記。此值是指格林威治標準時間 1970 年 1 月 1 日 0 點以後的毫秒數。
- serverStopTime[R] - 代表後端 ONC RPC 伺服器進入 STOPPED (0) 或 DEAD (3) 狀態時的時間戳記。此值是指格林威治標準時間 1970 年 1 月 1 日 0 點以後的毫秒數。
- serverType[R] - 後端 ONC RPC 伺服器的類型(Rational ClearCase®)。
- CqOncrpcServerMBean
針對由 ClearQuest 受管理 Connection Factory 啟動的每一個 ClearQuest ONC RPC 後端處理程序,會各建立一個 CqOncrpcServerMBean 的實例。唯有當此實例所代表的 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 受管理 Connection Factory 終止執行中的 ClearQuest ONC RPC 伺服器,則對該伺服器設定此值可能會失敗。
- totalHttpSessions[R] - 後端 ClearQuest ONC RPC 伺服器已處理的 HTTP 階段作業總數。
- workerThreadCount[R] - 後端 ClearQuest ONC RPC 伺服器正用來處理要求的執行緒數。