Oracle Net8 Administrator's Guide Release 8.0 A58230-01 |
|
A complete listing of all Net8 configuration parameters is provided for your reference. The following sections appear in this Appendix:
The configuration files in a Net8 network consist of parameters which include keyword-value pairs. Keyword-value pairs are surrounded by parentheses:
parameter = (keyword=value)
Some keywords have other keyword-value pairs as their values:
(keyword= (keyword=value) (keyword=value) )
For example, the address portion of a local naming configuration file (TNSNAMES.ORA) might include the following lines:
(ADDRESS= (PROTOCOL=tcp) (HOST=max) (PORT=1521) )
Set up configuration files so that indentation reflects what keyword is the "parent" or "owner" of other keyword-value pairs. This format is not required, but it does make the files much easier to read and understand.
Even if you do not choose to indent your files in this way, you must indent a wrapped line by at least one space, or it will be misread as a new parameter. The following layout is acceptable:
(ADDRESS=(PROTOCOL=tcp) (HOST=max.world)(PORT=1521))
The following layout is not acceptable:
(ADDRESS=(PROTOCOL=tcp) (HOST=max.world)(PORT=1521))
The following rules apply to the syntax of configuration files:
(ADDRESS = (PROTOCOL = TCP) (HOST = MARTHA.WORLD) (PORT = 1521) ) (ADDRESS = (PROTOCOL = TCP) (PORT = 1521) (HOST = MARTHA.WORLD) )
The network character set for keyword values consists of the following characters. Connect descriptors must be made up of single-byte characters.
A-Z, a-z
0-9
( ) < > / \
, . : ; ' " = - _
$ + * # & ! % ? @
Within this character set, the following symbols are reserved:
( ) = \ " ' #
Reserved symbols are used as delimiters, not as part of a keyword or a value unless the keyword or value is quoted. Either single or double quotes can be used to enclose a value containing reserved symbols. To include a quote within a value that is surrounded by quotes, use different quote types. The backslash (\) is used as an escape character.
A specific example of the use of reserved symbols is a numeric DECnet object within an address. An OBJECT can be a name such as ABC or #123. These would be entered in the form:
or
Because the "#" sign is a reserved symbol, the character must be preceded by a backslash.
The following characters may be used within a connect descriptor, but not in a keyword or value:
The listener name, service name, and Oracle Connection Manager names are limited to the following character set:
[a...z] [A...Z] [0...9] _
The first character must be an alphabetical character. The number of characters allowed is platform specific. In general, up to 64 characters is acceptable. A database service name must match the global database name defined by the database administrator, which consists of a database name (originally limited to eight characters), and the database domain. Service names and global database names are not case sensitive.
The following parameters are available in a profile. Profiles are stored in a configuration file called SQLNET.ORA.
AUTOMATIC_IPC | |
---|---|
Purpose: |
Forces the session to use or not use IPC addresses on your node. |
Default Value: |
OFF |
Available Values: |
|
Example: |
automatic_ipc=off |
BEQUEATH_DETACH | |
---|---|
Purpose: |
Turn on/off signal handling in Net8 on UNIX systems. |
Default Value: |
NO which leaves signal handling on. |
Available Values: |
|
Example: |
bequeath_detach=yes |
DAEMON.TRACE_LEVEL | |
---|---|
Purpose: |
Turns tracing on/off to a certain specified level for the Oracle Enterprise Manager daemon. |
Default Value: |
OFF |
Available Values |
|
Example: |
daemon.trace_level=user |
LOG_FILE_CLIENT | |
---|---|
Purpose: |
Controls the log output filename for an Oracle client. |
Default Value: |
SQLNET.LOG |
Example: |
log_file_client=client |
LOG_FILE_SERVER | |
---|---|
Purpose: |
Controls the log output filename for an Oracle server. |
Default Value: |
SQLNET.LOG |
Example: |
log_file_server=svr |
NAMES.DCE.PREFIX | |
---|---|
Purpose: |
Specifies the DCE cell name (prefix) to use for name lookup. |
Default Value: |
/.:/subsys/oracle/names |
Example: |
names.dce.prefix=/.:/subsys/oracle/names |
NAMES.NDS.NAME_CONTEXT | |
---|---|
Purpose: |
Specifies the default NDS name context in which to look for the name to be resolved |
Default Value: |
operating system specific |
Example: |
names.nds.name_context=<nds name> |
NAMES.NIS.META_MAP | |
---|---|
Purpose: |
Specifies the file to be used to map NIS attributes to an NIS mapname. |
Default Value: |
sqlnet.maps |
Example: |
names.nis.meta_map=sqlnet.maps |
NAMESCTL.INTERNAL_USE | |
---|---|
Purpose |
If set to TRUE, NAMESCTL enables a set of internal undocumented commands. All internal commands are preceded by an underscore in order to distinguish them as internal. |
NAMESCTL.TRACE_LEVEL | |
---|---|
Purpose: |
Indicates the level at which the NAMESCTL program should be traced. |
Default Value: |
OFF |
Values: |
OFF, USER, ADMIN, SUPPORT |
Example: |
namesctl.trace_level=admin |
NAMESCTL.TRACE_FILE | |
---|---|
Purpose: |
Indicates the file in which the NAMESCTL trace output is placed. |
Default Value: |
namesctl_PID.trc |
Example: |
namesctl.trace_file=nmsctl |
OSS.SOURCE.MY_WALLET | |
---|---|
Purpose: |
Defines the method for retrieving and storing the credentials for this Net8 client. |
Example: |
oss.source.my_wallet = (source= (method=oracle) (method_data=/oss/wallet)) |
OSS.SOURCE.LOCATION | |
---|---|
Purpose: |
Defines the method for retrieving encrypted private keys. |
Example: |
oss.source.location= (source= (method=oracle) (method_data= (sqlnet_address=oss))) |
SQLNET.AUTHENTICATION_KERBEROS5_SERVICE | |
---|---|
Purpose: |
Defines the name of the service used to obtain a Kerberos service ticket |
Example: |
sqlnet.authentication_kerberos5_service= oracle |
SQLNET.AUTHENTICATION_GSSAPI_SERVICE | |
---|---|
Purpose: |
Defines the CyberSAFE service principal |
SQLNET.ENCRYPTION_CLIENT | |
---|---|
Purpose: |
Specifies the desired behavior when this client is connecting to a server |
Default Value: |
ACCEPTED |
Available Values: |
|
Example: |
sqlnet.encryption_client=accepted |
SQLNET.ENCRYPTION_SERVER | |
---|---|
Purpose: |
Specifies the desired behavior when a client is connecting to this server |
Default Value: |
ACCEPTED |
Available Values: |
|
Example: |
|
SQLNET.IDENTIX_FINGERPRINT_DATABASE | |
---|---|
Purpose: |
Specifies the service name or alias for the authentication fingerprint database |
Example: |
sqlnet.identix_fingerprint_database = service_name |
SQLNET.IDENTIX_FINGERPRINT_DATABASE_USER | |
---|---|
Purpose: |
Specifies the well known user name for the fingerprint database |
Example: |
sqlnet.identix_fingerprint_database_user = username |
SQLNET.IDENTIX_FINGERPRINT_DATABASE_PASSWORD | |
---|---|
Purpose: |
Specifies the well known password for the fingerprint database |
Example: |
sqlnet.identix_fingerprint_database_password = password |
SQLNET.IDENTIX_FINGERPRINT_METHOD | |
---|---|
Purpose: |
Specifies the method name for the fingerprint database. The method name must be ORACLE |
Example: |
sqlnet.identix_fingerprint_method = oracle |
SQLNET.KERBEROS5_CC_NAME | |
---|---|
Purpose: |
Specifies the complete pathname to the Kerberos credentials cache file. |
Example: |
sqlnet.kerberos5_cc_name= /usr/tmp/krbcache |
SQLNET.KERBEROS5_CLOCKSKEW | |
---|---|
Purpose: |
Specifies how many seconds can pass before a Kerberos credential is considered out of date. |
Default Value |
300 |
Example: |
sqlnet.kerberos5_clockskew = 1200 |
TNSPING.TRACE_DIRECTORY | |
---|---|
Purpose: |
Controls the destination directory of the trace file. |
Default Value: |
$ORACLE_HOME/network/trace |
Example: |
tnsping.trace_directory=/oracle/traces |
TNSPING.TRACE_LEVEL | |
---|---|
Purpose: |
Turns tracing on/off to a certain specified level. |
Default Value: |
OFF |
Available Values |
|
Example: |
tnsping.trace_level=sdmin |
TRACE_DIRECTORY_CLIENT | |
---|---|
Purpose: |
Controls the destination directory of the trace file. |
Default Value: |
$ORACLE_HOME/network/trace |
Example: |
trace_directory_client=/oracle/traces |
TRACE_DIRECTORY_SERVER | |
---|---|
Purpose: |
Controls the destination directory of the trace file. |
Default Value: |
$ORACLE_HOME/network/trace |
Example: |
trace_directory_server=/oracle/traces |
TRACE_FILE_CLIENT | |
---|---|
Purpose: |
Controls the name of the client trace file. |
Default Value: |
SQLNET.TRC |
Example: |
trace_file_client=cli |
TRACE_FILE_SERVER | |
---|---|
Purpose: |
Controls the name of the server trace file. |
Default Value: |
SVR_PID.TRC |
Example: |
trace_file_server=svr |
TRACE_LEVEL_CLIENT | |
---|---|
Purpose: |
Turns tracing on/off to a certain specified level. |
Default Value: |
OFF |
Available Values |
|
Example: |
trace_level_client=user |
TRACE_LEVEL_SERVER | |
---|---|
Purpose: |
Turns tracing on/off to a certain specified level. |
Default Value: |
OFF |
Available Values |
|
Example: |
trace_level_server=admin |
USE_CMAN | |
---|---|
Purpose: |
Forces all sessions to go through Oracle Connection Manager to get to the server. |
Default Value: |
FALSE |
Values: |
TRUE or FALSE |
Example: |
use_cman=true |
USE_DEDICATED_SERVER | |
---|---|
Purpose: |
Forces the listener to spawn a dedicated server process for sessions from this client. |
Default Value: |
OFF |
Values: |
|
Example: |
use_dedicated_server=on |
The following name-value pairs are available in a local names configuration file. Local naming configurations are stored in a file called TNSNAMES.ORA.
DESCRIPTION | |
---|---|
Purpose: |
Beginning of a definition of a database listening address. |
Example: |
service name= (description = (address = ...) (connect_data=(sid=db1)) |
The following parameters are available in the network listener configuration film (LISTENER.ORA).
LOG_FILE_listener_name | |
---|---|
Purpose: |
Specifies the filename where the log information is written |
Default Value: |
listener_name.log |
Example: |
log_file_listener=lsnr |
LOGGING_listener_name | |
---|---|
Purpose: |
Logging is always on unless you provide this parameter and turn logging off. |
Default Value: |
ON |
Available Values |
ON or OFF |
Example: |
logging_listener=off |
PASSWORDS_listener_name | |
---|---|
Purpose: |
Specifies a password to perform certain DBA tasks against the listener using LSNRCTL. |
Default Value: |
NULL |
Example: |
passwords_listener=(super32, sly51) |
TRACE_DIRECTORY_listener_name | |
---|---|
Purpose: |
Controls the destination directory of the trace file. |
Default Value: |
$ORACLE_HOME/network/trace |
Example: |
trace_directory_listener=/oracle/traces |
TRACE_FILE_listener_name | |
---|---|
Purpose: |
Controls the name of the listener trace file. |
Default Value: |
|
Example: |
trace_file_listener=lsnr |
TRACE_LEVEL_listener_name | |
---|---|
Purpose: |
Turns tracing on/off to a certain specified level. |
Default Value: |
OFF |
Available Values |
|
Example: |
trace_level_listener=admin |
The following parameters are available in an Oracle Names configuration file (NAMES.ORA).
NAMES.AUTHORITY_REQUIRED | |
---|---|
Purpose: |
Determines whether system queries require Authoritative answers. |
Default Value: |
FALSE |
Example: |
names.authority_required=true |
NAMES.CONFIG_CHECKPOINT_FILE | |
---|---|
Purpose: |
Name of the file used to checkpoint configuration settings. |
Default Value: |
$ORACLE_HOME/NETWORK/NAMES/CKPCFG.ORA |
Example: |
names.config_checkpoint_file=cache.ckp |
NAMES.FORWARDING_AVAILABLE | |
---|---|
Purpose: |
The server forwards operations to foreign regions if set to TRUE. |
Default Value |
TRUE |
Example: |
names.forwarding_available=false |
NAMES.FORWARDING_DESIRED | |
---|---|
Purpose: |
If set to true, then this server will forward queries. |
Default Value: |
TRUE |
Example: |
names.forwarding_desired=true |
NAMES.LOG_UNIQUE | |
---|---|
Purpose: |
If set to true, then the log filename will be unique and not overwrite existing log files. |
Default Value: |
FALSE |
Example: |
names.log_unique=true |
NAMES.MAX_REFORWARDS | |
---|---|
Purpose: |
The maximum number of times the server attempts to forward an operation. |
Default Value: |
2 |
Minimum Value: |
1 |
Maximum Value: |
15 |
Example: |
names.max_reforwards=2 |
NAMES.NO_MODIFY_REQUESTS | |
---|---|
Purpose: |
If set to true, the server refuses any operations which modify the data in its region. |
Default Value: |
FALSE |
Example: |
names.no_modify_requests=true |
NAMES.NO_REGION_DATABASE | |
---|---|
Purpose: |
If set to true, the server won't look for a region database. |
Default Value: |
FALSE |
Example: |
names.no_region_database=true |
NAMES.TRACE_FILE | |
---|---|
Purpose: |
Indicates the name of the output file from a Names Server trace session. The filename extension is always.trc. |
Default Value: |
names |
Example: |
names.trace_file = filename |
NAMES.TRACE_FUNC | |
---|---|
Purpose: |
Enables internal mechanism to control tracing by function name. |
Default Value: |
FALSE |
Example: |
names.trace_func = false |
NAMES.TRACE_LEVEL | |
---|---|
Purpose: |
Indicates the level at which the Names Server is to be traced. |
Default Value: |
OFF |
Available Values |
|
Example: |
names.trace_level = admin |
The following parameters are available in an Oracle Connection Manager configuration file (CMAN.ORA).
The following parameters in the PROTOCOL.ORA configuration file are applicable to Net8.
protocol.EXCLUDED_NODES | |
---|---|
Purpose: |
Defines which nodes do not have validnode checking. |
Example: |
tcp.excluded_nodes= (hostname or tcp_address, ...) |
protocol.INVITED_NODES | |
---|---|
Purpose: |
Defines which nodes have validnode checking. |
Example: |
tcp.invited_nodes= (hostname or tcp_address, ...) |
protocol.VALIDNODE_CHECKING | |
---|---|
Purpose: |
Restricts session access of clients to destinations with enabling host privilege. |
Default Value: |
NO |
Values: |
|
Example: |
tcp.validnode_checking = yes |