To use IBM Cognos product documentation, you must enable JavaScript in your browser.

IBM Cognos Cubes

The IBM Cognos cubes that can be used as data sources in IBM Cognos 8 include

If you have problems creating data source connections to Cognos cubes, see the Troubleshooting section in this document.

For information about integrating IBM Cognos Finance multidimensional cubes in your IBM Cognos 8 environment, see the IBM Cognos Finance User Guide. For information about connecting to the IBM Cognos Planning - Contributor unpublished (real-time) data, see the IBM Cognos Planning Installation Guide.

IBM Cognos Finance

IBM Cognos 8 supports IBM Cognos Finance as a data source.

You can make an IBM Cognos PowerCube data source connection available by creating a connection to live Cognos Finance data.

When you create a package, select a specific IBM Cognos Finance submission. This does not limit reporting to that single submission. IBM Cognos Finance submissions can have different hierarchies within each submission. Selecting a submission designates the reporting view of the hierarchy and does not affect how data is calculated within IBM Cognos Finance.

IBM Cognos Finance Parameters

You specify connection parameters when you create a data source or modify a data source connection .

Parameter

Description

Server name

Enter the name of the IBM Cognos Finance server.

Port number

Enter the port number of the IBM Cognos Finance server. Use the port number that is specified on the IBM Cognos Finance Server Configuration page. The default is 8800.

Signon

Select the namespace to use for authentication.

IBM Cognos Now! Cube

IBM Cognos 8 supports IBM Cognos Now! cubes as data sources. Both IBM Cognos Now! cubes and view objects are supported. For cubes, use the parameters listed below. For views, you can download an ODBC driver from the Cognos Now! appliance under References and Downloads. Follow the instructions that come with the ODBC driver to set up your IBM Cognos 8 environment.

IBM Cognos Now! Cube Parameters

You specify connection parameters when you create a data source or modify a data source connection .

Parameter

Description

Server name

Enter the name of the server.

Port number

Enter 80 as the port number.

IBM Cognos Now! connection string:

Enter /cognos/now/RelXMLAProvider.jsp

IBM Cognos Planning - Contributor

IBM Cognos 8 supports IBM Cognos Planning - Contributor as a data source. You can use IBM Cognos 8 to report on and analyze real-time Contributor data. You can create an IBM Cognos 8 Contributor package in one of the following ways:

IBM Cognos Planning - Contributor Parameters

You specify connection parameters when you create a data source or modify a data source connection .

Parameter

Description

External namespace

Select the external namespace.

IBM Cognos Planning - Series 7

IBM Cognos 8 supports IBM Cognos Planning - Series 7 as a data source.

IBM Cognos Planning - Series 7 Parameters

You specify connection parameters when you create a data source or modify a data source connection .

Parameter

Description

Server name

Enter the name of the server.

Planning Administration Domain (PAD ID)

If the cube was created using IBM Cognos Planning - Contributor version 7.3, indicate the Planning Administration Domain (PAD ID).

Port number

Enter the port number. The default is 8800.

External namespace

Select the external namespace for authentication.

IBM Cognos PowerCubes

IBM Cognos 8 supports PowerCubes generated by Transformer 7.3 and later versions.

You make a PowerCube available to end users by creating a package and publishing it from Transformer 8.x, Framework Manager, or IBM Cognos Administration. You create a data source connection to a PowerCube in Transformer or in Framework Manager while publishing the cube, or in IBM Cognos Administration after the cube is published.

PowerCubes can be created in Linux and HPUX Itanium environments using Transformer 8.3. You can use IBM Cognos 8 security with these types of cubes, but not Series 7 security. However, you can deploy secured Series 7 PowerCubes to Linux and HPUX Itanium computers running as report servers in the IBM Cognos 8 environment if the Cognos 8 content store is running on a Series 7 -compliant server.

You cannot build cubes on Linux or HPUX Itanium if you are using Impromptu Query Definition (.iqd) files as data sources because the Series 7 IQD Bridge is not supported on those platforms.

After a connection to a PowerCube is created, you can:

For more information about PowerCubes, see the Transformer User Guide.

Securing PowerCubes

PowerCubes supported by IBM Cognos 8 can be secured using IBM Cognos 8 security namespaces. Security can be applied to an entire cube or to its custom views. Before accessing a cube secured against an IBM Cognos 8 namespace, you must log on to the applicable namespace.

In production environments, IBM Cognos 8 supports only PowerCubes secured against a single namespace. Therefore, when you deploy PowerCubes for use in a production environment, you must select the signon option Restrict PowerCube authentication to a single namespace.

Note: Instead of using IBM Cognos 8 security, you can add password protection to a PowerCube or decide not to use security.

Recommendation - Using PowerCubes in IBM Cognos 8

The following are some recommendations for using PowerCubes in IBM Cognos 8:

PowerCube Connection Parameters

You specify connection parameters when you create a data source or modify a data source connection .

Parameter

Description

Read cache size

The default value for this parameter is 80 MB. You can set this parameter to a value between 1 MB and 1 GB, as required for optimal query performance.

The optimal read cache size may be higher or lower than the default value of 80 MB. This is to be expected, as PowerCubes in production vary widely in type and query characteristics.

Note that the read cache size has no effect on the initial time required to open a cube.

The typical profile for query performance, or processing time, follows a pattern whereby performance increases with the read cache size and then levels off beyond the optimal setting.

To determine the optimal setting, we recommend that you lower the default by 10 MB (or 5 MB, or 1 MB, depending on the level of fine tuning desired) and use the resulting query performance results as a guide for establishing whether further reductions, or increases, are required.

The optimal read cache size will change as the cube grows and changes in the production environment. As a result, you should review the optimal read cache size when changes to the user’s query performance pattern, or changes in the PowerCube characteristics, occur.

Location

If all your report servers are installed on Windows computers, specify the Windows location. If all report servers are installed on UNIX computers, specify the Unix or Linux location.

Type the full path and file name for the cube. For example, for a local cube type C:\cubes\Great Outdoors Company.mdc. For a network cube type \\servername\cubes\Great Outdoors Company.mdc

For cubes that reside on UNIX computers, specify the correct UNIX location and type any characters in the Windows location because the Windows location cannot be empty.

If the report servers are installed on Windows and UNIX computers, and you want the report server running a request to access the PowerCube in both environments, specify the Windows and UNIX locations. To ensure that the same data is returned regardless of the environment in which the report server accesses the cube, the same cube file must be saved in both locations.

Signon

If you are using IBM Cognos 8 security, click Restrict PowerCube authentication to a single namespace, and select a namespace from the list.

If you are connecting to a password-protected PowerCube, click Cube password, and type the password in the Password and Confirm password boxes.

Select All applicable namespaces (including unsecured PowerCubes) only if you are migrating Series 7 PowerCubes to IBM Cognos 8 in your development or test environment. This setting can also be used for unsecured PowerCubes in a production environment.

For more information, see Securing PowerCubes.

If a cube password is required, click Cube password, then enter the password in the Password and Confirm password boxes. To create a user ID and password that automatically connects to the data source, click Create a a signon that the Everyone group can use.

For more information, see Securing Data Sources.

Create a Package for a PowerCube

Before you can use a PowerCube data source in any of the IBM Cognos 8 studios, you must create a package. When you create a PowerCube data source in IBM Cognos Administration , you are given the option to create a package using your new data source.

Note: You can also create a package while publishing PowerCubes from Transformer 8.x. For more information, see the Transformer User Guide.

To create a package for an existing PowerCube data source, follow the instructions below. To perform these tasks, you must have execute permissions for the Data Source Connections secured feature Secured Functions and Features.

Steps
  1. In IBM Cognos Connection, in the upper-right corner, click Launch, IBM Cognos Administration.

  2. On the Configuration tab, click Data Source Connections.

  3. Click More beside the data source with which you want to create a package.

  4. Click Create a Package.

    The New Package Wizard appears.

  5. Enter a name for the package, and click Next.

  6. Select the null-suppression options you want to make available to the IBM Cognos 8 studio user.

  7. Click Finish.

Deploy Updated PowerCubes

After you rebuild or update a PowerCube, you can use various methods to deploy the cube to the production environment.

To deploy an updated IBM Cognos 8 Transformer PowerCube, use the Copy and Activate method in IBM Cognos 8 Transformer (this is the recommended method), or copy the PowerCube yourself, and use the pcactivate command line utility.

To deploy an updated Series 7 Transformer PowerCube, you must copy the PowerCube first. Then, use the pcactivate command line utility instead of the PPAdmin utility used in previous releases.

For more information, see the section "Copy and Activate a Newer Version of a Published PowerCube" in the IBM Cognos 8 Transformer User Guide.

We recommend using the new methods to deploy updated PowerCubes instead of the PowerCube Connection (PCConn) and CubeSwap utilities from previous releases of IBM Cognos 8. If you have PowerCube update scripts that use the CubeSwap or PCConn utility, you may continue to use these scripts in this release.

Steps to Run the pcactivate Command
  1. Copy the Transformer PowerCube to the production environment.

    For example, copy the PowerCube to "D:\Cubes\production\production.mdc".

  2. At the command line prompt, type the pcativate command using the following syntax:

    pcactivate cube_name.mdc 
    destination_location destination_location

    You can type more than one destination location.

    For example, type

    Note: If you include a path in the cube_name parameter, the path is removed and ignored.