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. Page 1
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 2
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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).
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 3
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 4
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 5
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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).
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 6
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 7
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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.
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 8
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 9
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
./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).
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 10
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
Figure 16
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 11
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 12
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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=
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 13
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
# 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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 14
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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=
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 15
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 16
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
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.
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 17
xir2_install_ configure_datadirect_5_unix.pdf
BusinessObjects XI Release 2 How to install and configure DataDirect 5.2 for XIR2 on UNIX
9/13/2007 11:22:00 AM Copyright © 2006 Business Objects. All rights reserved. Page 18
xir2_install_ configure_datadirect_5_unix.pdf