10.1.5 Configuring Clients for Oracle Connection Manager

To route clients to the database server through Oracle Connection Manager, configure the tnsnames.ora file with a connect descriptor that specifies the protocol address of Oracle Connection Manager. This address enables clients to connect to the Oracle Connection Manager computer. The connect descriptor looks similar to the following:

sales=
  (DESCRIPTION=
    (ADDRESS=
      (PROTOCOL=tcp)
      (HOST=cman-pc)
      (PORT=1521))
    (CONNECT_DATA=
      (SERVICE_NAME=example.com)))

Note:

The Oracle Notification Service (ONS) auto-configuration does not work for connections through Oracle Connection Manager (CMAN). You need to manually configure the ONS and also ensure there is connectivity from client to ONS server on ONS port (6200 is the default port, a different port may have been chosen). Please refer the client-specific developer's guide for information on manual ONS configuration.

• Oracle Universal Connection Pool Developer’s Guide for JDBC clients
• Oracle Call Interface Developer's Guide for OCI clients
• Oracle Data Provider for .NET Developer's Guide for ODP.NET clients

The following procedure describes how to configure a protocol address for Oracle Connection Manager:

1. Start Oracle Net Manager.

   See Also:

   "Using Oracle Net Manager to Configure Oracle Net Services"

2. In the navigator pane, select Service Naming from Directory or Local menus.

3. Click the plus sign (+) on the toolbar, or select Create from the Edit menu.

   The Welcome page of the Net Service Name wizard appears.

4. Enter a name in the Net Service Name field.

5. Click Next.

   The Protocol page appears.

6. Select the TCP/IP protocol for Oracle Connection Manager.

7. Click Next.

   The Protocol Settings page appears.

8. Specify the Oracle Connection Manager port and protocol. The default port number for Oracle Connection Manager is 1521, and the protocol is TCP/IP.

   See Also:

   Oracle Database Net Services Reference for protocol parameter settings

9. Click Next.

   The Service page appears.

10. Enter a service name in the Service Name field, and then select the connection type.

    See Also:

    "About Connect Descriptors" for additional information about setting the service name string

11. Click Next.

    Note:

    Do not click Test, because a connection cannot be tested at this point.

12. Click Finish to save your configuration and close the Net Service Name wizard.

    The new network service name and the Oracle Connection Manager protocol address is added to the Service Naming folder.