Compartilhar via

  • Artigo

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

Aplica-se a: Office Resource Kit

 

Tópico modificado em: 2015-03-09

Neste artigo:

  • Log de eventos do aplicativo do Windows

  • Log de instalação do 2007 Office system

  • Log de custo total de propriedade (GIMME)

  • Log do Windows Installer

  • Log do OSE do Office 2007

Este artigo aborda cinco opções de log diferentes que você pode usar para ajudar a solucionar problemas de instalação e configuração do Microsoft Office 2007.

Log de eventos do aplicativo do Windows

O Windows Installer grava entradas no log de eventos de aplicativo do Windows para registrar eventos, como:

  • Sucesso ou falha da instalação, remoção ou reparo de um produto.

  • Erros que ocorrem durante a configuração do produto.

  • Detecção de dados de configuração corrompidos.

  • Informações sobre quais componentes ausentes causam um reparo de um aplicativo.

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).

Log de Instalação do 2007 Office system

Quando houver problemas com uma instalação ou atualização do 2007 Office system, os arquivos de log são o primeiro lugar que deve ser pesquisado para solucionar o problema. Muito pode ser determinado com a criação de um log detalhado e análise do Código de Retorno no log.

Nas versões anteriores do Office, você usava as propriedades do Windows Installer para personalizar e controlar a instalação do Office. No 2007 Office system, o processo de instalação é redefinido e o log é afetado por:

  • O elemento de log no arquivo Config.xml (método recomendado).

  • A propriedade de log adicionada usando a ferramenta de personalização do Office (OCT).

Por padrão, a Instalação do 2007 Office system cria automaticamente arquivos de log na pasta %TEMP% e registra tudo na memória; portanto, um erro de uma falha de instalação ou cancelamento fará com que o programa alterne para o log detalhado no ponto de falha.

Um arquivo de log separado não é criado para cada MSI pertencente ao produto instalado. Além disso, o arquivo de log só está disponível em inglês, sem nenhuma localização. No entanto, como o Windows SharePoint Services faz parte do Windows e é uma opção na instalação do 2007 Office system, o log do Windows Installer (que é independente do log da Instalação do 2007 Office system) continua a dar suporte à versão MUI do log do Windows.

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.

Atributo Valor Descrição

Type

Off

A Instalação não cria nenhum log.

Standard (padrão)

A Instalação registra todos os eventos de instalação (propriedades de linha de comando passadas, propriedades do arquivo config.XML passadas, patches aplicados), origem de instalação local (LIS), log MSI (ações personalizadas, estados do recurso), qual desses eventos é bem-sucedida ou não, erros, opções de usuário e a interface do usuário exibida.

Verbose

A Instalação grava todas as informações de instalação no arquivo de log.

Debug

A Instalação grava detalhes de todas as informações de log além de informações de depuração. Isso é útil ao identificar uma parte falha do código.

Path

caminho

O caminho totalmente qualificado para a pasta usada para o arquivo de log. Você pode usar variáveis de ambiente. O padrão é %temp%.

Template

nome_do_arquivo .txt

O nome do arquivo de log. Se você inserir a sequência de caracteres * em qualquer lugar no nome do arquivo, um arquivo de log exclusivo será criado para cada instalação executada pelo programa. Se * não estiver incluída e o nome de arquivo especificado já existir, as informações do log serão acrescentadas ao arquivo existente. Uma extensão de arquivo deve ser especificada. O modelo padrão é SetupExe (*) .log. Variáveis de ambiente, como %COMPUTERNAME%, podem ser usadas para criar logs facilmente identificados e exclusivos.

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.

Log de custo total de propriedade (GIMME)

No modelo de vários MSI para o 2007 Office system, recursos são espalhados entre vários MSIs e cada MSI tem seu próprio código do produto. Para lidar com esse novo modelo de vários MSIs, a API GIMME usa Setup.exe (em vez do Windows Installer) para executar ações de Instalar sob Demanda (IOD) e Reparar sob Demanda (ROD). Basicamente, a API GIMME identifica que uma chamada IOD ou ROD está sendo feita, determina qual conjunto de MSIs contém a opção solicitada e inicia o Setup.exe para instalá-lo. O log dessas ações é conhecido como log de custo total de propriedade.

O termo "GIMME" não é um acrônimo; é o termo usado para descrever a API que manipula a ações de solicitação de instalação feitas pelo MSO.DLL. Ele serve como um "wrapper" estendido em torno da API de tempo de execução do Windows Installer. Gimme quer dizer, literalmente, "Give Me" (Me Dê). Em outras palavras, como o aplicativo está carregando, está tentando reunir todos os seus componentes e verificar se foram todos instalados corretamente.

Motivos para usar um log de custo total de propriedade incluem o seguinte:

  • O Office realiza reparo repetido.

  • Para ver a atividade antes de uma falha que pode ser reproduzida.

  • O Office não está usando componentes instalados.

Os logs de custo total de propriedade são mais úteis quando o evento de disparo NÃO está no Log de Eventos do Aplicativo. Também são muito úteis para diagnosticar o motivo de uma instalação por demanda.

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.

Log do Windows Installer

Com o advento do modelo de instalação de vários MSIs do 2007 Office system, o log de Windows Installer ineficiente é secundário para o log de instalação do 2007 Office system. No entanto, ainda existem ocasiões em que somente o log do Windows Installer fornecerá o nível adicional de detalhamento necessário.

Como o tamanho dos logs pode ser significativo, você só deverá ativar o log do Windows Installer quando for necessário e desabilitá-lo imediatamente quando o problema for resolvido.

Embora o uso das funções do Windows Installer seja limitado ao 2007 Office system, o arquivo Setup.exe, em última análise, depende do Windows Installer para executar vários processos. Por isso, alguns dos erros que ocorrem com o próprio Windows Installer podem precisar ser corrigidos antes de determinarmos se existe um problema real com o 2007 Office system. Antes de habilitar log do Windows Installer, verifique o seguinte:

  • Verifique se o serviço Windows Installer não está desabilitado.

  • Verifique restrições de diretivas do sistema.

  • Limpe os arquivos temporários.

  • Verifique permissões DCOM.

Verifique se o serviço Windows Installer não está desabilitado

  1. Vá para Iniciar | Executar, digiteservices.msc e pressione o botão Enter.

  2. Clique duas vezes no serviço chamado Windows Installer.

  3. Verifique o valor do campo Tipo de inicialização. Se estiver definido como Desabilitado, esse é o problema. Mude-o para inicialização manual selecionando Manual na caixa suspensa.

Verificação de restrições de diretivas do sistema

  1. Vá para Iniciar | Executar, digiteGPEdit.msc e pressione o botão Enter.

  2. Abra a árvore Configuração do Computador | Modelos Administrativos | Componentes do Windows | Windows Installer.

  3. Confirme se as diretivas que podem afetar a Instalação estão habilitadas ou desabilitadas; por exemplo, Desabilitar Windows Installer.

Editor de Objeto de Diretiva de Grupo

Editor de Diretiva de Grupo

Limpar os arquivos temporários

  1. Você pode criar um arquivo de script simples/em lotes que contenha as linhas a seguir para esvaziar automaticamente todas as pastas temporárias e eliminar erros causados pela tentativa de exclusão de arquivos temporários que estão em uso:

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

    Como alternativa, você poderá excluir manualmente os arquivos temporários usando as seguintes etapas.

  2. Esvazie a pasta %SYSTEMDRIVE%\temp.

  3. Esvazie a pasta %WINDIR%\Temp.

  4. Esvazie a pasta de % TEMP %.

Verificar permissões DCOM

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.

Valor Descrição

v

Saída detalhada

o

Mensagens de falta de espaço em disco

i

Mensagens de status

c

Parâmetros iniciais da interface do usuário

e

Todas as mensagens de erro

w

Avisos não fatais

a

Inicialização de ações

r

Registros específicos de ação

m

Informações de saída fatal ou de falta de memória

u

Solicitações do usuário

p

Propriedades de terminal

+

Acrescentar ao arquivo existente

!

Mover cada linha para o log

x

Informações de depuração extra. O sinalizador "x" só está disponível no Windows Server 2003 e em sistemas operacionais posteriores e na versão redistribuível 3.0 do MSI e em versões posteriores do MSI redistribuível.

*

Caractere curinga, registra todas as informações exceto para as opções v e x. Para incluí-las, especifique "/l*vx".

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

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

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).

Log do OSE do Office 2007

O log do OSE (Office Source Engine) só será usado quando se trabalhar com o Atendimento Microsoft e normalmente só contém informações úteis para um desenvolvedor de produtos. Assim, essa referência é fornecida para oferecer as etapas necessárias quando o log OSE for solicitado pelo suporte técnico da Microsoft.

Quando você instala o 2007 Office system, a Instalação usa um serviço do sistema — o Office Source Engine (Ose.exe) — para criar a origem de instalação local (LIS) necessária copiando os arquivos de instalação exigidos do ponto de instalação para um local oculto em seu computador. A Instalação usa esse LIS como origem de instalação do 2007 Office system.

Como o Office Source Engine é uma parte vital dos processos de instalação e manutenção, há um método para registrar somente essas ações executadas pelo Office Source Engine.

Dois exemplos a seguir mostram erros gerados pelo Office Source Engine.

Mensagem de erro do Visualizador Cliente

Mensagem de erro do Visualizador Cliente

Mensagem de erro do Visualizador da Ajuda do Microsoft Office

Mensagem de erro do Visualizador da Ajuda do Microsoft Office

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.