8 Oracle Connection Manager Parameters (cman.ora)

ADDRESS

Purpose

Use the ADDRESS listening endpoint parameter to specify the protocol address of Oracle Connection Manager.

Syntax

(ADDRESS= ...)

Example (Default)

(ADDRESS=(PROTOCOL=tcp)(HOST=local_host)(PORT=1521))

ASO_AUTHENTICATION_FILTER

Use the ASO_AUTHENTICATION_LEVEL parameter to specify whether Oracle Advanced Security authentication settings must be used by the client. The global setting can be overridden by a rule-level setting in ACTION_LIST. This parameter accepts the following values:

• on to instruct Oracle Connection Manager to reject connect requests that are not using Secure Network Services (SNS). SNS is part of the Oracle Advanced Security.

• off (default) to instruct Oracle Connection Manager not to check for SNS between the client and server

CONNECTION_STATISTICS

Use the CONNECTION_STATISTICS parameter to specify whether the SHOW_CONNECTIONS command displays connection statistics. The global setting can be overridden by a rule-level setting in ACTION_LIST. This parameter accepts the following values:

• yes to display statistics

• no (default) to not display statistics

EVENT_GROUP

Use the EVENT_GROUP parameter to specify which event groups are logged. Multiple events may be designated using a comma-separated list. This parameter accepts the following values:

• INIT_AND_TERM—initialization and termination

• MEMORY_OPS—memory operations

• CONN_HDLG—connection handling

• PROC_MGMT—process management

• REG_AND_LOAD—Registration and load update

• WAKE_UP—events related to CMADMIN wakeup queue

• TIMER—gateway timeouts

• CMD_PROC—command processing

• RELAY—events associated with connection control blocks

IDLE_TIMEOUT

Use the IDLE_TIMEOUT parameter to specify the amount of time that an established connection can remain active without transmitting data. The global setting can be overridden by a rule-level setting in ACTION_LIST. This parameter accepts the following values:

0 (default) to disable the timeout

n>0 to enable the timeout, where n equals the timeout period in seconds

INBOUND_CONNECT_TIMEOUT

Use the INBOUND_CONNECT_TIMEOUT parameter to specify how long the Oracle Connection Manager listener waits for a valid connection from a client or another instance of Oracle Connection Manager. This parameter accepts the following values:

60 (default) to disable the timeout

n>0 to enable the timeout, where n equals the timeout period in seconds

MAX_CMCTL_SESSIONS

Use the MAX_CMCTL_SESSIONS parameter to specify the maximum number of concurrent local or remote sessions of the Oracle Connection Manager control utility allowable for a given instance. One of these sessions must be a local session. Any number of sessions can be designated.

MAX_CONNECTIONS

Use the MAX_CONNECTIONS parameter to specify the maximum number of connection slots that a gateway process can handle.

This parameter accepts a range of:

1 to 1024

MAX_GATEWAY_PROCESSES

Use the MAX_GATEWAY_PROCESSES parameter to specify the maximum number of gateway processes that an instance of Oracle Connection Manager supports. The maximum is 64. The number designated must be greater than the minimum number of gateway processes.

MIN_GATEWAY_PROCESSES

Use the MIN_GATEWAY_PROCESSES parameter to specify the minimum number of gateway processes that an instance of Oracle Connection Manager must support. Any number of sessions can be designated up to 64.

OUTBOUND_CONNECT_TIMEOUT

Use the OUTBOUND_CONNECT_TIMEOUT parameter to specify the length of time that the Oracle Connection Manager instance waits for a valid connection to be established with the database server or with another Oracle Connection Manager instance. This parameter accepts the following values:

60 (default) to disable the timeout

n>0 to enable the timeout, where n equals the timeout period in seconds

PASSWORD_instance_name

Use the PASSWORD_instance_name parameter to specify the encrypted instance password, if one has been set.

REMOTE_ADMIN

Use the parameter REMOTE_ADMIN to specify whether or not remote access to an Oracle Connection Manager is allowed. This parameter accepts the following values:

• yes to allow access from a remote Oracle Connection Manager Control utility session to Oracle Connection Manager

• no to allow only access to the local Oracle Connection Manager. This value prevents a user running a remote Oracle Connection Manager Control utility from accessing Oracle Connection Manager.

  See Also:

  "Distributed Operations" for configuration details

RULE

Purpose

Use the RULE rule list parameter to specify an access control rule list to filter incoming connections. A rule list specifies which connections are accepted, rejected, or dropped.

This parameter is listed in the rule list section of the cman.ora file preceded by RULE_LIST=.

Syntax

(RULE_LIST=
  (RULE=
    (SRC=host)
    (DST=host)
    (SRV=service_name)
    (ACT={accept|reject|drop})
    (ACTION_LIST=AUT={on|off}
    ((CONN_STATS={yes|no})(MCT=time)(MIT=time)(MOCT=time)))
  (RULE= ...))

Subparameters

The RULE parameter filters a connection or group of connections using the following subparameters:

SRC: Specify the source host name or IP address in dot notation of the client.

DST: Specify the destination server host name or IP address in dot notation of the database server.

SRV: Specify database service name of the Oracle Database 10g, Oracle9i, or Oracle8 database (obtained from the SERVICE_NAME parameter in the initialization parameter file).

ACT: Specify accept to accept incoming requests or reject to reject incoming requests.

ACTION_LIST: Specify rule-level parameter settings for some parameters. These parameters are as follows:

• AUT—Oracle Advanced Security authentication on client side

• CONN_STATS—log input and output statistics

• MCT—maximum connect time

• MIT—maximum idle timeout

• MOCT—maximum outbound connect time

Rule-level parameters override their global counterparts.

Usage Notes

• If no rules are specified, all connections are rejected.

• The source and destination can be a host name, IP address, or subnet mask.

• You must enter at least one rule for client connections and one rule for CMCTL connections. Omitting one or the other results in the rejection of all connections for the rule type omitted. The last rule in the example that follows is a CMCTL rule.

• If the CMCTL connection is remote, the REMOTE_ADMIN parameter in cman.ora must be set to on, regardless of the rules specified.

• Oracle Connection Manager does not support wildcards for partial IP addresses. If you use a wildcard, use it in place of a full IP address. The IP address of the client may, for example, be (SRC=*).

• Oracle Connection Manager supports only the /nn notation for subnet addresses. In the first rule in the example, /27 represents a subnet mask that comprises 27 left-most bits.

Example

(RULE_LIST=
  (RULE=
    (SRC=client1-pc)
    (DST=sales-server)
    (SRV=sales.us.acme.com)
    (ACT=reject))
  (RULE=
    (SRC=144.25.23.45)
    (DST=144.25.187.200)
    (SRV=db1)
    (ACT=accept))
  (RULE=
    (SRC=foo)
    (DST=foobar)
    (SRV=cmon)
    (ACT=accept)))

SESSION_TIMEOUT

Use the SESSION_TIMEOUT parameter to specify the maximum time allowed for a user session. The global setting can be overridden by a rule-level setting in ACTION_LIST. This parameter accepts the following values:

0 (default) to disable the timeout

n>0 to enable the timeout, where n equals the timeout period in seconds

ADR Diagnostic Parameters in cman.ora

This section lists the parameters used when ADR is enabled (when DIAG_ADR_ENABLED is set to on):

• ADR_BASE

• DIAG_ADR_ENABLED

• LOG_LEVEL

• TRACE_LEVEL

• TRACE_TIMESTAMP

ADR_BASE=/oracle/network/trace

DIAG_ADR_ENABLED=on

LOG_LEVEL=admin

TRACE_LEVEL=admin

on

TRACE_TIMESTAMP=true

Non-ADR Diagnostic Parameters in cman.ora

This section lists the parameters used when ADR is disabled (when DIAG_ADR_ENABLED is set to off):

• LOG_DIRECTORY

• TRACE_DIRECTORY

• TRACE_FILELEN

• TRACE_FILENO

LOG_DIRECTORY=

TRACE_DIRECTORY=/oracle/network/admin/trace

TRACE_FILELEN=100

1

TRACE_FILENO=3