 | |
| | Install the gateway for IBM Cognos 8 Metrics Manager components, if necessary |
| | |
| | Configure environment and security properties for the gateway |
| | |
| |
You can install the gateway on one or more computers, depending on your environment.
If you are upgrading from ReportNet or an earlier version of IBM Cognos 8, IBM Cognos 8 uses the existing configuration data for the gateway computers. However, if you installed the gateway in a new location, you must configure the gateway.
Ensure that the computer where you installed the active Content Manager is configured and available before you configure gateway computers.
Perform the following steps to install and configure the gateway:
Install the gateway for IBM Cognos 8 Metrics Manager components, if necessary
Configure environment and security properties for the gateway
You can install the gateway on one or more Web server computers.
If you are installing to a directory with other IBM Cognos 8 components, stop the IBM Cognos 8 service.
Set the JAVA_HOME environment variable to point to the installation location of your Java Runtime Environment (JRE).
An example of the installation location of a Java Runtime Environment is /directory/java/java_version/jre.
IBM Cognos 8 requires a JVM, such as IBM Java, to run on Linux.
On HP-UX, set the _M_ARENA_OPTS environment variable as follows:
_M_ARENA_OPTS 1:4
This increases the memory allocation for HP-UX to more closely match that of other UNIX platforms.
On AIX, set the AIXTHREAD_SCOPE environment variable as follows:
AIXTHREAD_SCOPE=S
This sets the contention scope for user threads to system-wide, which supports more efficient scheduling of user threads.
Mount the IBM Cognos product disk using Rock Ridge file extensions or go to the location where the installation files were downloaded.
Important: To mount the IBM Cognos CD on HP-UX, do the following:
Add the pfs_mount directory in your path.
For example,
PATH=/usr/sbin/:$PATH
export PATH
To start the required NFS daemons and run the daemons in the background, type bg pfs_mountd and then type bg pfsd
To mount the drive, type
pfs_mount -t rrip <device><mount_dir> -o xlat=unix
For example,
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
You can now install or copy files as a non-root user using an IBM Cognos CD from this drive.
When the installation is complete, type pfs_umount /cdrom and kill the pfsd and pfs_mountd daemons to unmount the CD.
To start the installation wizard, go to the operating system directory and then type
./issetup
Note: When you use the issetup command with XWindows, Japanese characters in messages and log files may be corrupted. When installing in Japanese on UNIX or Linux, first set environment variables LANG=C and LC_ALL=C (where C is the language code, for example ja_JP.PCK on Solaris), and then start the installation wizard.
If you do not use XWindows, run an unattended
installation 
.
Follow the directions in the installation wizard and copy the required files to your computer.
When selecting the directory, consider the following:
Install Gateway components in a directory that contains only ASCII characters in the path name. Some UNIX and Linux Web servers do not support non-ASCII characters in directory names.
If you are installing IBM Cognos 8 on a computer that has ReportNet or an earlier version of IBM Cognos 8 and you want to keep the earlier version, you must install IBM Cognos 8 in a different directory.
If you are installing in a directory that contains other IBM Cognos 8 components, you are prompted for the location of a directory in which to store backup copies of the files that will be overwritten.
When selecting components, clear all components except Gateway.
Choose how to proceed in the Finish page of the installation wizard:
We recommend that you do not configure IBM Cognos 8 immediately because you must do other tasks first to ensure that your environment is properly set up. However, if the console attached to your computer supports a Java-based graphical user interface, you can click Start IBM Cognos Configuration.
If you want to see late-breaking information about IBM Cognos 8, select View the Readme and then click Finish.
If the console attached to your computer does not support a Java-based graphical user interface, click Finish.
You can later configure IBM Cognos 8 using IBM Cognos Configuration by starting cogconfig.sh in the c8_location/bin directory, or editing cogstartup.xml in c8_location/configuration directory.
Append the c8_location/bin directory to the appropriate library path environment variable.
For Solaris and Linux, LD_LIBRARY_PATH
For AIX, LIBPATH
For HP-UX, SHLIB_PATH
If you want users to see product documentation in a language other than English, you must install the Supplementary Languages Documentation component in the location where you installed the Gateway components. For more information, see Install Translated Product Documentation.
If you are installing to a directory with other IBM Cognos 8 components, stop the IBM Cognos 8 service.
Insert the IBM Cognos product disk or go to the location where the installation files were downloaded and extracted.
The Welcome page of the installation wizard appears.
If no Welcome page appears, go to the operating system directory and double-click the issetup.exe file.
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 to any of the installed languages after installation.
Follow the directions in the installation wizard to copy the required files to your computer.
When selecting the directory, consider the following:
Install Gateway components in a directory that contains only ASCII characters in the path name. Some Windows Web servers do not support non-ASCII characters in directory names.
If you are installing IBM Cognos 8 on a computer that has ReportNet or an earlier version of IBM Cognos 8 and you want to keep the earlier version, you must install IBM Cognos 8 in a different directory.
If you are installing in a directory that contains other IBM Cognos 8 components, you are prompted for the location of a directory in which to store backup copies of the files that will be overwritten.
When selecting components, clear all components except Gateway.
In the Finish page of the installation wizard,
If you want to configure IBM Cognos components immediately, click Start IBM Cognos Configuration.
If you want to see late-breaking information about IBM Cognos components, click View the Readme.
Click Finish.
Use the Windows Start menu to start IBM Cognos Configuration from the shortcut folder.
If you want users to see product documentation in a language other than English, you must install the Supplementary Languages Documentation component in the location where you installed the Gateway components. For more information, see Install Translated Product Documentation.
If you are installing IBM Cognos 8 Metrics Manager with IBM Cognos 8 Business Intelligence, you must install each IBM Cognos 8 Metrics Manager component into the same location as each IBM Cognos 8 Business Intelligence component. Install the IBM Cognos 8 Metrics Manager Gateway component to the same location as you installed the IBM Cognos 8 Business Intelligence Gateway component.
You may also want to install Metric Designer .
Use the configuration tool, IBM Cognos Configuration, to configure IBM Cognos 8 components during the installation and configuration process and to start and stop IBM Cognos services.
Before starting IBM Cognos Configuration, ensure that the operating environment is properly set up. For example, ensure that all environment variables have been set.
On UNIX or Linux, do not start IBM Cognos Configuration in the last page of the installation wizard: additional setup is required before you can configure IBM Cognos 8. For example, you must update your Java environment. On Windows, you can start IBM Cognos Configuration in the last page of the installation wizard only if additional setup is not required. For example, if you use a database server other than Microsoft SQL or Cognos Content Database for the content store, we recommend that you copy the JDBC drivers to the appropriate location before you start the configuration tool.
Ensure that user or service account is set up. For information, see Configure a User Account or Network Service Account for IBM Cognos 8.
Go to the c8_location/bin directory and then type
./cogconfig.sh
If you want to access the help for IBM Cognos Configuration, go to the c8_location/configuration directory and edit the cogconfig.prefs file to add the location of your Web browser.
For example, if you use Firefox, add the following text to the file:
BrowserPath=Web_browser_location/firefox
where Web_browser_location is a path, such as /usr/local/bin/
Your Web browser must support the following syntax:
$ <Web_browser_location> <URL>
From the Start menu, click Programs, IBM Cognos 8, IBM Cognos Configuration.
If you want to access the help for IBM Cognos Configuration, go to the c8_location\configuration directory and edit the cogconfig.prefs file to add the location of your Web browser.
For example, if you use Firefox, add the following text to the file:
BrowserPath=Web_browser_location\firefox
where Web_browser_location is a path, such as \usr\local\bin\
Your Web browser must support the following syntax:
$ <Web_browser_location> <URL>
If you install the gateway component on a different computer than Content Manager or Application Tier Components, you must configure the gateway computer so that it knows the location of a dispatcher. A dispatcher is installed on every Content Manager and Application Tier Components computer. We recommend that the gateway use the dispatcher on an Application Tier Components computer.
For failover protection, you can configure more than one dispatcher for a gateway computer. When multiple dispatchers are configured, requests are normally routed to the first dispatcher in the list. If this dispatcher becomes unavailable, the gateway determines the next functioning dispatcher on the list and routes requests there. The primary dispatcher status is monitored by the gateway, and requests are routed back to this component when it returns to service.
After you do the required configuration tasks, the gateway computer can work in your environment.
Ensure that the computers where you installed Content Manager are configured and the default active Content Manager computer is available before you configure gateway computers.
Start IBM Cognos Configuration.
In the Explorer window, click Environment.
In the Properties window, under Gateway Settings, specify the values for Dispatcher URIs for the gateway:
Click in the value column.
Click the edit button.
Change the localhost portion of the URI to the name or IP address of an Application Tier Components computer.
Tip: If you want to send requests
to the dispatcher from an SDK application or an IBM Cognos 8
modeling tool that is outside of a network firewall, we recommend
that you connect to a dedicated gateway that is configured to connect
to the dispatcher using the internal dispatcher URI for your environment
(for example, http://localhost:9300/p2pd/servlet/dispatch). For
security reasons, the default setting for the Dispatcher URI for
gateway property prevents the dispatcher from accepting requests
for an SDK application or modeling tool that is outside the firewall.
Ensure that you configure appropriate security for this dedicated
gateway, such as SSL . Do not change your main gateway to use the
internal dispatcher URI. Doing so will reduce the security of the
IBM Cognos 8 portal and studios. For more information about
the modeling tool and network firewalls, see Firewall Considerations.
If you want to add another URI, click Add and change the localhost portion of the new URI to the name or IP address of another Application Tier Components computer.
Tip: If you want to use the dispatcher on a standby Content Manager computer, ensure that you add it after you add the Application Tier Components computers. If you add the dispatcher from the active Content Manager computer, ensure that it is last in the list.
After you specify all the URIs, click OK.
In the Explorer window, under Security, Cryptography, click Cognos, the default cryptographic provider.
Under the Certificate Authority settings property group, set the Password property to match what you configured on the default active Content Manager computer.
Ensure that all other cryptographic settings match what you set on the default active Content Manager computer.
Test that the symmetric key can be retrieved. In the Explorer window, right-click Cryptography and click Test.
IBM Cognos 8 components check the common symmetric keys (CSK) availability.
From the File menu, click Save.
For all installations, before you use Web pages generated by IBM Cognos 8, you must configure your Web server. You must create virtual directories, or aliases, so that users can connect to IBM Cognos 8 in the portal. If you plan to run more than one IBM Cognos 8 product, or several instances of the same product, on one computer, you must create a separate application pool for each product or instance and then associate the aliases for that product or instance to the application pool. The steps for creating an application pool vary depending on your operating system.
For IBM Cognos 8 for reporting, you must also set the content expiry for the images directory in your Web server so that the Web browser does not check image status after the first access.
On UNIX and Linux, the account under which the Web server runs must have read access to the cogstartup.xml file in the c8_location/configuration directory. By default the cogstartup.xml file has read permission for others. If you run your Web server under a specific group, you can change the cogstartup.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.
For information on creating a user account or a network
service account for IBM Cognos 8, see .
Create the following virtual directories:
Alias | Location | Permission |
cognos8 | c8_location/webcontent | Read |
cognos8/cgi-bin | c8_location/cgi-bin | Execute |
You can use a name other than cognos8 in the aliases. However, you must use cgi-bin as the second part of the alias and you must change the virtual directory in the Gateway URI property to match the new IBM Cognos alias. For more information, see Change a Port or URI Setting.
If you are upgrading from ReportNet or an earlier version of IBM Cognos 8, you can continue to use the existing aliases. If you install IBM Cognos 8 reporting components in a different location from the earlier version, change the existing aliases to include the new location. If you have more than one version of ReportNet or IBM Cognos 8 on one computer, you must use different alias names for IBM Cognos 8.
For Apache Web Server, ensure that you define the cognos8/cgi-bin alias before the cognos8 alias in the httpd.conf file located in the Apache_installation/conf directory. The cognos8/cgi-bin alias must be defined as a ScriptAlias.
If you want to use Report Studio’s image browser, enable Web Distributed Authoring and Versioning (WebDAV) on your Web server.
If you use Apache Web Server, specify a directory in which to enable WebDAV. For information about configuring WebDAV, see your Web server documentation.
If you use Microsoft Internet Information Services (IIS), enable the Read and Directory Browsing properties for the URL you want to access.
For IBM Cognos 8 for reporting, set the content expiry on the c8_location/pat/images virtual directory in your Web server.
Each time a user opens Report Studio, their Web browser checks with the Web server to determine if images are current. Because there are over 600 images, this can result in excess network traffic. You can postpone this check until a specified date by using the content expiry feature of the Web server.
For information on setting content expiry, see the documentation for your Web server.
Note: When you upgrade, Report Studio users must clear their Web browser cache to get the latest images.
If you use Web aliases other than cognos8,
or your Web server is on another computer, or you are using Microsoft
Internet Application Interface (ISAPI), apache_mod or a servlet
gateway, change the Gateway URI when you configure IBM Cognos components.
From the Start menu, select Control Panel, Performance and Maintenance, Administrative Tools.
Launch Internet Information Services (IIS) Manager.
Web Management Tools and World Wide Web Services are enabled automatically.
From the root (your system name and user), select Features View.
In the IIS section, launch ISAPI and CGI Restrictions.
Select Edit Feature Settings and enable Allow unspecified CGI modules and then click OK.
Add your aliases. For example, c8_location,c8_location/cgi-bin.
Select your cgi-bin alias and ensure that Features View is selected.
Right-click Application Pools and select Add.
In the dialog box, enter a Web alias and the corresponding path to IBM Cognos 8 webcontent.
Repeat steps 8 and 9 to add the next Web alias.
Select Default Web Site.
Open Handler Mappings.
Select CGI-cgi mappings.
In the right pane, click Revert to Inherited.
Expand the application that points to your webcontent location.
Expand your cgi-bin application node.
Add a mapping that points to *.cgi and name it CGI-cgi.
Select the CGI-cgi mapping.
In the right pane, click Revert to Inherited.
Restart the IIS server.
Find the folder that contains cgi-bin (c8_location/cgi-bin) and right-click it.
Select the Security tab.
Add the Network Services user, granting all permissions except Full Control.
Right-click on Cognos8 service and select Properties.
Click the Log On tab.
Click This account and enter Network Service as the user.
Delete the Password and the Confirm the password values.
Click OK.
You can test the installation using a Web browser.
Ensure that your Web server is running.
Open a Web browser.
In your address box, type the URI for the gateway. For example
http://hostname/cognos8
The Welcome page of the IBM Cognos 8 portal appears.
