安装或卸载用于 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 外接程序:
安装向导:在 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 /?
下载 Reporting Services 加载项的安装程序 (rsSharepoint.msi)。 有关如何下载外接程序的详细信息,请参阅 在何处查找用于 SharePoint 产品的 Reporting Services 外接程序。
以管理员身份运行 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)在 SharePoint 管理中心配置报表服务器设置和功能激活。 有关安装和配置 Reporting Services SharePoint 模式的详细信息,请参阅在 SharePoint 模式下安装第一个报表服务器。
“仅文件”安装
若要安装文件但跳过自定义操作安装阶段,可以从命令行中使用 SKIPCA 选项来运行 rssharepoint.msi。
使用 管理员权限打开命令提示符。
运行以下命令:
Msiexec.exe /i rsSharePoint.msi SKIPCA=1
安装用户界面将会打开并正常运行,同时也将安装 rsCustomAction.exe 文件。 但此 .exe 将不会在安装结束时运行,并且 rsCustomAction.exe 将在安装完成后保留在计算机中。
使用两步骤安装来排查安装问题
如果安装期间出现错误,可以从命令行分两个步骤运行安装程序:
使用管理员权限 打开命令提示符,根据前一节中所述运行仅文件安装。
运行自定义操作可执行文件:
导航到包含文件 rsCustomAction.exe的文件夹。 外接程序的“仅文件”安装方式会将此文件复制到你的计算机。 rsCustomAction.exe 位于 %Temp% 目录中。 要导航到此文件,请在命令提示符中输入以下示例:
CD %temp% 。
该文件应位于:\Users\<你的姓名>\AppData\Local\Temp
输入以下命令。 完成此配置步骤需要几分钟时间。 在此过程中,W3SVC 服务将会重启。 在程序复制文件、注册组件和运行 SharePoint 产品配置向导时,会显示若干状态消息。
rsCustomAction.exe /i
更改生效所需的时间可能因服务器环境而异。 您还可以运行 iisreset 以强制实施更快的更新。
用于脚本撰写的静默安装
可以使用 /q 或 /quiet 开关进行“无提示”安装,而不显示任何对话框或警告。 如果您想要编写外接程序安装的脚本,静默安装将很有用。
注意
如果将 /q 开关用于无提示命令行安装,将不显示最终用户许可协议。 对此软件的使用受到许可协议控制并且由你负责遵守该许可协议,而与安装方法无关。
执行静默安装:
使用 管理员权限打开命令提示符。
运行以下命令:
Msiexec.exe /i rsSharePoint.msi /q
如何移除 Reporting Services 外接程序
可以从 Microsoft Windows 控制面板或命令行卸载用于 SharePoint 产品的 Reporting Services 加载项。
使用控制面板在当前计算机上完全卸载文件,并从 SharePoint 场中移除 Reporting Services 对象和功能。 移除 Reporting Services 对象和功能后,将不再能查看和更新报表。
使用命令行方法卸载外接程序时,可以使用 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 控制面板启动向导并删除加载项:
在控制面板的 “程序” 中,选择 “卸载程序” 。
选择“用于 SharePoint 的 Microsoft SQL Server RS 外接程序” 。 还可以从命令提示符运行不带开关的 rssharepoint.msi 来启动卸载向导。
选择“删除” 。
从命令行卸载
从命令行卸载外接程序:
使用 管理员权限打开命令提示符。
运行以下命令:
msiexec.exe /uninstall rsSharePoint.msi
你会看到一个确认消息框。 选择是。
仅从本地服务器卸载外接程序
之前卸载外接程序的方法会从场中移除 Reporting Services 功能和对象。 如果具有多服务器场且只想从本地计算机卸载外接程序而使 SharePoint 场正常工作,请执行以下步骤:
使用 管理员权限打开命令提示符。
运行以下命令:
Msiexec.exe /uninstall rsSharePoint.msi LocalOnly=1
这会从 SharePoint 取消注册 Reporting Services 组件并且移除文件,但仅限本地计算机。
如果想要从 SharePoint 取消注册 Reporting Services 功能,但在磁盘上保留这些文件以供以后使用,请完成以下步骤:
使用 管理员权限打开命令提示符。
运行以下命令:
rsCustomAction.exe /p
上述步骤假定您使用 SkipCA=1 完成了 .msi 安装并且 rscusstomaction.exe 可用。 有关详细信息,请参阅描述仅文件安装的部分。
如何从命令行修复 rssharepoint.msi
若要使用命令行修复或卸载 Reporting Services 加载项,请完成以下步骤:
使用 管理员权限打开命令提示符。
运行以下命令:
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 记事本查看日志文件
下面的命令会更改命令提示符路径,列出 rs 日志文件,然后使用 Windows 记事本打开这些文件之一:
cd %temp%
Dir rs_sp*.log
notepad rs_sp_3.log
使用 PowerShell 查看日志文件
从 SharePoint Management Shell 输入以下命令,以便从该文件中返回包含“ssrscustomactionerror”的行的筛选后列表:
Get-content -path C:\Users\<UserName\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"
输出应类似于以下示例:
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 模式)
相关内容
更多疑问? 请访问 Reporting Services 论坛。