解决升级问题 (SharePoint Server 2010)

  • 项目

 

适用于： SharePoint Server 2010

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

即使通过对升级过程进行测试确定潜在问题之后，在从 Microsoft Office SharePoint Server 2007 升级到 Microsoft SharePoint Server 2010 的过程中仍有可能会遇到意外问题。如果在升级后遇到问题，那么检测并修复问题的速度越快，最终用户的体验就越好。

本文介绍确定和解决升级问题的一般原则，还提供了常见问题列表。在确定并解决这些问题后，可以继续升级。有关如何继续升级的详细信息，请参阅继续升级 (SharePoint Server 2010)。

本文内容：

  • 确定问题的一般原则

  • 常见问题

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

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

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

    • 博客缺少全局导航

    • 数据问题

    • UI 更改

    • 缺少空间

    • 基于表单的身份验证

    • 安全性和权限

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

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

    • 升级 SharePoint Portal Server 2003 中的数据：升级前检查程序将报告损坏的数据库

确定问题的一般原则

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

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

升级状态指示符和日志文件应指示升级过程中出现了什么问题。建议您仔细查看升级日志文件中记录的所有错误。警告并不一定表示存在问题，但应查看所有警告，以确定是否有任何警告可能引起更多问题。

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

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

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

    有关如何检查升级状态的详细信息，请参阅验证升级并审阅升级后的网站 (SharePoint Server 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 Server 2010)。有关跟踪日志文件的详细信息，请参阅 MSDN 中的跟踪日志（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=182380&clcid=0x804)（该链接可能指向英文页面）。

然后，按顺序解决问题

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

请按以下顺序解决问题：

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

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

  3. 您从影响最大、关注度最高的网站开始逐个网站发现的其他问题。

在确定并修复首要问题时，可以尝试再次运行升级，以查看升级过程中的任何后续问题是否已经修复。

常见问题

通过检查确定是否有以下任何问题正导致升级错误或警告。

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

升级期间的一个常见错误是服务器端文件（随 Office SharePoint Server 2007 安装的文件或自定义文件）丢失。在准备升级时，应创建网站所需要的服务器端自定义（如网站定义、模板、功能、Web 部件和程序集）的清单。（升级前检查工具可帮助确定这些项目。）检查此清单可确保升级环境中已安装自定义所需要的全部文件。

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

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

  • 错误: 在内容数据库“内容数据库名称”中找到“引用计数”个使用丢失的 Web 模板“网站模板标识符”(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 应用程序中，并为包含此网站集的内容数据库重新启动升级。

更新级别不一致或不正确

必须运行 Office SharePoint Server 2007 Service Pack 2 才能运行升级。如果不满足这一最低要求，则会显示错误并且升级将不运行。

此外，还必须正确更新服务器。例如，如果您应用了更新的 Windows SharePoint Services 3.0 版本，但未应用更新的 Office SharePoint Server 2007 版本，则升级将不运行。Windows SharePoint Services 3.0 的版本号显示在 SharePoint 管理中心的“服务器场中的服务器”页上。Office SharePoint Server 2007 的版本号是 %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\12\ISAPI 文件夹中的文件 Microsoft.SharePoint.portal.dll 的版本号。“服务器场中的服务器”页上的版本号和 Microsoft.SharePoint.portal.dll 文件的版本号必须匹配，并且必须为 12.0.6420.1000 或更高才能进行升级。有关详细信息，请参阅部署 Office SharePoint Server 2007 的软件更新。

博客缺少全局导航

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

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

数据问题

以下数据问题会导致升级期间出现错误或警告：

  • 与数据源的连接。如果服务器无法连接数据库，则不能对其进行升级。

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

  • 隐藏的列数据。如果升级过程向列表中添加列，而该列表中已经存在同名的自定义列，则会重命名该自定义列。升级后，可能必须要重新调整视图，才能包括重命名的列。

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

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

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

请修复任何孤立的项目或数据库损坏，然后再运行升级。

UI 更改

更改用户界面 (UI)（如添加 Fluent UI（也称为功能区）或遵循 XHTML 标准）可能导致网站中出现问题。有时，自定义元素（如内容类型）的名称可能与新版本中的名称冲突。您可能还有一些页面必须恢复为标准网站定义或要为其创建新视图的大型列表。

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

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

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

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

缺少空间

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

基于表单的身份验证

如果要升级的环境使用基于表单的身份验证，则需执行附加步骤。请按照为基于声明的 Web 应用程序配置基于表单的身份验证 (SharePoint Server 2010) 中的步骤操作，以升级基于表单的身份验证提供程序。

安全性和权限

如果收到有关未知帐户的错误，或者数据库未升级，请验证以下内容：

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

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

升级后 .Stp 文件不起作用

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

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

  1. 在 Office SharePoint Server 2007 中，创建基于模板的网站，然后将该网站升级到 SharePoint Server 2010。

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

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

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

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

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

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

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

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

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

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

是

否

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

是*

是*

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

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

升级 SharePoint Portal Server 2003 中的数据：升级前检查程序将报告损坏的数据库

Office SharePoint Server 2007 场中的内容数据库从 Microsoft Office SharePoint Portal Server 2003 内容数据库升级后，您在运行升级前检查程序时可能会看到以下错误：

失败：内容数据库的数据库架构已修改

如果您没有手动更改数据库的任何架构，可以忽略该错误，继续进行升级。这是从 SharePoint Portal Server 2003 升级到 Office SharePoint Server 2007 的过程中残留的错误。有关详细信息，请参阅 Microsoft 知识库文章 954772。

See Also

Concepts

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