businessobjects xi and xi release 2

BusinessObjects XI and XI Release 2

How to Install and Configure DataDirect 5.2 on UNIX

Overview This whitepaper describes how to install and configure the DataDirect Connect v.5.2 ODBC for BusinessObjects Enterprise XI Release 2 driver on a UNIX server. This driver must be purchased separately by the Business Objects customer who requires this connectivity.

Contents INTRODUCTION............................................................................................2 INSTALLATION.............................................................................................2 APPENDIX.................................................................................................12

Odbc.ini .....................................................................................................12

9/13/2007 11:22:00 AM Copyright © 2007 Business Objects. All rights reserved.

BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX

Introduction Configuring the ODBC driver is required for all reports that are created using an ODBC Data Source Name (DSN). The DSN must be configured on all processing tier servers that connect to the database, such as page servers and job servers. Business Objects XI Release 2 includes a DataDirect ODBC driver which works with Crystal Reports, Desktop Intelligence reports and WebIntelligence reports; however, after five days, it no longer works with Desktop Intelligence and WebIntelligence as Business Objects is only fully licensed to use the driver with Crystal Reports. It is available on a trial basis with the other two applications.

Installation The following instructions are tested and verified on BusinessObjects XI Release 2 running on a RedHat EL 4 server with a Microsoft SQL Server ODBC driver.

1. Log on to BusinessObjects UNIX server as owner uid.

2. In a UNIX xterm, source the BusinessObjects XI Release 2 env.sh to populate the DEFAULT_ODBCFILE, ODBC_HOME, and ODBCINI environment variables (Figure 1).

. ~/bobje/setup/env.sh

env | grep ODBC

Figure 1


xir2_install_ configure_datadirect_5_unix.pdf


NOTE Replace ~/bobje/ with your BusinessObjects XI Release 2 installation directory.

3. Download the DataDirect ODBC driver from:

http://www.datadirect.com/downloads/downloadinstructions/dl_connectodbcunix/index.ssp

NOTES • The supported UNIX architectures are AIX, HP-UX, HP-UX IPF, Linux, Solaris SPARC, and Solaris x86.

• For a list of supported 32-bit driver platforms and Databases, click here.

4. Unpack the DataDirect ODBC driver software:

mkdir DataDirect

mv evlinux.tar.Z DataDirect/

cd DataDirect/

tar xvfz evlinux.tar.Z

5. Execute the installation script:

./unixmi.ksh

Figure 2

6. Enter your serial number and license key (Figure 3).





http://www.datadirect.com/products/odbc/matrix/connectodbc.htm


Figure 3

NOTE If you are evaluating the DataDirect ODBC driver, enter EVAL for both serial number and key.

7. Click the Enter key to choose All Supported Databases (Figure 4).

Figure 4




8. Click the Enter key to continue the installation without the on-line book (Figure 5).

Figure 5

9. Click the Enter key to continue the installation to use /tmp for the temporary directory (Figure 6).

Figure 6

10. Enter the full path to the BusinessObjects XI Release 2 directory




Figure 7

NOTE If you are not sure where the installation directory is, execute the following to obtain the path from your installation directory, assuming your installation directory is /home/bobje/:

. /home/bobje/bobje/setup/env.sh

echo $ODBC_HOME

It will return something similar to the following:

/home/bobje/bobje/enterprise115/linux_x86/odbc

11. Click N to not install another product (Figure 8).

Figure 8

12. Click N to not launch the performance wizard (Figure 9).




Figure 9

13. Execute odbc.sh to include $ODBC_HOME in the LD_LIBRARY_PATH environment variable:

$ODBC_HOME/odbc.sh

14. Test loading the ODBC driver using odbctest.sh for Solaris or odbctestlinux.sh for Linux (Figure 10). (Similar files for other UNIX systems do not exist. For other UNIX systems, see step 17.)

cd $ODBC_HOME/lib

./odbctestlinux.sh

Figure 10




NOTE The odbctest.sh and odbctestlinux.sh files are available here.

Download them to your $ODBC_HOME/lib/ directory

chmod +x odbctest*.sh

15. Test load the ODBC driver (Figure 11) You can skip this if you have already verified the loading with odbctest.sh or odbctestlinux.sh.

cd $ODBC_HOME/bin

./ivtestlib ivmsss22.so

Figure 11

NOTES • ivmsss22.so is the DataDirect SQLServer wireprotocol ODBC driver.

• Some of the non-DataDirect ODBC drivers, such as the MySQL ODBC driver, might not show version information.

16. Edit the $ODBCINI configuration file to include the Database ODBC driver you plan to use. This example uses MicroSoft SQL Server 2000/2005 ODBC driver. See the Appendix for a sample odbc.ini configuration file.




Figure 12

NOTE The ODBC Data Source Name (Figure 13) has to match your Windows System DSN; otherwise, your report that uses this ODBC driver would not be able to connect to the data source from the XI Release 2 server.

Figure 13

17. Test and verify the ODBC connection (Figure 14). You may skip this if you have already verified the connection with odbctest.sh or odbctestlinux.sh.

cd $ODBC_HOME/example




./example

Figure 14

18. Test and verify the report using the SQLServer Wire Protocol DSN from your InfoView (Figure 15).

Figure 15

19. Click the SQL2005 Report.rpt found in Home > Public Folders > Sample Reports (Figure 16).




Figure 16




Appendix

Odbc.ini [ODBC Data Sources] DB2 Wire Protocol=DataDirect 5.2 DB2 Wire Protocol dBase=DataDirect 5.2 dBaseFile(*.dbf) FoxPro3=DataDirect 5.2 dBaseFile(*.dbf) Informix Wire Protocol=DataDirect 5.2 Informix Wire Protocol MySQL Wire Protocol=DataDirect 5.2 MySQL Wire Protocol Oracle Wire Protocol=DataDirect 5.2 Oracle Wire Protocol Oracle=DataDirect 5.2 Oracle PostgreSQL=PostgreSQL ODBC SQLServer Wire Protocol=DataDirect 5.2 SQL Server Wire Protocol Sybase Wire Protocol=DataDirect 5.2 Sybase Teradata=DataDirect 5.2 Teradata Text=DataDirect 5.2 TextFile(*.*) [DB2 Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivdb222.so Description=DataDirect 5.2 DB2 Wire Protocol AddStringToCreateTable= AlternateID= AlternateServers= ApplicationUsingThreads=1 AuthenticationMethod=0 CatalogSchema= CharsetFor65535=0 #Collection applies to z/OS and iSeries only Collection= ConnectionRetryCount=0 ConnectionRetryDelay=3 #Database applies to DB2 UDB only Database=<database_name> DynamicSections=200 GrantAuthid=PUBLIC GrantExecute=1 GSSClient= IpAddress=<DB2_server_host> LoadBalancing=0 #Location applies to z/OS and iSeries only Location=<location_name> LogonID= Password= PackageCollection=NULLID PackageOwner= ReportCodePageConversionErrors=0 TcpPort=50000 UseCurrentSchema=1 WithHold=1 [dBase] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivdbf22.so Description=DataDirect 5.2 dBaseFile(*.dbf) ApplicationUsingThreads=1 CacheSize=4




CreateType=dBASE5 Database=/home/bobje/bobje/enterprise115/linux_x86/odbc/demo DataFileExtension=DBF ExtensionCase=UPPER FileOpenCache=0 IntlSort=0 LockCompatibility=dBASE Locking=RECORD UseLongNames=0 UseLongQualifiers=0 [FoxPro3] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivdbf22.so Description=DataDirect 5.2 dBaseFile(*.dbf) ApplicationUsingThreads=1 CacheSize=4 CreateType=FoxPro30 Database=/home/bobje/bobje/enterprise115/linux_x86/odbc/demo DataFileExtension=DBF ExtensionCase=UPPER FileOpenCache=0 IntlSort=0 LockCompatibility=Fox Locking=RECORD UseLongNames=0 UseLongQualifiers=0 [Informix Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivifcl22.so Description=DataDirect 5.2 Informix Wire Protocol AlternateServers= ApplicationUsingThreads=1 CancelDetectInterval=0 ConnectionRetryCount=0 ConnectionRetryDelay=3 Database=<database_name> HostName=<Informix_host> LoadBalancing=0 LogonID= Password= PortNumber=<Informix_server_port> ServerName=<Informix_server> TrimBlankFromIndexName=1 [MySQL Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/libmyodbc3-3.51.12.so Description=DataDirect 5.2 MySQL Wire Protocol SERVER=lmarch6.intl.businessobjects.com PORT=3306 USER= Password= Database=BOE115 [Oracle Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivora22.so Description=DataDirect 5.2 Oracle Wire Protocol AlternateServers=




# ApplicationUsingThreads=1 # ArraySize=60000 # CachedCursorLimit=32 CachedDescLimit=0 CatalogIncludesSynonyms=1 # CatalogOptions=0 ConnectionRetryCount=0 ConnectionRetryDelay=3 # DefaultLongDataBuffLen=1024 DescribeAtPrepare=0 EnableDescribeParam=0 EnableNcharSupport=0 # EnableScrollableCursors=1 EnableStaticCursorsForLongData=0 EnableTimestampWithTimeZone=0 HostName=lmarch6.intl.businessobjects.com LoadBalancing=0 LocalTimeZoneOffset= # LockTimeOut=-1 LogonID= Password= PortNumber=1521 # ProcedureRetResults=0 ReportCodePageConversionErrors=0 ReportRecycleBin=0 ServerName= # ServerType=0 ServiceName=BOE115 SID= TimestampeEscapeMapping=0 TNSNamesFile=/opt/app/oracle/network/admin/tnsnames.ora UseCurrentSchema=1 # WireProtocolMode=1 # Optimized by Performance Wizard LockTimeOut=-1 ServerType=2 ApplicationUsingThreads=1 ProcedureRetResults=1 CachedCursorLimit=400 EnableScrollableCursors=1 WireProtocolMode=1 ArraySize=256000 CatalogOptions=0 DefaultLongDataBuffLen=5120 [Oracle] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivor822.so Description=DataDirect 5.2 Oracle AlternateServers= # ApplicationUsingThreads=1 # ArraySize=60000 CatalogIncludesSynonyms=1 # CatalogOptions=0 ClientVersion=9iR2 ConnectionRetryCount=0 ConnectionRetryDelay=3 # DefaultLongDataBuffLen=1024




DescribeAtPrepare=0 EnableDescribeParam=0 EnableNcharSupport=0 # EnableScrollableCursors=1 EnableStaticCursorsForLongData=0 EnableTimestampWithTimeZone=0 LoadBalancing=0 LocalTimeZoneOffset= # LockTimeOut=-1 LogonID= # OptimizeLongPerformance=0 Password= # ProcedureRetResults=0 ReportCodePageConversionErrors=0 ReportRecycleBin=0 ServerName=lmarch6.intl.businessobjects.com TimestampEscapeMapping=0 UseCurrentSchema=1 # Optimized by Performance Wizard ArraySize=256000 LockTimeOut=-1 OptimizeLongPerformance=0 ApplicationUsingThreads=1 DefaultLongDataBuffLen=5120 ProcedureRetResults=1 CatalogOptions=0 EnableScrollableCursors=1 [PostgreSQL] Driver=/usr/lib/libodbcpsql.so Description=PostgreSQL SERVER=lmarch6.intl.businessobjects.com PORT=5432 USER= Password= Database=BOE115 [SQLServer Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivmsss22.so Description=DataDirect 5.2 SQL Server Wire Protocol Address=10.55.221.14, 1433 AlternateServers= AnsiNPW=Yes ConnectionRetryCount=0 ConnectionRetryDelay=3 Database=master LoadBalancing=0 LogonID= Password= QuotedId=No SnapshotSerializable=0 [Sybase Wire Protocol] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivase22.so Description=DataDirect 5.2 Sybase Wire Protocol AlternateServers= ApplicationName=




ApplicationUsingThreads=1 ArraySize=50 AuthenticationMethod=0 Charset= ConnectionRetryCount=0 ConnectionRetryDelay=3 CursorCacheSize=1 Database=<database_name> DefaultLongDataBuffLen=1024 EnableDescribeParam=0 EnableQuotedIdentifiers=0 GSSClient= InitializationString= Language= LoadBalancing=0 LogonID= NetworkAddress=<Sybase_host, Sybase_server_port> OptimizePrepare=1 PacketSize=0 Password= RaiseErrorPositionBehavior=0 ReportCodePageConversionErrors=0 SelectMethod=0 ServicePrincipalName= TruncateTimeTypeFractions=0 WorkStationID= [Teradata] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivtera22.so Description=DataDirect 5.2 Teradata AccountString= CharacterSet=ASCII DBCName=vanrdfs05.product.businessobjects.com Database= EnableDataEncryption=No EnableLOBs=Yes EnableReconnect=No IntegratedSecurity=No LoginTimeout=20 MapCallEscapeToExec=No MaxRespSize=8192 Password= #PortNumber=1025 PrintOption=N ProcedureWithSplSource=Y ReportCodePageConversionErrors=0 SecurityMechanism= SecurityParameter= ShowSelectableTables=Yes UserID= [Text] Driver=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/ivtxt22.so Description=DataDirect 5.2 TextFile(*.*) AllowUpdateAndDelete=0 ApplicationUsingThreads=1 CacheSize=4




CenturyBoundary=20 Database=/home/bobje/bobje/enterprise115/linux_x86/odbc/demo DataFileExtension=TXT DecimalSymbol=. Delimiter= FileOpenCache=0 FirstLineNames=0 IntlSort=0 ScanRows=25 TableType=Comma UndefinedTable=GUESS [ODBC] IANAAppCodePage=4 InstallDir=/home/bobje/bobje/enterprise115/linux_x86/odbc Trace=0 TraceDll=/home/bobje/bobje/enterprise115/linux_x86/odbc/lib/odbctrac.so TraceFile=odbctrace.out UseCursorLib=0

DISCLAIMER The third party products discussed in this white paper were not fully tested in conjunction with our product prior to its release. Officially supported platforms for each Business Objects product are listed on our web site at:

http://support.businessobjects.com/documentation/supported_platforms/default.asp

The text file Platforms.txt that comes with the product is not as current.

The information in this document is provided as a courtesy to assist our customers with the configuration of our product in conjunction with these third party platforms.

In the event issues arise with an unsupported configuration, there is no escalation support; however, they will be considered during the development of the next generation of our product.



http://support.businessobjects.com/documentation/supported_platforms/default.asp




http://www.businessobjects.com

businessobjects xi and xi release 2

Documents