安装或卸载用于 SharePoint 的 Reporting Services 加载项 (SSRS)

适用范围: SQL Server Reporting Services (2016) 不支持 Power BI 报表服务器 SharePoint

了解如何在 SharePoint 服务器上运行用于 SharePoint 产品的 Microsoft SQL Server Reporting Services 加载项 (rsSharePoint.msi),以在 SharePoint 部署中启用 Reporting Services 功能。 这些功能包括 Power View、报表查看器 Web 部件、URL 代理终结点、Reporting Services 内容类型和应用程序页,使用它们可以创建、查看和管理 SharePoint 站点上的报表、数据源和其他报表服务器内容。 用于 SharePoint 产品的 Reporting Services 加载项是在 SharePoint 模式下运行的报表服务器的必需组件。 可以从 SQL Server 2016 安装向导或通过从 SQL Server 2016 功能包下载 rsSharePoint.msi 来安装此外接程序。 有关外接程序和下载页的版本列表,请参阅 在何处查找用于 SharePoint 产品的 Reporting Services 外接程序

注意

自 SQL Server 2016 之后,不再提供 Reporting Services 与 SharePoint 的集成这一功能。 SQL Server 2017 之后,Power View 支持不再可用。

先决条件

将报表服务器与 SharePoint 产品的实例集成需要若干步骤,安装 Reporting Services 加载项是其中的一步。 若要详细了解如何安装和配置 Reporting Services,请参阅在 SharePoint 模式下安装第一个报表服务器

  • 如果将 Reporting Services 与具有多个 Web 前端应用程序的 SharePoint 场集成,则将该加载项安装到场中每台具有 Web 服务器前端的计算机上。 仅对将要用于访问报表服务器内容的 Web 前端执行此操作。

  • 只有计算机上的管理员才能安装 Reporting Services 加载项。 例如,如果要在命令提示符下运行 rsSharePoint.msi,应使用“以管理员身份运行”选项用管理员权限打开命令提示符。

  • 只有 SharePoint 场管理员组的成员才能安装 Reporting Services 加载项。

  • 只有网站集管理员才能激活 Reporting Services 集成功能。

外接程序安装执行哪些操作?

外接程序安装过程由两个阶段组成,完成标准安装时将自动完成这两个阶段:

  • 第一个阶段是将文件安装到适当的文件夹。 这些文件夹是 SharePoint 部署的标准文件夹。 要安装的文件之一是 rsCustomAction.exe。

  • 安装的第二个阶段是运行一组自定义操作以便向 SharePoint 注册 Reporting Services 文件。 从 rsCustomAction.exe 运行这些自定义操作。 在整个两个安装阶段都完成后,该 exe 将被删除。 可以运行“仅文件”安装,在安装结束时不运行 rsCustomAction.exe,该文件将保留在驱动器上。

Reporting Services 安装顺序

外接程序可在安装 SharePoint 之前安装,也可在安装 SharePoint 之后安装。 此外接程序遵循 SharePoint 预部署标准,将文件安装到 SharePoint 安装所用的位置中。

备注

在安装 SharePoint 产品之前安装外接程序的好处是:当新的服务器添加到场后,SharePoint 场会配置并激活 Reporting Services 外接程序。

安装方法概述

使用以下两种方法之一可以安装用于 SharePoint 产品的 SQL Server 2016 Reporting Services 外接程序:

  • 安装向导:note在 SQL Server 2016 中,此加载项可以通过 SQL Server 安装向导进行安装。 在向导的“功能选择” 页上,选择“用于 SharePoint 产品的 Reporting Services 外接程序” 。

  • rsSharepoint.msi: 加载项可从安装介质直接安装,也可以通过下载安装。 rsSharepoint.msi 同时支持图形用户界面和命令行安装。 您必须以管理员权限来运行 .msi:首先使用提升权限打开命令提示符,然后从命令行运行 rsSharepoint.msi。 有关如何下载外接程序的详细信息,请参阅 在何处查找用于 SharePoint 产品的 Reporting Services 外接程序

    注意

    如果将 /q 开关用于无提示命令行安装,将不显示最终用户许可协议。 对此软件的使用受到许可协议控制并且由你负责遵守该许可协议,而与安装方法无关。

使用安装文件 rsSharePoint.msi 安装外接程序

本节介绍如何通过运行 .msi 安装向导或命令行安装,直接安装 rssharepoint.msi。 如果您使用 SQL Server 安装向导安装了该外接程序,则无需执行这些步骤。

您可以通过运行以下命令,看到命令行开关的完整列表:

Rssharepoint.msi /?  
  1. 下载 Reporting Services 加载项的安装程序 (rsSharepoint.msi)。 有关如何下载外接程序的详细信息,请参阅 在何处查找用于 SharePoint 产品的 Reporting Services 外接程序

  2. 以管理员身份运行 rsSharepoint.msi 以启动安装向导。 向导将显示“欢迎”页、软件许可条款和注册信息页。 安装程序将在以下路径下创建文件夹,并将文件复制到该文件夹中:

    %program files%\common files\Microsoft Shared\Web Server Extensions\15\ (SharePoint 2013)

    %program files%\common files\Microsoft Shared\Web Server Extensions\16\ (SharePoint 2016)

  3. 在 SharePoint 管理中心配置报表服务器设置和功能激活。 有关安装和配置 Reporting Services SharePoint 模式的详细信息,请参阅在 SharePoint 模式下安装第一个报表服务器

“仅文件”安装

若要安装文件但跳过自定义操作安装阶段,可以从命令行中使用 SKIPCA 选项来运行 rssharepoint.msi。

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    Msiexec.exe /i rsSharePoint.msi SKIPCA=1  
    

安装用户界面将打开并正常运行, rsCustomAction.exe 文件将安装。 但是,该 .exe 将不会在安装结束时运行,并且在安装完成后 rsCustomAction.exe 将保留在计算机中。

使用两步骤安装解决安装问题

如果安装期间出现错误,可以从命令行分两个步骤运行安装程序:

  1. 使用管理员权限 打开命令提示符,根据前一节中所述运行仅文件安装。

  2. 运行自定义操作可执行文件:

    1. 导航到包含文件 rsCustomAction.exe的文件夹。 此文件通过外接程序的“仅文件”安装复制到您的计算机。 rsCustomAction.exe 位于 %Temp% 目录中。 要导航到此文件,请从命令提示符键入以下信息:

      CD %temp%

      该文件应位于:\Users\<你的姓名>\AppData\Local\Temp

    2. 键入以下命令。 完成该配置步骤需要几分钟时间。 在此过程中,将重新启动 W3SVC 服务。 在程序复制文件、注册组件和运行 SharePoint 产品配置向导时,将显示若干状态消息。

      rsCustomAction.exe /i  
      
    3. 更改生效所需的时间可能因您的服务器环境而异。 您还可以运行 iisreset 以强制实施更快的更新。

用于脚本撰写的静默安装

可以使用 /q 或 /quiet 开关,进行不显示任何对话框或警告的“静默”安装。 如果您想要编写外接程序安装的脚本,静默安装将很有用。

注意

如果将 /q 开关用于无提示命令行安装,将不显示最终用户许可协议。 对此软件的使用受到许可协议控制并且由你负责遵守该许可协议,而与安装方法无关。

执行静默安装:

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    Msiexec.exe /i rsSharePoint.msi /q  
    

如何删除 Reporting Services 外接程序

可以从 Microsoft Windows 控制面板或命令行卸载用于 SharePoint 产品的 Reporting Services 加载项。

  1. 使用控制面板将在当前计算机上完全卸载文件,并且将从 SharePoint 场中删除 Reporting Services 对象和功能。 删除 Reporting Services 对象和功能后,将不再能查看和更新报表。

  2. 使用命令行方法卸载加载项时,可以使用 LocalOnly 参数仅从本地计算机删除加载项文件,场中的 Reporting Services 对象和功能将保持不变。

卸载外接程序会删除用于在报表服务器上处理报表的服务器集成功能。 它还将从 SharePoint 管理中心删除 Reporting Services 页和其他自定义 Reporting Services 页。 您可能还想删除在受影响的 SharePoint 站点上不再使用的所有报表和其他报表服务器项。 在删除 Reporting Services 加载项后,它们将不运行。

若要卸载 Reporting Services 加载项,必须使 SharePoint 处在安装状态。 如果先卸载 SharePoint,则必须重新安装该产品才能卸载 Reporting Services 加载项。

卸载外接程序的步骤与卸载独立服务器和服务器场的步骤相同。 安装程序将删除在安装过程中添加的程序文件和所有配置设置。

卸载加载项时不会删除以下内容:

  • 为用于访问 SharePoint 配置和内容数据库的报表服务器服务帐户创建的登录名。 必须从用于托管 SharePoint 数据库的 SQL Server 数据库引擎实例中删除报表服务器服务帐户的所有登录名。

  • 为报表用户创建的权限或组。 如果创建了自定义权限级别或 SharePoint 组来授予访问报表服务器功能的权限,则应撤销不再需要的任何权限。

  • 上载到 SharePoint 库的数据文件,包括报表定义 (.rdl)、共享数据源 (.rsds) 和已发布报表项 (.rsc) 文件。 不会删除这些文件,但它们将不再运行。 必须手动删除这些文件。

  • 安装程序将不删除报表服务器数据库,也不修改用于集成操作的报表服务器实例。

从 Windows 控制面板卸载

从 Microsoft Windows 控制面板启动向导并删除加载项:

  1. 在控制面板的 “程序” 中,选择 “卸载程序”

  2. 选择“用于 SharePoint 的 Microsoft SQL Server RS 外接程序” 。 还可以从命令提示符运行不带开关的 rssharepoint.msi 来启动卸载向导。

  3. 单击 “删除”

从命令行卸载

从命令行卸载外接程序:

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    msiexec.exe /uninstall rsSharePoint.msi  
    
  3. 你将看到一个确认消息框。 单击 “是”

仅从本地服务器卸载外接程序

之前卸载加载项的方法会从场中删除 Reporting Services 功能和对象。 如果具有多服务器场且只想从本地计算机卸载外接程序而使 SharePoint 场正常工作,请执行以下步骤:

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    Msiexec.exe /uninstall rsSharePoint.msi LocalOnly=1  
    

这将从 SharePoint 取消注册 Reporting Services 组件并且删除文件,但仅限本地计算机。

如果想要从 SharePoint 取消注册 Reporting Services 功能,但在磁盘上保留这些文件以供以后使用,请完成以下步骤:

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    rsCustomAction.exe /p  
    

上述步骤假定您使用 SkipCA=1 完成了 .msi 安装并且 rscusstomaction.exe 可用。 有关详细信息,请参阅描述仅文件安装的部分。

如何从命令行修复 rssharepoint.msi

若要使用命令行修复或卸载 Reporting Services 加载项,请完成以下步骤:

  1. 使用 管理员权限打开命令提示符。

  2. 运行以下命令:

    msiexec.exe /f rssharepoint.msi  
    

安装日志文件

安装程序在运行期间,会为安装 Reporting Services 加载项的用户将相应信息记录到 %temp% 文件夹下的一个日志文件中。 例如,c:\Users\<username>\AppData\Local\Temp。此文件名为 RS_SP_<number>.log,例如,RS_SP_0.log。 日志中的每个错误都以字符串“SSRSCustomActionError”开头。

注意

AppData 是 Windows 操作系统中隐藏的文件夹。 您可能需要修改您的 Windows 资源管理器的文件夹设置,以便可以看到隐藏的文件和文件夹。

使用 Windows 记事本查看日志文件

  1. 下面的命令将更改命令提示符路径,列出 rs 日志文件,然后使用 Windows 记事本打开这些文件之一:

    cd %temp%  
    
    Dir rs_sp*.log  
    
    notepad rs_sp_3.log  
    

使用 PowerShell 查看日志文件

  1. 从 SharePoint Management Shell 键入以下命令,以便从该文件中返回包含“ssrscustomactionerror”的行的筛选后列表:

    Get-content -path C:\Users\<UserName\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"  
    
  2. 输出将类似于以下内容:

    2011-05-23 12:40:12: SSRSCustomActionError: SharePoint is installed, but not configured.

升级

如果已具备 Reporting Services 外接程序的现有安装,则可以升级到最新版本。 外接程序安装程序将检测现有版本并提示您确认是否更新。 将显示如下的消息:

在您的系统上检测到此产品的较低版本。 是否要升级现有安装?

如果确认更新,则旧版本的外接程序将被删除,然后安装新版本。

请注意,Reporting Services 加载项不能识别实例。 一台计算机上只能有一个外接程序实例。 不能并行运行不同版本和当前版本。

rsCustomAction.exe

下表概述了 rscustomaction.exe 的各个开关:

开关 说明
i 安装自定义操作。 这将在 SharePoint 中注册 Reporting Services 组件。 并且将重新启动 W3SVCservice。
r Repair
u 卸载。 这将从整个 SharePoint 撤消注册 Reporting Services 组件,但在磁盘上保留文件。 并且将重新启动 W3SVCservice。
p 本地卸载。 这将仅从本地计算机撤消注册 Reporting Services 组件。 文件将保留在磁盘上。 并且将重新启动 W3SVCservice。
t 仅限 SQL Server Reporting Services 2005。 此开关测试报表服务器与报表服务器数据库之间是否具有有效的连接。

配置 Reporting Services

在所有所需计算机上都安装了外接程序之后,您需要从 SharePoint 管理中心来配置报表服务器。 所需步骤取决于安装不同技术的顺序。 有关详细信息,请参阅在 SharePoint 模式下安装第一个报表服务器Reporting Services 报表服务器(SharePoint 模式)

另请参阅

在 SharePoint 模式下安装第一个报表服务器
Reporting Services 报表服务器(SharePoint 模式)

更多疑问? 请访问 Reporting Services 论坛