BusinessObjects Enterprise Administrator's Guide

Native drivers

If you design reports using native drivers, you must install the appropriate database client software on each Job Server and/or Page Server machine that will process the reports. The server loads the client software at runtime in order to access the database that is specified in the report. The server locates the client software by searching the library path environment variable that corresponds to your operating system (LD_LIBRARY_PATH on Sun Solaris, LIBPATH on IBM AIX, and so on), so this variable must be defined for the login environment of each Job Server and Page Server.

Depending on your database, additional environment variables may be required for the Job Server and Page Server to use the client software. These include:

• Oracle

  The ORACLE_HOME environment variable must define the top-level directory of the Oracle client installation.

• Sybase

  The SYBASE environment variable must define the top-level directory of the Sybase client installation. The SYBPLATFORM environment variable must define the platform architecture.

• DB2

  The DB2INSTANCE environment variable must define the DB2 instance that is used for database access. Use the DB2 instance initialization script to ensure that the DB2 environment is correct.

Note:    For complete details regarding these and other required environment variables, see the documentation included with your database client software.

As an example, suppose that you are running reports against both Sybase and Oracle. The Sybase database client is installed in /opt/sybase, and the Oracle client is installed in /opt/oracle/app/oracle/product/8.1.7. You installed BusinessObjects Enterprise under the crystal user account (as recommended in the BusinessObjects Enterprise Installation Guide).

If the crystal user's default shell is a C shell, add these commands to the crystal user's login script:

setenv LD_LIBRARY_PATH /opt/oracle/app/oracle/product/8.1.7/lib:opt/sybase/lib:$LD_LIBRARY_PATH

setenv ORACLE_HOME /opt/oracle/app/oracle/product/8.1.7

setenv SYBASE /opt/sybase

setenv SYBPLATFORM sun_svr4

If the crystal user's default shell is a Bourne shell, modify the syntax accordingly:

LD_LIBRARY_PATH=/opt/oracle/app/oracle/product/8.1.7/lib:opt/sybase/lib:$LD_LIBRARY_PATH;export LD_LIBRARY_PATH

ORACLE_HOME=/opt/oracle/app/oracle/product/8.1.7;export ORACLE_HOME

SYBASE=/opt/sybase;export SYBASE

SYBPLATFORM=sun_svr4;export SYBPLATFORM