IBM® Support Assistant Lite 工具旨在協助疑難排解 IBM 軟體產品的問題。此工具著重於自動收集問題資料。此外,也針對 IBM 軟體產品所發現的各種種類問題,提供症狀分析支援。它會收集並分析和某種問題類型有關的資訊,以協助找出調查中問題的根源。此工具可協助您縮短重建問題(設有適當追蹤層次)的時間,以及減少將適當日誌資訊傳送至『IBM 支援中心』所需的心力。在此說明手冊中,我們會告訴您如何啟動並執行 IBM Support Assistant Lite 工具。
在大多數情況下,執行下列步驟序列可讓您啟動並執行此工具。如果您遇到問題,或需要其中任何步驟的相關資訊,則可以參閱此步驟下面的區段。
無論如何,只需解壓縮所下載保存檔中的檔案,即可完成 IBM Support Assistant Lite 工具的安裝作業。可以將這些檔案解壓縮到預期執行此工具的檔案系統位置 (您可以在系統上選擇任何檔案系統位置來執行此工具)。這會在此目標目錄中建立子目錄 \ISALite。
不論您是在 GUI 模式下還是在指令行主控台模式下使用 IBM Support Assistant Lite 工具,都可以使用相同的程序來啟動此工具:從指令行呼叫適當的啟動 Script。若為 Windows 系統,則這些啟動 Script 是批次檔。若為其他環境,則它們是 Shell Script。
由於此工具是實作為 Java 應用程式,因此必須先設定 JAVA_HOME 環境變數才能啟動此工具。 如果 PATH 上沒有 Java,則您將必須手動設定 JAVA_HOME 環境變數。IBM Support Assistant Lite 工具需要 JRE 1.4.2 版或以上版本(在 Windows 7 64 位元上為 1.5 或以上版本),因此您必須先確定預期執行此工具的系統上有安裝適當的 JRE。如果有安裝適當的 JRE,則您將需要發出作業系統特定指令,以便將 JAVA_HOME 變數設為指向此 JRE。不支援 Microsoft JVM/JDK 及 gij (GNU libgcj)。 例如,在 Windows 平台上,如果您將 jdk1.4.2 安裝在 c:\jre1.4.2 中,請使用下列指令來設定 JAVA_HOME:
SET JAVA_HOME=c:\jre1.4.2
在 Linux、AIX、HP-UX 或 Solaris 平台上,用來設定 JAVA_HOME 變數的確切指令語法視您使用的 Shell 而定。例如,如果您使用 Bash Shell,且將 JDK 安裝在 /opt/jre142 中,請使用下列指令來設定 JAVA_HOME:
export JAVA_HOME=/opt/jre142
將此工具安裝至其中一個預設位置之後,您可能會發現無法啟動此工具,且傳回錯誤訊息『錯誤:此工具需要 JRE 1.4.2 或以上版本才能執行』。此訊息指出 JRE 的版本低於 1.4.2。在此情況下,請手動設定 JAVA_HOME 變數,以指向適當版本的 JRE。
您需要發出下列啟動 Script:
如果無法使用 GUI,則會自動在指令行模式下啟動此工具。如果在即使可以使用 GUI 時也需要主控台模式,則請在指令行上指定 "-console"。在某些實例中,無法判斷 GUI 無法使用,且不會啟動此工具。在這些實例中,需要使用 "-console" 來重新啟動此工具。
依預設,ISA Lite 安裝目錄會用來儲存在執行期間所建立的檔案。 在某些系統上,ISA Lite 安裝目錄是唯讀目錄。在此實例中,請使用 -useHome 參數。此參數會使暫存檔寫入系統暫存目錄,而持續檔案則會寫入使用者起始目錄。
在 GUI 模式下啟動 IBM Support Assistant Lite 工具之後,即會顯示下面所示的圖形介面。
您必須如下面示範,先在『問題類型』視窗中選取問題類型,才能使用此工具來執行資料收集及分析。
除了『問題類型』之外,您唯一需要在主要 GUI 上提供的輸入欄位值為資料收集 ZIP 檔的檔名。此時,您可以隨意輸入檔名,例如,您可以使用檔名 Install_failed_2007_01_03。如果您沒有提供檔名,此工具會自動附加 "zip" 副檔名。不過,如果您執行收集的問題已開啟 PMR,以及如果您要讓此工具自動將收集結果以 FTP 傳送至『IBM 支援中心』,則在 FTP 步驟中,此工具會施行『IBM 支援中心』所要求的特定檔案命名慣例:檔名必須以 3 個特定欄位開頭:<pmrnumber>.<branchnumber>.<countrycode>.<short description>.zip。此類型檔名的範例如下:34143.055.000.logs.zip。為了與之前的格式相容,也接受在前三個句點處放置逗點(但不可放在 "zip" 副檔名之前的第四個句點處)。不過,句點是偏好的定界字元。
填寫這些值之後,下一步是按 [收集資料] 按鈕。作業繼續執行時,收集 Script 會要求您提供完成其收集活動所需的任何其他資訊。Script 可能也會要求您提供配置資訊、會導致您目前所處理問題的事件順序相關資訊,或者是您希望如何完成收集的相關喜好設定。一旦它具備所有的必要資訊後,Script 會繼續處理後段的收集程序。
當此工具完成資料收集時,您可以將結果傳送給 IBM 支援中心。您可以選擇使用不加密的 FTP 或加密的 HTTPS 來傳送檔案。此工具傳送給 IBM 支援中心的 ZIP 檔名稱,將會是 [輸出檔名/路徑] 方框中所輸入的檔名,並附加伺服器主機名稱及現行時間戳記。
範例:如果使用的 [輸出檔名/路徑] 檔名是 34143.055.000.logs.zip,則傳送給 IBM 的 ZIP 檔名稱會是
34143.055.000.logs.zip-<hostname>-<currentTimestamp>.zip。
『IBM 支援中心』FTP 網站 ftp.emea.ibm.com 的自動化,完全根據 IBM Support Assistant Lite 工具主要 GUI 所述的檔案命名慣例。如果接收到的檔案名稱未遵循此慣例,則該檔案不會傳送至 IBM 支援中心。因此,此工具在呼叫 FTP 作業以將收集 ZIP 檔傳送至 ftp.emea.ibm.com 之前,會針對慣例驗證收集 ZIP 檔的名稱。如果檔名的格式不正確,則會出現蹦現視窗,讓您更正檔名。FTP 網站的現行檔案命名慣例即為此處所記載的慣例,其中,組合檔名稱中的個別欄位以句點區隔。不過,之前的慣例是使用逗點作為分隔字元。因為 FTP 網站仍會處理根據之前的慣例所命名的檔案,因此 IBM® Support Assistant Lite 工具的驗證邏輯同時接受以句點及逗點作為定界字元。
當 IBM Support Assistant Lite 在指令行主控台模式下執行時,不會提供選項清單或輸入欄位供使用者輸入。 可選的選項採編號清單呈現,請輸入您的選項編號,然後按 Enter 鍵。輸入欄位則轉變成提示,請輸入您的回應,然後按 Enter 鍵。
若要停止收集器工具,請在主控台模式下鍵入 quit。
此工具會提示您輸入檔名。在 Unix 平台上,不支援使用 "~" 來指定使用者的 HOME 目錄。如果使用 "~",則會參照目前工作目錄下名稱為 "~" 的子目錄。
主控台模式也提供無聲自動收集功能,可讓您將主控台模式階段作業的回應記錄在檔案中,這樣,以後就可以使用該檔案來驅動執行相同的收集 Script。
若要達到此目的,請先建立【回應檔】,其中包含透過資料收集器執行之特定作業的所有問題答案。下次需要執行相同的資料收集時,只要在啟動工具時提供回應檔,就會使用之前提供的答案來回答所有問題。您可以調整及修改回應檔,以改變答案來執行不同的資料收集。
若要建立回應檔,您只要在指令行主控台模式下,以 -record 選項(後面接著回應檔的名稱)呼叫此工具即可。例如,在 Linux 環境中,您可以執行:
./runISALite.sh -console -record response.txt
在此模式下執行時,您會被帶到原始的互動式階段作業,並在其中對 Script 提示提供回應。不過,您的回應除了會影響現行收集之外,也會儲存在所命名的檔案中。互動式階段作業一旦完成之後,日後您就可以使用此回應檔來執行相同的 Script,而不需要明確的使用者輸入。
例如,若要在 UNIX 環境中,使用您記錄的回應檔以無聲自動模式執行此工具,請執行:
./runISALite.sh -console response.txt
回應檔是純文字檔案,因此您可以編輯該檔案,以視需要變更使用者的回應。例如,如果您想要在與記錄回應檔不同的系統上執行此工具,您可能需要調整回應檔中的部分值。
使用回應檔時,請記住使用者名稱及密碼等機密性資訊可能會儲存在這些檔案中,因此管理這些檔案時請務必防止機密性資訊受到未獲授權的存取。此外,並非所有資料收集都適用於無聲自動收集選項。部分資料收集一律需要與使用者進行一些互動作業。例如,可能會要求您重新產生資料收集期間的問題,以收集適當的日誌和追蹤檔案。在此情況下,無聲自動收集無法記錄及重新產生此步驟。
自 ISA Lite 1.3.4 版開始,回應檔格式變得更方便人類讀取/編輯。此檔案非常類似 Java 內容檔,並含有以 '#' 開頭的註解,以及一系列鍵值組。
現在有方法可新增暫停至這些新回應檔(使用您最愛的編輯器)。下列是兩個受支援新索引鍵的簡短摘要:
注意事項
依預設,此工具(及其各種子元件)的版本會列印到在其中啟動此工具的主控台中。在 GUI 模式下執行時,使用 [說明 -> 關於功能表] 選項,也可以找到版本資訊。 如果 Java 無法使用,或者 Java 應用程式無法啟動,則也可以藉由執行含有 "-version" 選項的啟動 Script,來取得此工具的版本。
使用 "-version" 選項時,啟動 Script 會印出版本資訊,但不會實際呼叫此工具。
IBM、IBM 標誌及 AIX 是 International Business Machines Corportation 在美國及/或其他國家或地區的商標或註冊商標:
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Microsoft、Windows、Windows NT 及 Windows 標誌是 Microsoft Corporation 在美國及/或其他國家或地區的商標。
UNIX 是 The Open Group 在美國及其他國家或地區的註冊商標。
Linux 是 Linus Torvalds 在美國及/或其他國家或地區的商標。
HP-UX 是 Hewlett-Packard Company 的註冊商標。
其他公司、產品或服務名稱,可能為第三者之商標或服務標誌。