Setup/Connection Issues

You are experiencing a setup/connection issue if you are encountering an error or hang while you are trying to make a database connection with the ODBC driver or are trying to configure the ODBC driver.

Some common errors that are returned by the ODBC driver if you are experiencing a setup/connection issue include:

Specified driver could not be loaded
Data source name not found and no default driver specified
Cannot open share library: libodbc.sl
ORA-12203: Unable to connect to destination
ORA-01017: invalid username/password; logon denied

Troubleshooting the Issue

Some common reasons that setup/connection issues occur are:

The library path environment variable is not set correctly for the ODBC drivers:
PATH on Windows
LD_LIBRARY_PATH on Solaris and Linux
LIBPATH on AIX
SHLIB_PATH on HP
The database and/or listener are not started.
The ODBCINI environment variable is not set correctly for the ODBC drivers on UNIX and Linux.
The ODBC driver's connection attributes are not set correctly in the system information file on UNIX and Linux (refer to "Data Source Configuration" in "Configuring the Product on UNIX/Linux" of the DataDirect Connect for ODBC and Connect XE for ODBC User's Guide). For example, the host name or port number are not correctly configured. Refer to individual driver chapters in the DataDirect Connect for ODBC and Connect XE for ODBC User's Guide for a list of connection string attributes that are required for each driver to connect properly to the underlying database.

For UNIX and Linux users: Refer to "Configuring the Product on UNIX/Linux" in the DataDirect Connect for ODBC and Connect XE for ODBC User's Guide for more information. See also "The ivtestlib Tool" for information about a helpful diagnostic tool.