通过

解决升级问题 (SharePoint Foundation 2010)

  • 项目

 

适用于： SharePoint Foundation 2010

上一次修改主题： 2016-11-30

即使在通过测试升级过程来标识潜在问题之后，您也可能会在从 Windows SharePoint Services 3.0 升级到 Microsoft SharePoint Foundation 2010 的过程中遇到意外的问题。当您在升级后遇到问题时，您检测并解决这些问题的速度越快，最终用户体验就越佳。

本文描述用于标识和解决升级问题的一般原则，并包含一个常见问题列表。在标识并解决问题之后，可以恢复升级。有关如何恢复升级的详细信息，请参阅继续升级 (SharePoint Foundation 2010)。

本文内容：

  • 确定问题的一般原则

  • 常见问题

    • 服务器端文件或自定义项缺失或被弃用

    • 服务器场、Web 应用程序或服务配置错误或缺少设置

    • 更新级别不一致或不正确

    • 博客缺少全局导航

    • 数据问题

    • UI 更改

    • 缺少空间

    • 基于表单的身份验证

    • 安全性和权限

    • 升级后 .Stp 文件不起作用

    • 找不到 Fabulous 40 应用程序模板的新版本

确定问题的一般原则

首先，通过检查升级状态确定升级停止的位置（如果已停止），通过检查日志文件查找任何错误或警告。接下来，解决您发现的问题，然后再继续升级。

首先，检查升级状态和日志文件

升级状态指示器和日志文件将指出升级过程中出现的错误。我们建议您仔细审阅升级日志文件中记录的所有错误。虽然警告并不总是表示问题，但您应审阅所有警告以确定是否存在可能导致更多问题的警告。

  1. 通过执行下列一项或两项操作来查看升级状态：

    • 查看 SharePoint 管理中心网站中的“升级状态”页。

    • 使用 Stsadm.exe 操作 localupgradestatus 查看升级状态。

    有关如何查看升级状态的详细信息，请参阅验证升级和审阅升级后的网站 (SharePoint Foundation 2010)。

  2. 查看以下日志文件：

    • Setup.exe 日志文件。

    • SharePoint 产品配置向导 (Psconfig.exe) 日志文件。

    • 升级错误日志文件和升级日志文件（此文件中包含的信息比升级错误日志文件中包含的信息更为详细）。

    • ULS 或跟踪日志文件。

      这些文件存储在 %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS 文件夹中，其名称为 Servername_YYYYMMDD-MMSS.log。

    • 应用程序事件日志文件。

      可以使用事件查看器来查看此文件。

    有关 Setup.exe、PSconfig.exe 和升级日志文件的详细信息，请参阅验证升级和审阅升级后的网站 (SharePoint Foundation 2010)。有关跟踪日志文件的详细信息，请参阅 MSDN 上的跟踪日志（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=182380&clcid=0x804)（该链接可能指向英文页面）。

然后，按顺序解决问题

有一些问题产生的影响比其他问题产生的影响更大。例如，缺少服务器端文件会导致许多看似不相关的网站级错误。

按以下顺序解决问题：

  1. 缺少的服务器端文件或自定义项，如功能或 Web 部件。

  2. 服务器场、Web 应用程序或服务（如未启动的托管路径或服务）中的配置问题。

  3. 在各个网站（从影响较大的网站开始）上发现的其他问题。

在标识并解决首要问题时，可以尝试重新运行升级以查看是否解决了升级过程中后面出现的任何问题。

常见问题

检查以确定以下问题中是否存在导致升级错误或警告的问题。

服务器端文件或自定义项缺失或被弃用

升级过程中的一个常见错误是缺少服务器端文件（随 Windows SharePoint Services 3.0 安装的文件或自定义的文件）。在准备升级时，应创建网站所需的服务器端自定义项（例如网站定义、模板、功能、Web 部件、程序集）的清单。（升级前检查程序可帮助识别这些项。）查看此清单以确保在升级环境中安装自定义项所需的所有文件。

如果执行的是数据库附加升级，则可在升级数据库之前使用 test-spcontentdatabaseWindows PowerShell cmdlet 来确定丢失的任何文件。也可以使用 Stsadm.exe 中的 enumallwebs 操作来标识正在使用的服务器端自定义项。

在升级日志文件中，您也许会看到如下类似的错误：

  • 错误: 发现使用缺少的 Web 模板的网站的引用计数，ContentDatabase 内容数据库名称中的网站模板标识符 (lcid: 网站模板语言代码)。

  • 错误: 找到一个缺失的功能 ID = [功能标识符]

  • 错误: 文件 [相对文件路径] 在数据库中引用了 [引用计数] 次，但在当前服务器上没有安装。

  • 警告: WebPart 类 [Web 部件标识符] 在数据库中引用了 [引用计数] 次，但在当前服务器上没有安装。

  • 警告: 程序集 [程序集路径] 在数据库中进行了引用，但在当前服务器上没有安装。

  • 警告: 未能升级功能。异常: 未能找到 ID 为*“功能标识符”*的功能定义。

如果您能够获得缺失的服务器端文件或依赖项，请安装它，然后为受影响的网站重新运行升级。如果该文件或依赖项（如 Web 部件）已被弃用，您必须调查是否需要重新生成网站、网页或 Web 部件以使用不同的模板、功能或 Web 部件。如果使用尚未被弃用的依赖项来重新进行自定义，则可以为受影响的网站重新运行升级。如果无法移除依赖项，则无法升级网站。

安装缺少的文件或依赖项之后，可以在测试服务器上使用 test-SPContentDatabaseWindows PowerShell cmdlet 来确定是否缺少该数据库的任何其他文件。如果只是运行升级前检查程序或重新运行升级，则日志文件中可能不会显示该错误，即使该错误可能仍在发生。

服务器场、Web 应用程序或服务配置错误或缺少设置

验证服务器场和 Web 应用程序的设置，创建并启动任何缺失的服务。

确认每个 Web 应用程序的任何托管路径（包含路径或排除路径）配置正确。

在升级日志文件中，您也许会看到如下类似的错误：

  • 错误: 由于异常而未能访问模板 模板 Id: SPSite Id=网站 Id。在模板升级过程中跳过 SPWeb Id=Web Id。异常: System.IO.FileNotFoundException: 未找到具有 ID 网站 Id 的网站。

    此错误指示缺少管理路径。请将网站集的管理路径添加到 Web 应用程序中，并为包含此网站集的内容数据库重新启动升级。

更新级别不一致或不正确

必须运行 Windows SharePoint Services 3.0 Service Pack 2 才能运行升级。如果未满足此最低要求，则您将看到一个错误，并且升级将不会运行。

博客缺少全局导航

另一个常见错误是升级博客缺少全局导航。出现这种错误的原因是升级期间未启用 MySiteNavigation (6adff05c-d581-4c05-a6b9-920f15ec6fd9) 功能。要启用此功能，请运行 Enable-SPFeatureWindows PowerShell 2.0 cmdlet。

有关详细信息，请参阅 Enable-SPFeature。

数据问题

以下数据问题会导致升级过程中出现错误或警告：

  • 与数据源的连接。如果服务器无法连接到数据库，则无法更新它们。

  • 孤立的网站或列表或其他数据库已损坏。有关详细信息，请参阅在升级之前清理环境 (SharePoint Foundation 2010)。

  • 列数据已隐藏。如果升级过程向列表中添加一个列，而列表中已存在一个具有相同名称的自定义列，则将重命名该自定义列。在升级之后，您可能必须重新调整视图以包含该重命名的列。

在升级日志文件中，您也许会看到如下类似的错误：

  • 警告: 孤立的网站可能会导致升级失败。

  • 错误: 数据库 [内容数据库名称] 包含的网站 (Id = [网站集标识符]，Url = [网站集 URL]) 在站点地图中找不到。

修复任何孤立的项或数据库损坏问题，然后重新运行升级。

UI 更改

对用户界面 (UI) 进行更改（如添加 Fluent UI（也称作功能区）或遵循 XHTML 标准）会导致网站中出现问题。有时，自定义元素（如内容类型）具有的名称可能会与新版本中的某个名称发生冲突。您也可以有必须转换为标准网站定义的网页或必须为其创建新视图的大型列表。

有关如何查看网站中的 UI 问题的详细信息，请参阅验证升级和审阅升级后的网站 (SharePoint Foundation 2010)。

在升级日志文件中，您也许会看到如下类似的错误：

  • 未能在网站 [网站 Url] 上激活网站集功能。异常: 发现重复的内容类型名称*“名称”*。

    此错误指示已将第三方的“摘要信息”内容类型添加到 o12 中的指定网站，并且在升级到 o14 的过程中，其名称与动态“摘要信息”内容类型的名称发生冲突。在指定网站中，删除第三方内容类型或将其重命名为“摘要信息”之外的其他名称，然后再重新运行升级。

缺少空间

如果空间不足（例如，用于数据库服务器上的事务日志文件的空间不足），升级将无法继续。请释放一些空间，或增大事务日志文件的大小，然后再继续升级。有关详细信息，请参阅管理事务日志文件的大小 (https://go.microsoft.com/fwlink/?linkid=124882&clcid=0x804)。

基于表单的身份验证

如果升级的是使用基于表单的身份验证的环境，则必须执行其他步骤。按照为基于声明的 Web 应用程序配置基于表单的身份验证 (SharePoint Foundation 2010) 中的步骤执行操作可升级基于表单的身份验证提供程序。

安全性和权限

如果您收到一条有关未知帐户的错误，或者数据库未升级，请验证以下事项：

  • 对于就地升级，确保用于运行 SharePoint 产品配置向导的帐户是要升级的所有数据库的 db_owner 固定数据库角色的成员。如果它不是此角色的成员，则在向导开始升级数据库时，您可能会看到有关未知用户帐户的错误。

  • 对于数据库附加升级，如果在 SQL Server 的实例之间移动数据库，请确保验证是否正确配置了安全性。检查所用帐户是否有适当的固定角色和数据库权限，以及在跨域升级时它们是否仍是有效的帐户。

升级后 .Stp 文件不起作用

网站模板（.stp 文件）在 SharePoint Foundation 2010 中已被弃用，不能用来创建新网站。基于 .stp 文件的现有网站将继续正常运行。在 SharePoint Foundation 2010 中，支持用解决方案包（.wsp 文件）来创建基于模板的网站。可将 .stp 文件转换为 .wsp 文件以便在升级后继续使用模板。

将 .stp 文件转换为 .wsp 文件

  1. 在 Windows SharePoint Services 3.0 中，创建基于模板的网站，然后将该网站升级到 SharePoint Foundation 2010。

  2. 在 SharePoint Foundation 2010 中，在已升级网站中的“网站操作”菜单上，单击“网站设置”。

  3. 在“网站设置”页的“网站操作”下，单击“将网站另存为模板”。

  4. 在“另存为模板”页上，输入“文件名”和“模板名称”，然后单击“确定”。

    网站模板将以 .wsp 文件的形式保存到此网站集的解决方案库中，然后可以创建基于此解决方案的新网站。

找不到 Fabulous 40 应用程序模板的新版本

许多人都使用过为 Windows SharePoint Services 3.0 创建的“Fabulous 40”模板。其中一些模板创建为网站管理模板（.stp 文件），还有一些模板创建为服务器管理模板（.wsp 文件）。Microsoft 不会为 SharePoint 2010 产品 发布这些模板的新版本。而且，在升级到 SharePoint Foundation 2010 后，.stp 文件将被弃用，不能用来创建新网站。

可以升级基于这些模板的网站。但应尝试先在测试环境中升级这些网站，然后再升级生产环境，以便可以发现任何潜在问题。使用升级前检查工具可以发现任何问题。（有些人已经在模板中发现自定义工作流或基于 CAML 的视图存在问题。）请注意，升级后您将无法使用 .stp 文件来创建新模板。

下表介绍模板的使用方法。

模板类型 是否可以升级基于此模板的网站？ 升级后是否可以使用模板？

网站管理（.stp 文件或网站模板）

是

否

服务器管理（.wsp 文件或解决方案包）

是*

是*

*升级后，有些 .wsp 文件存在问题。特别需要注意，在升级后，有些客户不能创建基于以下模板的网站：休假申请和休假时间表管理、呼叫中心、技术支持、IT 团队工作区、知识库以及物理资产跟踪和管理。如果在使用上述任何模板时遇到问题，可在 SharePoint 2010 – 安装、升级、管理和操作 TechNet 论坛（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=201600&clcid=0x804)（该链接可能指向英文页面） 中发布问题或与 Microsoft 客户支持部门联系。

如果要在 SharePoint Foundation 2010 中继续创建基于网站管理模板（.stp 文件）的网站，必须将这些模板转换为解决方案包（.wsp 文件）。有关详细信息，请参阅上文中的升级后 .Stp 文件不起作用一节。

See Also

Concepts

使用试验升级查找潜在问题 (SharePoint Foundation 2010)
验证升级和审阅升级后的网站 (SharePoint Foundation 2010)
继续升级 (SharePoint Foundation 2010)