White PaperWorking with the Cognos BI Server Using theGreenplum DatabaseInteroperability and Connectivity Configuration fo...
Copyright © 2012 EMC Corporation. All Rights Reserved.   EMC believes the information in this publication is accurate of  ...
Executive summaryThe correct functionality of the Greenplum database with the Cognos BI Server isdependent on the configur...
Tier 2 contains the Web server where the IBM Cognos BI gateway, dispatcher andcontent manager are hosted. The content stor...
SQL_DBMS_NAME variable returned from the SQLGetInfo call to the ODBC driver. Allof this occurs automatically for the Cogno...
In order to verify that all the shared objects required by the ODBC driver are properly identifiedin the LD_LIBRARY_PATH, ...
4.   As a convenience, a greenplum_clients_path.sh file is provided in the client tools installation     directory followi...
   The host name or IP address of the GPDB master server      The port number used by the GPDB, default 5432.      The ...
Validation of the connectivity between the Cognos BI Server and theGreenplum databaseIn order to validate the connectivity...
At the bottom of page, select Test the Connection. Verify connectivity to Greenplumthrough Cognos and ODBC by selecting th...
The next page should show the connection status as Succeeded. Complete theCognos data connection by selecting Close twice,...
It is important note that although Greenplum does not enforce referential integrity,users should include foreign key const...
Give the Package a name, in this case Greenplum and select the Next button. Selectthe Next button and include the Greenplu...
data demonstrates a successful end-to-end validation of the Cognos to Greenplumconnectivity.                 Working with ...
ConclusionAs stated at the outset of this white paper, the correct functionality of the Greenplumdatabase with the Cognos ...
Upcoming SlideShare
Loading in …5
×

Working with the Cognos BI Server Using the Greenplum Database -- Interoperability and Connectivity Configuration for Linux Users

2,154 views
2,021 views

Published on

This white paper explains how the Cognos BI Server running in the Linux environment can be configured and used with a Greenplum database. Included in this paper are detailed instructions for configuration and connectivity verification.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
2,154
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
44
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Working with the Cognos BI Server Using the Greenplum Database -- Interoperability and Connectivity Configuration for Linux Users

  1. 1. White PaperWorking with the Cognos BI Server Using theGreenplum DatabaseInteroperability and Connectivity Configuration for Linux Users Abstract This white paper explains how the Cognos BI Server running in the Linux environment can be configured and used with a Greenplum database. Included in this paper are detailed instructions for configuration and connectivity verification. March 2012
  2. 2. Copyright © 2012 EMC Corporation. All Rights Reserved. EMC believes the information in this publication is accurate of its publication date. The information is subject to change without notice. The information in this publication is provided “as is”. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. VMware is a registered trademark of VMware, Inc. All other trademarks used herein are the property of their respective owners. Part Number H10589Working with the Cognos BI Server in Linux with the Greenplum Database 2
  3. 3. Executive summaryThe correct functionality of the Greenplum database with the Cognos BI Server isdependent on the configuration of an ODBC (Open Database Connectivity) driverusing the Greenplum Connectivity Pack. This white paper walks the reader throughthe process of driver selection and installation, the configuration and validation of anODBC connection to Greenplum, the creation of a Cognos data connection, andvalidation of that connection using Cognos Framework Manager and Query Studio.This white paper is based on examples from Cognos 10.1.1 (release pack 1), Red HatLinux 5.5 and Greenplum 4.1.1 and Greenplum Connectivity pack greenplum-connectivity-4.1.1.0-build-4-RHEL5-x86_64.AudienceThis white paper is intended for customers, as well as, EMC field and supportpersonnel who will be using the Cognos BI Server in the Linux environment with theGreenplum database. This white paper does not replace the Cognos documentationset supplied by IBM nor the Greenplum documentation set supplied by EMC. It isexpected that the reader has basic knowledge of the Cognos BI Server, ODBC driverconfiguration in the Linux environment, and the Greenplum database.Organization of this paperThis paper covers the following topics:  Overview of the Cognos BI system and components  How the Cognos BI Server integrates with relational database management systems  The installation, configuration, and verification of an ODBC connection using the Greenplum Connectivity Pack  Validation of the connectivity between the Cognos BI Server and the Greenplum database using the Cognos components Framework Manager and Query StudioOverview of the Cognos BI system and componentsThe IBM Cognos BI server is implemented in a multi-tier architecture. For descriptivepurposes, this architecture can be thought of as three tiers. Please note that Cognos10 is a 32 bit application, therefore 32 bit ODBC drivers must be used.Tier 3 is the query database or data source. In this white paper the query databasecan be Greenplum either implemented on a computing appliance (Greenplum DataComputing Appliance) or in software only mode. Working with the Cognos BI Server in Linux with the Greenplum Database 3
  4. 4. Tier 2 contains the Web server where the IBM Cognos BI gateway, dispatcher andcontent manager are hosted. The content store is a relational database that containsdata that IBM Cognos needs to operate, such as report specifications, publishedmodels, and the packages that contain them.Tier 1 contains user interfaces including the Framework Manager modeling tool thatdrives query generation for IBM Cognos and the Cognos Connection user portal thatincludes administrative tools and reporting tools such as Query Studio. TIER 1 TIER 2 TIER 3 Framework Manager ODBC GPDB ODBC Cognos Web server Connection IBM Cognos BI Gateway Greenplum DCA Content or Software Store InstallationHow the Cognos BI Server integrates with relational databasemanagement systemsBecause Cognos supports many databases and those databases offer various levelsof functionality, the Cognos BI Server must take into account which database it issending SQL commands to in order to get optimal use out of that database. Cognossupports variable levels of SQL functionality by shipping individualized initializationfiles for each supported query database. The initialization file renders the genericCognos SQL into the dialect of a particular supported database. The Cognos BI serverresolves which database initialization file to load by interrogating the Working with the Cognos BI Server in Linux with the Greenplum Database 4
  5. 5. SQL_DBMS_NAME variable returned from the SQLGetInfo call to the ODBC driver. Allof this occurs automatically for the Cognos user.The installation, configuration, and verification of an ODBC connectionusing the Greenplum Connectivity PackThis section walks the reader through the steps required to select, install, configureand verify an ODBC connection to Greenplum.Install Required and Recommended SoftwareThe correct Greenplum Connectivity Pack for a particular combination of Greenplumand Cognos releases can be determined by referring to the IBM support site.Searching for the string “cognos 10.1.1 supported environments” in a Web searchsite, should direct the reader to the IBM support site. In the ODBC section of theCognos release software environments page, locate the Greenplum database to beinstalled. A Greenplum Connectivity Pack version will be indicated for each supportedenvironment. For example, for Cognos 10.1.1, Greenplum 4.1.1 is supported viaConnectivity Pack 4.1.1 for Linux (x86).Greenplum Connectivity Packs can be downloaded from EMC’s PowerLink web site orfrom the Greenplum Community site. Please refer to the GPConnectUnix PDF in theinstallation pack for detailed installation instructions. Briefly, the installation of theGP connectivity tools consists of these steps:1. Download the appropriate greenplum-connectivity-4.1.1.0-build-4-RHEL5-x86_64.bin installer package for RedHat Linux 64-bit.2. Unzip the installer: unzip greenplum-connectivity-4.1.1.0-build-4-RHEL5-x86_64.bin.zip3. Run the installer: /bin/bash greenplum-connectivity-4.1.1.0-build-4-RHEL5-x86_64.bin. Accept the license agreement and supply an absolute path for the tool installation.4. As a convenience, a greenplum_connectivity_path.sh file is provided in the client tools installation directory following installation to set the environment variables GPHOME_CLIENTS, PATH, and LD_LIBRARY_PATH. The examples in this white paper specified the ODBC driver manager as unixodbc-2.2.12 and the ODBC driver as psqlodbc-08.04.0200.The Cognos BI server requires a 32-bit ODBC driver. The word size of the ODBC driverdownloaded can be confirmed using the Linux “file” command. For example,-bash-3.2$ file <4.1.1-gp-conn-install-dir>/drivers/odbc/psqlodbc-08.04.0200/unixodbc-2.2.12/psqlodbcw.sopsqlodbcw.so: ELF 32-bit LSB shared object, Intel 80386, version 1(SYSV), not stripped Working with the Cognos BI Server in Linux with the Greenplum Database 5
  6. 6. In order to verify that all the shared objects required by the ODBC driver are properly identifiedin the LD_LIBRARY_PATH, it is recommended that the user run the “ldd” command on the drivershared object. The ldd command prints the shared libraries required by each program orshared library specified on the command line. For example,ldd <4.1.1-gp-conn-install-dir>/drivers/odbc/psqlodbc-08.04.0200/unixodbc-2.2.12/psqlodbcw.solinux-gate.so.1 => (0xffffe000)libssl.so.0.9.8 => /my-gpconn-dir/lib/libssl.so.0.9.8 (0xf7f22000)libpq.so.5 => /my-gpconn-dir/lib/libpq.so.5 (0xf7eeb000)libpthread.so.0 => /lib/libpthread.so.0 (0xf7ec0000)libodbcinst.so.1 => /my-gpconn-dir/drivers/odbc/psqlodbc-08.04.0200/unixodbc-2.2.12/libodbcinst.so.1 (0xf7eab000)libodbc.so.1 => /my-gpconn-dir/drivers/odbc/psqlodbc-08.04.0200/unixodbc-2.2.12/libodbc.so.1 (0xf7e29000)libc.so.6 => /lib/libc.so.6 (0xf7ce3000)libcrypto.so.0.9.8 => /my-gpconn-dir/lib/libcrypto.so.0.9.8 (0xf7b9c000)libdl.so.2 => /lib/libdl.so.2 (0xf7b98000)libkrb5.so.3 => /my-gpconn-dir/lib/libkrb5.so.3 (0xf7b17000)libcrypt.so.1 => /lib/libcrypt.so.1 (0xf7ae5000)libldap_r-2.3.so.0 => /my-gpconn-dir/lib/libldap_r-2.3.so.0 (0xf7a9f000)/lib/ld-linux.so.2 (0x00a0e000)libk5crypto.so.3 => /my-gpconn-dir/lib/libk5crypto.so.3 (0xf7a7b000)libcom_err.so.3 => /my-gpconn-dir/lib/libcom_err.so.3 (0xf7a75000)libkrb5support.so.0 => /my-gpconn-dir//lib/libkrb5support.so.0 (0xf7a6d000)libresolv.so.2 => /lib/libresolv.so.2 (0xf7a5a000)liblber-2.3.so.0 => /my-gpconn-dir/lib/liblber-2.3.so.0 (0xf7a4c000)Each of the shared objects should be found. If exceptions occur, the LD_LIBRARY_PATHenvironment file should be adjusted.It is recommended that the GP Client Tools from EMC be downloaded and installed.The client tools can be downloaded from EMC’s PowerLink web site or the GreenplumCommunity site. This tool will be used to verify connectivity between the Linuxmachine where the Cognos BI Server will run and the target Greenplum database.Please refer to the GPClientToolsUnix PDF in the Greenplum Database Client Tools forUnix installation pack for detailed installation instructions. Briefly, the installation ofthe GP client tools consists of these steps:1. Download the appropriate greenplum-clients-4.1.1.0-build-4-RHEL5-x86_64.bin installer package for RedHat Linux.2. Unzip the installer: unzip greenplum-clients-4.1.1.0-build-4-RHEL5-x86_64.bin.zip3. Run the installer: /bin/bash greenplum-clients-4.1.1.0-build-4-RHEL5-x86_64.bin. Accept the license agreement and supply an absolute path for the tool installation. Working with the Cognos BI Server in Linux with the Greenplum Database 6
  7. 7. 4. As a convenience, a greenplum_clients_path.sh file is provided in the client tools installation directory following installation to set the environment variables GPHOME_CLIENTS, PATH, and LD_LIBRARY_PATH.Verify Connectivity between the Cognos Linux Machine and GreenplumBefore beginning the configuration of an ODBC connection for Cognos, it isrecommended that the connectivity between the Linux machine where the BI Serverwill run and Greenplum be verified. If issues such as firewall restrictions exist, theywill be exposed by this verification step. The psql command line tool included in theGreenplum Client Tools installation will be used to verify connectivity. At a Unixcommand prompt, simply invoke the psql command line tool supplying theGreenplum master database host name, port number, user name, and password. Thepsql command connection options are:Connection options: -h, --host=HOSTNAME database server host or socket directory (default: "local socket") -p, --port=PORT database server port (default: "5432") -U, --username=USERNAME database user name -d, --dbname=DBNAME database nameA successful connection is followed by a prompt from psql that includes the databasename. For example, to access the cognos_samples database, the following commandwould be issued supplying the correct host name, username, and password.-bash-3.2$ psql -h HOSTNAME -U USER -d cognos_samples -p 5432psql (8.2.15)Type "help" for help.cognos_samples=#Some users may be inclined to confirm the connectivity between the Cognos BI hostand the Greenplum database using the Linux-installed isql program. Caution shouldbe exercised during this test because there is the possibility of a word-size mismatchbetween a 64-bit isql program and the 32-bit Greenplum Connectivity pack ODBCdriver, resulting in a false-negative result to this connectivity test. It is recommendedthat the “-v” option be supplied when invoking isql in order to expose wrong ELF classerrors.Configure an ODBC DSN for GreenplumThe data source name (DSN) that is used to connect to Greenplum is specified in the odbc.inifile. This file may be placed wherever it is convenient. The environment variable ODBCINI willbe used to inform Cognos where to find it. To get to the Greenplum database, the following areneeded:  The database name Working with the Cognos BI Server in Linux with the Greenplum Database 7
  8. 8.  The host name or IP address of the GPDB master server  The port number used by the GPDB, default 5432.  The username to log in to the master server  The password of the login userThere are two sections of interest in the odbc.ini file, namely the ODBC Data Source sectionfollowed by one section for each DSN defined. These will be described by in-line commentsbelow.# ODBC Data Sources lists the DSN’s to be defined[ODBC Data Sources]Greenplum=PostgreSQL driver for Greenplum# DSN for Greenplum points to cognos_samples database[Greenplum]Description = PostgreSQL driver for Greenplum# the absolute location for ODBC driver to be usedDriver = /my-gpconn-install-dir/drivers/odbc/psqlodbc-08.04.0200/unixodbc-2.2.12/psqlodbcw.so# tracing is may useful during testing but turned# after moving to productionTrace = 0TraceFile = /tmp/odbctraces_dbtmDebug = 0DebugFile = /tmp/odbcdebug# the name of the target databaseDatabase = cognos_samples# the host name or IP address, user and password of the target dataserverServername = xx.x.xx.xxxUserName = user-namePassword = password# default port number for GreenplumPort = 5432ReadOnly = NoRowVersioning = No# recommended sizeMaxLongVarcharSize = 2048DisallowPremature = No# provides some efficiency in query reuseUseServerSidePrepare = YesShowSystemTables = YesShowOidColumn = NoFakeOidIndex = No# allows for cursor fetch of result sets avoids out of# memory errors in Cognos BI serveruseDeclareFetch = 1Fetch = 4096UpdatableCursors = Yes# required versionProtocol = 7.4# recommended sizesCacheSize = 75000MaxVarcharSize = 1024 Working with the Cognos BI Server in Linux with the Greenplum Database 8
  9. 9. Validation of the connectivity between the Cognos BI Server and theGreenplum databaseIn order to validate the connectivity end-to-end between Cognos and Greenplum aCognos data source connection will be created that will be used in small packagecreated in Framework Manager and exercised in Cognos Connection Query Studio.Create a Cognos Data ConnectionFrom the Cognos Connection portal, launch IBM Cognos Administration. SelectConfiguration > Data Source Connections > *New Data Source. Enter a Data SourceName and Description and select the Next button.For a Type, pick ODBC from the pull down and select the Next button. For the ODBCdata source, enter the ODBC DSN created above, in this example “Greenplum”.Supply the User ID and Password in the Sigons section. Working with the Cognos BI Server in Linux with the Greenplum Database 9
  10. 10. At the bottom of page, select Test the Connection. Verify connectivity to Greenplumthrough Cognos and ODBC by selecting the Test button. Working with the Cognos BI Server in Linux with the Greenplum Database 10
  11. 11. The next page should show the connection status as Succeeded. Complete theCognos data connection by selecting Close twice, followed by Finish.Create Project in Framework ManagerIn Windows, start Framework Manager (Start -> Programs -> IBM Cognos -> IBM CognosFramework Manager). From the Welcome page, click Create a new project. In the NewProject page, specify a name and location for the project, for example Greenplum inthis location, and click OK. In the Select Language page, click the design language forthe project.Once the Metadata Wizard appears, select the Cognos Data Source created above, inthis case Greenplum, and then select the Next button. The scope of Greenplumobjects to be imported by the Wizard can be controlled in the Select Objects screen.Assuming the IBM Cognos Samples database has been loaded into Greenplum, selectthe branch table in Great Outdoors Sales (gosales) schema. Select the Next button tocontinue. Working with the Cognos BI Server in Linux with the Greenplum Database 11
  12. 12. It is important note that although Greenplum does not enforce referential integrity,users should include foreign key constraints during data migration since they are thesource of information for the Metadata Wizard to build relationships between tablesin Query Subjects. Select Import followed by Finish to complete the metadata importprocess.Create a PackageIn order to make the Query Subject just created available for reporting in the CognosConnection, a Package must be created and published. In Framework Manager selectCreate under Packages. Working with the Cognos BI Server in Linux with the Greenplum Database 12
  13. 13. Give the Package a name, in this case Greenplum and select the Next button. Selectthe Next button and include the Greenplum function set in the Create Package screen.Select the Finish button and specify the IBM Cognos 10 Content Store as publishinglocation in the Publish Wizard – Select Location Type. Select defaults for security andpublish. Exit the Wizard by selecting the Finish button.Create a Report in Query StudioThe final step in the end-to-end validation is to create a report in Query Studio. Fromthe Cognos Connection portal, launch Query Studio. In the Insert Data menu selectbranch_code, address1, address2, and city from the branch table. The appearance of Working with the Cognos BI Server in Linux with the Greenplum Database 13
  14. 14. data demonstrates a successful end-to-end validation of the Cognos to Greenplumconnectivity. Working with the Cognos BI Server in Linux with the Greenplum Database 14
  15. 15. ConclusionAs stated at the outset of this white paper, the correct functionality of the Greenplumdatabase with the Cognos BI Server is dependent on the configuration of an ODBCdriver using the Greenplum Connectivity Pack. This white paper walked the readerthrough the process of driver selection, installation, the configuration and validationof an ODBC connection to Greenplum, the creation of a Cognos data connection to aGreenplum database, and validation of that connection using Cognos FrameworkManager and Query Studio. Working with the Cognos BI Server in Linux with the Greenplum Database 15

×