Getting Started Installation Guide: IBM Cognos Business Intelligence
Getting Started Installation Guide: IBM Cognos Business Intelligence
Getting Started Installation Guide: IBM Cognos Business Intelligence
Note Before using this information and the product it supports, read the information in Notices on page 31.
Product Information
This document applies to IBM Cognos Business Intelligence Version 10.2.0 and may also apply to subsequent releases. To check for newer versions of this document, visit the IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp). Licensed Materials - Property of IBM Copyright IBM Corporation 2005, 2012. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 2. Install Cognos BI on one computer . . . . . . . . . . . . . . . . . . . 3
System requirements. . . . . . . . . . . . . . . . . . . . Installing the server components. . . . . . . . . . . . . . . . Installing Framework Manager . . . . . . . . . . . . . . . . Create a content store database . . . . . . . . . . . . . . . . Creating a content store in IBM DB2 . . . . . . . . . . . . . Creating a content store in Microsoft SQL Server . . . . . . . . . Saving your settings and starting the IBM Cognos services . . . . . . . Confirming that Content Manager is running . . . . . . . . . . . Configure your web server . . . . . . . . . . . . . . . . . Using the CGI gateway on Microsoft Internet Information Services version Using the CGI gateway on Apache Server or IBM HTTP Server . . . . Testing your access to the portal . . . . . . . . . . . . . . . Configuring Framework Manager on a 64-bit computer. . . . . . . . . . . . . . . . . . . . . 3 . . . . . . . . . . . . . 4 . . . . . . . . . . . . . 5 . . . . . . . . . . . . . 6 . . . . . . . . . . . . . 6 . . . . . . . . . . . . . 7 . . . . . . . . . . . . . 8 . . . . . . . . . . . . . 8 . . . . . . . . . . . . . 9 7. . . . . . . . . . . . . 9 . . . . . . . . . . . . . 10 . . . . . . . . . . . . . 10 . . . . . . . . . . . . . 11
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
iii
iv
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Chapter 1. Introduction
This document is intended for use with IBM Cognos Business Intelligence. Cognos BI is a Web-based business intelligence solution with integrated reporting, analysis, scorecarding, and event management features. This document provides the information you need to install and configure Cognos BI on a Microsoft Windows operating system using a single-server installation with default settings. This installation is the quickest and easiest way to get started, and suitable for setting up a test or evaluation environment. Additional tasks are provided to extend the single-server installation by adding components to your installation. Further information on distributed installations, however, is provided in the IBM Cognos Business Intelligence Installation and Configuration Guide.
Audience
To use this guide, you should be familiar with: v Some database concepts v Basic Microsoft Windows operating system administration skills v Web server configuration
Finding information
To find IBM Cognos product documentation on the web, including all translated documentation, access one of the IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp). Release Notes are published directly to Information Centers, and include links to the latest technotes and APARs. You can also read PDF versions of the product release notes and installation guides directly from IBM Cognos product disks.
Accessibility Features
Accessibility features help users who have a physical disability, such as restricted mobility or limited vision, to use information technology products. This product has accessibility features. For information on these features, see Keyboard Shortcuts for the Installation Wizard on page 29.
Forward-looking statements
This documentation describes the current functionality of the product. References to items that are not currently available may be included. No implication of any future availability should be inferred. Any such references are not a commitment, promise, or legal obligation to deliver any material, code, or functionality. The development, release, and timing of features or functionality remain at the sole discretion of IBM.
Samples disclaimer
The Great Outdoors Company, GO Sales, any variation of the Great Outdoors name, and Planning Sample depict fictitious business operations with sample data used to develop sample applications for IBM and IBM customers. These fictitious records include sample data for sales transactions, product distribution, finance, and human resources. Any resemblance to actual names, addresses, contact numbers, or transaction values is coincidental. Other sample files may contain fictional data manually or machine generated, factual data compiled from academic or public sources, or data used with permission of the copyright holder, for use as sample data to develop sample applications. Product names referenced may be the trademarks of their respective owners. Unauthorized duplication is prohibited.
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
System requirements
Use the following tables to check the minimum hardware and software requirements to install and run IBM Cognos Business Intelligence components on one computer. Additional resources may be required for distributed or production environments.
Table 1. Hardware requirements Requirement Operating system RAM Specification Microsoft Windows Between 8 and 10 GB. Note: Memory settings depend on many factors, such as the level of activity expected on the server, the complexity of the IBM Cognos applications, the number of users and requests, and acceptable response times. A minimum of 3.5 GB of free space is required to install the software and 4 GB of free space on the drive that contains the temporary directory used by IBM Cognos components. For all databases, the size will increase over time. Ensure that you have sufficient disk space for future requirements. Table 2. Software requirements Requirement Web server
Copyright IBM Corp. 2005, 2012
Disk space
Table 2. Software requirements (continued) Requirement Database Specification Cognos Content Database can be installed and configured as the default content store database in a test or proof-of-concept system. If you do not install the Cognos Content Database component, you can use another database, including IBM DB2, Microsoft SQL Server, Oracle, Sybase, or Informix. This document includes steps for using Cognos Content Database, IBM DB2, and Microsoft SQL Server. For the other databases, see the IBM Cognos Business Intelligence Installation and Configuration Guide. TCP/IP connectivity is required for all database types. Web browser For all web browsers, the following options must be enabled: v Cookies v JavaScript For Microsoft Internet Explorer only, the following options must be enabled: v Run ActiveX controls and plug-ins v Script ActiveX controls marked safe for scripting v Active scripting v Allow META REFRESH
Procedure
1. Insert the IBM Cognos product disk or go to the location where the installation files were downloaded and extracted. To manually start the installation wizard, go to the operating system directory and then double-click the issetup.exe file.
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
2. Select the language to use for the installation. The language that you select determines the language of the user interface. You can change the language of the user interface to any of the installed languages after installation. 3. Accept the defaults on the Component Selection page to install all the required components. If you want to install the Cognos Content Database, expand IBM Cognos Business Intelligence Server, and select Cognos Content Database. If you do not install Cognos Content Database, you can use an IBM DB2 or Microsoft SQL Server database for your content store. Information about using other databases is provided in the IBM Cognos Business Intelligence Installation and Configuration Guide. If you will also be installing the samples, you must have access to another database, such as IBM DB2 or Microsoft SQL Server. You cannot restore the samples to the Cognos Content Database. 4. Click Next and follow the directions in the wizard to complete the installation. 5. When you are prompted about installing non-English product documentation, click OK to continue.
Procedure
1. Insert the disk for your IBM Cognos modeling product, and then open the installation menu. The Welcome page of the installation wizard appears. If the Welcome page does not appear, in the win32 directory on the disk, double-click issetup.exe. 2. Select the language to use, and click Next. 3. On the IBM License Agreement panel, select I Agree, and click Next. 4. On the Installation Location panel, accept the default, and click Next. Important: If you installed the 64-bit version of the IBM Cognos BI server components, do not attempt the install Framework Manager to that same location. If you installed the 32-bit version of the server components, the default location will be the same as the server location. 5. On the Component Selection panel, accept the default, and click Next. 6. On the Shortcut Folder panel, do one of the following: v If you have installed the 32-bit version of the server components, you can accept the default value in the Program Folder box, and click Next.
v If you have installed the 64-bit version of the server components, enter IBM Cognos 10 Framework Manager in the Program Folder box, and click Next. 7. On the Installation Summary panel, click Next and complete the installation.
Procedure
1. Copy the following files from DB2_installation\sqllib\java directory to the c10_location\webapps\p2pd\WEB-INF\lib directory: v The universal driver file, db2jcc.jar v The license file, db2jcc_license_cu.jar If you installed IBM Cognos BI to the default location, copy the files to C:\Program Files\ibm\cognos\c10\webapps\p2pd\WEB-INF\lib directory. From the Start menu, click Programs then click IBM Cognos 10 then click IBM Cognos Configuration. In the Explorer window, under Data Access, Content Manager, click Content Store. In Database server and port number, enter the name of your computer and the port number on which DB2 is running. For example, localhost:50000. 50000 is the default port number used by DB2. If you are using a different port number, ensure you use that value. Click the Value field next to the User ID and password property and then click the edit button when it appears. Type the appropriate values and click OK. In the Properties window, for the Database name property, type the name for your content store database.
2. 3. 4.
5.
6.
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
7. 8.
9. 10.
Important: Do not use a name longer than eight characters and use only letters, numbers, underscores, and hyphens in the name. Right-click Content Store, and click Generate DDL. Click Details to record the location of the generated DDL file. The DDL file named createDB.sql is created. The script is created in the c10_location\configuration\schemas\content\db2 directory. Click File then clickSave to save your settings. Log in as the IBM DB2 user, and, from the IBM DB2 Control Center, open the Command Editor, and the open and run the createDB.sql DDL file to create the database.
11. When the script has completed successfully, you can log back in as your Cognos user or your regular user account.
Procedure
1. Create a database using your Microsoft SQL Server administration tools. a. Ensure that the collation sequence for the database is case insensitive. In a cstom installation, you choose a collation sequence, which includes character sets and sort order, during the Microsoft SQL Server setup. In a typical installation, the installation uses the locale identified by the installation program for the collation. This setting cannot be changed later. b. Ensure that TCP/IP connectivity is used for Microsoft SQL Server. From the Start menu, click Programs then click IBM Cognos 10 then click IBM Cognos Configuration. In the Explorer window, under Data Access, Content Manager, right-click Content Store, and click Delete. This removes the default content store properties, which are defaulted to use an IBM DB2 database. Right-click Content Manager, and click New Resource then click Database. In the Name field, type a name for the resource. Such as Content Store. In the Type box, select the appropriate Microsoft SQL Server database type, and click OK.
2. 3.
4. 5. 6.
If you use Windows authentication for your Microsoft SQL Server database, select Microsoft SQL Server database (Windows authentication). If not, select Microsoft SQL Server database. 7. In Database server and port number, enter the name of your computer and port number on which Microsoft SQL Server is running. For example, localhost:1433. The value 1433 is the default port number used by Microsoft SQL Server. If you are using a different port number, ensure you use that value. 8. Click the Value field next to the User ID and password property and then click the edit button when it appears. Type the appropriate values and click OK. 9. In the Properties window, for the Database name property, type the name for your content store database.
10. Right-click the resource you added for the content store database, and click Test. If the test is successful, Content Manager can create the required tables in the content store when you start the IBM Cognos service for the first time. If the connection properties are not specified correctly, you cannot start the IBM Cognos services.
Procedure
1. If you have not already started IBM Cognos Configuration, from the Start menu, click Programs then click IBM Cognos 10 then click IBM Cognos Configuration. 2. In IBM Cognos Configuration, click File then click Save to save your configuration settings. 3. Click Actions then click Start. It may take a few minutes for the IBM Cognos service to start. You will receive a warning during the Testing the mail server connection process. Click OK and Continue to continue starting the services. A mail server connection is not required. If you have installed the Cognos Content Database component, the Cognos Content Database service will also be started.
Procedure
1. Open a web browser. 2. Type the Content Manager URI value from IBM Cognos Configuration in your Web browser address bar, and press Enter. For example, type http://localhost:9300/p2pd/servlet localhost can be your computer name, or IP address, or localhost. 9300 is the default port number used by IBM Cognos components.
Results
The State value should be Running. This indicates that your IBM Cognos services have started, and that they have connected to the content store. If the State is not Running, ensure that you have entered the correct information to connect to your content store database and that the services have been started in IBM Cognos Configuration.
What to do next
After you verify that Content Manager is running, you can configure your Web server to allow access to the portal from a web browser.
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Procedure
1. Click Start then click Control Panel then click Programs and Features. 2. Click Turn Windows features on or off. 3. If you are using Microsoft Windows 2008 Server, take the following steps: a. Click Server Manager then click Roles then click Web Server (IIS). b. If CGI is set to Not installed, select CGI and click Add Role Service. 4. If you are using Microsoft Windows 7, take the following steps: a. Expand Internet Information Services then click World Wide Web Services then click Application Development Features. b. If CGI is not selected, select CGI. 5. c. Click OK. In the Internet Information Services (IIS) Manager console, under Connections, select your server name. If you are using Microsoft Windows 7, click Start > Control Panel > System and Security then click Administrative Tools to access the IIS Manager console. In the IIS group, double-click ISAPI and CGI Restrictions. Under Actions, click Add. Enter the path to the cognos.cgi file. The file is located in the c10_location\cgi-bin directory. You must enter the full path including the filename. If the path includes spaces, ensure you use quotation marks around the path. For example, enter: C:\Program Files\ibm\cognos\c10\cgi-bin\cognos.cgi Enter a Description, such as Cognos CGI. Select Allow extension path to execute, and click OK.
6. 7. 8.
9. 10.
11. Under Actions, click Edit Feature Settings, select Allow unspecified CGI modules, and click OK. 12. Under Connections, expand Sites, and under your web site, add the virtual directories as shown in the table:
Table 3. Required virtual directories Alias ibmcognos ibmcognos/cgi-bin Location c10_location/webcontent c10_location/cgi-bin
13. Select the cgi-bin virtual directory you created. 14. In the IIS group, double-click Handler Mappings. 15. Under Actions, click Add Module Mapping and take the following steps: a. In Request Path, type cognos.cgi.
Chapter 2. Install Cognos BI on one computer
b. c. d. e.
In Module, select CgiModule. Leave Executable (optional) blank. In Name, enter a name for the entry, such as CognosCGI. Click OK.
Results
Users can access the CGI gateway by entering http://servername/ibmcognos in their Web browsers.
Procedure
1. Go to the Webserver_installation/conf directory. 2. Open the httpd.conf file in an editor. 3. Ensure that both the server name and web server port number values are specified for the ServerName property. 4. Add the following:
ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin" <Directory "c10_location/cgi-bin"> AllowOverride None Options None Order allow,deny Allow from all </Directory> Alias /ibmcognos "c10_location/webcontent" <Directory "c10_location/webcontent"> Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all </Directory>
The <Directory> directive is optional. Tip: Ensure that you define the /ibmcognos/cgi-bin alias before the /ibmcognos alias. 5. Save and close the file. 6. Restart the web server.
Results
Users can access the portal at http://servername:port/ibmcognos.
10
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Procedure
1. Open a web browser. 2. Test the connection to the IBM Cognos BI portal by typing the Gateway URI value from IBM Cognos Configuration. For example, type: http://host_name/ibmcognos If you are on the computer where your Web server is installed, you can enter localhost for the host_name value. When you see the Welcome page of IBM Cognos Connection, your IBM Cognos BI installation is running. 3. Optionally, from the Start menu, click Programs, IBM Cognos 10, Framework Manager. The Welcome page of Framework Manager will appear.
What to do next
After you verify that the product is running, you can deploy the samples.
Procedure
1. From the Start menu, click Programs then click IBM Cognos 10 Framework Manager then click IBM Cognos Configuration. Note: The IBM Cognos 10 Framework Manager value corresponds to what you entered when you installed Framework Manager. 2. From the File menu, click Save.
11
12
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Procedure
1. Insert the IBM Cognos samples disk or go to the location where the installation files were downloaded and extracted. 2. Go to the operating system directory and double-click issetup.exe. The Welcome page of the installation wizard appears. If the IBM Cognos service is running, you will be prompted to stop the service to continue with the samples installation. 3. Select the language to use for the installation wizard. 4. Follow the directions in the installation wizard. Install the samples in the same location as you installed the server components. 5. In the Finish page of the installation wizard, click Finish. After you complete the samples installation, you must restart the IBM Cognos service. 6. From the Start menu, click Programs > IBM Cognos 10 > IBM Cognos Configuration. 7. Click Actions the click Start. It may take a few minutes for the IBM Cognos service to start. You will receive a warning during the Testing the mail server connection process. Click OK and Continue to continue starting the services.
Results
You can now set up the samples. To set up the samples, you must perform several tasks, such as restoring the samples databases and creating data source connections. After setting up the samples, you can use them to learn how to use IBM Cognos software.
13
Procedure
1. Go to the c10_location/webcontent/samples/datasources/db2 directory. 2. Extract the GS_DB.tar.gz file and retain the original directory structure. Important: If you use WinZip to extract the DB2 move file on Microsoft Windows operating system, ensure that the TAR file smart CR/LF conversion option is not selected. The option is located in the Options > Configuration > Miscellaneous tab of Winzip. 3. In a command window, go to the location where you extracted the GS_DB.tar.gz file. 4. Go to the win folder. 5. Run the setupGSDB.bat file. The script displays a summary of your choices before you commit to changes to your environment. If you approve the choices, press Enter and the script makes the changes. The script may take several minutes to complete.
Procedure
1. Open IBM Cognos Administration by connecting to the Cognos BI portal and clicking Administer IBM Cognos Content on the Welcome page. 2. Click the Configuration tab, and click Data Source Connections. . 3. Click the new data source icon 4. In the Name box, type great_outdoors_sales and then click Next. 5. In the connection page, select IBM DB2, clear Configure JDBC connection, and click Next. The connection string page for the selected database appears. 6. In the DB2 database name field, type GS_DB using uppercase letters. If you used another name when you restored the sample database, enter that name. 7. Leave DB2 connect string blank. 8. Under Signons, select both Password and Create a signon that the Everyone group can use, type the user ID and password for the user that you created for the sample database, and then click Finish. Tip: To test whether the parameters are correct, click Test the connection. After testing the connection, click OK to return to the connection page. 9. Click Finish.
14
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
10. Click the new data source icon to create a second connection. 11. In the Name box, type great_outdoors_warehouse and then click Next. 12. In the connection page, select IBM DB2, clear Configure JDBC connection, and click Next. The connection string page for the selected database appears. 13. In DB2 database name, type GS_DB using uppercase letters. If you used another name when you restored the sample database, enter that name. 14. Leave DB2 connect string blank. 15. Under Signons, select both Password and Create a signon that the Everyone group can use, type the user ID and password for the user that you created for the sample database, and then click Finish. Tip: To test whether the parameters are correct, click Test the connection. After testing the connection, click OK to return to the connection page. 16. Click Finish.
Procedure
1. Go to the c10_location/webcontent/samples/datasources/sqlserver directory. 2. Uncompress the GOSALES.zip and GOSALESDW.zip files. 3. Restore the uncompressed files using the Microsoft SQL Server administration tools. Restore the file from a device, and ensure that the restore locations are correct for the .ldf and .mdf database files. Restore the Gosales database as GOSALES and restore Gosalesdw database as GOSALESDW.
Creating data source connections to the samples database in Microsoft SQL Server
You must create two data source connections to the samples database that you restored.
Procedure
1. Open IBM Cognos Administration by connecting to the IBM Cognos BI portal and clicking Administer IBM Cognos Content on the Welcome page. 2. Click the Configuration tab, and click Data Source Connections. . 3. Click the new data source icon 4. In the Name field, type great_outdoors_sales and then click Next. 5. In the connection page, select Microsoft SQL Server (OLE DB), clear Configure JDBC connection, and click Next. The connection string page for the selected database appears.
15
6. In the Server name field, type the name of the computer where Microsoft SQL Serer is installed. 7. In the Database name field, enter GOSALES. 8. Under Signons, select both Password and Create a signon that the Everyone group can use, type the user ID and password for the user that you created for the sample database, and then click Finish. Tip: To test whether the parameters are correct, click Test the connection. After testing the connection, click OK to return to the connection page. 9. Click Finish. to create a second connection. 10. Click the new data source icon 11. In the Name field, type great_outdoors_warehouse and then click Next. 12. In the connection page, select Microsoft SQL Server (OLE DB), clear Configure JDBC connection, and click Next. The connection string page for the selected database appears. 13. In the Server name field, type the name of the computer where Microsoft SQL Serer is installed. 14. In the Database name field, enter GOSALESDW. 15. Under Signons, select both Password and Create a signon that the Everyone group can use, type the user ID and password for the user that you created for the sample database, and then click Finish. Tip: To test whether the parameters are correct, click Test the connection. After testing the connection, click OK to return to the connection page. 16. Click Finish.
Procedure
1. Copy the IBM_Cognos_Samples.zip file from the c10_location/webcontent/ samples/content directory to the c10_location/deployment directory. 2. Open a web browser. 3. Enter the Gateway URI value from IBM Cognos Configuration in the address bar, and press Enter. For example, enter http://host_name/ibmcognos If you are on the computer where your web server is installed, you can enter localhost for the host_name value. 4. On the Welcome page, click Administer IBM Cognos Content. 5. On the Configuration tab, click Content Administration. 6. On the toolbar, click New Import. 7. In the Deployment Archive pane select the archive you want to import. You can import only one deployment at a time. To start, select IBM_Cognos_Samples. 8. Click Next.
16
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
9. If you want, type a unique name and an optional description and screen tip for the deployment archive, select the folder where you want to save it, and then click Next. 10. In the Public Folders Content pane, select the folders that you want to import. 11. If you want, select the options along with your conflict resolution choice for options that you select, and then click Next. 12. In the Specify the general options pane, select whether to include access permissions and references to external namespaces, and who should own the entries after they are imported. 13. Click Next. The summary information appears. 14. Review the summary information and click Next. 15. Select the action that you want: v To run once now or later, click Save and run once. Click Finish, specify the time and date for the run, then click Run. Review the run time and click OK. v To schedule at a recurring time, click Save and schedule. Click Finish, and then select frequency and start and end dates. Click OK. Tip: To temporarily disable the schedule, select the Disable the schedule check box. v To save without scheduling or running, click Save only and click Finish. 16. When the import is submitted, click Finish.
What to do next
You can now use the sample packages to create reports and analyses using the IBM Cognos Business Intelligence studios. You can also run the sample reports that are available on the Public Folders tab under Samples/Models in the portal. For more information about using the product, see the IBM Cognos Getting Started Guide.
17
18
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Examples
If you used the installation tasks described in this document, your IBM Cognos installation should appear as shown in the following diagram.
Adding components to your installation, can result in an installation that appears as shown in the following diagram.
19
20
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Procedure
1. For your existing server installation, open IBM Cognos Configuration. 2. In the Explorer pane, click Environment. 3. Change localhost to the name or IP address where you are running the instance in the following fields: v Gateway URI v Dispatcher URIs for gateway v External dispatcher URI v Internal dispatcher URI v Dispatcher URI for external applications v Content Manager URIs For example, change the External dispatcher URI value from http://localhost:9300/p2pd/servlet to http://Server_1:9300/p2pd/servlet. From figure 1, Server_1 is the server name of your existing instance. 4. Click the field for Dispatcher URIs for gateway, and click the edit button. The Value - Dispatcher URI for gateway window appears. a. In the Current values list, change localhost to the name or IP address where you are running the instance.
21
For example, change the value from http://localhost:9300/p2pd/servlet to http://Server_1:9300/p2pd/servlet. Server_1 is the server name of your existing instance. b. Click OK. 5. Click the field for Content Manager URIs, and click the edit button. The Value - Content Manager URIs window appears. a. In the Current values list, change localhost to the name or IP address where you are running the instance. For example, change the value from http://localhost:9300/p2pd/servlet to http://Server_1:9300/p2pd/servlet. Server_1 is the server name of your existing instance. b. Click OK. 6. Click File then click Save. 7. Click Action then click Restart to restart the services.
Procedure
1. Insert the IBM Cognos product disk or go to the location where the installation files were downloaded and extracted. To manually start the installation wizard, go to the operating system directory and then double-click the issetup.exe file. 2. Select the language to use for the installation. The language that you select determines the language of the user interface. You can change the language of the user interface to any of the installed languages after installation. 3. On the Component Selection page, expand IBM Cognos Business Intelligence Server to display the components. 4. Click Gateway and Content Manager so that they indicate Not selected. Ensure only Application Tier Components is indicated as Selected. 5. Click Next and follow the directions in the wizard to complete the installation. 6. When you are prompted about installing non-English product documentation, click OK to continue.
Procedure
1. For your Application Tier Components installation, open IBM Cognos Configuration.
22
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
2. In the Explorer panel, click Environment. 3. Change localhost to the name or IP address where you are running the Application Tier Components instance in the following fields: v External dispatcher URI v Internal dispatcher URI v Dispatcher URI for external applications For example, change the External dispatcher URI value from http://localhost:9300/p2pd/servlet to http://Server_2:9300/p2pd/servlet. From figure 2, Server_2 is the Application Tier Components instance you are adding. 4. Change the Gateway URI value from http://localhost:80/ibmcognos/cgibin/cognos.cgi to http://Server_1:80/ibmcognos/cgi-bin/cognos.cgi. Where Server_1 is the name or IP address for your existing IBM Cognos instance. From figure 1, Server_1 is your existing IBM Cognos instance. 5. Click the field for Content Manager URIs, and click the edit button. The Value - Content Manager URIs dialog box appears. a. In the Current values list, change localhost to the name or IP address where you are running the instance. For example, change the value from http://localhost:9300/p2pd/servlet to http://Server_1:9300/p2pd/servlet. Server_1 is your existing IBM Cognos instance. b. Click OK. 6. Click File then click Save. 7. Click Action then click Start. You will receive a warning during the Testing the mail server connection process. Click OK and Continue to continue starting the services. A mail server connection is not required. Starting the service will register the Application Tier Components instance in the content store database, and allow it to be used to process user requests.
Procedure
1. Open a web browser. 2. Enter the Gateway URI value from IBM Cognos Configuration in the address bar, and press Enter. For example, enter http://Server_1/ibmcognos 3. On the Welcome page, click Administer IBM Cognos Content. 4. On the Configuration tab, click Dispatchers and Services. The displayed list includes a URL for both your original IBM Cognos instance and your Application Tier Components instance. The URLs appear as http://servername:port_number/p2pd.
23
Procedure
1. Insert the IBM Cognos product disk or go to the location where the installation files were downloaded and extracted. To manually start the installation wizard, go to the operating system directory and then double-click the issetup.exe file. 2. Select the language to use for the installation. The language that you select determines the language of the user interface. You can change the language of the user interface to any of the installed languages after installation.
24
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
3. On the Component Selection page, expand IBM Cognos Business Intelligence Server to display the components. 4. Click Application Tier Components and Content Manager so that they indicate Not selected. Ensure only Gateway is indicated as Selected. 5. Click Next and follow the directions in the wizard to complete the installation. 6. When you are prompted about installing non-English product documentation, click OK to continue.
Procedure
1. For your gateway installation, open IBM Cognos Configuration. 2. In the Explorer pane, click Environment. 3. Click the field for Dispatcher URIs for gateway, and click the edit button. The Value - Dispatcher URIs for gateway window appears. a. In the Current values list, change localhost to the name or IP address of the instance where you installed all of the IBM Cognos components. For example, change the value from http://localhost:9300/p2pd/servlet to http://Server_1:9300/p2pd/servlet. In the diagrams, Server_1 is the instance where all of your IBM Cognos components are installed. b. If you have added an Application Tier Components instance to your installation, click Add, and change the value from http://localhost:9300/ p2pd/servlet to http://Server_2:9300/p2pd/servlet The first value in the list represents the default dispatcher. If that dispatcher becomes unavailable, the second dispatcher will become the default dispatcher. From figure 3, Server_2 is your existing IBMCognos instance. c. Click OK. 4. Click File then click Save.
Procedure
1. Click Start then click Control Panel then click Programs and Features. 2. Click Turn Windows features on or off. 3. If you are using Microsoft Windows 2008 Server, take the following steps: a. Click Server Manager then click Roles then click Web Server (IIS).
Chapter 4. Add components to your installation
25
b. If CGI is set to Not installed, select CGI and click Add Role Service. 4. If you are using Microsoft Windows 7, take the following steps: a. Expand Internet Information Services then click World Wide Web Services then click Application Development Features. b. If CGI is not selected, select CGI. c. Click OK. 5. In the Internet Information Services (IIS) Manager console, under Connections, select your server name. If you are using Microsoft Windows 7, click Start > Control Panel > System and Security then click Administrative Tools to access the IIS Manager console. 6. In the IIS group, double-click ISAPI and CGI Restrictions. 7. Under Actions, click Add. 8. Enter the path to the cognos.cgi file. The file is located in the c10_location\cgi-bin directory. You must enter the full path including the filename. If the path includes spaces, ensure you use quotation marks around the path. For example, enter: C:\Program Files\ibm\cognos\c10\cgi-bin\cognos.cgi 9. Enter a Description, such as Cognos CGI. 10. Select Allow extension path to execute, and click OK. 11. Under Actions, click Edit Feature Settings, select Allow unspecified CGI modules, and click OK. 12. Under Connections, expand Sites, and under your web site, add the virtual directories as shown in the table:
Table 4. Required virtual directories Alias ibmcognos ibmcognos/cgi-bin Location c10_location/webcontent c10_location/cgi-bin
13. Select the cgi-bin virtual directory you created. 14. In the IIS group, double-click Handler Mappings. 15. Under Actions, click Add Module Mapping and take the following steps: a. In Request Path, type cognos.cgi. b. In Module, select CgiModule. c. Leave Executable (optional) blank. d. In Name, enter a name for the entry, such as CognosCGI. e. Click OK.
Results
Users can access the CGI gateway by entering http://servername/ibmcognos in their Web browsers.
26
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Procedure
1. Go to the Webserver_installation/conf directory. 2. Open the httpd.conf file in an editor. 3. Ensure that both the server name and web server port number values are specified for the ServerName property. 4. Add the following:
ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin" <Directory "c10_location/cgi-bin"> AllowOverride None Options None Order allow,deny Allow from all </Directory> Alias /ibmcognos "c10_location/webcontent" <Directory "c10_location/webcontent"> Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all </Directory>
The <Directory> directive is optional. Tip: Ensure that you define the /ibmcognos/cgi-bin alias before the /ibmcognos alias. 5. Save and close the file. 6. Restart the web server.
Results
Users can access the portal at http://servername:port/ibmcognos.
Procedure
1. Open a web browser. 2. Test the connection to the IBM Cognos BI portal by typing the Gateway URI value from IBM Cognos Configuration. For example, type http://Server_3/ibmcognos If you are on the computer where your web server is installed, you can enter localhost for the host_name value. From figure 3, Server_3 is the instance where your additional gateway is installed.
27
28
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
The following table lists the keyboard shortcuts you can use to perform some of the main tasks in the License Agreement page of the installation wizard.
Table 6. List of keyboard shortcuts on the License Agreement page To do this Accept the license agreement Decline the license agreement Quit the installation wizard Press Alt+A Alt+D Alt+x
The following table lists the keyboard shortcuts you can use to perform some of the main tasks in IBM Cognos Configuration on a Windows operating system.
Table 7. List of keyboard shortcuts for IBM Cognos Configuration on a Windows operating system To do this Save the current configuration Press Crtl+S
29
Table 7. List of keyboard shortcuts for IBM Cognos Configuration on a Windows operating system (continued) To do this Close IBM Cognos Configuration Rename the selected item Display the File menu Display the Edit menu Display the View menu Display the Actions menu Display the Help menu Press Alt+F4 F2 Alt+F Alt+E Alt+V Alt+A Alt+H
30
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Notices
This information was developed for products and services offered worldwide. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. This document may describe products, services, or features that are not included in the Program or license entitlement that you have purchased. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
Copyright IBM Corp. 2005, 2012
31
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Software Group Attention: Licensing 3755 Riverside Dr Ottawa, ON K1V 1B7 Canada Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear.
32
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Trademarks
IBM, the IBM logo, ibm.com, and Cognos are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. The following terms are trademarks or registered trademarks of other companies: v Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. v Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Notices
33
34
IBM Cognos Business Intelligence Version 10.2.0: Getting Started Installation Guide
Index Numerics
64-bit computer configuring Framework Manager 11 installation testing 11 installing Framework Manager 5 Great Outdoors samples
13
A
accessibility features 29 aliases configuring on web servers Apache web servers configuring aliases 9, 25 9, 25
K
keyboard shortcuts 29
M
models modifying for samples 16
C
CGI gateway Apache server 10, 27 IBM HTTP Server 10, 27 configuration testing 11 configuring Framework Manager on a 64-bit computer web server 9, 25 connections data source 14, 15
S
11 samples data source connections 14, 15 importing 16 installing 13 security settings for Web browsers 3 shortcut keys 29 starting the IBM Cognos service from IBM Cognos Configuration 8 system requirements 3
D
data sources samples connections 14, 15
T F
Framework Manager configuring on 64-bit computer installing 5 11 testing server components configuration 11 server components installation 11 testing Content Manager 8
G
Great Outdoors samples installing 13
V
virtual directories IBM Cognos BI 9, 25
I
IBM Cognos BI system requirements 3 IBM Cognos service starting from IBM Cognos Configuration importing samples 16 8
W
web aliases IBM Cognos BI 9, 25 Web browsers security settings 3 web servers configuring 9, 25
35