Net Service Names and the tnsnames.ora File
The installation process creates a tnsnames.ora file on each node. This file acts as a repository of net service names. Each net service name is associated with a connect identifier. A connect identifier is an identifier that maps a user-defined name to a connect descriptor.
A connect descriptor contains the following information:
-
The network route to the service, including the location of the listener through a protocol address
-
The
SERVICE_NAMEparameter, with the value set to the name of a database serviceNote:
The
SERVICE_NAMEparameter that you use in thetnsnames.orafile is singular, because you can specify only one service name. TheSERVICE_NAMEparameter is not the same as theservice_namesdatabase initialization parameter. Theservice_namesdatabase parameter defaults to the global database name, a name comprising thedb_nameanddb_domainparameters in the initialization parameter file. When you add service names using SRVCTL or Oracle Enterprise Manager Cloud Control, it lists additional cluster-managed services for the database.
The tnsnames.ora file is located in both the Grid_home/network/admin and Oracle_home/network/admin directories. By default, the tnsnames.ora file is read from the Grid home when Oracle Grid Infrastructure is installed.
With Oracle Clusterware 11g Release 2 and later, the listener association no longer requires tnsnames.ora file entries. The listener associations are configured as follows:
-
DBCA no longer sets the
LOCAL_LISTENERparameter. The Oracle Clusterware agent that starts the database sets theLOCAL_LISTENERparameter dynamically, and it sets it to the actual value, not an alias. Solistener_aliasentries are no longer needed in thetnsnames.orafile. -
The
REMOTE_LISTENERparameter is configured by DBCA to reference the SCAN and SCAN port, without any need for atnsnames.oraentry. Oracle Clusterware uses the Easy Connect naming method withscanname:scanport, so no listener associations for theREMOTE_LISTENERparameter are needed in thetnsnames.orafile.
For example, after you create the database, to add a second listener, listening on port 2012, use a command similar to the following command to have the database register with both listeners on startup:
SQL> alter system set local_listener='(DESCRIPTION=
(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.0.61)(PORT=1521))
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.0.61)(PORT=2012))))'
scope=BOTH SID='OCRL1';See Also:
-
Oracle Database Net Services Administrator's Guide for more information about the
tnsnames.orafile
Parent topic: Oracle Net Services Configuration Files and Parameters