Installation of BR Execution Server

Use this page to learn how to install the IFS Business Reporter Execution Server (also called BRES in this document).

Contents

Prerequisites

Please refer the following link >>

Installation Steps

The IFS Business Reporter Execution Server can only be installed using an installation package, i.e. BRExecutionServerSetup.msi.

Some possibilities how to get hold of the msi:

  1. Copy the file BRExecutionServerSetup.msi from the IFS Applications build home,

    e.g. \\<server>folder>Build\Home\win32server\IFS BR Execution Server\Install to a local server folder and run it from there or run it directly from the build home folder

  2. Get the msi file from an db administrator/technician that knows the location of the Build Home and copy it to a local server disk and execute it from there
  3. Find the msi in component BACLI
    1.  ..\bacli\win32server\IFS BR Execution Server\Install
  4. Download it via LCS using Harvest Extractor if a new version of BRES is released via a bug

    Note: In case of bug corrections, the standard way is to include component BACLI in an ordinary general or delivery build, thus making BRES available via the IFS Build Home

The installation package will install:

Figure 1-1: IFS Business Reporter Execution Server Installation

Click Next to continue.

Figure 1-2: IFS Business Reporter Execution Server Installation

Supply a folder where you want IFS Business Reporter Execution Server to be installed.

Default suggested folder is often good enough.

It is necessary to have Administrator privileges to perform the installation.

Click Next to continue

Figure 1-3: IFS Business Reporter Execution Server Installation - Part 1

 

Figure 1-4: IFS Business Reporter Execution Server Installation - Part 2

This step provides some important information regarding credentials for the user running the IFS Business Reporter Execution Server service as well as license limitations. Please note that the VSTO (Microsoft Excel Based) mode of IFS Business Reporter Execution Server (BRES) requires that Excel is installed on the computer/server.

Note: Please observe this note about licenses. The computer/server running BRES must have a valid Excel license if running on VSTO (Microsoft Excel based) mode. Also note that all IFS Applications end users taking advantage of the BRES server, running on a separate, to produce Excel reports need to have a valid Microsoft Excel license.

Click Next to continue

Figure 1-5: IFS Business Reporter Execution Server Installation

This step is used to supply a valid login for the BRES Service. The service login information is mandatory.

Note: It is recommended to use an AD user account and also to add the user to the Administrators group is also recommended to avoid problems. To be able to administrate the BRES server from within IFS EE using an AD user is a must; if a local user is specified remote administration will not be possible.
The Username must always be entered as a fully qualified name, meaning that the domain must be present. If a local user account is used, the Username can be entered as .\<username>  where the dot means the local machine.
It is important to provide service user credentials to make sure that the IFS Business Reporter Execution Server can render and process reports without generating errors. One example is reports that are configured to be saved as a PDF. This means that after rendering the report it must be converted to a PDF report. The user account to be used by the service must have the privilege to perform the PDF conversion else the report execution will fail and the IFS Business Reporter Execution Server will report an error.
For more information please refer to BRES Windows Service User

Note: The Set Service Logon dialog might not appear centered on the wizard. If this dialog does not appear centered and the wizard seems to be stuck, please try to locate the logon dialog, normally popping up in the upper left corner of the screen.

 

Click Next to continue

Figure 1-6: IFS Business Reporter Execution Server Installation

The installation ends by clicking Close on the last of the installation wizard.

At the end of the installation, a shortcut is added to IFS BR Execution Server Console among programs. Dependig on operation system, programs are presented differently. One example is given below with the Execution Server installed on a Windows Server 2012R2:

Figure 1-7: IFS BR Execution Server among Apps on a Windows Server 2012R2

 

Note: It is important to make sure that the Windows Service representing IFS Business Reporter Execution Server has access to the installed IFS Business Reporter client as well as necessary privileges to run the Microsoft XPS Document Writer in order to create PDF files.
The service logon is thus important.
It is always possible to locate the IFS BR Execution Server service in Services or Computer Services in Windows and modify the service logon.
For more information please refer to BRES Windows Service User

Figure 2: Defining the account for the system service representing IFS Business Reporter Execution Server

 

BRES Windows Service User

Some useful information and check points related to the Windows Service running the BRES server will be discussed in this section.