利用 wsadmin 工具修改 MBean 屬性

您可以利用 WebSphere Application Server 指令行介面 wsadmin 設定可用的 MBean 屬性, 來自訂 Rational® ClearQuest® Web 伺服器。
重要: 請勿修改任何 MBean 屬性,除非這些屬性以 [W] 表示法(表示寫入)載明為可修改,或「IBM® 支援中心」指示您這樣做。修改唯讀 [R] 或未註明的 MBean 屬性會影響系統效能。

當您使用 wsadmin 工具時,ClearQuest Web 伺服器必須在執行中。

MBean 屬性會依照其儲存所在的 MBean 來分類。您可以擷取所有以 [R] 表示為讀取的參數。可修改的參數以 [W] 表示寫入。您可以使用 IBM WebSphere® Application Server wsadmin 工具搭配 Jacl(Java 應用程式控制語言)指令,來存取這些屬性。teamAdminUtils.jacl 檔提供了 Jacl 指令、語法和函數的範例。您也可以使用網站配置 視窗來修改部分 ClearQuest Web 伺服器 MBean 屬性。

只有當 ClearQuest Web 伺服器在執行時,才能變更可修改的 MBean 參數。這些變更會立即生效,不需要重新啟動伺服器處理程序。對於控管後端「開放式網路運算遠端程序呼叫 (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 處理程序自動執行生命週期管理。

MBean 和 MBean 屬性

接下來說明的 ClearQuest Web Server MBean 屬性會依 MBean 編排:
  • TeamServerMBean
    TeamServerMBean 會保留與整體 ClearQuest Web 伺服器行為相關的屬性。控制 ClearQuest Server Factory 運作方式的特定屬性儲存在 CqServerFactoryMBean 伺服器 Factory 中。
    表 1. TeamServerMBean 屬性
    MBean 屬性 存取控制 說明
    attachmentTempLocation [R,W] 指定用於儲存附件的目錄。依預設,附件會深入儲存於 WAS 設定檔目錄結構內。不過,Windows 會將路徑名稱的長度限制為大約 250 個位元組。如果附件檔名的長度超過大約 150 個位元組,則 ClearQuest 可能無法儲存附件,因為預設儲存體位置中附件的完整路徑名稱,其長度將超過 250 個位元組。
    cqFulltextSearchCacheSize [R,W] 針對單一全文搜尋儲存在 ClearQuest 核心程式中的記錄命中數。預設值是 0(未設定)。正值會置換 ClearQuest 核心程式的預設值。
    cqFulltextSearchRecordHitLimit [R,W] 在一個全文搜尋 Web 服務呼叫中傳回的記錄命中數上限。此數目也代表可在應用程式伺服器中快取的命中數。預設值是 100。
    cqLoginSessionTimeout [R,W] Rational 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 逾時值是後端伺服器 Factory 預設讀取 Socket 逾時值的四倍。這個倍數只適用於某些作業。除非「IBM 支援中心」指示您變更這個值,否則請不要這樣做。
    maxCqSessionsPerUser [R,W] 在單一階段作業中,對每一個使用者建立的 ClearQuest 階段作業數上限。預設值是 2;最小值為 1。
    maxProcureServerAttempts [R,W] 在傳回異常狀況給受管理的連線儲存區之前,可取得後端 ONC RPC 伺服器的嘗試次數上限。預設值是 6;這個值必須大於或等於 2。
    mediumReadSocketTimeoutMultiplier [R,W] 針對特定的長時間執行作業,套用到中間層與後端伺服器元件之間 Socket 上的 read-timeout 值的倍數。預設值 2 表示 read-socket-timeout 值是 backend-server-factory default-read-socket-timeout 值的兩倍。這個倍數只適用於某些作業。除非「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] 自伺服器啟動以來所發出的 ONC RPC 呼叫數。
    totalWebServiceCallCount [R] 自伺服器啟動以來所發出的 Web 服務呼叫數。
    versionNumber [R] ClearQuest Web Server 產品版本號碼,以字串值表示,且含有內嵌的句點分隔字元。例如:7.1.2.1。
  • CqServerFactoryMBean
    這個屬性包含與 ClearQuest 受管理 Connection Factory 相關的配置值。ClearQuest 受管理 Connection Factory 會啟動並管理與 ClearQuest 核心程式進行通訊的 ClearQuest ONC RPC 後端處理程序。 這個 MBean 中的屬性如同 TeamServerMBean MBean 中的部分 ClearQuest 屬性一樣,並不會影響一般 ClearQuest 行為。相反地,這個 MBean 中的屬性會控制 Factory 的行為,且會管理其啟動的 ClearQuest ONC RPC 後端處理程序。對於剛啟動的後端處理程序,針對這個 MBean 所做的變更會立即生效;您不需要重新啟動伺服器處理程序。現有的後端處理程序不會受影響。
    表 2. CqServerFactoryMBean 屬性
    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。
    recycleServerHttpSessionLimi [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 Server 上執行時,才會執行該 MBean 伺服器處理程序。當處理程序終止時,相關聯的 MBean 處理程序也會終止。表 3 說明所有 MBean 伺服器處理程序中的基本屬性。
    表 3. OncrpcServerMBean 屬性
    MBean 屬性 存取控制 說明
    hostname [R] 在其上執行後端 ONC RPC 伺服器的主機名稱。
    oncrpcCalls [R] 後端 ONC RPC 伺服器所處理的 ONC RPC 呼叫總數。
    port [R] 後端 ONC RPC 伺服器所接聽的整數埠號。
    serverId [R] 後端 ONC RPC 伺服器的唯一 ID。
    serverStartTime [R] 指出何時啟動後端 ONC RPC 伺服器的時間戳記。此值是指自格林威治標準時間 (GMT) 1970 年 1 月 1 日 00:00:00 以後的毫秒數。
    serverState [R] 後端 ONC RPC 伺服器的現行狀態,以整數表示(0=已停止,1=執行中,2=停止中,3=已失效)。
    serverStoppingTime [R] 指出後端 ONC RPC 伺服器何時進入「停止中 (2)」狀態的時間戳記。此值是指自格林威治標準時間 (GMT) 1970 年 1 月 1 日 00:00:00 以後的毫秒數。
    serverStopTime [R] 指出後端 ONC RPC 伺服器何時進入「已停止 (0)」或「已失效 (3)」狀態的時間戳記。此值是指自格林威治標準時間 (GMT) 1970 年 1 月 1 日 00:00:00 以後的毫秒數。
    serverType [R] 後端 ONC RPC 伺服器的類型:Rational ClearQuest。
  • CqOncrpcServerMBean
    針對由 ClearQuest 受管理 Connection Factory 啟動的每一個 ClearQuest ONC RPC 後端處理程序,會各建立一個 CqOncrpcServerMBean MBean 的實例。 只有當此實例代表的 ClearQuest ONC RPC 後端處理程序在 ClearQuest Web 伺服器上執行時,此實例才會存在。只要該處理程序終止,代表該處理程序的 MBean 也會終止。

    CqOncrpcServerMBean 處理程序是 OncrpcServerMBean 處理程序的延伸。每一個 CqOncrpcServerMBean 處理程序都含有 OncrpcServerMBean 處理程序所定義的所有值,加上表 4 中所說明的屬性。

    表 4. CqOncrpcServerMBean 屬性
    MBean 屬性 存取控制 說明
    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 伺服器用來處理要求的執行緒數。

範例

使用 wsadmin 工具擷取及設定 MBean 屬性

本範例說明用來啟動及使用 wsadmin 工具的 JACL 型指令。

// 本節提供用來啟動及使用 wsadmin 工具的範例指令。
// 為了說明之用,作業系統命令提示字元會以
// 井字字元 "#" 表示,而 wsadmin 命令提示字元則以 "wsadmin>" 表示。
//
// 有一些 ClearQuest Web 伺服器 wsadmin 工具 Script 提供了一些便利的
// 方法與函數。依預設,這些 Script 位於下列
// 目錄中:
// 在 Windows 上:
//      "C:\Program Files\IBM\RationalSDLC\common\CM\scripts" 
// 在 UNIX 系統和 Linux 上:
//      UNIX 系統和 Linux 上的 "/opt/rational/common/CM/scripts"。
//
// 開啟命令提示字元,將預設目錄設為
// ClearQuest Web 伺服器 wsadmin 工具 Script 的位置。例如://
// 在 Windows 上:
# cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
//
// 在 UNIX 系統和 Linux 上:
# cd /opt/rational/common/CM/scripts
//
// 使用適用於您偏好之 Shell 的語法,
// 將 WAS_BIN 環境變數設為 wsadmin 工具的位置。例如://
// 在 Windows 上:
# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"

// 在 UNIX 系統和 Linux 上:
# WAS_BIN=/opt/rational/common/eWAS/bin

// 指定 ClearQuest Web 伺服器設定檔名稱來啟動 wsadmin 工具。
// 預設 ClearQuest Web 伺服器設定檔名稱是 'cmprofile'。例如://
// 在 Windows 上:
# %WAS_BIN%\wsadmin -profileName cmprofile

// 在 UNIX 系統和 Linux 上:
# $WAS_BIN/wsadmin.sh -profileName cmprofile

// 下列 wsadmin 指令會載入 ClearQuest Web 伺服器 wsadmin 便利函數:
wsadmin> source teamAdminUtils.jacl

// 下一個指令是如何顯示一些有用的 ClearQuest Web 伺服器指令的範例。
// getTeamServer 函數對於建立最上層 TeamServerMBean 的指標非常有用,
// 且有助於取得及設定個別 TeamServerMBean 屬性。
//
wsadmin> info proc *Team*
    startTeamEAR stopTeamEAR getTeamServer

// 下列指令會顯示可用的 'dump' 指令,以供快速且
// 容易地檢視 MBean 值:
wsadmin> info proc dump*

   dumpAllServers dumpAll dumpTeamServer dumpCcServers dumpCqServerFactory
   dumpCcServerFactory dumpCqServers


// 下一個指令會使用便利指令 'getTeamServer' 來設定
// 變數 't',其接著可以用來存取 TeamServerMBean 屬性:
wsadmin> set t [getTeamServer]

// 利用變數 't' 擷取 TeamServerMBean 屬性值:
wsadmin> $AdminControl getAttributes $t 

{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
    mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
    process=server1}

{oncrpcBufferLimit 100}
{cqLoginSessionWaitTimeout 300}
{oncrpcInterruptLimit 1000}
{sessionReaperThreadDelay 900}
{sessionQueryObjectTimeout 1800}
{oncrpcServers {
{cqLoginSessionTimeout 1800}
{cqFulltextSearchRecordHitLimit 100}
{ejbBufferLimit 100}
{sessionRecordObjectTimeout 10800}
{cqFulltextSearchPageSize 25}
{numberOfActiveSessions 0}
{sessionObjectDefaultTimeout 1800}
{maxProcureServerAttempts 6}
{cqFulltextSearchCacheSize 1000}
{maxCqSessionsPerUser 2}
{totalNumberOfOncrpcServers 0}
{numberOfHttpSessionsCreated 0}
{procureServerInterval 60}



// 以下是擷取所有 TeamServerMBean 屬性更方便的方式:
wsadmin> dumpTeamServer

TeamServerMBean 屬性:
====================

{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
    mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
    process=server1}


// 其他 'get' 便利指令包括:getCqServerFactory、getTeamServer
// 和 getOncrpcServers。


// 下一個指令會設定變數 'cq' 來存取 CqServerFactoryMBean
// 屬性。請注意,定義在之前指令中的變數 't' 是用來
// 取得 TeamServerMBean 之 cqServerFactory 屬性值的指標;
// 接著變數 'cq' 可以用來存取 CqServerFactoryMBean 中的屬性:
wsadmin> set cq [$AdminControl getAttribute $t cqServerFactory]

// 以下是設定變數 'cq' 更方便的方式:
wsadmin>set cq [getCqServerFactory]

// 下一個指令會利用先前定義的 'cq' 變數,來擷取
// CqServerFactoryMBean 屬性值:
wsadmin> $AdminControl getAttributes $cq
. . . 

// 下列指令會設定變數 'os',用來存取
// ONCRPC 伺服器 MBean 的清單,每一個各代表特定的 ONCRPC 後端伺服器。
// 該指令會使用這個階段作業開始時所「取得」之 teamAdminUtils.jacl
// Script 中定義的其中一個便利方法:
wsadmin> set os [$AdminControl invoke $t getOncrpcServers]  
        .   .   .   

        // 畫面會顯示執行中 oncrpc 後端伺服器的清單。第一個
        // oncrpc 伺服器位於索引 0(零),第二個位於索引 1,依此類推...


// 下一個指令會設定變數 'o',來存取前一個指令之輸出中顯示的
// 第一個 oncrpc 伺服器 MBean。這個層次的 MBean 屬性
// 存取(亦即,特定的 oncrpc 伺服器 MBean)很難處理,因為後端 oncrpc
// 伺服器處理程序是暫時的,可能在您可以存取之前就已解除。
wsadmin> set o [getOnc 0]      // '0' 是前一個指令輸出中
                               //  列出之第一個後端伺服器的索引編號。

// 下列指令會擷取變數 'o' 所定義之 CQ oncrpc 伺服器
// 的 MBean 屬性值:
wsadmin> $AdminControl getAttributes $o
        {workerThreadCount 16}  
        {serverState 1}
        {activeStatefulHttpSessions 0} 
        {port 3431} 
        {oncrpcCalls 7} 
        {recycleServerHttpSessionLimit 500} 
        {serverId {ClearQuest - 0
        {serverType ClearQuest} 
        {hostname testhost2}
        {activeHttpSessions 0} 
        {totalHttpSessions 1} 


// 下一個指令會設定並接著取得先前由變數 'o' 定義之 CQ oncrpc
// 伺服器中的 recycleServerHttpSessionLimit 屬性:
wsadmin> $AdminControl setAttribute $o recycleServerHttpSessionLimit 501 

wsadmin> $AdminControl getAttribute $o recycleServerHttpSessionLimit 501


// 其餘的指令會顯示一些其他 oncrpc 伺服器 MBean 存取作業和其輸出。
// 請記住,ONCRPC 伺服器的清單是暫時的;使用 dumpCqServers
// 或 dumpAllServers 之類的 dump 指令會方便得多:

wsadmin> listOnc
       "WebSphere:cell=testhost2Node02Cell,version=6.1.0.0,spec=1.0,
       name=ClearQuest - 11,mbeanIdentifier=ClearQuest - 11, 
       type=stp.management.CqOncrpcServerMBean,node=testhost2Node02,
       process=server1"
       

// 以下是使用便利的 dump 指令時會看到的內容範例:
wsadmin> dumpAllServers

ONCRPC 伺服器:ClearQuest - 0
============
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0} 
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500} 
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest} 
{hostname testhost2}
{activeHttpSessions 0} 
{totalHttpSessions 0}


wsadmin> dumpCqServers
CQRPC 伺服器:ClearQuest - 0
===========
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0} 
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500} 
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest} 
{hostname duke2}
{activeHttpSessions 0} 
{totalHttpSessions 0}


wsadmin> dumpCqServerFactory
CqServerFactoryMBean 屬性:
==========================
{serverWorkerThreadCount 10}
{recycleServerLifetimeLimit 14400}
{recyclingPeriod 3600}
{recycleServerOncrpcCallLimit 500000}
{recycleServerHttpSessionLimit 500} 
{maximumActiveServers 4}
{activeHttpSessionThreshold 40}


wsadmin> dumpAll
     // 這個指令的輸出會傾出所有 MBean 屬性值,包括
     // 所有目前執行中的後端 ONCRPC 伺服器處理程序。

使用 wsadmin 工具匯入及匯出 MBean 屬性

請使用 wsadmin 工具搭配 ClearQuest Web 伺服器 importexport 便利指令來分別匯入及匯出 MBean 屬性。 這些指令可以擷取及更新 MBean 屬性值,並提供一個簡單的方法來擷取特定的配置。如果 ClearQuest Web 伺服器未正常運作,您可以即時匯入先前擷取的工作已知配置。

您可以使用文字編輯器來編輯內容檔,然後即時匯入及匯出這些檔案。您可以註銷內容檔中任何不需要匯入的項目。請務必遵循 MBean 名稱和屬性名稱的命名慣例。若要在使用 importFile 指令時清除某個字串值,請在要匯入的內容檔中指定 "",或將該值保留空白。請勿將數值保留空白。

// 這個 wsadmin 指令會載入所有便利指令和方法,
// 包括 importFile 和 exportToFile 指令。這些指令
// 可以擷取及更新 MBean 屬性值,並提供一個簡單的
// 方式來擷取特定的配置。如果 ClearQuest Web 伺服器
// (在舊版中稱為 CM Server)未正常運作,
// 您可以即時匯入先前擷取的
// 配置。
wsadmin> source teamAdminUtils.jacl

// 如果您要擷取 TeamServerMBean 和 CqServerFactoryMBean MBean 的 Snapshot,
// 請使用 exportToFile 指令。請指定
// 要在其中儲存檔案的完整路徑名稱。您可以使用文字編輯器來編輯
// 產生的內容檔,然後使用 importFile 指令來
// 匯入該檔案。
// 重要事項:這些指令的路徑名稱中必須使用正斜線。
wsadmin> exportToFile C:/temp/CmServer.properties

"C:/temp/CmServer.properties" 檔不存在,繼續匯出...
正在擷取 MBean...
正在匯出 TeamServerMBean.sessionReaperThreadDelay...
正在匯出 TeamServerMBean.cqLoginSessionTimeout...
正在匯出 TeamServerMBean.cqLoginSessionWaitTimeout...
正在匯出 TeamServerMBean.sessionObjectDefaultTimeout...
正在匯出 TeamServerMBean.sessionQueryObjectTimeout...
正在匯出 TeamServerMBean.sessionRecordObjectTimeout...
正在匯出 TeamServerMBean.oncrpcBufferLimit...
正在匯出 TeamServerMBean.oncrpcInterruptLimit...
正在匯出 TeamServerMBean.ejbBufferLimit...
正在匯出 TeamServerMBean.cqFulltextSearchPageSize...
正在匯出 TeamServerMBean.cqFulltextSearchCacheSize...
正在匯出 TeamServerMBean.cqFulltextSearchRecordHitLimit...
正在匯出 TeamServerMBean.procureServerInterval...
正在匯出 TeamServerMBean.maxProcureServerAttempts...
正在匯出 TeamServerMBean.maxCqSessionsPerUser...
正在匯出 CqServerFactoryMBean.serverWorkerThreadCount...
正在匯出 CqServerFactoryMBean.activeHttpSessionThreshold...
正在匯出 CqServerFactoryMBean.maximumActiveServers...
正在匯出 CqServerFactoryMBean.recycleServerHttpSessionLimit...
正在匯出 CqServerFactoryMBean.recycleServerLifetimeLimit...
正在匯出 CqServerFactoryMBean.recycleServerOncrpcCallLimit...
正在匯出 CqServerFactoryMBean.recyclingPeriod...

wsadmin> importFile C:/temp/CmServer.properties

找到 "C:/temp/CmServer.properties" 檔,繼續匯入...
正將值 '900' 匯入 MBean TeamServerMBean 中的 sessionReaperThreadDelay 內容
    舊的值=900
    新的值=900
正將值 '1803' 匯入 MBean TeamServerMBean 中的 cqLoginSessionTimeout 內容
    舊的值=1803
    新的值=1803
正將值 '300' 匯入 MBean TeamServerMBean 中的 cqLoginSessionWaitTimeout 內容
    舊的值=300
    新的值=300
正將值 '1800' 匯入 MBean TeamServerMBean 中的 sessionObjectDefaultTimeout 內容
    舊的值=1800
    新的值=1800
   . . .

// 如果您嘗試匯出至已存在的檔案,則會將時間戳記
// 附加至您在指令中指定的檔名:
wsadmin> exportToFile C:/temp/CmServer.properties

"C:/temp/CmServer.properties" 檔已存在;正在附加日期到檔案名稱。
exportFilePath 現在為:C:/temp/CmServer.properties_2008-07-09_16-27-11
正在擷取 MBean...
正在匯出 TeamServerMBean.sessionReaperThreadDelay...

// 以下是一般匯出檔的樣子:
C:\> type c:\temp\CmServer.properties
# 匯出 ClearQuest Web 伺服器 MBean 屬性,建立於:2008-07-09_16-22-29
#
#
# TeamServerMBean 可寫入的屬性
#
TeamServerMBean.sessionReaperThreadDelay=900
TeamServerMBean.cqLoginSessionTimeout=1803
TeamServerMBean.cqLoginSessionWaitTimeout=300
TeamServerMBean.sessionObjectDefaultTimeout=1800
TeamServerMBean.sessionQueryObjectTimeout=1803
TeamServerMBean.sessionRecordObjectTimeout=10800
TeamServerMBean.oncrpcBufferLimit=100
TeamServerMBean.oncrpcInterruptLimit=1000
TeamServerMBean.ejbBufferLimit=100
TeamServerMBean.cqFulltextSearchPageSize=25
TeamServerMBean.cqFulltextSearchCacheSize=1000
TeamServerMBean.cqFulltextSearchRecordHitLimit=100
TeamServerMBean.procureServerInterval=60
TeamServerMBean.maxProcureServerAttempts=6
TeamServerMBean.maxCqSessionsPerUser=2
#
# CqServerFactoryMBean 可寫入的屬性
#
CqServerFactoryMBean.serverWorkerThreadCount=10
CqServerFactoryMBean.activeHttpSessionThreshold=40
CqServerFactoryMBean.maximumActiveServers=4
CqServerFactoryMBean.recycleServerHttpSessionLimit=500
CqServerFactoryMBean.recycleServerLifetimeLimit=14400
CqServerFactoryMBean.recycleServerOncrpcCallLimit=500000
CqServerFactoryMBean.recyclingPeriod=3600

意見