Dashboards Reporting Services Gateway Installation Guide SAP BusinessObjects 4.1

Transcription

1 Dashboards Reporting Services Gateway Installation Guide SAP BusinessObjects 4.1

2 Copyright 2011 SAP AG. All rights reserved.sap, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company.sybase and Adaptive Server, ianywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase, Inc. Sybase is an SAP company. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.these materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

3 Contents Chapter 1 About this Guide...5 Chapter Planning Installations...7 Getting started...7 Overview of Dashboards Reporting Services Gateway...7 Naming conventions...7 Variables...7 Chapter Performing Installations...9 Installing the Dashboards Reporting Services Gateway...9 To install the Dashboards Reporting Services Gateway...9 Chapter Post Installation...11 Configuring the Dashboards Reporting Services Gateway...11 To configure the Dashboards Reporting Services Gateway...11 To configure the XRS virtual directory for Reporting Services Testing the Dashboards Reporting Services Gateway...12 Uninstalling the Dashboards Reporting Services Gateway...12 Appendix A More Information...15 Index 17 3

4 Contents 4

5 About this Guide About this Guide This guide is intended for business intelligence users who need to use Microsoft Reporting Services reports with Dashboards. For more information about features and capabilities, see the Dashboards and Presentation Design User Guide. 5

6 About this Guide 6

7 Planning Installations Planning Installations 2.1 Getting started Overview of Dashboards Reporting Services Gateway Dashboards is a data visualization tool that allows you to create dynamic, interactive dashboards. These dashboards can access live data, and you can add them to web-based dashboards. You must install the Dashboards Reporting Services Gateway on a Windows web server to be able to connect to Reporting Services (RS) servers. Related Topics Installing the Dashboards Reporting Services Gateway Testing the Dashboards Reporting Services Gateway 2.2 Naming conventions Variables This guide uses the following variables. 7

8 Planning Installations Variable <REPORTDIR> <WWWROOTDIR> Description The directory where Reporting Services files are located on the Dashboards media. D:\Connectivity\Reporting Services\ The web application root directory on your Reporting Services Server. C:\Inetpub\wwwroot\ 8

9 Performing Installations Performing Installations 3.1 Installing the Dashboards Reporting Services Gateway You can install the Dashboards Reporting Services Gateway (XRS) on a Windows web server connected to a Reporting Services (RS) server. You can also install the XRS on an RS server. Note: If you use Reporting Services 2005, you must configure the XRS virtual directory to point to an application pool different from the Report and ReportServer virtual directories. Related Topics To configure the XRS virtual directory for Reporting Services To install the Dashboards Reporting Services Gateway Before you install the Dashboards Reporting Services Gateway (XRS), ensure that Microsoft Reporting Services and the.net Framework are installed, running, and configured to use a data source. 1. Run <REPORTINGDIR>/setup.exe from the Dashboards media. The interactive installation wizard appears. 2. Proceed through the wizard to the "License Agreement" page, review the License Agreement, select I accept the License Agreement, and click Next. 3. Enter the virtual directory name into the "Virtual Directory Name" field. 4. (Optional) To test system operation with other ports, enter a new port number into the "Port Number" field. Note: Ensure that your IIS server configuration includes the same port. 5. Click Next. The installation begins. 6. When the installation is complete, click Finish. You can now configure the XRS. 9

10 Performing Installations Related Topics Variables 10

11 Post Installation Post Installation 4.1 Configuring the Dashboards Reporting Services Gateway To configure the Dashboards Reporting Services Gateway After you install the Dashboards Reporting Services Gateway (XRS), you can configure it. 1. On your Reporting Services Server, copy <WWWROOTDIR>\wss\<virtualdirecto ry>\80\web.config to web.config.bak 2. Open web.config in a text editor. 3. Change localhost to new values for the following parameters: Parameter ReportingServicesUrl ReportServerUrl XrsServicesUrl New value The name of the server on which Reporting Services is installed. The name of the server on which XRS is installed. 4. Ensure that the authentication methods for the Report, ReportServer, and XRS virtual directories match on the "Directory Security" tab of your IIS settings. 5. Save and close web.config Related Topics Variables To configure the XRS virtual directory for Reporting Services

12 Post Installation After you install the Dashboards Reporting Services Gateway (XRS), you can configure the XRS virtual directory. Note: You must configure the XRS virtual directory to point to an application pool different from the Report and ReportServer virtual directories. 1. In the Report directory, on the Virtual Directory tab, click the application pool list and note its value. 2. Open the SRS virtual directory properties, and change the application pool to a value different from the value used for the Report virtual directory. 4.2 Testing the Dashboards Reporting Services Gateway To test the Dashboards Reporting Services Gateway, use a web browser to navigate to the following URL on your Reporting Services Server, and log in using the information in the web.config file. Note: If you run the test on a local machine, you may not be asked to log in. If the test succeeds, XML-formatted output containing <param> and <report> tags appears. The output may also contain additional messages: Message License Key Failed - LogonUser failed with error code: 87 License Key Failed - Could not find file "C:\inetpub\wwwroot\xrs.xky". The permissions granted to user '<username>' are insufficient for performing this operation. Solution Add the Administrator credential information to the web.config file on the server. Ensure that a valid license key exists in the correct location. <username> does not have sufficient permissions to view reports in Reporting Services. 4.3 Uninstalling the Dashboards Reporting Services Gateway You can use Add/Remove Programs or Programs and Features in "Control Panel" to repair, modify, or remove your installation of the Dashboards Reporting Services Gateway. 12

13 Post Installation Note: If you have configured any virtual directories, copy <WWWROOTDIR>\wss\<virtualdirecto ry>\80\web.config.bak to web.config for every virtual directory. Related Topics Variables 13

14 Post Installation 14

15 More Information More Information Information Resource SAP BusinessObjects product information Location Navigate to and on the "SAP BusinessObjects Overview" side panel click All Products. SAP Help Portal You can access the most up-to-date documentation covering all SAP BusinessObjects products and their deployment at the SAP Help Portal. You can download PDF versions or installable HTML libraries. Certain guides are stored on the SAP Service Marketplace and are not available from the SAP Help Portal. These guides are listed on the Help Portal accompanied by a link to the SAP Service Marketplace. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. SAP Service Marketplace > Documentation Installation guides: Release notes: The SAP Service Marketplace stores certain installation guides, upgrade and migration guides, deployment guides, release notes and Supported Platforms documents. Customers with a maintenance agreement have an authorized user ID to access this site. Contact your customer support representative to obtain an ID. If you are redirected to the SAP Service Marketplace from the SAP Help Portal, use the menu in the navigation pane on the left to locate the category containing the documentation you want to access. Docupedia Docupedia provides additional documentation resources, a collaborative authoring environment, and an interactive feedback channel. Developer resources

16 More Information Information Resource SAP BusinessObjects articles on the SAP Community Network Location These articles were formerly known as technical papers. Notes Forums on the SAP Community Network These notes were formerly known as Knowledge Base articles. Training From traditional classroom learning to targeted e-learning seminars, we can offer a training package to suit your learning needs and preferred learning style. Online customer support The SAP Support Portal contains information about Customer Support programs and services. It also has links to a wide range of technical information and downloads. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. Consulting Consultants can accompany you from the initial analysis stage to the delivery of your deployment project. Expertise is available in topics such as relational and multidimensional databases, connectivity, database design tools, and customized embedding technology. 16

17 Index I installation 7, 9 P post-installation configuring 11 testing 12 uninstallation 12 XRS virtual directories, configuring 12 R Reporting Services files, location 7 T testing 12 U uninstallation 12 V variables Reporting Services files, location 7 web application, root directory 7 W web application, root directory 7 X XRS virtual directories, configuring 12 17

18 Index 18