排查Microsoft Web 平台安装程序问题

2009-03-18

适用于： Internet Information Services 7.0、Internet Information Services 7.5

简介

® Microsoft Web 平台安装程序（Web PI）可以轻松下载和安装最新的Microsoft® Web 平台组件，包括 Internet Information Services（IIS）、Microsoft® SQL Server® 2008/R2 Express、Microsoft® ASP.NET 模型视图控制器（MVC3）和Microsoft® Visual Web Developer 2008/SP1 Express Edition。 Web PI 还有助于安装常用的 Web 应用程序，如 WordPress、DasBlog 或 Silverstripe。本文提供 Microsoft Web PI 可能出现的问题的一些故障排除建议。

Web PI 可在下列操作系统中运行：

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

虽然可以在 Windows® XP 家庭版上安装 Web PI，但此操作系统版本不包括 IIS。因此，Windows XP 家庭版不支持 Web PI。

Web PI 任务可分为三个阶段：

启动阶段 - 在此阶段 ，Web PI 检索最新的产品目录，并将目录组件与当前安装的产品进行比较。
产品选择阶段 - 在此阶段 ，Web PI 会检查所选产品的依赖项，并生成需要安装的依赖产品列表。
安装阶段

Web PI 可帮助你使用以下三种技术之一安装产品：

Windows® 操作系统组件（例如 IIS）-Web PI 使用 Windows 操作系统工具和接口，如 PKGMGR。
非操作系统平台组件（例如 SQL Server 2008/R2 Express）- Web PI 使用 Windows® Installer 技术（也称为 MSI）。
Web 应用程序（例如 WordPress、Silverstripe 或 DasBlog）- Web PI 使用 Microsoft® Web 部署工具。

Visual Web Developer 2010 或 Visual Studio 2010 SP1 安装时出现问题

在某些情况下，安装 VWD 2010/SP1 或 VS 2010/SP1 后，Web PI 仍显示捆绑包可供安装。这是由于检测逻辑（WebPI 术语中的 discoveryHints）方面的问题，这些需要修订。如果执行 VWD 2010/SP1 或 VS 2010/SP1 的安装，并且该过程完成后所有内容都显示为已成功安装，则部分不会执行其他工作。可以安全地忽略再次安装捆绑包的选项。

排查启动阶段的问题

Web PI 启动阶段最常见的问题涉及连接。 Web PI 从Microsoft网站下载最新的产品目录。如果失败，将显示以下错误消息：

显示显示错误消息的“Microsoft Web 平台安装程序”对话框的屏幕截图。

无法下载 Web 平台错误消息

代理隐藏：如果计算机位于代理后面，请确保正确设置 Windows® Internet Explorer 的代理设置，然后重试通过 Internet Explorer® 和 Web PI 访问 URL。
防火墙后面：在计算机上安装第三方防火墙时，请尝试在启动 Web PI 之前禁用它们。还可以将 WebpiLauncher.exe 和 WebPlatformInstaller.exe 的例外添加到防火墙设置。如果问题未解决，应遵循 Internet Explorer 中如何排查网络连接问题的步骤来解决该问题。

如果 URL 可以在 Internet Explorer 中访问，但不能通过 Web PI 访问，请使用 Fiddler，该调试器用于监视从计算机发出的 HTTP 请求。

排查安装阶段的问题

Web PI 以“无提示”方式安装组件和应用程序（不显示用户界面），安装失败会写入日志文件。由于大量受支持的安装技术和平台，因此存在许多日志文件。

安装技术可归类为：

操作系统组件
随 Windows Installer (MSI) 技术一起安装的产品
使用 Microsoft Web 部署工具部署技术的 Web 应用程序

操作系统组件

操作系统组件（如 IIS）随 Windows 安装技术一起安装。接下来的几个部分介绍了设置日志文件的位置。

Windows Vista、Windows 7、Windows Server 2008 和 Windows Server 2008 R2

Windows Vista、Windows 7、Windows Server 2008 和 Windows Server 2008 R2 上的操作系统组件使用基于组件的设置。操作系统组件的日志文件存储在 %windir%\logs\cbs 目录中。可以使用 folowing 命令打开它：

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

有关详细信息，请参阅可选组件安装程序日志诊断程序。

IIS 7.0（Windows Vista 和 Windows Server 2008）和 IIS 7.5（Windows 7 和 Windows Server 2008 R2）安装程序生成单独的安装日志文件，位于 %windir% 目录中。可以使用以下命令打开此日志文件：

notepad %windir%\iis7.log

使用 Windows Installer (MSI) 技术安装的产品

可以将 Windows Installer 技术用于 Web 平台组件，例如 Microsoft® SQL Server ® 和 Visual Web Developer 2008 Express Edition。若要查看日志，请打开 Internet Explorer 并在地址栏中键入以下路径：

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

Web PI 还会显示指向摘要屏幕中失败的日志文件的链接。有关详细信息，请参阅 Windows Installer 错误代码的详细说明。

使用 Microsoft Web 部署工具技术安装的产品

Web 部署工具通过向现有压缩文件（Zip）包添加一些清单文件，为 Web 应用程序加入 Web PI 生态系统提供了一种方法。 Web PI 调用 Web 部署工具，并在 IIS 网站上安装 Web 应用程序。 Web 部署工具技术用于在 Windows Web 应用库中可找到的所有 Web 应用程序。请注意，Web 部署工具将其所有信息记录到名为 x86_msdeploy.txt （32 位系统）或 x64_msdeploy.txt （64 位系统）的文件中。

已知问题

以下是一些已知问题：

如果启用了共享配置，Web PI 无法安装其他 IIS 组件

如果为共享配置配置 IIS，Web PI 无法安装大多数附加的 IIS 组件。有关详细信息，请参阅 IIS 7.x 安装问题疑难解答。

使用 Web PI 安装应用程序期间的问题

将应用程序安装到新站点时，Web PI 不会自动创建物理目录。手动创建目录或使用“...”用于创建新文件夹的物理路径文本框旁边的按钮。
Web PI 要求填写密码字段且不允许为空。如果应用程序允许空密码，则当应用程序安装在 Web PI 中时，密码不起作用。

应用程序安装期间Microsoft SQL Server 的问题

没有 SQL“混合模式身份验证”，应用程序无法工作。

对于大多数 Web 应用程序，需要 SQL Server 用户帐户才能访问数据库。如果仅选择了 SQL Server 的集成或Windows 身份验证，则无法在库中安装某些应用程序。
如果 SQL Server 密码不符合强度要求，则不接受这些密码。

但是，Web PI 不会验证密码的强度或其他条件。应用程序安装过程中，无法创建使用弱密码的帐户，因而安装失败。根据 SQL Server 策略使用强密码。
SQL Server 用户名不能超过 16 个字符。

但是，Web PI 不会验证用户字段的长度或其他条件。创建用户名超过 16 个字符的帐户在应用程序安装期间失败，并且安装失败。使用长度不超过 16 个字符的名称。
其他Microsoft SQL Server 问题。

有关详细信息，请查看以下目录中的 SQL Server 日志文件：

%programfiles%\microsoft sql server\100\setup bootstrap\log

有关如何排查 SQL 问题的信息，请参阅 “查看和读取 SQL Server 安装程序日志文件”。

其他故障排除工具、提示和技巧

以下信息包含一些其他有用的提示和技巧，用于解决在使用 Web PI 安装部分 Microsoft Web 平台堆栈时可能遇到的问题。

琴师

Web PI 通过 HTTP 请求下载其产品目录和产品包。 Fiddler 是一种 Web 调试程序，可帮助确定这些请求是否成功，以及请求的资源是否仍然可用。 Fiddler 可监视从运行 Web PI 的基于 Windows 的计算机发出的所有 HTTP 请求。

进程监视器

进程监视器是 Windows 的高级监视工具，用于显示实时文件系统、注册表和进程或线程活动。对于 Web PI，请使用进程监视器监视安装程序的活动。

Windows 事件日志

Windows 有一个中心存储库，用于存储称为 Windows 事件日志的错误、信息性消息和警告。虽然有时会被忽略，但事件日志通常提供了许多问题的解决方案，值得探索。若要打开 Windows 事件日志，请在命令提示符处或在 “运行 ”菜单中键入以下命令：

eventvwr.msc

Web PI 跟踪

Web PI 具有附加的内置跟踪机制。通过将以下配置文件保存为 %programfiles%\Microsoft\Web Platform Installer 目录中的 webplatforminstaller.exe.config，即可激活该文件。

<?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>

名为WebPI.log文件的跟踪文件也会写入 %programfiles%\Microsoft\Web Platform Installer 目录。

清理 Web PI 缓存

Web PI 缓存产品目录和其他文件以优化启动时间。如果产品目录似乎已过时，或者 Web PI 中显示不正确的数据，请使用以下命令删除缓存：

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

其他帮助

如果已用尽本文中的故障排除提示和技巧，但仍遇到问题，请访问 Web 平台安装程序论坛。

通过