Usando logs para solucionar problemas de instalação e configuração no Office System 2007

Examine o log de eventos do aplicativo

Os logs de eventos de aplicativo do Windows são encontrados em Visualizar Eventos.

Quando o sistema inicia um reparo automaticamente e falha, normalmente registra dois eventos no Log de Eventos de Aplicativo do Windows.

• O evento MsiInstaller 1001 identificará o Código do Produto, Recurso e Código do Componente do caminho-chave solicitado.

• O evento MsiInstaller 1004 identificará o Código do Produto, Recurso e Código do Componente de caminho-chave detectado como quebrado.

O MSI do produto especificado será necessário para identificar o recurso exato referenciado como o caminho-chave quebrado. Você poderá encontrá-lo procurando em um dos seguintes locais:

• Painel de Controle | Adicionar ou Remover Programas

• No Registro, sob a chave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90120000-####-####-0000-0000000FF1CE}. Localize o GUID que faz referência a *<Produto>*WW.msi.

Para obter informações sobre o esquema de numeração para GUIDs, consulte o artigo 928516 da Base de Dados de Conhecimento Microsoft sobre a descrição do esquema de numeração para GUIDs nos conjuntos e programas do Office 2007 (https://go.microsoft.com/fwlink/?LinkId=128098).

Configurar atributos de log

A Instalação procura uma cópia de Config.xml na mesma pasta que Setup.exe. Se nenhuma cópia for encontrada nessa pasta, a Instalação usará o arquivo Config.xml que reside na pasta principal do produto que você está instalando. Se houver vários produtos disponíveis na fonte de instalação, o programa de instalação espera até que você especificar qual produto para instalar antes de ele procura a cópia do arquivo Config.xml. Devido a esse design, o elemento de log só será usado pelo programa de instalação quando o arquivo Config.XML residir na mesma pasta que Setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando Setup /config. Se o programa de instalação usar o arquivo Vonfig.xml da pasta do produto, as opções de log padrão padrão serão usadas.

Para configurar os atributos de log para o programa de instalação, edite o arquivo Config.xml que você usará para a instalação. Use o elemento de log do arquivo Config.xml para especificar o tipo de log que esse programa de instalação executará. A sintaxe usada é a seguinte:

<Logging

   Type="Off" | "Standard"(padrão) | "Verbose" | "Debug"

   Path="caminho"

   Template="nome_do_arquivo.txt"

/>

A tabela a seguir fornece os atributos de log de instalação disponíveis.

Você pode especificar um * em qualquer lugar no valor de Template. A Instalação insere uma sequência de caracteres nesse local com o seguinte formato:

AAAAMMDDHHMMSS xxx

onde:

1. AAAA = Ano

2. MM = Mês

3. DD = Dia

4. HH = Hora

5. MM = Minuto

6. SS = Segundos

7. xxx = uma sequência de caracteres exclusiva gerada pela Instalação

O arquivo de log Setup.exe contém a linha de comando especificada para a instalação e portanto, pode ser usado para confirmar a sintaxe adequada, ortografia, caminhos etc.

Para obter mais informações sobre como editar o arquivo Config.xml, consulte Arquivo Config.xml no Office System 2007.

Examine o log de Instalação

Você encontrará os arquivos de log na pasta C:\Windows\%TEMP% se instalação foi executada pelo sistema. Se a Instalação for executada na conta de um usuário, estará na pasta %TEMP% do usuário.

Da segunda para a última linha do log de instalação haverá um código de retorno. Códigos de retorno comuns são 0 para a instalação bem-sucedida, 3010 para reinicialização necessária, 1642 para versões incorretas de patch e 1603 para um erro fatal. Valores de código de retorno adicionais podem ser encontradas no artigo 290158 da Base de Dados de Conhecimento Microsoft: Lista de códigos de erro e mensagens de erro para processos do Installer nos produtos do Office 2003 e do Office XP (https://go.microsoft.com/fwlink/?LinkId=128248).

Se você receber uma mensagem de erro durante a instalação, procure o número de erro no arquivo de log. Execute estas etapas para diagnosticar o problema:

1. Pesquise o número de erro no arquivo de log. Se você recebeu uma mensagem de erro 1603, procure por "return value 3" (localizado) para ajudar a determinar por que a falha ocorreu.

2. Leia cada linha até da linha com o número de erro. Normalmente você verá uma linha com falha, com o resultado final de erro de Instalação.

3. Se você não receber um número de erro, também poderá pesquisar a palavra "Erro".

4. Quando nenhum erro óbvio for gerado ou registrado, procure a sequência de caracteres "Observação". Uma "Observação" é um erro que é esperado com frequência (por exemplo, quando estiver verificando a existência de um arquivo que foi excluído, pode-se esperar receber um erro "Arquivo não encontrado"). Às vezes, no entanto, ele é uma indicação de um erro de verdade.

Embora normalmente um código de retorno de 0 não indique problemas, ocasionalmente, não haverá nenhum erro gerado e, ainda assim, o processo de instalação não será concluído como esperado.

Para obter mais informações sobre códigos de erros usados por instalações do 2007 Office system quando o log detalhado estiver habilitado, consulte Códigos de erro de instalações do 2007 Office system.

Habilitar o log de custo total de propriedade

Para habilitar o log para o 2007 Office system, adicione as seguintes configurações do Registro:

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

O Installer não grava informações inseridas em uma linha de comando no log, a menos que a diretiva do sistema de depuração esteja definida. Para gravar linhas de comando no log, defina a diretiva de sistema de depuração para um valor 7.

O arquivo de log será criado na pasta %TEMP% como Office.log. O nome do log não pode ser controlado e é substituído quando fica cheio.

Examine o log de custo total de propriedade

Quando o log de custo total de propriedade está habilitado, reproduza o problema e examine o arquivo de log Office.log criado na pasta %TEMP%.

Procure entradas de GimmeFile() que indicam que um arquivo está ausente, corrompido ou tem uma versão incorreta. Em seguida, verifique no arquivo de log outras ocorrências desse nome de arquivo para determinar se ele foi instalado com êxito.

Se o arquivo não for instalado com êxito, verifique o caminho de origem fornecido para garantir que ele seja válido.

Se o problema estiver relacionado a Reparar sob Demanda ou a Instalar sob Demanda, procure as entradas de GimmeFile() relacionadas para identificar o problema.

Desabilitar o log de custo total de propriedade

Para desabilitar (remover) as entradas do log do TCO do 2007 Office system, coloque as seguintes configurações do Registro em um arquivo .reg e use o comando Regedit.exe –s:

REGEDIT4

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

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

Não exclua manualmente os recursos de caminho-chave (arquivos ou valores do Registro) para disparar um reparo. Se você suspeitar que arquivos foram corrompidos, habilite o log, execute novamente a instalação do Office no modo de manutenção e use a opção Corrigir Office.

Habilitar o log do Windows Installer

Para habilitar o log do Windows Installer, abra o Registro usando regedit.exe e crie o caminho e as chaves a seguir:

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

As letras no campo de valor podem estar em qualquer ordem. Cada letra ativa um modo de log diferente. A função real de cada letra para a versão 1.1 do MSI é mostrada na tabela a seguir.

O log do Windows Installer deve ser usado somente para solucionar problemas e não deve ser habilitado e ignorado, porque terá efeitos negativos sobre o desempenho do sistema e espaço em disco. Toda vez que você usar Adicionar ou Remover Programas no Painel de controle, um novo arquivo de Msi*.log será criado.

Para obter mais informações sobre como habilitar o log do Windows Installer, consulte o artigo da Base de Dados de Conhecimento Microsoft 223300 sobre como habilitar o log (https://go.microsoft.com/fwlink/?LinkId=128265) do Windows Installer.

Examinar o log do Windows Installer usando o Analisador de Log Detalhado do Windows Installer

O Analisador de Log Detalhado do Windows Installer (Wilogutl.exe) ajuda a análise de arquivos de log de uma instalação do Windows Installer e exibe soluções sugeridas para erros encontrados em um arquivo de log.

Por padrão, os erros não-críticos não são exibidos. Wilogutl.exe pode ser executado no modo silencioso ou com uma interface do usuário. A ferramenta gera relatórios como arquivos de texto na interface do usuário e modos silenciosos. Ele funciona melhor com arquivos de log detalhados do Windows Installer, mas também funciona com logs de não-detalhados. Para obter mais informações, consulte Log (em inglês) (https://go.microsoft.com/fwlink/?linkid=128276\&clcid=0x416) (em inglês).

Para obter mais informações sobre o Analisador de Log Detalhado do Windows Installer (Wilogutl.exe), consulte Wilogutl.exe (em inglês) (https://go.microsoft.com/fwlink/?linkid=128277\&clcid=0x416) (em inglês) e Blog do SDK do Microsoft Windows - joias raras do SDK do Windows: parte 1 (https://go.microsoft.com/fwlink/?linkid=128278\&clcid=0x416).

Para baixar o Analisador de Log Detalhado do Windows Installer (Wilogutl.exe), consulte Atualização do Software Development Kit do Microsoft Windows para Windows Vista (https://go.microsoft.com/fwlink/?linkid=128279\&clcid=0x416).

Quando executado no modo de interface do usuário, Wilogutl.exe exibe as caixas de diálogo mostradas na tabela a seguir.

Nome	Descrição
Analisador de Log Detalhado do Windows Installer	A caixa de diálogo Analisador de Log Detalhado do Windows Installer permite que os usuários selecionem um arquivo de log para análise: O botão Abrir abre o arquivo no Bloco de Notas. A área Visualizar pode ser usada para verificar se o arquivo de log correto foi selecionado. O botão Analisar inicia a análise do arquivo de log e exibe a caixa de diálogo Exibição de Arquivo de Log Detalhado. Analisador de Log Detalhado do Windows Installer
Exibição de Arquivo de Log Detalhado	A caixa de diálogo Exibição de Arquivo de Log Detalhado exibe informações de erro registradas. Use os botões Voltar e Avançar para percorrer vários erros. Para exibir erros não-críticos, marque a caixa de seleção Mostrar Erros de Depuração Ignorados. A versão de instalação no computador usada para executar a instalação registrada será exibida. Se a instalação registrada foi executada com permissões elevadas, a caixa de seleção Instalação elevada? será marcada e informações serão fornecidas nas caixas de texto Detalhes de Privilégio do Lado Cliente e Detalhes de Privilégio do Lado Servidor. A caixa de diálogo Exibição de Arquivo de Log Detalhado contém os seguintes botões: Estados - mostra a caixa de diálogo Estados de Recurso e Componente. Propriedades - mostra a caixa de diálogo Propriedades. Diretivas - mostra a caixa de diálogo Diretivas. Log de HTML - mostra o log como arquivo HTML anotado. Salvar Resultados - salvar arquivos de relatório no diretório especificado. Ajuda de Erro - mostra a ajuda da mensagem de erro do instalador. Ajuda - mostra ajuda para o Analisador de Log de Instalação do Windows Installer. Como Ler um Arquivo de Log - mostra o documento de ajuda do arquivo de log. Exibição de Arquivo de Log Detalhado
Estados de Recurso e Componente	A caixa de diálogo Estados de Recurso e Componente exibe as seguintes colunas de estados de recurso e componente: A coluna Recurso mostra o nome do recurso no pacote de instalação. A coluna Componente mostra o nome do componente no pacote de instalação. A coluna Instalado mostra o estado do recurso ou componente no final da instalação. A coluna Solicitação mostra a seleção do usuário durante a instalação em relação ao estado do recurso ou componente. A coluna Ação mostra a ação tomada pelo instalador do recurso ou componente. Para obter mais informações, consulte Função MsiGetComponentState (em inglês) (https://go.microsoft.com/fwlink/?linkid=128284&clcid=0x416) (em inglês) e Função MsiGetFeatureState (em inglês) (https://go.microsoft.com/fwlink/?linkid=128285&clcid=0x416) (em inglês).
Propriedades	A caixa de diálogo Propriedades mostra propriedades do Windows Installer e seus valores no final da instalação. Você pode classificar as propriedades por nome ou por valor usando as seguintes guias: A guia Cliente mostra propriedades de valores durante a parte da instalação executada no lado cliente. A guia Servidor mostra propriedades de valores durante a parte da instalação executada no lado servidor. A guia Aninhado mostra as propriedades e valores de quaisquer instalações simultâneas. Para obter mais informações, consulte Propriedades (em inglês) (https://go.microsoft.com/fwlink/?linkid=128287&clcid=0x416) (em inglês) e Instalações simultâneas (em inglês) (https://go.microsoft.com/fwlink/?linkid=128288&clcid=0x416) (em inglês).
Diretivas	A caixa de diálogo Diretivas exibe a diretiva do sistema definida após a instalação: Um valor 0 (zero) definido para a diretiva significa que a diretiva não está habilitada. Um valor 1 (um) significa que a diretiva está habilitada. Um valor ? (ponto de interrogação) significa que o valor da diretiva não está registrado no log. Se for necessário um valor de diretiva que não esteja no log, tente usar o Regedit.exe para verificar as chaves do Registro no computador no qual a instalação falhou. Para obter mais informações sobre as diretivas do sistema, consulte Diretiva do sistema (https://go.microsoft.com/fwlink/?LinkId=128292).

Para obter mais informações sobre como solucionar problemas do Windows Installer, consulte o artigo 907749 da Base de Dados de Conhecimento Microsoft sobre etapas básicas de solução de problemas do Windows Installer (https://go.microsoft.com/fwlink/?LinkId=128294).

Habilitar o log do OSE

Para habilitar o log do OSE, insira manualmente as entradas do Registro a seguir:

REGEDIT4

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

Revise o log do OSE

Inicialmente, os logs do OSE são criados no diretório %TEMP% do usuário porque o Office Source Engine não é estabelecido ainda como um serviço de sistema.

Depois que o Office Source Engine tiver sido instalado e registrado com êxito, o log alterna para o diretório %WINDIR%\Temp.

Quando solicitado, forneça esse log ao Suporte ao Produto da Microsoft para análise.