Oracle9i Net Services Reference Guide Release 2 (9.2) Part Number A96581-01 |
|
This chapter provides a complete listing of the names.ora
file configuration parameters.
This chapter contains these topics:
Oracle Names server configuration, stored in the names.ora
file, consists of the following elements:
By default, names.ora
is located in the $ORACLE_HOME/network/admin
directory on UNIX operating systems and the ORACLE_HOME
\network\admin
directory on Windows NT. names.ora
can also be stored the following locations:
TNS_ADMIN
environment variable or registry value/var/opt/oracle
.
Figure 10-1 shows a names.ora
file for an Oracle Names server named namesvr2.us.acme.com
.
NAMES.SE
RVER_NAME=namesvr2.us.acme.comNAMES.ADDRESSES=
(ADDRESS=(PROTOCOL=tcp
)(HOST=namesvr2-server)(PORT=1575))NAMES.ADMIN_REGION=
(REGION=
(DESCRIPTION=
(ADDRESS=(PROTOCOL=tcp
)(HOST=sales-server)(PORT=1521))(CONNECT_DATA=
(SERVICE_NAME=sales.us.acme.com))
(USERID=
system) (PASSWORD=manager) (NAME=local_region)(REFRESH=86400)
(RETRY=60)
(EXPIRE=600))
NAMES.DOMAIN_HINTS= (HINT_DESC= (HINT_LIST= (HINT= (NAME=namesvr1) (ADDRESS=(PROTOCOL=tcp)(HOST=namesvr1-server)(PORT=1575))NAMES.DOMAINS=
(DOMAIN=
(NAME=us.acme.com)
(MIN_TTL=
86400))
This section lists and describes the names.ora
file parameters.
Use the parameter NAMES.ADDRESSES
to list the protocol addresses on which the Oracle Names server listens. Any valid ADDRESS
or ADDRESS_LIST
is allowed.
See Also:
|
NAMES.ADDRESSES= [(ADDRESS_LIST=] (ADDRESS=...) (ADDRESS=...)[)]
NAMES.ADDRESSES= (ADDRESS=(PROTOCOL=tcp)(HOST=namesvr-server)(PORT=1575))
NAMES.ADDRESSES= (ADDRESS_LIST= (ADDRESS=(PROTOCOL=tcp)(HOST=namesrv2-server)(PORT=1575)) (ADDRESS=(PROTOCOL=tcp)(HOST=namesrv2-server)(PORT=1375)))
Use the parameter NAMES.ADMIN_REGION
to specify the data source for an administrative region.
NAMES.ADMIN_REGION= (REGION= (DESCRIPTION= (ADDRESS=...) (CONNECT_DATA=(SERVICE_NAME|SID=service_name
|sid
))) (USERID=user) (PASSWORD=password) (REFRESH=seconds) (RETRY=seconds) (EXPIRE=seconds) (VERSION=version) (TYPE=ldap|ldif) (HOST=directory_host) (PORT=port
) (TIMEOUT=time
) (SUBTREE_LIST= (SUBTREE=(BASE=base_DN)[(SCOPE=sub|one)))
REGION
supports the following subparameters:
DESCRIPTION
: Specify the connect descriptor that the Oracle Names server uses to connect to the region database.
USERID
: If loading data from the region database, specify a database user. If loading restricted data from a LDAP-compliant directory server, specify a directory user with read privileges in the form of a distinguished name (DN).
PASSWORD
: Specify the password for the database user or directory user.
REFRESH
: Specify the interval in seconds when the local Oracle Names server's memory cache (not the cache checkpoint file) will be refreshed from the region database.
The interval value for this parameter is irrelevant for Oracle Names LDAP Proxy servers, because the directory has no mechanism for enabling the Oracle Names LDAP Proxy server to determine if there is new data. Even if this parameter is specified, an Oracle Names LDAP Proxy server always has a reload interval of 248 days, 13 hours, and 20 minutes
RETRY
: Specify the interval in seconds the Oracle Names server will wait after a failure to connect to the region database before trying again.
EXPIRE
: Specify the time in seconds to wait before terminating the retry attempt.
VERSION
: Specify an arbitrary value. Even though the value is irrelevant, this parameter is still necessary.
The following parameters are reserved for Oracle Names LDAP Proxy servers:
TYPE
: Specify how the Oracle Names LDAP Proxy server is to load data from a directory server. This parameter supports the following values:
ldap
: Specifies that the Oracle Names LDAP Proxy server is to load data directly from a directory server
ldif
: Specifies that the Oracle Names LDAP Proxy server is to use data from an LDAP Data Interchange Format (LDIF) file
The following subparameters are for (TYPE=ldap)
:
HOST
: Specify the directory server host name.
PORT
: Specify the listening TCP/IP port for the directory server. If you do not specify this option, the default port (389) is used.
TIMEOUT
: Specify the time limit in seconds in which the Oracle Names LDAP Proxy server can spend performing a search of directory objects. This time limit cannot be greater than the time limit set for searches in the directory server. By default, the time limit is set to 10 seconds, which is sufficient for most searches.
SUBTREE_LIST
| SUBTREE
: Use the SUBTREE
parameter to specify the DN. Use the SUBTREE_LIST
parameter if there are multiple DNs. The SUBTREE
parameter supports the following subparameters:
BASE
: Specify a subtree location in the directory information tree (DIT) from which the Oracle Names Proxy server should load data. The location is specified as a DN of a LDAP directory entry. The Oracle Names Proxy loads directory naming data from one or more Oracle Contexts located in the subtree following the entry specified.
SCOPE
: Specifies where the Oracle Names Proxy server looks for directory data to load. one
(default) specifies that the Oracle Names Proxy server look only in one Oracle Context directly following the entry specified in the BASE
parameter. sub
specifies the Oracle Names Proxy server look in all the Oracle Contexts in the subtree following the entry specified in the BASE
parameter.
See Also:
Oracle9i Net Services Administrator's Guide for more information about configuring the |
NAMES.ADMIN_REGION= (REGION= (DESCRIPTION= (ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=1575)) (CONNECT_DATA=(SERVICE_NAME=sales.us.acme.com))) (USERID=system) (PASSWORD=manager) (REFRESH=172800) (RETRY=2700) (EXPIRE=8700) (VERSION=34619392))
Use the parameter NAMES.AUTHORITY_REQUIRED
to specify whether or not system queries require authoritative answers.
false
NAMES.AUTHORITY_REQUIRED=true
Use the parameter NAMES.AUTO_REFRESH_EXPIRE
to specify the amount of time, in seconds, for the Oracle Names server to cache other region's database server addresses which have been obtained through the NAMES.DOMAIN.HINTS
parameter. At the end of this interval, the Oracle Names server issues a query to the other region database servers to refresh the address.
600
60
to 1209600
NAMES.AUTO_REFRESH_EXPIRE=1200000
Use the parameter NAMES.AUTO_REFRESH_RETRY
to specify the interval, in seconds, that the Oracle Names server retries the other Oracle Names servers on its domain hint list.
180
60
3600
NAMES.AUTO_REFRESH_RETRY=180
Use the parameter NAMES.CACHE_CHECKPOINT_FILE
to specify the name and directory path of the file to which the Oracle Names server writes its checkpoint file.
The $ORACLE_HOME/network/names/ckpcch.ora
file on UNIX operating systems and the ORACLE_HOME
\network\names\ckpcch.ora
file on Windows NT
NAMES.CACHE_CHECKPOINT_FILE=c:\oracle\network\names\cacheck.ora
Use the parameter NAMES.CACHE_CHECKPOINT_INTERVAL
to specify the interval, in seconds, in which the Oracle Names server writes a checkpoint of its stored data to a checkpoint file. Each Oracle Names server can periodically write its cached data to a file to protect against startup failures.
0
(disabled)
10
259200
(3 days)
NAMES.CACHE_CHECKPOINT_INTERVAL=24
Use the parameter NAMES.CONFIG_CHECKPOINT_FILE
to specify the name and directory path of the file used to checkpoint Oracle Names server configuration settings.
The $ORACLE_HOME/network/names/ckpcfg.ora
file on UNIX operating systems and the ORACLE_HOME
\network\names\ckpcfg.ora
file on Windows NT
NAMES.CONFIG_CHECKPOINT_FILE=c:\oracle\network\names\configck.ora
Use the parameter NAMES.CONNECT_TIMEOUT
to specify the amounts of time, in seconds, for the Oracle Names server to wait for the connection from a client to complete.
3
1
600
NAMES.CONNECT_TIMEOUT=8
Use the parameter NAMES.DEFAULT_FORWARDERS
to provide an address list of other Oracle Names servers used to forward queries.
NAMES.DEFAULT_FORWARDERS=
(FORWARDER_LIST=
(NAME=onames_server)
(ADDRESS=...))
FORWARDER_LIST
supports the following subparameters:
NAME
: Specify the Oracle Names server name to forward queries.
ADDRESS
: Specify the protocol address of the Oracle Names server.
See Also:
"Protocol Parameters" for descriptions of the correct parameters to use for each protocol |
NAMES.DEFAULT_FORWARDERS= (FORWARDER_LIST= (FORWARDER= (NAME=rootserv1.com) (ADDRESS=(PROTOCOL=tcp)(HOST=root-server)(PORT=4200))))
Use the parameter NAMES.DEFAULT_FORWARDERS_ONLY
to specify how the Oracle Names server forwards queries.
When you set the parameter to true
, the Oracle Names server forwards queries only to those Oracle Names servers listed as default forwarders with the NAMES.DEFAULT_FORWARDERS
parameter. When you set the parameter to false
, the Oracle Names server calls the Oracle Names servers listed as default forwarders before other Oracle Names servers found in the cache.
false
NAMES.DEFAULT_FORWARDERS_ONLY=c:\oracle\network\names\domainck.ora
Use the parameter NAMES.DOMAIN_CHECKPOINT_FILE
to specify the name and path of the file used for checkpoint authoritative domain data.
The $ORACLE_HOME/network/names/ckpdom.ora
file on UNIX operating systems and the ORACLE_HOME
\network\names\ckpdom.ora
file on Windows NT
NAMES.DOMAIN_CHECKPOINT_FILE=c:\oracle\network\names\domainck.ora
Use the parameter NAMES.DOMAINS
to provide a list of domains in the Oracle Names server's local region, as well as the default time to live (TTL) in seconds for data in those domains.
NAMES.DOMAINS=
(DOMAIN_LIST=
(DOMAIN=
(NAME=
domain)
(MIN_TTL=
ttl))
NAMES.DOMAINS
supports the following subparameters:
In the following example, NAMES.DOMAINS
contains a listing for the root (value of null), com
, acme.com
, and hq.oracle.com
domains. All the domain precedent to hq.acme.com
must be defined in order to define hq.acme.com
.
NAMES.DOMAINS=
(DOMAIN_LIST=
(DOMAIN=
(NAME=)
(MIN_TTL=
86400))(DOMAIN=
(NAME=com)
(MIN_TTL=
86400))(DOMAIN=
(NAME=acme.com)
(MIN_TTL=
86400))(DOMAIN=
(NAME=hq.acme.com)
(MIN_TTL=
86400)))
Use the parameter NAMES.DOMAINS_HINTS
in one of two ways:
NAMES.DOMAINS_HINTS
supports the following subparameters:
HINT_LIST
: Specify a list of hints. Each hint contains the name and address of Oracle Names server in a remote administrative region. HINT_LIST
uses the following syntax:
(HINT_LIST= (HINT=(NAME=onames_server)(ADDRESS=...)))
DOMAIN_LIST
: Specify the list of remote domains. DOMAIN_LIST
uses the following syntax:
(DOMAIN_LIST= (DOMAIN=domain))
See Also:
Oracle9i Net Services Administrator's Guide for usage notes |
In the following example, NAMES.DOMAIN_HINTS
contains a domain hint for Oracle Names server rootsvr.com
that is located in the root domain of the remote administrative region. The DOMAIN
parameter is left null, meaning that the hint is for the root domain.
NAMES.DOMAIN_HINTS= (HINT_DESC= (HINT_LIST= (HINT= (NAME=rootsvr.com) (ADDRESS=(PROTOCOL=tcp)(HOST=root-server)(PORT=1575)))) (DOMAIN_LIST= (DOMAIN=)))
The following example shows a hint to query two domains, the root domain and the us.acme.com
domain, for Oracle Names servers rootsvr.com
and namesvr.us.acme.com
.
NAMES.DOMAIN_HINTS= (HINT_DESC= (HINT_LIST= (HINT= (NAME=rootsvr.com) (ADDRESS=(PROTOCOL=tcp)(HOST=root-server)(PORT=1575))) (HINT= (NAME=namesrv.us.acme.com) (ADDRESS=(PROTOCOL=tcp)(HOST=hr-server)(PORT=1575)))) (DOMAIN_LIST= (DOMAIN=) (DOMAIN=us.acme.com)))
Use the parameter NAMES.FORWARDING_AVAILABLE
to specify how the Oracle Names server forwards client requests.
When you set the parameter to on
, the Oracle Names server forwards client requests to remote Oracle Names server. When you set the parameter to off
, clients outside the local domain without access to the network are unable to resolve names.
on
on
| off
NAMES.FORWARDING_AVAILABLE=off
Use the parameter NAMES.FORWARDING_DESIRE
to specify how the Oracle Names server handles requests for remote Oracle Names servers.
When you set the parameter to true
, the Oracle Names server provides protocol address of remote Oracle Names server to clients. This way, clients are redirected to the appropriate Oracle Names server. When you set the parameter to false
, the Oracle Names server connects to the remote Oracle Names server on behalf of clients.
true
true
| false
NAMES.FORWARDING_DESIRED=true
Use the parameter NAMES.KEEP_DB_OPEN
to specify whether to attempt to keep the connection to the region database open between operations.
When you set the parameter to true
, the connection is left open after each load, reload, or reload-check. When you set the parameter to false
, the connection is closed after each load, reload, or reload-check.
true
true
| false
NAMES.KEEP_DB_OPEN=false
Use the parameter NAMES.LOG_DIRECTORY
to specify the destination directory where the log file for Oracle Names server operational events are written
The $ORACLE_HOME/network/log
directory on UNIX operating systems and the ORACLE_HOME
\network\log
directory on Windows NT
NAMES.LOG_DIRECTORY=c:\oracle\network\names
Use the parameter NAMES.LOG_FILE
to indicate the name of the output file to which Oracle Names server operational events are written. The file name extension is always .log
. Do not enter an extension for this parameter.
names
NAMES.LOG_FILE=onames
Use the parameter NAMES.LOG_STATS_INERVAL
to specify the number of seconds between full statistical dumps in the log file.
0 (disabled)
10 seconds
none
NAMES.LOG_STATS_INTERVAL=12
Use the parameter NAMES.LOG_UNIQUE
to indicate whether or not log files are given unique names.
When you set the parameter to on
, a process identifier is appended to the name of each log file generated, allowing multiple log files to coexist. For example, log files named names
pid
.log
are created if the default log file name, names.log
, is used.
false
true
| false
NAMES.LOG_UNIQUE=true
Use the parameter NAMES.MAX_OPEN_CONNECTIONS
to specify the number of connections that the Oracle Names server can have open at any given time. The value is generated as the value 10 or the sum of one connection for listening, 5 for clients, plus one for each remote domain defined in the local administrative region, whichever is greater.
The calculated value is acceptable for most installations.
Calculated based on entered data.
2
64
NAMES.MAX_OPEN_CONNECTIONS=52
Use the parameter NAMES.MAX_REFORWARDS
to specify the maximum number of times the Oracle Names server attempts to forward an operation.
2
1
15
NAMES.MAX_REFORWARDS=2
Use the parameter NAMES.MESSAGE_POOL_START_SIZE
to determine the initial number of messages allocated in the Oracle Names server's message pool that are used for incoming or outgoing forwarded messages.
10
3
256
NAMES.MESSAGE_POOL_START_SIZE=10
Use the parameter NAMES.NO_MODIFY_REQUESTS
to allow or disallow operations that modify data in the Oracle Names server's region.
When the parameter NAMES.NO_MODIFY_REQUESTS
is set to true
, the Oracle Names server refuses any operations that modify data in its region. When the parameter NAMES.NO_MODIFY_REQUESTS
is set to false
, the Oracle Names server accepts operations that modify data in its region.
false
true
| false
NAMES.NO_MODIFY_REQUESTS=true
Use the parameter NAMES.NO_REGION_DATABASE
to enable or disable the Oracle Names server from loading data from a region database.
When you set the parameter to true
, the Oracle Names server does not load data from a region database. Instead, it loads data from its checkpoint files. When you set the parameter to false
, the Oracle Names server loads data from a region database.
false
true
| false
NAMES.NO_REGION_DATABASE=true
Use the parameter NAMES.PASSWORD
to set an encrypted password for an Oracle Names server, so that certain privileged operations, such as STOP
, RESTART
and RELOAD
, used from the Oracle Names Control utility are secure.
If this parameter is set with Oracle Net Manager, then the password is encrypted. A clear-text password can be made manually. If the password is clear-text, ensure that the NAMESCTL.INTERNAL_ENCRYPT_PASSWORD
parameter in the sqlnet.ora
file is set to false
.
None
NAMES.PASSWORD=625926683431aa55
Use the parameter NAMES.RESET_STATS_INTERVAL
to specify the number of seconds during which the statistics collected by the Oracle Names servers should accumulate. At the frequency specified, they are reset to 0. The default value of 0 means never reset statistics.
0
(never reset)
10
None
NAMES.RESET_STATS_INTERVAL=15
Use the parameter NAMES.SAVE_CONFIG_ON_STOP
to specify whether or not runtime configuration changes are saved into the names.ora
file.
When you set the parameter to true
, the Oracle Names Control utility saves runtime configuration changes to names.ora
file. Any parameters which were modified through Oracle Names Control utility SET
operations replace prior names.ora
settings. When you set the parameter to false
, the Oracle Names Control utility does not save runtime configuration changes to the names.ora
file.
false
NAMES.SAVE_CONFIG_ON_STOP=false
Use the NAMES.SERVER_NAME
parameter to uniquely identify an Oracle Names server by a name. All configuration references to a particular Oracle Names server use this name.
ONAMES_
onames_server
NAMES.SERVER_NAME=namesrv1.us.acme.com
Use the parameter NAMES.TOPOLOGY_CHECKPOINT_FILE
to specify the name and path of the file used for checkpoint topology data. This file defines the domains in the administrative region and the Oracle Names servers authoritative for each domain. Specifically, topology data consists of:
NS.SMD
record types that are authoritative for the domainA.SMD
record type and listening protocol addressesThe $ORACLE_HOME/network/names/ckptop.ora
file on UNIX operating systems and the ORACLE_HOME
\network\names\ckptop.ora
on Windows NT
NAMES.TOPOLOGY_CHECKPOINT_FILE=c:\oracle\network\names\topck.ora
Use the parameter NAMES.TRACE_DIRECTORY
to specify the destination directory of the output trace files from Oracle Names trace sessions.
The $ORACLE_HOME/network/trace
directory on UNIX operating systems and the ORACLE_HOME
/network/trace
directory on Windows NT
NAMES.TRACE_DIRECTORY=/oracle/network/admin/trace
Use the parameter NAMES.TRACE_FILE
to specify the name of the output trace files for Oracle Names trace sessions. The file name extension is always .trc
.
names
NAMES.TRACE_FILE=onames
Use the parameter NAMES.TRACE_FUNC
to enable the internal mechanism to control tracing by a function name.
false
NAMES.TRACE_FUNC=false
Use the parameter NAMES.TRACE_LEVEL
to turn Oracle Names tracing on, at a specific level, or off.
off
off
for no trace outputuser
for user trace informationadmin
for administration trace informationsupport
for Oracle Support Services trace informationNAMES.TRACE_LEVEL=admin
Use the parameter NAMES.TRACE_UNIQUE
to indicate whether or not trace files are given unique names. When the value is set to on
, a process identifier is appended to the name of the trace file generated, allowing multiple trace files to coexist.
For example, trace files named names
pid
.trc
are created if the default trace file name, names.trc
, is used.
on
on
| off
NAMES.TRACE_UNIQUE=on
|
![]() Copyright © 2001, 2002 Oracle Corporation. All Rights Reserved. |
|