Upgrading ALM Cognos Connector: Configuring Jazz user authentication with Cognos

After you have uninstalled the previous version of ALM Cognos Connector and installed the latest version, you can set up authentication with the Jazz™ Team Server.

Setting the Java 7 SDK as the default Java SDK for WebSphere Application Server

Since ALM Cognos Connector works with the Java 7 SDK, you must also set WebSphere Application Server to use the Java 7 SDK.

Procedure

  1. Open a command window and enter one of the following commands from the [WASInstalldir]\profiles\[server]\bin directory:
    • managesdk –enableProfileAll –sdkname 1.7_64 –enableServers
    • managesdk -enableProfile -profileName [yourProfileName] -sdkname 1.7_64 -enableServers 
  2. Verify your changes by running the following command:
    managesdk -listEnabledProfile -profileName [yourProfileName] -verbose
    Manage SDK commands
  3. To verify that your changes in the administrative console, open the administrative console in a browser: https://[server:port]/ibm/console.
  4. Go to Servers > Server Types > WebSphere application servers > server_name > Java SDKs. .
  5. Ensure that the Java 7 SDK is set to true in the Default column.
    Java SDK
  6. Save your changes.

Setting up Jazz authentication libraries in Cognos

Procedure

On your file system, copy the contents of the ALM Cognos Connector lib folder , to the Cognos Business Intelligence and WebSphere Application Server profile folders.
  • Example ALM Cognos Connector lib folder : C:\Program Files\IBM\ALMCognosConnector\setup\rrdi\clm\cognos\webapps\p2pd\WEB-INF\lib
  • Example Cognos folder: C:\Program Files\IBM\cognos\c10_64\webapps\p2pd\WEB-INF\lib
  • Example WebSphere Application Server folder: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\[node_cell]\IBM Cognos.ear\p2pd.war\WEB-INF\lib

Verifying the Jazz namespace in Cognos

Procedure

Open the jazzns_config.xml file located in the [ALM_Cognos_Connector_InstallDir]\setup\rrdi\clm\cognos\configuration folder. This file contains the information about CLM authentication (the consumer key and secret and the URLs for both the CLM server and the Cognos server) that the Cognos Business Intelligence server can use to connect to the CLM server. Verify that the information in this file is correct:
  1. Set the value of the jazz-namespace encrypted property to false.
  2. Ensure that the jazz-server url property is set to the Jazz Team Server URL.
  3. For the oauth-key property, ensure that this value matches the consumer Oauth key from the com.ibm.rational.reporting entry that you entered in the Consumers (Inbound) section of the Jazz Team Server admin page.
  4. For the oauth-secret property, ensure that this value matches the same secret that you chose in step 10 of the Setting up Jazz Team Server to connect to the Cognos Business Intelligence server section.
  5. Make sure that the Jazz Team Server URL includes a fully qualified host name; for example, https://hostname:port/jts.
    Note: Ensure that the URL for the Jazz Team Server uses https and that your port number is a secure port.
  6. Make sure that the Cognos Business Intelligence URL includes a fully qualified host name; for example, http://hostname:port/reporting/servlet/dispatch.
    Note: Ensure that the URL for Cognos Business Intelligence uses http and that your port number is a public port.
  7. Save any changes to the jazzns_config.xml file. Here is an example of the jazzns_config.xml file.
    <?xml version='1.0' encoding='utf-8'?>
    <jazz-namespace encrypted="false"> 
            <jazz-server url="https://jts_server.yourcompany.ibm.com:9443/jts" oauth-key="yourkey" oauth-secret="yoursecret"/> 
            <report-server url="http://reportserver.yourcompany.ibm.com:9080/p2pd/servlet/dispatch"/>
    </jazz-namespace>

Setting up the Jazz authentication provider in Cognos

Procedure

  1. Go to the [CognosInstallDir]\cognos\configuration directory. If this directory exists, check to see if it contains a single AAA.properties file.
  2. Delete this directory.
  3. Ensure you do not delete the [CognosInstallDir]\cognos\c10_64\configuration directory, as that folder is the correct location for the AAA.properties file.
  4. Copy all of the files in the [ALM_Cognos_Connector_InstallDir]\setup\rrdi\clm\cognos\configuration folder to the [CognosInstallDir]\c10_64\configuration, where [CognosInstallDir] might be D:\IBM\cognos.
  5. Check the [CognosInstallDir]\cognos\c10_64\configuration directory to ensure that the AAA.properties file has been copied to the correct location.

Verifying that the report styles are copied to the Cognos Business Intelligence application

About this task

Verify that the icons and report styles have been copied to the Cognos Business Intelligence application so that your custom reports will apply the same styles that they used in Rational® Reporting for Development Intelligence.

Procedure

  1. Go to the WebSphere Application Server profile directory where you have deployed the Cognos Business Intelligence web application, for example [WAS_installdir]\WebSphere\AppServer\profiles\AppSrv02\installedApps\[node_cell]\IBM Cognos.ear\p2pd.war.
  2. Copy the webcontent folder from ALM Cognos Connector:
    1. [ALM_Cognos_Connector_installdir]\ALMCognosConnector\setup\rrdi\cognos\webcontent
  3. Paste the webcontent folder into the WebSphere Application Server profile directory where you have deployed the Cognos Business Intelligence web application, for example [WAS_installdir]\WebSphere\AppServer\profiles\AppSrv02\installedApps\[node_cell]\IBM Cognos.ear\p2pd.war. Overwrite the existing folders and files when prompted.

Updating the COGNOS_DIR environment variable on WebSphere Application Server

Procedure

  1. Open the WebSphere Application Server administrative console and log in.
  2. In the administrative console, click Servers > Server Types > WebSphere application servers > server1
  3. In the Server Infrastructure group, expand Java and Process Management and click Process Definition .
  4. On the Process definition page, in the Additional Properties group, click Environment Entries.
  5. Update the COGNOS_DIR environment variable. This environment variable must have a value of [CognosInstallDir]\c10_64, for example, for example D:\IBM\cognos\c10_64.
    Environment entries page of administrative console
  6. Save your changes to the master configuration.
  7. Stop and restart WebSphere Application Server.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki