使用記錄檔疑難排解 2007 Office system 的安裝和設定問題

適用於: Office Resource Kit

 

上次修改主題的時間: 2015-03-09

本文內容:

  • Windows 應用程式事件記錄檔

  • Office system 安裝程式記錄

  • TCO (GIMME) 記錄

  • Windows Installer 記錄

  • Office 2007 OSE 記錄

本文涵蓋五種不同的記錄選項,可供您用來疑難排解與安裝和設定 2007 Microsoft Office 系統 有關的問題。

Windows 應用程式事件記錄檔

Windows Installer 會將項目寫入 Windows 應用程式事件記錄檔,以記錄類似下列的事件:

  • 安裝、移除或修復產品成功或失敗。

  • 產品設定期間發生的錯誤。

  • 偵測損毀的設定資料。

  • 與遺失元件導致必須修復應用程式相關的資訊。

檢閱應用程式事件記錄檔

您可以在事件檢視器中找到 Windows 應用程式事件記錄檔。

當系統自動初始化修復作業但卻失敗時,通常會在 Windows 應用程式事件記錄檔中記錄兩個事件。

  • MsiInstaller 事件 1001 會識別所要求之關鍵路徑的產品代碼、功能以及元件碼。

  • MsiInstaller 事件 1004 會識別損毀時偵測到的關鍵路徑的產品代碼、功能以及元件碼。

在識別參照為損毀關鍵路徑的確切資源時,將必須用到指定之產品的 MSI。您可以查看下列任一位置,找出 MSI:

  • 控制台 | 新增/移除程式

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90120000-####-####-0000-0000000FF1CE} 登錄區底下的登錄檔。尋找參照 *<Product>*WW.msi 的 GUID。

如需 GUID 編號配置的詳細資訊,請參閱 Microsoft 知識庫文件 928516:說明 2007 Office 套件和程式中產品代碼 GUID 的編號配置 (https://go.microsoft.com/fwlink/?linkid=128098\&clcid=0x404) (機器翻譯)。

2007 Office system 安裝程式記錄

當安裝、升級或更新 2007 Office System 發生問題時,疑難排解問題所要查看的第一個部分,就是記錄檔。透過建立詳細的記錄檔,然後分析記錄檔中的傳回碼,可以看出不少資訊。

在舊版 Office 中,您使用 Windows Installer 屬性自訂並控制 Office 安裝。在 2007 Office System 中,安裝程序經過重新設計且記錄會受下列項目的影響:

  • Config.xml 檔案中的 Logging 項目 (建議使用的方法)。

  • 使用 Office 自訂工具 (OCT) 新增的記錄屬性。

根據預設,2007 Office System 安裝程式會自動在 %TEMP% 資料夾中建立記錄檔。安裝程式預設會將所有項目記錄至記憶體;因此,因安裝失敗或取消而產生的錯誤會使安裝程式在失敗時切換成詳細資訊記錄。

安裝程式不會針對屬於已安裝之產品的每個 MSI 建立個別記錄檔。此外,記錄檔僅提供英文版,並未當地語系化。不過,由於 Windows SharePoint Services 屬於 Windows 的一部分,並且也是 2007 Office System 安裝中的選項,因此,Windows Installer 記錄 (與 2007 Office System 安裝程式記錄無關) 會繼續支援 Windows MUI 版本的記錄。

設定記錄屬性

安裝程式會在與 Setup.exe 相同的資料夾中尋找 Config.xml 的複本。如果找不到複本,安裝程式就會將位於核心產品資料夾的 Config.xml 檔案用於您要安裝的產品。如果安裝來源有多個可用的產品,安裝程式會等候您指定要安裝的產品,然後才尋找 Config.xml 的複本。由於這個設計的緣故,當 Config.xml 檔案位於與 Setup.exe 相同的資料夾,或者您使用 Setup /config 命令列選項指定 Config.xml 檔案時,Logging 項目只能由安裝程式使用。如果安裝程式使用產品資料夾中的 Config.xml 檔案,則會採用預設的標準記錄選項。

若要設定安裝程式的記錄屬性,請編輯您要用於安裝的 Config.xml 檔案。請使用 Config.xml 檔案中的 Logging 項目來指定安裝程式執行的記錄類型。下列是所使用的語法:

<Logging

   Type="Off" | "Standard"(預設值) | "Verbose" | "Debug"

   Path="路徑"

   Template="檔案名稱.txt"

/>

下表提供可用的安裝程式記錄屬性。

屬性 描述

Type

Off

安裝程式不進行記錄。

Standard (預設值)

安裝程式會記錄所有安裝事件 (傳遞的命令列屬性、傳遞的 Config.xml 屬性、套用的修補程式)、本機安裝來源 (LIS)、MSI 記錄 (自訂動作、功能狀態)、成功或失敗的事件、錯誤、使用者選擇以及顯示的 UI。

Verbose

安裝程式會將所有安裝資訊寫入記錄檔。

Debug

安裝程式會寫入所有詳細資訊記錄的資訊,以及其他偵錯資訊。在識別失敗的程式碼片段時,這會很有用。

Path

路徑

記錄檔所使用的資料夾完整路徑。您可以使用環境變數。預設值為 %TEMP%

Template

檔案名稱 .txt

記錄檔的名稱。若在檔案名稱任何位置插入字串 *,即會為安裝程式所執行的每個安裝作業建立唯一的記錄檔。若不包含 * 且指定的檔案名稱已存在,則記錄資訊會附加到現有的檔案中。請務必指定副檔名。預設範本為 SetupExe(*).log。環境變數 (例如 %COMPUTERNAME%) 可以用來建立可輕鬆識別、唯一的記錄檔。

您可以在 Template 值的任何位置指定 *。安裝程式會在該位置插入下列格式的字串:

YYYYMMDDHHMMSS xxx

其中:

  1. YYYY = 年

  2. MM = 月

  3. DD = 日

  4. HH = 小時

  5. MM = 分鐘

  6. SS = 秒

  7. xxx = 安裝程式所產生的唯一字串

Setup.exe 記錄檔包含為安裝指定的命令列,因此,可以用來確認適當的語法、拼字、路徑等。

如需如何編輯 Config.xml 檔案的詳細資訊,請參閱<2007 Office 系統的 Config.xml 檔案>。

檢閱安裝記錄檔

如果安裝程式是由系統執行的,您將會在 C:\Windows\%TEMP% 資料夾中找到記錄檔。如果安裝程式是以某個使用者帳戶執行,則記錄檔會在使用者的 %TEMP% 資料夾中。

安裝記錄檔的第二到最後一行會有一個傳回碼。通常傳回碼 0 表示安裝成功、3010 表示需要重新開機、1642 表示修補版本錯誤,而 1603 表示嚴重錯誤。如需其他傳回碼值,請參閱 Microsoft 知識庫文件 290158:Office 2003 產品和 Office XP 產品中的 Windows Installer 程序的錯誤代碼與錯誤訊息清單 (https://go.microsoft.com/fwlink/?linkid=128248\&clcid=0x404)。

如果您在安裝期間收到錯誤訊息,請在記錄檔中尋找錯誤編號,然後依照下列步驟診斷問題:

  1. 在記錄檔中搜尋錯誤編號。如果您收到 1603 錯誤訊息,請搜尋「傳回值 3」,以協助您判斷發生失敗的原因。

  2. 從錯誤編號的那行往上閱讀每一行。通常您看到的失敗一行,其終極結果會是安裝程式錯誤。

  3. 如果您沒有收到錯誤編號,則也可以搜尋 "Error" 一字。

  4. 若沒有產生或記錄明顯錯誤,則搜尋 "Note" 字串。"Note" 是發生錯誤時通常預期會看到的文字 (例如,在檢查已刪除的檔案是否存在時,預期會收到 "File not found" 錯誤)。然而,有時候它確實表示發生錯誤。

傳回碼 0 通常表示沒有問題,不過有時表示沒有產生錯誤,但安裝程序未如預期地完成。

如需在啟用詳細資訊記錄的情況下,2007 Office System 安裝所用錯誤碼的詳細資訊,請參閱<2007 Office system 安裝的錯誤碼>。

TCO (GIMME) 記錄

在 2007 Office System 的多重 MSI 模型中,各種功能會展現於多個 MSI 之間,並且每個 MSI 都各自擁有產品代碼。為了處理這個全新的多重 MSI 模型,GIMME API 使用 Setup.exe (而非 Windows Installer) 來執行「隨選安裝」(IOD) 和「隨選修復」(ROD) 動作。本質上,GIMME API 會識別出所要進行的 IOD 或 ROD 呼叫、判斷哪一組 MSI 包含所要求的選項,然後初始 Setup.exe 進行安裝。這些動作的記錄稱為 TCO 記錄。

"GIMME" 一字並非縮寫;這個字描述處理 MSO.DLL 所執行之安裝要求動作的 API,它可以當做 Windows Installer 執行階段 API 周圍的延伸「包裝函式」來使用。GIMME 從字面上可以看做 "Give Me"。換句話說,當應用程式在載入的同時,也忙碌地嘗試將所有元件提取在一起,並確認元件全都正確地安裝。

使用 TCO 記錄檔的理由如下:

  • Office 會再次執行修復。

  • 能看到可重現當機前的活動。

  • Office 不會使用已安裝的元件。

當觸發事件「不」在應用程式事件記錄檔中時,TCO 記錄檔是最好用的,同時,它對於診斷必要安裝進行的原因也非常有幫助。

啟用 TCO 記錄

若要啟用 2007 Office System 的記錄,請新增下列登錄設定:

REGEDIT4

[HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Common\Debug]
"TCOTest"=dword:00000001
"TCODarwinTest"=dword:00000001
"TCOAssertInstalls"=dword:00000001
"TCOTrace"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Installer]
"Logging"="voicewarmupx"
"Debug"=dword:00000007

除非設定了偵錯系統原則,否則,安裝程式不會將輸入命令列的資訊寫入記錄檔。若要將命令列寫入記錄檔,請將偵錯系統原則設定為 7 的值。

%TEMP% 資料夾中會建立 Office.log 記錄檔。您無法控制記錄檔名稱,而且當這個記錄檔已滿時,便會加以覆寫。

檢閱 TCO 記錄檔

當 TCO 記錄已啟用時,請重現問題並檢閱在 %TEMP% 資料夾中建立的記錄檔 Office.log。

請尋找 GimmeFile() 項目,這些項目表示檔案已遺失、損毀或版本錯誤。接著,在記錄檔中進一步檢查該檔案名稱,看看它是否已成功安裝。

如果檔案未成功安裝,請檢查為檔案提供的來源路徑,確認它是有效的。

如果問題與「隨選修復」或「隨選安裝」有關,請尋找相關的 GimmeFile() 項目以識別問題。

停用 TCO 記錄

若要停用 (移除) 2007 Office System 的 TCO 記錄項目,請將下列登錄設定加入 .reg 檔案並使用 Regedit.exe –s 命令:

REGEDIT4

[-HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Common\Debug]

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Installer]
"Logging"=-
"Debug"=-

請勿手動刪除關鍵路徑資源 (檔案或登錄值) 以觸發修復作業。如果您懷疑檔案已損毀,請啟用記錄,以維護模式再次執行 Office 安裝程式,並且使用 [修復 Office 選項]。

Windows Installer 記錄

有了 2007 Office System 多重 MSI 安裝模式之後,效能不佳的 Windows Installer 記錄淪為 2007 Office System 安裝記錄的次要。不過,有些時候也只有 Windows Installer 記錄能提供額外的必要詳細資料。

由於記錄檔的大小會很大,您應只在需要時啟用 Windows Installer 詳細資訊記錄,並在問題解決之後立即停用記錄。

雖然在 2007 Office System 中使用 Windows Installer 功能會受到限制,但是 Setup.exe 最終仍會依賴 Windows Installer 來執行許多程序。因此,一些常見的項目因 Windows Installer 本身而發生錯誤時,必須在判斷實際 2007 Office System 問題是否存在之前加以改正。在啟用 Windows Installer 記錄之前,您應檢查下列項目:

  • 確認 Windows Installer 服務未停用。

  • 檢查是否有系統原則限制。

  • 清除暫存檔。

  • 檢查 DCOM 權限。

確認 Windows Installer 服務未停用

  1. 移至「開始 | 執行」,輸入 services.msc,然後按下 Enter 按鈕。

  2. 按兩下名為 Windows Installer 服務。

  3. 檢查 [啟動類型] 欄位中的值。如果目前設定為 [已停用],這便是問題所在。請從下拉式方塊中選取 [手動],將它變更為手動啟動。

檢查是否有系統原則限制

  1. 移至「開始 | 執行」,輸入 GPEdit.msc,然後按下 Enter 按鈕。

  2. 開啟「電腦設定 | 系統管理範本 | Windows 元件 | Windows Installer」樹狀目錄。

  3. 確認是否啟用或停用任何可能會影響安裝的原則,例如 [停用 Windows Installer]。

群組原則物件編輯器

群組原則編輯器

清除暫存檔

  1. 您可以建立包含下列行的簡易指令碼/批次檔,以便自動清空所有暫存資料夾,並且避免因嘗試刪除使用中的暫存檔而造成的錯誤:

    @Echo off
    cd %temp%
    del *.* /Q
    exit
    

    或者,您也可以使用下列步驟,手動刪除暫存檔。

  2. 清空 %SYSTEMDRIVE%\temp 資料夾。

  3. 清空 %WINDIR%\Temp 資料夾。

  4. 清空 %TEMP% 資料夾。

檢查 DCOM 權限

啟用 Windows Installer 記錄

若要啟用 Windows Installer 記錄,請使用 Regedit.exe 開啟登錄,並建立下列的路徑和機碼:

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer
Reg_SZ: Logging
Value: voicewarmupx

在數值欄位中的字母可以是任何順序。每個字母會啟用不同記錄模式。下表說明 MSI 1.1 版本每個字母的實際功能。

描述

v

詳細資訊輸出

o

磁碟空間不足訊息

i

狀態訊息

c

初始 UI 參數

e

所有錯誤訊息

w

非嚴重警告

a

啟動動作

r

特定動作記錄

m

記憶體不足或嚴重結束資訊

u

使用者要求

p

終端機內容

+

附加到現有的檔案

!

清除每一行到記錄

x

額外偵錯資訊。只有 Windows Server 2003 及更新版本的作業系統、可轉散發的 MSI 3.0 以及 MSI 更新版本才會出現 "x" 標幟。

*

萬用字元,會記錄所有資訊,除了 v 和 x 選項。若要包含 v 和 x 選項,請指定 "/l*vx"。

Windows Installer 記錄應僅做為疑難排解之用,不可以保持為啟用,因為它會對系統效能和磁碟空間造成不良影響。每當您使用 [控制台] 中的 [新增/移除程式] 時,都會建立一個新的 Msi*.log 檔。

如需如何啟用 Windows Installer 記錄的詳細資訊,請參閱 Microsoft 知識庫文件 223300:如何啟用 Windows Installer 記錄 (https://go.microsoft.com/fwlink/?linkid=128265\&clcid=0x404) (機器翻譯)。

使用 Windows Installer Verbose Log Analyzer 檢閱 Windows Installer 記錄檔

Windows Installer Verbose Log Analyzer (Wilogutl.exe) 可以協助分析 Windows Installer 安裝的記錄檔,並且會針對在記錄檔中找到的錯誤顯示建議的解決方案。

預設不會顯示非嚴重性錯誤。Wilogutl.exe 能以安靜模式執行或搭配使用者介面 (UI) 一起執行。此工具在 UI 和安靜模式中都會產生文字檔形式的報告。與 Windows Installer 詳細資訊記錄檔搭配時,能發揮最大的成效。如需詳細資訊,請參閱記錄 (英文) (https://go.microsoft.com/fwlink/?linkid=128276\&clcid=0x404) 。

如需 Windows Installer Verbose Log Analyzer (Wilogutl.exe) 的詳細資訊,請參閱 Wilogutl.exe (英文) (https://go.microsoft.com/fwlink/?linkid=128277\&clcid=0x404) 和 Microsoft Windows SDK 部落格 - Windows SDK 隱藏的寶藏:第 1 部 (英文) (https://go.microsoft.com/fwlink/?linkid=128278\&clcid=0x404) 。

若要下載 Windows Installer Verbose Log Analyzer (Wilogutl.exe),請參閱適用於 Windows Vista 的 Microsoft Windows 軟體開發套件更新 (英文) (https://go.microsoft.com/fwlink/?linkid=128279\&clcid=0x404) 。

以 UI 模式執行時,Wilogutl.exe 會顯示下列表格中的對話方塊。

名稱 描述

Windows Installer Verbose Log Analyzer

[Windows Installer Verbose Log Analyzer] 對話方塊可讓使用者選取用於分析的記錄檔:

  • [Open] 按鈕會以 [記事本] 開啟檔案,而 [Preview] 區域可用來確認已選取正確的記錄檔。

  • [Analyze] 按鈕會開始記錄檔分析,並顯示 [Detailed Log File View] 對話方塊。

Windows Installer Verbose Log Analyzer

Windows Installer Verbose Log Analyzer

Detailed Log File View

[Detailed Log File View] 對話方塊會顯示已記錄錯誤的資訊。使用 [Back] 和 [Next] 按鈕可以瀏覽多個錯誤。

若要顯示非嚴重性錯誤,請選取 [Show Ignored Debug Errors] 核取方塊。隨即顯示電腦用來執行登入安裝的安裝程式版本。如果登入安裝是以提高的權限執行,[Elevated install?] 核取會是已選取,並且 [Client Side Privilege Details] 和 [Server Side Privilege Details] 文字方塊會出現資訊。[Detailed Log File View] 對話方塊會包含下列按鈕:

  • [States] - 顯示 [Feature and Component States] 對話方塊。

  • [Properties] - 顯示 [Properties] 對話方塊。

  • [Policies] - 顯示 [Policies] 對話方塊。

  • [HTML Log] - 以註釋的 HTML 檔案顯示記錄檔。

  • [Save Results] - 將報告檔案儲存至指定的目錄。

  • [Error Help] - 顯示安裝程式錯誤訊息說明。

  • [Help] - 顯示 Windows Installer 安裝程式 Log Analyzer 的說明。

  • [How to Read a Log File] - 顯示記錄檔的說明文件。

Detailed Log File View

Detailed Log File View

Feature and Component States

[Feature and Component States] 對話方塊會顯示下列功能的狀態和元件欄位:

  • [Feature] 欄位會顯示安裝套件中的功能名稱。

  • [Component] 欄位會顯示安裝套件中的元件名稱。

  • [Installed] 欄位會在安裝結束時顯示功能或元件的狀態。

  • [Request] 欄位會顯示安裝期間功能或元件狀態的使用者選擇。

  • [Action] 欄位會顯示安裝程式對功能或元件採取的動作。

如需詳細資訊,請參閱 MsiGetComponentState 函式 (英文) (https://go.microsoft.com/fwlink/?linkid=128284&clcid=0x404) 和 MsiGetFeatureState 函式 (英文) (https://go.microsoft.com/fwlink/?linkid=128285&clcid=0x404) 。

Properties

[Properties] 對話方塊會在安裝結束時顯示 Windows Installer 屬性及其值。您可以使用下列索引標籤依名稱或依值排序屬性:

  • [Client] 索引標籤會顯示用戶端安裝期間的屬性和值。

  • [Server] 索引標籤會顯示伺服器端安裝期間的屬性和值。

  • [Nested] 索引標籤會顯示任何並行安裝的屬性和值。

如需詳細資訊,請參閱屬性 (英文) (https://go.microsoft.com/fwlink/?linkid=128287&clcid=0x404) 和並行安裝 (英文) (https://go.microsoft.com/fwlink/?linkid=128288&clcid=0x404) 。

Policies

[Policies] 對話方塊會顯示安裝後設定的系統原則:

  • 將原則設定為 0 (零) 的值,表示原則未啟用。

  • 1 (一) 的值表示原則已啟用。

  • ? (問號) 的值表示原則值未記錄在記錄檔中。

如果您需要不在記錄檔中的原則值,請嘗試在安裝失敗的電腦上使用 Regedit.exe 檢查登錄機碼。

如需系統原則的詳細資訊,請參閱系統原則 (英文) (https://go.microsoft.com/fwlink/?linkid=128292&clcid=0x404) 。

如需疑難排解 Windows Installer 問題的詳細資訊,請參閱 Microsoft 知識庫文件 907749:Windows Installer 的基本疑難排解步驟 (https://go.microsoft.com/fwlink/?linkid=128294\&clcid=0x404) (機器翻譯)。

Office 2007 OSE 記錄

Office 來源引擎 (OSE) 記錄只能在採用 Microsoft 產品支援時使用,並且通常只包含對產品開發人員有用的資訊。此參考資料本身是提供用來在 Microsoft 產品支援要求取得 OSE 記錄時提供所需的步驟。

當您安裝 2007 Office System 時,安裝程式會使用一項名為 Office 來源引擎 (Ose.exe) 的系統服務,藉由將必要的安裝檔案從安裝點複製到電腦上的隱藏位置,以建立必要的本機安裝來源 (LIS)。接著,安裝程式會將這個 LIS 當做來源,以安裝 2007 Office System。

由於 Office 來源引擎是安裝和維護程序中的重要一環,因此,有個方法可用來只記錄 Office 來源引擎本身執行的那些動作。

下列兩個範例說明 Office 來源引擎產生的錯誤。

CLView 錯誤訊息

CLView 錯誤訊息

Microsoft Office Help Viewer 錯誤訊息

Microsoft Office Help Viewer 錯誤訊息

啟用 OSE 記錄

若要啟用 OSE 記錄,請手動輸入下列登錄項目:

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Delivery\SourceEngine\Settings]
"LogLevel"=dword:00000002
"TraceLevel"=dword:00000003
"TraceFiles"=dword:00000001

檢閱 OSE 記錄檔

由於 Office 來源引擎尚未建立成為系統服務,因此 OSE 記錄檔最先會安裝在安裝使用者的 %TEMP% 目錄中。

一旦成功安裝並登錄 Office 來源引擎,記錄就會切換至 %WINDIR%\Temp 目錄。

被要求時,請提供這個記錄檔給 Microsoft 產品支援,以供分析。