BuildForge Help

Oracle Client Configuration

To install and configure the client for Oracle:

  1. Install an Oracle client driver on the Management Console host. If you need to use Instant Client, use the latest version of Instant Client Package - Basic for your operating system. Download it from Oracle at http://www.oracle.com/technology/software/tech/oci/instantclient/index.html.
  2. Set up the environment on the Management Console host. Several environment variables must be set.
    • LD_LIBRARY_PATH: set to include the client installation directory.
    • NLS_LANG: set to an appropriate value for international language support. It must include AL32UTF8. Example: AMERICAN_AMERICA.AL32UTF8.
    • ORACLE_HOME: set to the path of your Oracle client installation directory.
    • ORA_NLS: set to the path where character-set data is located on the server.
    • ORA_NLS32: set to the same path as ORA_NLS.
    • PATH: set to include the client installation directly.
    • TNS_ADMIN: set to the path where the tnsnames.ora file is located on the server.

    To check the current language setting on the Oracle server, log in to Oracle and execute the following command:

    SQL> host echo $NLS_LANG
Important: During installation, tnsnames.ora is set up to use the same value for the database name and the Oracle SID. A limitation in JDBC drivers requires this constraint. If they are not the same, the Quick Report reporting feature and the services-layer APIs for Java and Perl do not work.