Compartilhar via

Solução de problemas com Microsoft Web Platform Installer

por equipe do IIS

Introdução

O Microsoft® Web Platform Installer (Web PI) simplifica o download e a instalação dos componentes mais recentes da Plataforma Web da Microsoft®, incluindo os Serviços de Informações da Internet (IIS), o Microsoft® SQL Server ® 2008/R2 Express, o Microsoft® ASP.NET Model View Controller (MVC3) e o Microsoft® Visual Web Developer 2008/SP1 Express Edition. O Web PI também instala aplicativos Web populares, como WordPress, DasBlog ou Silverstripe. Este artigo apresenta alguns conselhos de solução de problemas que podem surgir com o Microsoft Web PI.

O Web PI é executado nos seguintes sistemas operacionais:

  • Windows Server® 2008 e Windows Server® 2008 R2
  • Service Pack 3 do Windows® XP Professional Edition
  • Windows Server® 2003 SP2
  • Windows Vista® SP 1
  • Windows® 7

Observe que, embora seja possível instalar o Web PI no Windows® XP Home Edition, essa versão do sistema operacional não inclui o IIS; Portanto, não há suporte para o Web PI no Windows XP Home Edition.

As tarefas do Web PI podem ser divididas em três fases:

  • Fase de inicialização. O Web PI recupera o catálogo de produtos mais atual e compara os componentes do catálogo com os produtos atualmente instalados.
  • Fase de seleção do produto.
    O Web PI verifica as dependências dos produtos selecionados para instalar e compila a lista de produtos dependentes que precisam ser instalados.
  • Fase de instalação.

O Web PI instala produtos usando uma das três tecnologias:

  • Para instalar componentes do sistema operacional Windows® (por exemplo, IIS), o Web PI usa ferramentas e interfaces do sistema operacional Windows, como PKGMGR.
  • Para instalar componentes da plataforma do sistema não operacional, (por exemplo, SQL Server 2008/R2 Express) o Web PI usa a tecnologia do Windows® Installer (também conhecida como MSI).
  • Para instalar aplicativos Web (por exemplo, WordPress, Silverstripe ou DasBlog), o Web PI usa a Ferramenta de Implantação da Web da Microsoft®.

Problemas recentes

(Postado: 25 de julho de 2011)

Problemas com a instalação do Visual Web Developer 2010/Visual Studio 2010 SP1

Os usuários relataram problemas em que, depois de instalar o VWD 2010/SP1 ou o VS 2010/SP1, essa WebPI ainda mostra o pacote como disponível para instalação. Isso ocorre devido a problemas com a lógica de detecção (discoveryHints em termos de WebPI) que precisam de revisões. Se você executar uma instalação do VWD 2010/SP1 ou VS 2010/SP1 e tudo aparecer como instalado com êxito após a conclusão do processo, não haverá nenhum trabalho adicional de sua parte. No momento, você pode ignorar com segurança a opção de "instalar" o pacote novamente

Práticas recomendadas de solução de problemas gerais

Para ajudar a Equipe da Plataforma Web a depurar problemas com sua tentativa de instalação, poste os logs nos fóruns. Criamos uma postagem que fornece detalhes adicionais sobre quais arquivos de log postar: Você pode ler sobre isso aqui: https://forums.iis.net/t/1178550.aspx

Solução de problemas durante a fase de inicialização

Os problemas mais comuns durante a fase de inicialização do Web PI envolvem conectividade. O Web PI baixa o catálogo de produtos mais recente de um site da Microsoft. Se isso falhar, uma mensagem de erro como a seguinte será exibida:

Captura de tela da caixa de diálogo Microsoft Web Platform Installer exibindo uma mensagem de erro.

Figura 1: não é possível baixar a mensagem de erro da Plataforma Web

Atrás do Proxy Se o computador estiver por trás de um proxy, verifique se as configurações de proxy do Windows® Internet Explorer® estão definidas corretamente e tente novamente acessar a URL por meio do Internet Explorer e, em seguida, por meio do Web PI
Atrás de firewalls No caso em que firewalls de terceiros estão instalados no computador, tente desabilitá-los antes de iniciar o Web PI. Você também pode adicionar exceções para WebpiLauncher.exe e WebPlatformInstaller.exe às configurações de firewall. Se o problema ainda não for resolvido, será possível corrigir o problema seguindo as etapas descritas em como solucionar problemas de conectividade de rede no Internet Explorer.

Se a URL puder ser acessada no Internet Explorer, mas não por meio do Web PI, use o Fiddler, um depurador da Web que monitora quais solicitações HTTP são feitas de um computador. O Fiddler pode ser baixado do apresentando o Fiddler.

Solução de problemas durante a fase de instalação

O Web PI instala componentes e aplicativos "silenciosamente" (sem exibir uma interface do usuário) e as falhas de instalação são gravadas em arquivos de log. Há muitos arquivos de log devido ao grande número de plataformas e tecnologias de instalação com suporte.

As tecnologias de instalação podem ser categorizadas como:

  • Componentes do sistema operacional
  • Produtos instalados com a tecnologia MSI (Windows Installer)
  • Aplicativos Web usando a tecnologia de implantação Ferramenta de Implantação da Web da Microsoft

Componentes do sistema operacional

Componentes do sistema operacional, como o IIS, são instalados com tecnologias de instalação do Windows. Os locais para os arquivos de log de instalação são descritos nos parágrafos a seguir.

Windows Vista, Windows 7, Windows Server 2008 e Windows Server 2008 R2

Os componentes do sistema operacional no Windows Vista, Windows 7, Windows Server 2008 e Windows Server 2008 R2 usam a instalação baseada em componentes. O arquivo de log para componentes do sistema operacional é armazenado no %windir%\logs\cbs diretório. Você pode abri-lo com o comando:

notepad %windir%\logs\cbs\cbs.log

Para obter mais informações, consulte o Diagnosticer de Log de Instalação de Componente opcional.

O IIS 7.0 (Windows Vista e Windows Server 2008) e a instalação do IIS 7.5 (Windows 7 e Windows Server 2008 R2) geram um arquivo de log de instalação separado, localizado no %windir% diretório. Você pode abrir esse arquivo de log com o comando:

notepad %windir%\iis7.log

Windows XP e Windows Server 2003

Os arquivos de log de instalação do Windows XP e do Windows Server 2003 são armazenados no %systemroot% diretório. Você pode abrir o arquivo de log de instalação do Windows com o nome setuperr.log com o comando:

notepad %systemroot%\setuperr.log.

O arquivo de log de instalação do IIS é chamado iis6.log ou iis51.log. Você pode abri-lo com o comando:

notepad %wsystemroot%\iis6.log.

Produtos instalados usando a tecnologia MSI (Windows Installer)

Você pode usar a tecnologia do Windows Installer para componentes da plataforma Web, como o Microsoft® SQL Server ® e o Visual Web Developer 2008 Express Edition. Para examinar os logs, abra o Internet Explorer e digite o seguinte na barra de endereços:

%localappdata%\Microsoft\Web Platform Installer\logs\install

O Web PI também exibe um link para o arquivo de log que falhou na tela de resumo; consulte a descrição detalhada dos códigos de erro do Windows Installer.

Produtos instalados usando a tecnologia Ferramenta de Implantação da Web da Microsoft

A Ferramenta de Implantação da Web oferece uma maneira de aplicativos Web ingressarem no ecossistema do Web PI adicionando alguns arquivos de manifesto a um pacote zip (arquivo compactado) existente. O Web PI chama a Ferramenta de Implantação da Web e instala o aplicativo Web em um site do IIS. A tecnologia ferramenta de implantação da Web é usada para todos os aplicativos Web encontrados na Galeria de Aplicativos Web do Windows. Observe que a Ferramenta de Implantação da Web registra todas as suas informações em um arquivo chamado x86_msdeploy.txt (sistema de 32 bits) ou x64_msdeploy.txt (sistema de 64 bits).

Problemas conhecidos

A seguir estão alguns problemas conhecidos:

O Web PI não poderá instalar componentes adicionais do IIS se a configuração compartilhada estiver habilitada.
Se o IIS estiver configurado para "Configuração Compartilhada", o Web PI não poderá instalar a maioria dos componentes adicionais do IIS. Para obter mais informações, consulte o artigo de suporte "Você não pode instalar ou desinstalar um componente no IIS 7.0 (https://support.microsoft.com/kb/954856)."

Problemas durante a instalação do aplicativo usando o Web PI:

  • O Web PI não cria diretórios físicos automaticamente quando um aplicativo é instalado em um novo site.
    Crie o diretório manualmente ou use o '...' botão ao lado da caixa de texto caminho físico para criar uma nova pasta.
  • O Web PI requer que os campos de senha sejam preenchidos e não permite que eles fiquem vazios.
    Se um aplicativo permitir uma senha vazia, a senha não funcionará quando o aplicativo estiver instalado no Web PI.

Problemas com a Microsoft SQL Server durante a instalação do aplicativo:

  • Os aplicativos não funcionam sem a "autenticação de modo misto" do SQL.
    Para a maioria dos aplicativos Web, SQL Server contas de usuário são necessárias para acessar um banco de dados. Se apenas os autenticação do Windows ou integrados para SQL Server estiverem selecionados, você não poderá instalar alguns dos aplicativos na galeria.
  • SQL Server senhas não serão aceitas se não atenderem aos requisitos de força.
    No entanto, o Web PI não valida senhas para força ou para outros critérios. A falha na criação de uma conta com uma senha fraca ocorre durante a instalação do aplicativo e a instalação falha. Use uma senha forte de acordo com a política de SQL Server.
  • SQL Server nomes de usuário não podem ter mais de 16 caracteres.
    No entanto, o Web PI não valida campos de usuário para tamanho ou outros critérios. A falha ao criar uma conta com um nome de usuário com mais de 16 caracteres ocorre durante a instalação do aplicativo e a instalação falha. Use um nome de usuário que não tenha mais de 16 caracteres.
  • Outros problemas de SQL Server da Microsoft. Verifique os arquivos de log SQL Server no seguinte diretório para obter mais informações:
    %programfiles%\microsoft sql server\100\setup bootstrap\log
    Mais detalhes sobre como solucionar problemas de SQL podem ser encontrados https://support.microsoft.com/kb/955396
  • Instalação personalizada de SQL Server
    Para clientes que precisam de personalização para seus SQL Server instalar fora do Web PI, verifique este guiahttps://blogs.msdn.com/sqlexpress/archive/2009/06/15/installing-sql-server-2008-guidance.aspx.

Problemas com a instalação do Visual Web Developer:

Ferramentas, dicas e truques adicionais de solução de problemas

As informações a seguir contêm algumas dicas e truques úteis adicionais para resolver problemas que você pode encontrar ao instalar partes da pilha Microsoft Web Platform com o Web PI.

Arquivos do Instalador do Web PI

Os arquivos do instalador da WebPI podem ser baixados diretamente - consulte a postagem a seguir sobre onde obter os arquivos

Fiddler

O Web PI baixa seu catálogo de produtos e os pacotes de produtos por meio de solicitações HTTP. O Fiddler é um depurador da Web que pode ajudar a determinar se essas solicitações têm êxito e se os recursos solicitados ainda estão disponíveis. O Fiddler monitora todas as solicitações HTTP feitas no computador baseado no Windows que executa o Web PI.

Process Monitor

O Monitor de Processo é uma ferramenta avançada de monitoramento para Windows que mostra o sistema de arquivos em tempo real, o registro e a atividade de processo/thread. No caso do Web PI, o Monitor do Processo pode ser usado para monitorar a atividade de programas de instalação.

Log de eventos do Windows

O Windows tem um repositório central para erros, mensagens informativas e avisos chamado log de eventos do Windows. Embora às vezes negligenciado, o Log de Eventos geralmente fornece a solução para muitos problemas e vale a pena explorar. Para abrir o Log de Eventos do Windows, digite o seguinte no prompt de comando ou no menu Executar:

eventvwr.msc

Rastreamento do Web PI

O Web PI tem um mecanismo de rastreamento interno adicional. Ele pode ser ativado salvando o arquivo de configuração a seguir como webplatforminstaller.exe.config no diretório %programfiles%\Microsoft\Web Platform Installer.

<?xml version='1.0' encoding='UTF-8' ?>
<configuration>
  <system.diagnostics>
    <trace autoflush='true' />
    <sources>
      <source name='DownloadManager'>
        <listeners>
          <add name='TextFile'/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="TextFile"
           type="System.Diagnostics.TextWriterTraceListener"
           initializeData="WebPI.log"/>
    </sharedListeners>
    <switches>
      <add name='mySwitch' value='Verbose' />
    </switches>
  </system.diagnostics>
</configuration>

O arquivo de rastreamento chamado arquivo WebPI.log também é gravado no diretório %programfiles%\Microsoft\Web Platform Installer.

Limpar o cache do Web PI

O Web PI está armazenando em cache o catálogo de produtos e outros arquivos para otimizar o tempo de inicialização. Se o catálogo de produtos parecer desatualizado ou se dados incorretos forem exibidos no Web PI, exclua o cache com:

del /q "%localappdata%\Microsoft\web platform installer\*"

Ajuda adicional

Se você tiver esgotado as dicas e truques de solução de problemas neste artigo e ainda estiver tendo problemas, visite o fórum do Web Platform Installer em https://forums.iis.net/1155.aspx.