特定管理 > 分析系統與企業資訊 > 系統組態收集器 > 收集狀況視窗詳細資訊
  
收集狀況視窗詳細資訊
當您開始使用「系統組態收集器」收集系統資訊時,以及傳送收集的資訊時,「收集狀況」視窗會開啟。
此主題提供「收集狀況」視窗中可用的取消功能,以及視窗中顯示的訊息與圖示的相關詳細資訊。
停止收集或傳送資訊的 Windchill 動作
當在「收集狀況」視窗中啟動「取消作業」按鈕時,可以停止尚未執行的剩餘 Windchill 收集器動作。
如果在執行外掛程式時按一下「取消作業」,Windchill 會嘗試停止執行外掛程式;但是,外掛程式的執行通常無法停止,外掛程式可能會繼續執行,直到完成為止。所有剩餘的外掛程式都會取消,如果剩餘動作包括傳送操作,則也會取消這些動作。
如果在檔案傳送時按一下「取消作業」,則不會停止目前的傳送操作;但是,將會取消所有剩餘的傳送操作。
當取消 Windchill 收集器動作時,Windchill 不會刪除從已完成但尚未傳送的外掛程式中產生的資料夾或檔案。而是會在產生的時間日期資料夾名稱後面附加 "-canceled"。例如,假設資訊儲存於 2010 年 7 月 10 日下午 2 點 35 分 5 秒,然後操作被取消,則已取消操作的目錄名稱為:
100710143505-canceled
取消收集動作之後,審核產生的資訊以確定其是否有用。完成審核後,請務必刪除剩下來的任何檔案與資料夾。
瞭解顯示在收集狀況視窗中的外掛程式的訊息
當 Windchill 開始收集系統資訊時,「收集狀況」視窗會顯示您開始收集列出的資訊時所選的類別。
當各個外掛程式執行時,顯示的訊息會不斷更新,格式如下:
Executing plugin: <plugin_display_name>
<plugin_display_name> plugin executed using: <process_id>@<host_name>
Collected data location: <Windchill>/utilities/SystemConfigurationCollector/saved/
<save_dir>/<type>/<date_time>
<completion_status>
其中:
<plugin_display_name>
是正在執行的外掛程式的顯示名稱。建立外掛程式時,建立者會指定「系統組態收集器」所使用的顯示名稱。顯示名稱不需要與可從 JMX 用戶端檢視的 MBean 名稱相同。
<process_id>@<host_name>
識別軟體流程 (伺服器管理員、應用伺服器或其他流程,例如 Windchill 目錄伺服器流程) 及在其上執行外掛程式的電腦。如果執行外掛程式發生問題,可以使用流程 ID 來尋找執行中的流程。電腦名稱可標識流程在何處執行,以及由此外掛程式收集的資訊儲存於本機的何處。
<Windchill>
是 Windchill 安裝目錄路徑。
<save_dir>
是一個建立的子目錄,用來保存來自特定動作的所有已收集資訊,以收集系統組態資訊:
如果選取了「收集與儲存」選項,<save_dir> 即是您在「收集系統資訊」視窗中指定的目錄。
如果選取了「收集、儲存與傳送」選項,<save_dir> 即是您在「收集系統資訊」視窗中輸入的字母 C 後跟技術支援呼叫編號。
<type>/<date_time>
是為要儲存的資訊類型建立的額外目錄路徑,以及建立檔案的日期與時間。如需詳細資訊,請參閱已收集資訊的詳細資訊
<completion_status>
指示外掛程式是否成功完成,並提供儲存狀況資訊的目錄路徑。下列是可能的訊息:
<plugin_display_name> completed successfully.
指示外掛程式執行完畢,且未發生錯誤。
<plugin_display_name> failed. <message>
指示未成功完成外掛程式執行。傳回的 <message> 指示遇到的問題類型。
當傳回的訊息所標識的來源位置無效時,失敗有一個可能的解釋,就是外掛程式可能嘗試從未安裝的元件存取檔案。例如,如果在未安裝 Windchill Business Reporting 的情況下執行 Windchill Business Reporting 類別中的外掛程式,則此類別中的許多外掛程式會失敗,因為未安裝所需的檔案。
如果在執行外掛程式期間取消收集操作,會傳回以下訊息:
The plugin execution was canceled.
如果有一或多個外掛程式可以執行,但其他外掛程式無法執行,則會傳回以下訊息:
Collection operation has been canceled; Before the cancelation, execution of one or more plugins completed successfully. Results:
One or more plugin executions failed.
在叢集環境中執行外掛程式時,「系統組態收集器」會確定在何處執行個別外掛程式。如果外掛程式在叢集的多個節點上執行,則會傳回多個訊息集合。在每一個集合中,都有唯一的流程 ID 與主機名稱來識別外掛程式在何處執行。
處理完所有外掛程式之後,會傳回以下訊息:
All plugins have been processed.
Saving the plugin execution status log to: <Windchill>/utilities/SystemConfigurationCollector/saved/<save_dir>/PTC_Logs/<date_time>
所儲存的狀況檔案名稱為 gatherExecutionStatus.log
例如,假設成功執行 Web 伺服器記錄檔外掛程式後會在「收集狀況」視窗中產生以下訊息:
Executing plugin: Web Server Logs Web Server Logs plugin executed using: 3456@myhost Collected data location: D:ptc\Windchill\utilities\SystemConfigurationCollector\saved\issue15\PTC_Logs\100609194415
Web Server Logs completed successfully.
從訊息內容中可解釋以下內容:
所選類別包括 Web 伺服器記錄檔外掛程式,它由應用伺服器以流程 ID 3456 在 myhost 主機上執行。
Windchill 安裝目錄為 D:ptc\Windchill
針對已儲存的資訊輸入的目錄為 issue15
收集的日期與時間為 2010 年 6 月 9 日的 19:44:15。
瞭解與傳送資訊給 PTC 技術支援部門相關的訊息
在封裝及傳送包含所收集檔案的每個目錄的內容時,顯示畫面都會更新,其訊息格式如下:
Sending data on cluster node: <process_id>@<host_name>
<type> directory sent from location: <Windchill>/utilities/SystemConfigurationCollector/
saved/<save_dir>/<type>/
<completion_status>
其中:
<process_id>@<host_name>
識別軟體流程 (伺服器管理員、應用伺服器或其他流程,例如 Windchill 目錄伺服器流程) 及用來建立已儲存檔案的電腦。
<type>
是內容被封裝及傳送的目錄的名稱。可能的類型如已收集的資訊類型所述。
<Windchill>
是 Windchill 安裝目錄路徑。
<save_dir>
是一個建立的子目錄,用來保存來自特定動作的所有已收集資訊,以收集系統組態資訊:
如果選取了「收集與儲存」選項,<save_dir> 即是您在「收集系統資訊」視窗中指定的目錄。
如果選取了「收集、儲存與傳送」選項,<save_dir> 即是您在「收集系統資訊」視窗中輸入的字母 C 後跟技術支援呼叫編號。
<completion_status>
指示資料是否成功傳送。下列是可能的訊息:
Data sent successfully.
指示未傳回錯誤。
Sending data failed with: <error_message>
指示未成功完成傳送操作。錯誤訊息通常是一個 HTTP 回應碼,後跟一則指示輸送問題的訊息,或一則 Java 訊息 (如果資料本身有問題)。
如果在傳送資料時取消收集操作,會傳回以下訊息:
Request received to cancel current operation.
如果已傳送一或多個目錄,尚有其他目錄未傳送,則會傳回以下訊息:
Send operation has been canceled; one or more directories have not been sent. Before the cancelation, some data was sent.
以下是一則範例訊息,指示傳送操作成功完成:
Sending data on cluster node: 3456@myhost WinDU directory sent from location: D:ptc\Windchill\utilities\SystemConfigurationCollector\saved\C7111666\WinDU\
Data sent successfully.
可從範例中解釋以下內容:
WinDU 目錄中的檔案透過在 myhost 主機上以流程 ID 3456 執行應用伺服器上的外掛程式來建立。
Windchill 安裝目錄為 D:ptc\Windchill
輸入的呼叫編號是 7111666。
正在傳送 WinDU 目錄的內容。
如果要在本機儲存已傳送檔案的副本 (此為預設),Windchill 會儲存 ZIP 檔案,然後從 saved 目錄中刪除對應檔案。如需預設 sent 目錄的詳細資訊,請參閱已傳送資訊的本機目錄結構
傳送完所有資料之後,以下訊息會顯示在視窗中:
Data from all directories has been sent.
如果傳送任何資料 (包括報告) 失敗,以下訊息會顯示在視窗中:
One or more send operations failed.