Database Management

Connect to Oracle using name resolution

This article describes how to connect DPA to Oracle instances by name (TNS names or LDAP).

First published date

10/9/2018 3:08 AM

Last published date

7/7/2021 12:09 AM

Overview

For DPA to connect to Oracle instances by name (TNS names or LDAP), the following Oracle Network configuration (.ora) files are required (see file descriptions below):

    tnsnames.ora - required for TNS name resolution
    ldap.ora - required for LDAP name resolution
    sqlnet.ora - required if default domains are used
   
Note: DPA does not support Oracle Names (onames).

Product section

Database Performance Analyzer

Resolution

The files must be created in or copied to the following location:

<ignite_install_directory>/iwc/tomcat/ignite_config/oracle_config

If the DPA server is running on a Linux computer, you can use symbolic links in place of the actual files.

The files can be added and modified while the DPA server is running. The new properties are used on subsequent connection attempts.

Property names in sqlnet.ora and ldap.ora must be upper case or lower case. Mixed case property names are not supported.

DPA supports changing the location of these files to a directory outside of the DPA installation. To use a different directory:

  1. Open the following file in a text editor:
    <ignite_install_directory>/iwc/tomcat/ignite_config/idc/system.properties
  2. Set the property com.confio.ignite.oracleConfigurationDirectory to the path of the desired file directory. Directories in the path must be delimited by a forward slash.  For example:
    com.confio.ignite.oracleConfigurationDirectory=c:/mytnsnamesdir

Notes:

  • If the property does not exist in system.properties, you must add it. 
  • This directory must exist and be accessible by the DPA server process.
  • The DPA server must be restarted to recognize this change. 

sqlnet.ora

Two properties from this file are used by DPA. This file is not required unless a default domain is used for name resolution.

NAMES.DIRECTORY_PATH 
Used to determine if name resolution should first be attempted using LDAP or TNS names. Valid values are LDAP or TNSNAMES, and the default is TNSNAMES. If the primary name resolution is LDAP, SolarWinds recommends that you add the sqlnet.ora file to the directory and set this property to (LDAP).

NAMES.DEFAULT_DOMAIN
If this property is set, all unqualified TNS names are suffixed with this domain.

tnsnames.ora

This file is used to resolve a name as a TNS name alias. Included files (ifile property) are not supported. If NAMES.DEFAULT_DOMAIN property is specified in the sqlnet.ora file, all names are suffixed with this value before the name is resolved.

ldap.ora

This file is used to determine the LDAP server(s) and default admin context that should be used to resolve names through a directory service, such as OID.

At a minimum, the DIRECTORY_SERVERS property must be defined in this file.

This file must be present for DPA to resolve LDAP names.