Использование журналов для устранения неполадок при установке и настройке в версии 2007 системы Office

Назначение: Office Resource Kit

 

Последнее изменение раздела: 2015-03-09

Содержание:

  • Журнал событий приложений Windows

  • Ведение журнала при настройке системы Office 2007

  • Ведение журнала TCO (GIMME)

  • Ведение журнала установщика Windows

  • Ведение журнала Office 2007 OSE

В данной статье рассказывается о пяти различных возможностях по ведению журнала, которые можно использовать для решения проблем при установке и настройке Выпуск 2007 системы Microsoft Office.

Журнал событий приложений Windows

Установщик Windows вносит записи в журнал событий приложений Windows в следующих случаях:

  • Успех или сбой установки, удаления или восстановления продукта.

  • Ошибки во время настройки продукта.

  • Обнаружение поврежденных данных конфигурации.

  • Информация о недостающих компонентах, повлекших за собой необходимость восстановления приложения.

Просмотр журнала событий приложения

:Журналы событий приложений Windows находятся в Просмотре событий.

Когда система автоматически начинает восстановление, и во время него происходит сбой, в журнал событий приложений Windows записываются два события.

  • Событие 1001 MsiInstaller определяет код продукта, компонент и код компонента запрошенного ключевого пути.

  • Событие MsiInstaller 1004 определяет код продукта, компонент и код компонента сбойного ключевого пути.

Для определения точного ресурса, определенного как сбойный ключевой путь, потребуется MSI указанного продукта. Его можно найти в следующих местах:

  • Панель управления | Установка и удаление программ

  • Реестр под ульем HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90120000-####-####-0000-0000000FF1CE}. Определите GUID, ссылающийся на *<Продукт>*WW.msi.

Для получения более подробной информации о схеме нумерации GUID см. базу знаний Microsoft, статью 928516: Описание схемы нумерации для GUID кодов продукта в оболочках и программах Office 2007 (https://go.microsoft.com/fwlink/?linkid=128098\&clcid=0x419).

Ведение журнала при настройке системы Office 2007

При появлении проблем во время установки, улучшения или обновления Выпуск 2007 системы Office проблему прежде всего стоит искать в файлах журналов. Многое можно определить, используя расширенный журнал и анализ кода возврата.

В прошлых версиях Office для настройки и управления установкой использовались параметры установщика Windows. В Выпуск 2007 системы Office процесс настройки изменен и ведение журнала зависит от:

  • Элемента, отвечающего за ведение журнала, в файле Config.xml (рекомендуемый метод).

  • Параметра, отвечающего за ведение журнала, добавленного с использованием центра развертывания Office (OCT).

По умолчанию программа настройки Выпуск 2007 системы Office автоматически создает файлы журналов в папке %TEMP%. По умолчанию программа настройки записывает все в память. Таким образом, при ошибке, произошедшей из-за сбоя или отмены установки, программа настройки с момента ошибки переключается на расширенный режим ведения журнала.

Для каждого MSI, относящегося к устанавливаемому продукту, не создается отдельный файл журнала. Файл журнала ведется только на английском, без локализации. Однако, поскольку Windows SharePoint Services является частью Windows и параметром в установке Выпуск 2007 системы Office, ведение журнала установщика Windows (проходящее независимо от ведения журнала настройки Выпуск 2007 системы Office) поддерживает версии ведения журнала Windows MUI.

Настройка атрибутов ведения журнала

Программа настройки запрашивает копию файла Config.xml, находящуюся в той же папке, что и Setup.exe. Если такая копия не обнаружена, программа настройки использует файл Config.xml, находящийся в основной папке устанавливаемого продукта. Если в источнике установки имеется несколько продуктов, программа настройки ждет, пока пользователь не укажет, какой продукт устанавливать, и затем запрашивает копию файла Config.xml. Из-за данного метода элемент Logging используется программой настройки в том случае, если файл Config.xml располагается в той же папке, что и Setup.exe, или же при указании пользователем файла Config.xml параметром командной строки Setup /config. Если программа настройки использует файл Config.xml, находящийся в папке продукта, используются параметры ведения журнала по умолчанию.

Для настройки атрибутов ведения журнала программы настройки отредактируйте файл Config.xml, используемый при установке. Используйте элемент Logging в файле Config.xml для указания типа ведения журнала. Используется следующий синтаксис:

<Logging

   Type="Off" | "Standard"(default) | "Verbose" | "Debug"

   Path="path"

   Template="filename.txt"

/>

В следующей таблице представлены доступные атрибуты ведения журнала программы настройки.

Атрибут Значение Описание

Type

Off

Программа настройки не ведет журнал.

Standard (default)

Программа настройки записывает все произошедшие события (принятые параметры командной строки, принятые параметры файла Config.xml, примененные исправления), локальный источник установки (LIS), ведение журнала MSI (действия по настройке, состояния компонентов), успех или сбой данных событий, ошибки, выбор пользователя и отображаемый пользовательский интерфейс.

Verbose

Программа настройки записывает все сведения об установке в файл журнала.

Debug

Программа настройки записывает все расширенные сведения и дополнительную отладочную. Это полезно при определении сбойной части кода.

Path

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 см. Файл Config.xml в версии 2007 системы Office.

Просмотр журнала программы настройки

Если программа настройки была запущена системно, файлы журналов будут находиться в папке C:\Windows\%TEMP%. Если программа настройки была запущена учетной записью пользователя, они будут находиться в папке %TEMP% пользователя.

Предпоследняя строка в журнале программы настройки будет содержать код возврата. Обычными кодами возврата являются 0 при успешной установке, 3010 при необходимости в перезагрузке, 1642 при использовании неверной версии исправления и 1603 при критической ошибке. Дополнительные значения кодов возврата могут быть найдены в базе знаний Microsoft, статья 290158: Список кодов ошибок и сообщений об ошибках для процессов установщика Windows для продуктов Office 2003 и Office XP (https://go.microsoft.com/fwlink/?linkid=128248\&clcid=0x419).

При получении сообщения об ошибке во время работы программы настройки найдите номер ошибки в файле журнала. Следуйте данным инструкциям для анализа проблемы:

  1. Найдите номер ошибки в файле журнала. Если вы получили сообщение об ошибке 1603, ищите в файле "return value 3" (локализованное), чтобы понять, почему произошла ошибка.

  2. Рассмотрите строки выше строки с номером ошибки. Как правило, находится сбойная строка, которая привела к ошибке программы настройки.

  3. Если поиск не дал номера ошибки, также можно поискать по слову "Error".

  4. Если в журнале не отмечено явной ошибки, проведите поиск по слову "Note". "Note" обозначает ожидаемую ошибку (например, при проверке наличия файла, который был удален, ожидаемой ошибкой будет "Файл не найден"). Однако в некоторых случаях данное слово обозначает настоящую ошибку.

Хотя код возврата 0 обычно означает отсутствие проблем, сообщения об ошибке не создается, и все же процесс установки не заканчивается, как ожидалось.

Для получения большей информации о кодах ошибок, используемых установкой Выпуск 2007 системы Office при включении расширенного ведения журнала, см. Коды ошибок при установке выпуска 2007 системы Microsoft Office.

Ведение журнала TCO (GIMME)

В модели с многочисленными MSI, какой является Выпуск 2007 системы Office, компоненты распределены по нескольким MSI, и каждый файл MSI обладает собственным кодом продукта. Для обработки данной новой модели использует GIMME API Setup.exe (вместо установщика Windows) для выполнения действий Установка по требованию (IOD) и Восстановление по требованию (ROD). Главным образом GIMME API определяет вид сделанного запроса, какой набор файлов MSI содержит запрошенные компоненты, а затем запускает программу настройки для их установки. Запись данных действий называется ведением журнала TCO.

Термин "GIMME" − не аббревиатура, он используется для описания API, обрабатывающего запросы по установке, совершаемые MSO.DLL. Он используется как расширенная "обертка" API среды выполнения установщика Windows. "Gimme" переводится как "дай мне". Другими словами, пока загружается приложение, оно пытается собрать всего его компоненты и подтвердить правильность их установки.

Причины использовать журнал TCO:

  • Office выполняет повторяющееся восстановление.

  • Для просмотра действий перед повторяемой ошибкой.

  • Office не использует установленные компоненты.

Наиболее полезны журналы TCO в тех случаях, когда события нет в журнале событий приложения. Также они очень полезны при анализе причин появления требований установки.

Включение ведения журналов TCO

Чтобы включить ведение журналов для Выпуск 2007 системы Office, добавьте следующие параметры реестра:

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

Установщик не записывает в журнал информацию, введенную в командную строку, если не установлена системная политика Debug. Для записи командной строки в журнал установите значение системной политики Debug равным 7.

Файл журнала будет создан в папке %TEMP% с названием Office.log. Название журнала изменить нельзя. Он будет перезаписан при переполнении.

Просмотр журнала TCO

При включенном ведении журнала TCO повторите ошибку и просмотрите файл журнала, созданный Office.log в папке %TEMP%.

Ищите записи вида GimmeFile(), означающие, что файл отсутствует, поврежден или неправильной версии. Затем просмотрите файл журнала далее, чтобы определить, был ли файл успешно установлен.

Если успешной установки файла не произошло, проверьте правильность пути источника файла.

Если проблема связана с действиями Восстановление по требованию или Установка по требованию, ищите соответствующие записи GimmeFile(), чтобы определить проблему.

Отключение ведения журналов TCO

Чтобы отключить ведение записей TCO при работе с Выпуск 2007 системы Office, поместите следующие параметры реестра в файл 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

С появлением модели установки Выпуск 2007 системы Office, использующей многочисленные MSI, недостаточное ведение записей установщика Windows уступает ведению журнала программы настройки Выпуск 2007 системы Office. Однако до сих пор есть случаи, в которых только журнал установщика Windows предоставляет необходимую информацию.

Поскольку размер файлов журналов может быть значительным, нужно включать расширенное ведение журнала установщика Windows только при необходимости и немедленно выключать сразу по разрешении проблемы.

Хотя использование функций установщика Windows в Выпуск 2007 системы Office ограничено, Setup.exe в конечном счете полагается на выполнение установщиком Windows многих процессов. Из-за этого некоторые общие проблемы, возникающие при работе с самим установщиком Windows, могут нуждаться в предварительном анализе перед тем, как определить, существует ли проблема с Выпуск 2007 системы Office в действительности. Перед включением ведения журнала установщика Windows необходимо сделать следующее:

  • Убедиться, что служба установщика Windows включена.

  • Проверить ограничения политик системы.

  • Удалить временные файлы.

  • Убедитесь в наличии разрешений DCOM.

Включение службы установщика Windows

  1. Нажмите Пуск | Выполнить, введите services.msc и нажмите ВВОД.

  2. Дважды щелкните на службе Установщик Windows.

  3. Проверьте значение в поле Тип подготовки. Оно не должно быть установлено в положение Отключено. Поменяйте его, задав подготовку вручную, выбрав из раскрывающегося списка Вручную.

Проверка ограничений политик системы

  1. Нажмите Пуск | Выполнить, введите GPEdit.msc и затем нажмите ВВОД.

  2. Раскройте дерево Конфигурация компьютера | Административные шаблоны | Компоненты Windows | УстановщикWindows.

  3. Убедитесь, что любые политики, способные повлиять на установку, отключены или включены. Например, политика Отключить установщик Windows.

Редактор объектов групповой политики

Редактор групповой политики

Удаление временных файлов

  1. Для автоматического очищения всех временных папок и устранения ошибок, возникающих при попытках удаления используемых временных файлов, можно создать простой пакетный файл, содержащий следующее:

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

    Также вы можете вручную удалить временные файлы, следуя данным инструкциям.

  2. Очистить папку %SYSTEMDRIVE%\temp.

  3. Очистить папку %WINDIR%\Temp.

  4. Очистить папку %TEMP%.

Наличие разрешений DCOM

Включения ведения журнала установщика Windows

Чтобы включить ведение записей установщика Windows, откройте реестр, используя Regedit.exe, и создайте следующий путь и разделы:

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

Буквы в поле значения могут идти в любом порядке. Каждая буква включает отдельный режим ведения журнала. Функция каждой буквы применительно к MSI версии 1.1 показана в следующей таблице:

Значение Описание

v

Расширенный вывод

o

Сообщения о недостатке места на диске

i

Сообщения о состоянии

c

Начальные параметры пользовательского интерфейса

e

Все сообщения об ошибках

w

Предупреждения, не являющиеся критическими

a

Подготовка действий

r

Записи о действиях

m

Информация о нехватке памяти или выходе по сбою

u

Запросы пользователя

p

Конечные свойства

+

Добавление к существующему файлу

!

Добавлять в журнал каждую строку

Х

Дополнительная отладочная информация. Пометка "x" доступна только в Windows Server 2003 и более поздних операционных системах, при версии компонента MSI 3.0 или более поздней.

*

Подстановочный знак, записывать всю информацию за исключением параметров v и x. Для их включения укажите"/l*vx".

Ведение журнала установщика Windows должно использоваться только для решения проблем и не должно быть активно после их устранения из-за отрицательного влияния на производительность и свободное место на диске. Каждый раз при использовании функции Установка и удаление программ в Панели управления создается новый файл Msi*.log.

Для получения более полной информации о включении ведения записей установщика Windows см. базу знаний Microsoft, статью 223300: Включение ведения записей установщика Windows (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128265\&clcid=0x419) (на английском языке).

Просмотр журнала установщика Windows с помощью анализатора расширенных журнала установщика Windows

Анализатор расширенного журнала установщика Windows (Wilogutl.exe) помогает в рассмотрении файлов журналов установщика Windows и отображает предложения по решению проблем, обнаруженных в журнале.

По умолчанию отображаются только критические ошибки. Wilogutl.exe может запускаться в тихом режиме или с пользовательским интерфейсом (UI). Средство создает отчеты в виде текстовых файлов в обоих режимах. Лучше всего данный инструмент работает с файлами расширенных журналов установщика Windows, но он также поддерживает и не расширенные журналы. Для получения более полной информации см. Ведение журналов (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128276\&clcid=0x419) (на английском языке).

Для получения более полной информации по анализатору расширенных журналов установщика Windows (Wilogutl.exe) см. Wilogutl.exe (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128277\&clcid=0x419) (на английском языке) и Блог SDK Microsoft Windows — Тайные жемчужины Windows SDK: Часть 1 (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128278\&clcid=0x419) (на английском языке).

Чтобы скачать анализатор расширенных журналов установщика Windows (Wilogutl.exe), см. Обновление пакета средств разработки Microsoft Windows для Windows Vista (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128279\&clcid=0x419) (на английском языке).

При запуске в режиме пользовательского интерфейса Wilogutl.exe отображает диалоговые окна, представленные в следующей таблице:

Название Описание

Анализатор расширенных журналов установщика Windows

Диалоговое окно Анализатор расширенных журналов установщика Windows позволяет пользователю выбрать файл журнала для анализа:

  • Кнопка Открыть открывает файл в Блокноте. Область Предпросмотр позволяет убедиться в выборе верного файла.

  • Кнопка Анализировать начинает анализ файла и вызывает диалоговое окно Подробный вид журнала.

Анализатор расширенных журналов установщика Windows

Подробный анализ журнала установщика Windows

Подробный вид журнала

В диалоговом окне Подробный вид журнала отображается информация о занесенных в журнал ошибках. Используйте кнопки Назад и Вперед для перемещения между ошибками.

Чтобы отображались не только критические ошибки, поставьте флажок Показывать игнорируемые ошибки отладки. Отображается версия установщика, имеющаяся на компьютере, где запущен анализатор. Если установка, занесенная в журнал, проводилась с более высоким уровнем разрешений, будет отмечен флажок Более высокая установка?, и информация появится в текстовых полях Данные о привилегиях на стороне клиента и Данные о привилегиях на стороне сервера. Диалоговое окно Подробный вид журнала содержит следующие кнопки:

  • Состояния − Вызывает диалоговое окно Состояния компонентов.

  • Свойства − Вызывает диалоговое окно Свойства.

  • Политики − Вызывает диалоговое окно Политики.

  • Журнал HTML − Отображает журнал в виде файла HTML с комментариями.

  • Сохранить результаты − Сохраняет отчеты в указанную папку.

  • Справка по ошибкам − Отображает файл справки по сообщениям об ошибках установщика.

  • Справка − Отображает файл справки по анализатору расширенных журналов установщика Windows.

  • Чтение файла журналов − Отображает файл справки по журналам.

Подробный вид журнала

Подробный просмотр файла журнала

Состояния компонентов

Диалоговое окно Состояния компонентов отображает следующие состояния компонентов:

  • Столбец Возможность отображает название возможности в пакете установки.

  • Столбец Компонент отображает название компонента в пакете установки.

  • Столбец Установленные отображает состояние компонентов в конце установки.

  • Столбец Запрос показывает выбор пользователя во время установки применительно к состоянию возможности или компонента.

  • Столбец Действие показывает действия, предпринятые пользователем применительно к компоненту или возможности.

Для получения более полной информации см. Функция MsiGetComponentState (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128284&clcid=0x419) (на английском языке) и Функция MsiGetFeatureState (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128285&clcid=0x419) (на английском языке).

Свойства

Диалоговое окно Свойства отображает свойства установщика Windows и их значения на момент завершения установки. Можно отсортировать свойства по имени или по значению, используя следующие вкладки:

  • Вкладка Клиент демонстрирует свойства и значения во время установки на стороне клиента.

  • Вкладка Сервер демонстрирует свойства и значения во время установки на стороне сервера.

  • Вкладка Вложенное демонстрирует свойства и значения всех одновременных установок.

Для получения более полной информации см. Свойства (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128287&clcid=0x419) (на английском языке) и Одновременные установки (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128288&clcid=0x419) (на английском языке).

Политики.

Диалоговое окно Политики отображает системные политики, заданные после установки:

  • Установленное для политики значение 0 (ноль) означает, что политика не активирована.

  • Значение 1 (один) означает, что политика активирована.

  • Значение ? (вопросительный знак) означает, что значение политики не было отмечено в журнале.

Если вам нужно узнать значение политики, не отмеченной в журнале, попробуйте использоваться Regedit.exe для проверки разделов реестра на компьютере, где произошел сбой установки.

Для получения более полной информации по системным политикам см. Системная политика (на английском языке) (https://go.microsoft.com/fwlink/?linkid=128292&clcid=0x419) (на английском языке).

Для получения более полной информации о решении проблем установщика Windows см. базу знаний Microsoft, статью 907749: Основные шаги по решению проблем установщика Windows (https://go.microsoft.com/fwlink/?linkid=128294\&clcid=0x419).

Ведение журнала Office 2007 OSE

Ведение журнала для Office Source Engine (OSE) используется только при работе со службой поддержки продукта Microsoft и в обычных условиях предоставляет информацию, полезную только для разработчиков продукта. По этой причине данное описание предоставлено для рассказа о шагах, предпринимаемых при необходимости включения ведения журналов OSE для службы поддержки продукта Microsoft.

При установке Выпуск 2007 системы Office программа настройки использует системную службу − Office Source Engine (Ose.exe) − для создания требуемого локального источника установки (LIS) путем копирования установочных файлов из точки установки в скрытое расположение на вашем компьютере. Затем программа настройки использует эти файлы для установки Выпуск 2007 системы Office.

Поскольку Office Source Engine является важнейшей частью процессов установки и обслуживания, имеется метод ведения записей о действиях, выполняемых самим средством Office Source Engine.

Следующие два примера демонстрируют ошибки, создаваемые Office Source Engine.

Сообщение об ошибке CLView

Сообщение об ошибке CLView

Сообщение об ошибке окна справки Microsoft Office

Сообщение об ошибке средства просмотра справки Microsoft Offic

Включение ведения журнала OSE

Для включения ведения журнала OSE введите вручную следующие записи в реестр:

REGEDIT4

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

Просмотр журнала OSE

OSE изначально создаются в папке %TEMP% пользователя, проводящего установку, поскольку Office Source Engine еще не закреплен в качестве системного средства.

После того как Office Source Engine успешно установлен и зарегистрирован, журналы сохраняются в папку %WINDIR%\Temp.

По запросу передайте данный журнал в службу поддержки продукта Microsoft для анализа.