rsactivate Utility

rsactivate Utility

Reporting Services - Tools and Utilities Reference

rsactivate Utility

The rsactivate utility activates the Report Server Windows service and Report Server Web service on a report server instance. You activate service when you add a new report server instance to a Web farm or replace a report server that has failed due to hardware problems. The process of activating a service creates a symmetric key that the report server uses to encrypt and decrypt data in a report server database.

Some of the Rsactivate arguments cannot be used together. The following table describes the arguments that must be specified separately:

Argument	Description
-m computername	Use this argument to active a remote report server instance. When specifying this argument, you must also specify the -u username and -p password arguments to log on to the remote computer as a local administrator.
-c configurationfile	Use this argument to activate a local report server instance
-r reactivate	Use this argument to reactivate a local report server instance

To run the tool, you must be a local administrator on the computer that has the report server instance you are activating. For more information about the tool, see Activating a Report Server Instance.

File Location

The command line utilities are installed when you choose Administration Tools during Setup. You can run them from any directory on your file system. Rsactivate.exe is located at <drive>:\Program Files\Microsoft SQL Server\80\Tools\Binn.

Syntax

rsactivate {-?}
[–m computername]
[-c configurationfile]
{-r reactivate}
{-u username}
{-p password}
{-t trace}

Arguments

Displays the syntax of rsactivate arguments.

-m computername

Used to activate a remote report server instance. This argument specifies the name of the remote computer on which the report server is to be activated. The following example illustrates the syntax for this argument:

rsconfig -m \\<remoteservername> -u<admin user account> -p<admin user password>

-c configurationfile

Used to activate a local report server instance. This argument is used in place of computername. The value must be a fully qualified path to the RSReportServer configuration file. The following example illustrates the syntax for this argument:

rsconfig -c"C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\RSReportServer.config"

Important Note that the path must be enclosed in double-quotation marks.

-r

Reactivates the Report Server Web service on the local computer. This argument does not take a value. The following example illustrates the syntax for this argument:

rsconfig -r

-u [domain\]username

Specifies the user name of the local administrator. Specify this value when you use the -m argument.

-p password

(Required if username is specified.). Specifies the password to use with the username argument. This value is case-sensitive.

-t

(Optional.) Adds trace information to any error messages that may occur. This argument does not take a value.

File Location

Syntax

Arguments

See Also