This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
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.
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).
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).
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.)
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.
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.
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:
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.