Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

RtReports

Support multiple RtReports servers with a single PI Server instance

Support multiple RtReports servers with a single PI Server instance

  • Last UpdatedMar 20, 2026
  • 2 minute read

Use this method to add an RtReports server that has different report templates, generated reports, comments, verifications, and approvals to the same PI Server that is associated with an existing RtReports server.

You must specify a separate path to the Asset Framework configuration database for the second RtReports server to store its data and specify a prefix for the PI Tags that are utilized by RtReports.

The comment and verification collections for the two RtReports servers must also be unique.

  1. Install the second RtReports server.

    By default, the RtReports server setup configures this new RtReports server to point to the same Asset Framework path that the first RtReports server uses, \RtReports.

  2. Change the template path of the new RtReports server in the web.config file to a name that is different from the name on the existing RtReports server. This file is located in %PIHOME%\RtReports.

  3. Change the TemplatePath entry from \RtReports to another path, such as \RtReportsNewPath. This path represents an element in the Configuration database of the AF Server storing your application data.

  4. Change the PI Tag used for Report property storage.

    A tag prefix is required to be specified in the web.config in the ReportPropertyTagPrefix key.

    If the key does not exist, add the following line to the appSettings section of the web.config file for the second RtReports server:

    <add key="ReportPropertyTagPrefix" value=" prefix"></add>

  5. Run SecuritySettings with new location.

  6. Open a command prompt and navigate to %PIHOME%\RtReports\bin.

  7. Run OSISoft.RtReports.SecuritySettings.exe providing the new path and the name of the AF Server|AF in double quotes. Here is an example:

    OSISoft.RtReports.SecuritySettings.exe “\RtReportsNewPath” “AFServerName|AF”

The information below is accurate for RtReports upgrades that have chosen to continue using the Module Database for application data storage. For more information, see RtReports application data storage.

You must specify a separate path to the PI Module Database on the PI Server for the second RtReports server to store its data, and specify a prefix for the PI Tags that are utilized by RtReports.

The comment and verification collections for the two RtReports servers must also be unique.

Related Links