pimSupport.sh Script

語法

pimSupport.sh --help --version --outputdirectory=path_to_store_the_result 
--pmrnumber=<xxxxx.bbb.ccc>
--logtracking=start|stop --monitor=start|stop
--dumpprocess=<service name | PID> [--count --interval]
--basic --code=<company_code> --keeplog=yes|no
--collectlogs=all|allPIM|AS|appsvr|scheduler|workflowengine|queuemanager|admin|eventprocessor
 --fromtime=from_time  --totime=to_time
--code=<company_code> --colarea=<collaboration_area_name>
--catalog=<catalog_name>
 

參數

一般選項的參數

-h --help

列印用法訊息。

-v --version

列印 pimsupport.sh的版本號碼。

-o --outputdirectory=<path_to_store_the_result>

指定最終輸出檔所在的目錄。 如果未指定，則預設目錄是 $TOP/etc/default/common.properties 檔案中定義的 tmp 目錄。

-p --pmrnumber=<xxxxx.bbb.ccc>

產生的保存檔會以 PMR 號碼作為字首，以在 ecurep FTP 伺服器上進行適當的識別及儲存。

資訊收集選項的參數

-t --logtracking=start | stop

此參數用於啟動或停止記載至具有 log level=debug 和 maxBackupIndex=5的不同目錄。

-m --monitor=start | stop

此參數用於啟動或停止背景工作，其會持續監視系統資訊，例如 vmstat 和 iostat。 輸出會暫時寫入 $TOP/logs/diagnostic/system_status 目錄下。 若要提取監視結果，請使用下列選項: –collectmonitorlogs=yes

-d --dumpprocess=<service name | PID> [--count --interval]

此參數用於傾出具有指定 ID "PID" 或 "service name" 之處理程序的處理程序資訊，通常用於具有高處理器用量的處理程序。 此選項 (不含任何其他選項) 會提供可用服務及 PID 的清單。 --count 及 --interval 是選用參數，可決定記憶體傾出產生之間的次數及間隔。 預設值為 5 和 30 秒。

附註: 部分參數在叢集環境中無法運作。

附註: 第一次執行 pimSupport.sh 指令時，不會移除 proc_info 目錄。 執行 pimSupport.sh 指令之後，您需要手動刪除 proc_info 目錄。 使用此修正程式，在執行 pimSupport.sh -dumpprocess 指令之後，您將不再看到 $TOP/logs/diagnostic 目錄下的 proc_info 目錄。 proc_info 目錄的內容包含在所產生的 Tar 檔中，現在可以在 highcpulogs 目錄下找到。 proc_info 目錄的內容已包含在產生的 Tar 檔中，可在 highcpulogs 目錄下找到。

-b --basic

此參數用來收集基本環境配置及系統狀態資訊。

--code=<company_code>

這是選用參數。 如果指定的話，此參數會收集該公司的 Product Master 實體計數。

--keeplog=yes | no

這是選用參數。 如果指定的話，此參數會保留用於最終報告的所有暫時輸出。 如果未指定，則相當於 --keeplog=no。 如果最終性能報告有任何問題，此選項可協助除錯。

-l --collectlogs=all | allPIM | AS | appsvr | scheduler | workflowengine | queuemanager | admin | eventprocessor

all 指定從 $TOP/logs 目錄收集所有日誌。

allPIM 指定收集 Product Master的所有日誌檔。

AS 指定收集 WebSphere® 的日誌檔。

appsvr 指定從應用程式伺服器服務收集所有日誌。

排程器 指定從排程器服務收集所有日誌。

workflowengine 指定從工作流程引擎服務收集所有日誌。

queuemanager 指定從佇列管理程式服務收集所有日誌。

admin 指定從管理服務收集所有日誌。

eventprocessor 指定從事件處理器服務收集所有日誌。

此參數用於收集產品產生的日誌檔。 如果未指定，則不會收集任何日誌。 您可以指定多個服務，方法是使用 | 字元來區隔每一個服務，並以引號 "|"括住它們。

除了指定此參數來收集特定 Product Master 服務的 WebSphere Application Server 日誌及日誌檔之外，您還可以套用時間型過濾機制，指定 fromtime 或 totime 選項以僅收集日誌檔的部分。

附註: 時間型過濾器僅適用於 Product Master 日誌。 這些過濾器 不 適用於 WebSphere Application Server 日誌。

這些選項用來選取特定時間範圍的日誌項目。

-- fromtime

選擇性地指定此選項，以設定 從 收集日誌檔中的日誌項目的時間。 預設值為 1970 年 1 月 1 日 00:00。

以下列格式表示的日期時間字串:

MM_dd_yyyy__HH_mm

其中：

• MM 代表兩位數的月份
• dd 代表兩位數的日期
• yyyy 代表四位數年份
• HH 代表兩位數的小時
• mm 代表兩位數的分鐘

指定此選項時，也會收集所有指定服務的 svc.out、 svc.err及 svc.pid 檔案。

-- totime

選擇性地指定此選項，以指定收集日誌檔中日誌項目 至 的時間。 預設值是啟動程式的時間。

以下列格式表示的日期時間字串:

MM_dd_yyyy__HH_mm

其中：

• MM 代表兩位數的月份
• dd 代表兩位數的日期
• yyyy 代表四位數年份
• HH 代表兩位數的小時
• mm 代表兩位數的分鐘

附註：

• 這些選項用來選取特定時間範圍的日誌項目。 它們必須與 collectlogs 選項搭配使用。
• 如果同時指定 fromtime 和 totime ，則會收集在指定時段內產生的日誌項目。
• 如果指定 fromtime 但未指定 totime ，則會收集從 fromtime 開始直到啟動程式為止所產生的日誌項目。
• 如果指定 totime 但未指定 fromtime ，則會收集在 totime 之前產生的日誌項目。
• 如果 未 指定 fromtime 和 totime ，則會收集所有日誌項目。 一次只能提供一個選項值，且該選項值不得包含 "|"。

db2support <OUTPUT_DIR_PATH> -f -d <DB_SERVICE_NAME> -m -c -u <DB_USER_NAME> -p <DB_USER_PWD> /dev/null

範例