Cognos ReportNetTM Installation and Configuration Guide

Cognos ReportNetTM Installation and Configuration Guide Cognos ReportNetTM Installation and Configuration Guide

sharepoint.cabq.gov
from sharepoint.cabq.gov More from this publisher
20.07.2014 Views

Chapter 4: Configuring ReportNet If you change the value of a property, you must save the configuration and then restart the ReportNet service to apply the new settings to your computer. Before you configure ReportNet, ensure that • all ReportNet server components are installed on one computer • a Web server is installed and running on the same computer as the ReportNet components • you created the database for the content store on an available computer in your network Use the following checklist to guide you through the required configuration tasks: ❑ Configure your Web server. ❑ Set the database connection properties for the content store. ❑ Configure a mail server account. ❑ Configure your Web browser. ❑ Test the installation and configuration. After you complete these configuration tasks, you can change the default behavior of ReportNet (p. 40) to better suit your reporting environment. Configuring Your Web Server For all installations, before you use Web pages generated by ReportNet, you must configure your Web server. You must set up virtual directories, also known as Web aliases, for the directories that contain the HTML and Web files for ReportNet. On UNIX, the account under which the Web server runs must have read access to the crnstartup.xml in the crn_location/configuration directory. By default the crnstartup.xml file has read permission for others. If you run your Web server under a specific group, you can change the crnstartup.xml file permissions to ensure that it belongs to the same group as the Web server. You can then remove the read permission for others. The following virtual directories are required for all Web servers. You can use a name other than crn in the aliases. However, you must use cgi-bin and help as the second part of the alias. Alias Location Permission crn crn_location\webcontent Read crn/cgi-bin crn_location\cgi-bin Execute crn/help crn_location\webcontent\documentation Read Tips • If you use Apache Web server, ensure that you define the crn/cgi-bin alias before the crn and crn/help aliases in the httpd.conf file located in the Apache_installation/conf directory. • If you use Web aliases other than crn, your Web server is on another computer, or you are using Microsoft Internet Application Interface (ISAPI), apache_mod or a servlet gateway, you must change the value of the Gateway URI property in the Environment group in Cognos Configuration. • To use Report Studio’s image browser, you must enable Web Distributed Authoring and Versioning (WebDAV) on your Web server. For information about configuring WebDAV, see your Web server documentation. Note: iPlanet does not support WebDAV. Set the Database Connection Properties for the Content Store For all installations, you must specify the database server information to ensure that ReportNet can connect to the database you use for the content store. Content Manager uses the database logon to access the content store. Ensure that you used one of the supported database servers to create the content store. 34 Cognos ReportNet TM

Chapter 4: Configuring ReportNet Steps for Oracle and DB2 Databases 1. On the computer where you installed Content Manager, start Cognos Configuration. 2. In the Explorer window, under Data Access, Content Manager, right-click Content Store and click Delete. This deletes the default resource. You can configure ReportNet to access only one content store. 3. Right-click Content Manager, and then click New resource, Database. 4. In the Name box, type a name for the resource. 5. In the Type box, select the type of database and click OK. 6. In the Properties window: • If you are use a DB2 database, for the Database name property, type the database alias. • If you use an Oracle database, type the appropriate values for the Database server and port number and Service name properties. 7. Click the Value box next to the User ID and password property and then click the edit button when it appears. 8. Type the appropriate values in the Enter the user ID and password dialog box and then click OK. 9. From the File menu, click Save. The logon credentials are immediately encrypted. Content Manager can now create the required tables in the content store when you start the ReportNet service for the first time. If the connection properties are not specified correctly, the tables are not created and you cannot connect to Cognos Connection, the ReportNet Web portal. Steps for Microsoft SQL Server Databases 1. On the computer where you installed Content Manager, start Cognos Configuration. 2. In the Explorer window, under Data Access, Content Manager, click Content Store. By default, ReportNet uses properties for a Microsoft SQL Server database. 3. If necessary, in the Properties window, change the default value for the Database server and port number. 4. For the Database name property, type the name of the database you previously created in Microsoft SQL Server to use as the content store. 5. Click the Value box next to the User ID and password property and then click the edit button when it appears. 6. In the Enter the user ID and password dialog box, type the appropriate values and then click OK. 7. From the File menu, click Save. The logon credentials are immediately encrypted. Content Manager can now create the required tables in the content store when you start the ReportNet service for the first time. If the connection properties are not specified correctly, the tables are not created and you cannot connect to Cognos Connection, the ReportNet Web portal. Configure a Mail Server Account If you want to send reports by email, you must configure a mail server account. To be able to load balance, you must configure mail server settings on each Content Manager and report server computer. Tip: To be able to open reports that are sent by email, you must change the host name portion of the Gateway URI from localhost to either the IP address of the computer or the computer name. Otherwise the URL in the email will contain localhost and remote users will not be able to open the report. Installation and Configuration Guide 35

Chapter 4: Configuring ReportNet<br />

If you change the value of a property, you must save the configuration <strong>and</strong> then restart the<br />

ReportNet service to apply the new settings to your computer.<br />

Before you configure ReportNet, ensure that<br />

• all ReportNet server components are installed on one computer<br />

• a Web server is installed <strong>and</strong> running on the same computer as the ReportNet components<br />

• you created the database for the content store on an available computer in your network<br />

Use the following checklist to guide you through the required configuration tasks:<br />

❑ Configure your Web server.<br />

❑ Set the database connection properties for the content store.<br />

❑ Configure a mail server account.<br />

❑ Configure your Web browser.<br />

❑ Test the installation <strong>and</strong> configuration.<br />

After you complete these configuration tasks, you can change the default behavior of ReportNet<br />

(p. 40) to better suit your reporting environment.<br />

Configuring Your Web Server<br />

For all installations, before you use Web pages generated by ReportNet, you must configure<br />

your Web server. You must set up virtual directories, also known as Web aliases, for the<br />

directories that contain the HTML <strong>and</strong> Web files for ReportNet.<br />

On UNIX, the account under which the Web server runs must have read access to the<br />

crnstartup.xml in the crn_location/configuration directory. By default the crnstartup.xml file has<br />

read permission for others. If you run your Web server under a specific group, you can change<br />

the crnstartup.xml file permissions to ensure that it belongs to the same group as the Web<br />

server. You can then remove the read permission for others.<br />

The following virtual directories are required for all Web servers. You can use a name other than<br />

crn in the aliases. However, you must use cgi-bin <strong>and</strong> help as the second part of the alias.<br />

Alias Location Permission<br />

crn crn_location\webcontent Read<br />

crn/cgi-bin crn_location\cgi-bin Execute<br />

crn/help crn_location\webcontent\documentation Read<br />

Tips<br />

• If you use Apache Web server, ensure that you define the crn/cgi-bin alias before the crn<br />

<strong>and</strong> crn/help aliases in the httpd.conf file located in the Apache_installation/conf directory.<br />

• If you use Web aliases other than crn, your Web server is on another computer, or you are<br />

using Microsoft Internet Application Interface (ISAPI), apache_mod or a servlet gateway,<br />

you must change the value of the Gateway URI property in the Environment group in<br />

<strong>Cognos</strong> <strong>Configuration</strong>.<br />

• To use Report Studio’s image browser, you must enable Web Distributed Authoring <strong>and</strong><br />

Versioning (WebDAV) on your Web server. For information about configuring WebDAV, see<br />

your Web server documentation.<br />

Note: iPlanet does not support WebDAV.<br />

Set the Database Connection Properties for the Content Store<br />

For all installations, you must specify the database server information to ensure that ReportNet<br />

can connect to the database you use for the content store. Content Manager uses the database<br />

logon to access the content store.<br />

Ensure that you used one of the supported database servers to create the content store.<br />

34 <strong>Cognos</strong> ReportNet TM

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!