Datacap Report Viewer setup

To install Report Viewer in a client server environment, you must perform the required set up tasks on the server and the workstation.

On Do This
Server Ensure that a domain/Windows Account Exists for Report Viewer

When Datacap Web or Report Viewer are installed on the same web server, they must use the same domain/Windows account.

Ensure that a domain/Windows account exists for Report Viewer

Web server

Add Report Viewer account to Administrators group

Add domain/Windows account to Administrators group

Server

Stop Datacap Server Service

In the Start menu, click IBM Datacap Services> Datacap Server ManagerStop

Web server Ensure that Microsoft .NET Framework 3.5.1 is Installed

Start > Administrative Tools > Server Manager

In the Server Manager hierarchy pane, select Features

Click Add Features

Select .NET Framework 3.5.1 Feature, click Next

Click Install

Web server Ensure that Required IIS Components are Installed

Start Administrative Tools > Server Manager

Expand Roles, select Web Server (IIS)

In Web Server (IIS) pane:

Under Common HTTP Features, ensure Static Content is installed

Scroll down to Role Services, under Application Development ensure that ASP.NET and ASP modules are installed

Scroll down further to Management Tools, ensure that IIS Management Console is installed

Server Set Report Viewer Sharing Permissions on Datacap Folder

Right-click C:\Datacap folder, select Sharing, select Advanced Sharing

Click Permissions, add Report Viewer account, set to allow Read

Server Set Report Viewer Security on Datacap Folder

Right-click C:\Datacap folder, select Properties

Click Security tab

Add Report Viewer account, set to allow Read & Execute

Web server Install Report Viewer on web server

Install only Report Viewer component

Web server To use ADSI or LDAP authentication with Report Viewer, confirm that EnableLDAP value="true" in the Datacap\RV2\web.config file.
Web server

Import encryption keys

Navigate to the Datacap Server on which you generated keys

Copy the dc_KTF.xml file from Datacap Server to the C:\Datacap\Taskmaster folder on the web server

Web server

Add Application Pool for Report Viewer

Start > Administrative Tools >Internet Information Services Manager

Connections pane > Expand the Server > right-click Application Pools, select Add Application Pool

Set: Name to Report Viewer

Set: .NET Framework version to v 4.0.30319

Set: Managed pipeline mode to Integrated

Select: Start application pool immediately, click OK

Web server Create Report Viewer Web Site

Start > Administrative Tools >Internet Information Services Manager

Connections pane > Expand the Server > expand Sites

Right-click Default Web Site, select Add Application

Set: Alias to Report Viewer

Click Select, select the Report Viewer Application Pool you added (Report Viewer), click OK

Set: Physical path to C:\Datacap\RV2, click OK

Connections pane, select Application Pools

Select Report Viewer application pool, then in Actions pane, click Advanced Settings

Ensure that Microsoft .NET version is set to v4.0, ensure that Enable 32-Bit Applications is set to True

Click Browse next to Process Model Identity, select Custom account, click Set and enter Report Viewer domain/Windows account information (accountname@domainname), click OK

Set Load User Profile to True, click OK

Select the Report Viewer site, double-click Session State

Under Cookie Settings, change Name to Report Viewer, click Apply

Connections pane, select Default Web Site, in Actions pane, under Manage Web Site, click Restart

Ensure that Web Server, Application Pool and Default Web Site are all started

Web server Set Location of Datacap.xml

In the Start menu, click IBM Datacap Services and select Datacap Application Manager.

Click Service tab, change path to reflect the location where the datacap.xml file is located on the Server (\\Server\Datacap\datacap.xml)

Web server Set the database type

Open the \Datacap\RV2 folder.

Back up the reports.xml file and then edit the original file by setting the dbtype parameter:
Microsoft Access
dbtype="0"
SQL Server
dbtype="1"
Oracle
dbtype="2"
DB2
dbtype="3"

Apply for all applicable reports, and then save reports.xml.