Skip to main content link. Accesskey S
  • HCL Logo
  • HCL Connections On-Premise Wiki
  • THIS WIKI IS READ-ONLY.
  • HCL Forums and Blogs
  • Home
  • API Documentation
Search
Community Articles > Deployment Scenarios > Setting up a connection to Microsoft SQL Server to Cognos on Linux/AIX for Connections 4.0 Metrics
  • Share Show Menu▼

Recent articles by this author

IBM Connections 4.0 Metrics Frequently Asked Questions

Frequently Asked Questions (FAQs) of Connections 4.0 Metrics

Setting up a connection to Microsoft SQL Server to Cognos on Linux/AIX for Connections 4.0 Metrics

IBM Cognos Business Intelligence (BI) is installed as a part of an Connections Metrics 4.0 deployment. This article explains how to set up an ODBC connection to an SQL Server from Cognos BI on LinuxAIX and then configure an ODBC connection to SQL Server in Cognos Administration for ...
Community articleSetting up a connection to Microsoft SQL Server to Cognos on Linux/AIX for Connections 4.0 Metrics
Added by ~Lorraine Kiwezen | Edited by ~Lorraine Kiwezen on January 25, 2013 | Version 12
  • Actions Show Menu▼
expanded Abstract
collapsed Abstract
IBM Cognos Business Intelligence (BI) is installed as a part of an Connections Metrics 4.0 deployment. This article explains how to set up an ODBC connection to an SQL Server from Cognos BI on Linux/AIX and then configure an ODBC connection to SQL Server in Cognos Administration for Metrics.
, 4.0_deployment
ShowTable of Contents
HideTable of Contents
  • 1 Introduction
  • 2 Installing Process DataDirect Connect for ODBC
  • 3 Setting up ODBC Connection to SQL Server from Cognos BI
  • 4 Defining JVM Variables to Cognos Server
  • 5 Configuring ODBC connection to SQL Server in Cognos BI Administration
  • 6 Configuring Cognos BI
  • 7 Verify Metrics works correctly
  • 8 Conclusion
  • 9 Tell us what you think
  • 10 Resources
  • 11 About the author

Introduction


Metrics is a new component in IBM® Connections 4.0 supported by IBM Cognos® Business Intelligence, which is installed as a part of a Connections deployment. If Cognos BI is installed on Linux® or AIX, in order to connect to a Microsoft® SQL Server database, an ODBC driver must be installed for the Cognos server.

This article shows you how to set up an ODBC connection to an SQL Server from Cognos BI on Linux/AIX and then configure an ODBC Connection to the SQL Server in Cognos Administration for Connections Metrics.

Installing Process DataDirect Connect for ODBC


Currently, the Process DataDirect Connect for ODBC is the only ODBC driver that IBM Cognos supports for connecting to data located in SQL Server. For detailed information, refer to IBM Support Techdoc #7021368, “Cognos Business Intelligence 10.1.1 Software Environments."

To install DataDirect software, follow these steps:

1. First, download the Process DataDirect ODBC driver (32-bit), Connect for ODBC - 32-bit UNIX/Linux Driver, from http://www.datadirect.com/download.html


NOTE:
This is licensed software, and you must register to download it, but you can get a free,15-day trial to test it out.

2. Install the DataDirect ODBC driver on the Cognos BI server. The detailed installation instructions are in “Installation on Unix and Linux" on the DataDirect Web site.

Setting up ODBC Connection to SQL Server from Cognos BI


To do this:
1. Create a file in the directory called .odbc.ini (i.g, ~/.odbc.ini). A template .odbc.ini is provided where the DataDirect ODBC driver is installed.
2. Edit the .odbc.ini, configuring the SQL Server data source:
  • In the [ODBC] section, specify the ODBC root directory and whether Driver Manager tracing is enabled.
  • In the [ODBC Data Sources] section, define the name and driver for each data source.
  • Create a copy of the [dsn-name] section for each data source defined in the [ODBC Data Sources] section.
  • For each data source defined in the [ODBC Data Sources] section, define additional details, using a [dsn-name] section.
Here is a Linux-based example of the odbc.ini configuration with data source for METRICSDS:

[ODBC Data Sources]
  • metricsds=DataDirect 7.1 SQL Server Wire Protocol
[ODBC]
  • IANAAppCodePage=4
    InstallDir=/opt/Progress/DataDirect/Connect_for_ODBC_71
    Trace=0
    TraceFile=odbctrace.out
    TraceDll=/opt/Progress/DataDirect/Connect_for_ODBC_71/lib/ivtrc27.so
[metricsds]
  • Driver=/opt/Progress/DataDirect/Connect_for_ODBC_71/lib/ivsqls27.so
    Description=DataDirect 7.1 SQL Server Wire Protocol
    Database=metrics
    HostName=lwptsthink68.cn.ibm.com
    PortNumber=1511
To verify that DataDirect and the data source are configured correctly, follow these steps:

1. Set the appropriate library path environment variable to specify the location of the ODBC libraries for your operating system:

Linux: LD_LIBRARY_PATH
AIX: LIBPATH
For example, on Linux:
  1. export LD_LIBRARY_PATH=/opt/Progress/DataDirect/Connect_for_ODBC_71/lib/

2. Set the ODBCINI environment as follows:



3. Go to the "demo" subdirectory in the DataDirect installation directory, and run the command:

“demoobc”

  1. cd /opt/Progress/DataDirect/Connect_for_ODBC_71/samples/demo
  2. ./demoodbc -uid metricsuser -pwd ***** metricsds
(set the password as the Metrics database password of your SQL Server)
If you receive the message below, it means your ODBC driver works fine and can connect to your Metrics database (the "EMP" error does not matter):

./demoodbc DataDirect Technologies, Inc. ODBC Sample Application.
./demoodbc: will connect to data source 'metricsds' as user 'metricsuser/password1'.
......SQLExecute has Failed. RC=-1
SQLSTATE = S0002
NATIVE ERROR = 208
MSG = [DataDirect][ODBC SQL Server Wire Protocol driver][Microsoft SQL Server]Invalid object name 'EMP'.

Defining JVM Variables to Cognos Server

Define ODBCINI and LD_LIBRARY on linux, LIBPATH on AIX, JVM variables to Cognos server. Add the variable to JVM environment variable list:

  • Log in to the WAS Administration console of Cognos server.
  • Click Servers --- Servers type --- WebSphere application servers
  • lick the link of the --- Cognos_server
  • Click Java and then Process Management --- Process definition --- Environment entries.
  • Edit LD_LIBRARY_PATH on linux, LIBPATH on AIX, adding the "<ODBC Driver Location>/lib" to it.
  • Add ODBCINI entry and set "<.ODBC.INI Location>/lib"
  • Save the change and restart cognos_server.

Configuring ODBC connection to SQL Server in Cognos BI Administration


To do this:
  1. Log in Cognos Administrator to Cognos server via http://hostname:port/cognos/servlet/dispatch/ext.
2. Select Launch --- IBM Cognos Administration (see figure 1).

Figure 1. IBM Cognos Administration menu option



3. Click the Configuration tab, select Data Source Connection on the left-hand navigation panel, and click on "METRICS_CUBE_DS" (see figure 2).

Figure 2. Configuration tab



4. Click the Properties button for “METRICS_BUBE_DS” (see figure 3).

Figure 3. Properties button


5. On the Connection tab, change the type to Microsoft SQL Server (ODBC), and then click Edit button (pencil icon; see figure 4).

Figure 4. Connection tab



6. Click the Edit button for "Connection String" and type "metricsds" (the one set in .odbc.ini) in the ODBC data source field (see figure 5).

Figure 5. ODBC data source field


Also, remember to check “Password” in the Signon section at the bottom of the page (see figure 6).

Figure 6. Signon section


7. Click the JDBC tab and input the database information, setting the Database name field to “metrics” (see figure 7). Click OK, to save configuration change.

Figure 7. JDBC tab



Now test the connection to see whether ODBC and JDBC are both working:

1. Click the “Test the connection” link (see figure 8).

Figure 8. “Test the connection” link



2. On the Test Connection page, click “Test”. If the database driver works fine, the ODBC connection test will be successful (see figure 9).

Figure 9. Test Succeeded


Configuring Cognos BI


Add the environment variables ODBCINI and LD_LIBRARY_PATH on linux, LIBPATH on AIX to cron jobs of Congos server.

1.use the following command to edit cron jobs:

crontab -e

2. Add the environment variabls for scheduled cube generation tasks:


For example on Linux, add the following to "daily-refresh.sh" and "weekly-rebuild.sh" lines.
export LD_LIBRARY_PATH=/opt/Progress/DataDirect/Connect_for_ODBC_71/lib/; export ODBCINI=/root/.odbc.ini

3. Save the change and restart cognos_server.

/opt/Cognos/Transformer/metricsmodel/trxschelog.log

Verify Metrics works correctly


First, verify the Metrics cube can be built:


1. Set the appropriate library path environment variable to specify the location of the ODBC libraries for your operating system:


Linux: LD_LIBRARY_PATH
AIX: LIBPATH
For example, on Linux:
export LD_LIBRARY_PATH=/opt/Progress/DataDirect/Connect_for_ODBC_71/lib/

2. Go to the metrics cube folder, cognos_transformer_install_location/metricsmodel; for example:


/opt/Cognos/Transformer/metricsmodel

3. Run the build-all.sh script to the build cube, and then check the log to verify there is no error. For AIX or Linux:

/opt/Cognos/Transformer/metricsmodel/trxschelog.log

Second, verify that Metrics Report can display properly:
1. Open https://localhost:port/metrics and log in the user who has the Metrics-report-run role. The reports should display without error.

Finally, verify the community metrics can be updated successfully:
1. Create a community, using “Start a community”, and select Metrics on left-hand navigation pane.
2. Click Update metrics; Metrics should be able to complete updating successfully and the reports display without error.

Conclusion


You should now understand how to set up an ODBC connection to an SQL Server by DataDirect connect for ODBC from Cognos BI on Linux, and then configure the ODBC connection in Cognos so that Metrics can work to generate and display reports successfully.

Tell us what you think


Please visit this link to take a one-question survey about this article:

http://www.surveymonkey.com/s/9Q6ZKGN

Resources

  • Participate in the discussion forum
  • Read the wiki article, “Using the Metrics application in IBM Connections 4.0.”
  • Refer to the IBM Connections product page.
  • Refer to the Connections product wiki.

About the author


Rong Rong Wang is a Staff Software Engineer based at IBM's Beijing, China, Lab. She currently works as the Team Lead for the Functional Verification Test team for the Connections Moderation feature and also tests Metrics in IBM Connections. She can be contacted at rrwang@cn.ibm.com.



  • Actions Show Menu▼


expanded Attachments (0)
collapsed Attachments (0)
Edit the article to add or modify attachments.
expanded Versions (1)
collapsed Versions (1)
Version Comparison     
VersionDateChanged by              Summary of changes
This version (12)Jan 25, 2013, 7:22:20 AM~Lorraine Kiwezen  
expanded Comments (0)
collapsed Comments (0)
Copy and paste this wiki markup to link to this article from another article in this wiki.
Go ElsewhereStay ConnectedAbout
  • HCL Software
  • HCL Digital Solutions community
  • HCL Software support
  • BlogsDigital Solutions blog
  • Community LinkHCL Software forums and blogs
  • About HCL Software
  • Privacy
  • Accessibility