This article introduces the best practices for changing the service account for the report server in Microsoft SQL Server Reporting Services and Power BI Report Server.
Original product version: SQL Server
Original KB number: 958999
Introduction
In Microsoft SQL Server Reporting Services, you can configure the report server to use the Service Credentials type for the database connection. When you try to change the service account by using the Services.msc management console, the operation may corrupt the encryption key that is used to protect sensitive information that is stored in the report server database. We recommend that you change the service account for the report server by using one of the following methods
Method 1
Use Reporting Services Configuration Manager to change the service account for the report server. To do this follow these steps:
- Open Reporting Services Configuration Manager, and then connect to the instance of SQL Server Reporting Services.
- Click Microsoft service Identity on the left pane.
- Change the account and the password in the Account text box and the Password text box, and then click Apply.
Method 2
Use the Rsconfig.exe utility to change the service account for the report server. To do this, run the following command:
Rsconfig -c -s <Server Name> -d <Database Name> -u <User Name> -p <Password> -a <Authentication Method>
Note: If the instance of SQL Server that hosts the report server database is a named instance, add the -i switch to specify the instance name.
Method 3
If method 1 and method 2 do not work, use the rskeymgmt utility. When you use this utility, you must back up the encrypted keys before you change the user account that is used to run the Report Server Microsoft service or the Report Server Web service, and then you must apply the keys that were backed up. To do this, follow these steps on the computer that is running the service:
-
Start the Report Server Microsoft service and the Report Server Web service by using the user account that the service was running successfully for.
-
Use the
rskeymgmtcommand-line utility to back up the encryption keys. To do this, run the command at the command prompt:RSKeyMgmt -e -f <FileName> -p <StrongPassword>[!NOTE] By default, the
rskeymgmtcommand-line utility is located in the<InstallationDrive>:\Program Files\Microsoft SQL Server\80\Tools\Binn folder.For more information about the
rskeymgmtcommand-line utility, run the following command at the command prompt:rskeymgmt /? -
Use the
rskeymgmtcommand-line utility to remove the reference to the existing keys. To do this, run the command at the command prompt:rskeymgmt -r <InstallationID>[!NOTE] Replace the
InstallationIDplaceholder by using the installation ID that is provided in the InstallationID setting of the RSReportServer.config file. By default, the RSReportServer.config file is stored in the<InstallationDrive>:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer folder. -
Stop Internet Information Services (IIS).
-
Stop the Report Server Microsoft service.
-
Change the user account that is used to run the Report Server Microsoft service or the Report Server Web service to the user account that you want.
-
Start IIS.
-
Start the Report Server Microsoft service.
-
Use the rskeymgmt command-line utility to apply the encryption keys that were backed up in step 2. To do this, run the following command at the command prompt:
rskeymgmt -a -f <FileName> -p <StrongPassword>[!NOTE] Replace the
<FileName>placeholder and the<StrongPassword>placeholder with the file name and the password that you used to back up the symmetric encryption keys in step 1.
Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
