7 Managing Oracle Net Services

Learn about the various administration tools of Oracle Net Services, and also explore the command-line control utilities.

This involves the main administration applications, Oracle Enterprise Manager Cloud Control and Oracle Net Manager.

7.1 Using the User Interface Tools

Oracle Net Services provides tools to help you perform configuration and administrative tasks.

7.1.1 Using Oracle Enterprise Manager Cloud Control to Configure Oracle Net Services

Oracle Enterprise Manager Cloud Control enables you to configure Oracle Net Services for any Oracle home across multiple file systems. It also provides common administration functions for listeners. Oracle Enterprise Manager Cloud Control provides an integrated environment for configuring and managing Oracle Net Services.

You can use Oracle Enterprise Manager Cloud Control to configure and administer the following from multiple Oracle homes:

  • Listeners: Configure listeners to receive client connections.

  • Naming: Define connect identifiers and map them to connect descriptors to identify the network location of a service. Oracle Net Manager supports configuration of connect descriptors in local tnsnames.ora files or a centralized directory service.

  • File location: Specify the file location of the Oracle Net configuration files.

See Also:

Oracle Enterprise Manager Cloud Control documentation set and online help for information about using Oracle Enterprise Manager Cloud Control

7.1.1.1 Accessing the Net Services Administration Page

The following procedure describes how to access the Net Services Administration page using Oracle Enterprise Manager Cloud Control:

  1. From the Login to Database page, enter the database credentials, and then click Login.

    The Select Enterprise Manager Home page appears.

  2. Select All Targets from the Targets menu.

  3. Select Listener from the Refine Search list.

  4. Select the listener by double-clicking on the listener name.

  5. Select Net Services Administration from the Oracle Listener menu.

    The Net Services Administration page appears.

From the Net Services Administration page, you can administer the listeners, naming methods, preferences, and so on. The administration procedures are described in other chapters of this book.

7.1.2 Using Oracle Net Manager to Configure Oracle Net Services

Oracle Net Manager enables you to configure Oracle Net Services for an Oracle home on a local client or server host.

You can use Oracle Net Manager to configure the following network components:

  • Listeners: Create and configure listeners to receive client connections.

  • Naming: Define connect identifiers and map them to connect descriptors to identify the network location and identification of a service. Oracle Net Manager supports configuration of connect descriptors in local tnsnames.ora files or a centralized directory service.

  • Naming methods: Configure the ways connect identifiers are resolved to connect descriptors.

  • Profiles: Configure preferences for enabling and configuring Oracle Net features on the client or server.

This section introduces the features of Oracle Net Manager. However, the primary documentation for using Oracle Net Manager is online help.

7.1.2.1 Starting Oracle Net Manager

To start Oracle Net Manager, do the following

  • On Linux, run netmgr from the ORACLE_HOME/bin directory.

  • On Microsoft Windows, select Programs from the Start menu, and then select Oracle - HOME_NAME. Next, select Configuration and Migration Tools, and then Net Manager.

7.1.2.2 Navigating Oracle Net Manager

The Oracle Net Manager interface includes a toolbar and menu options, as well as property sheets for configuring network components.

The navigator pane provides a tree view of network objects and the objects they contain, organized in a folder hierarchy. You can expand and collapse the folders to monitor or manage objects such as connect identifiers, listeners, and profiles. Click an object to make changes to it.

The following are the main folders in the navigator pane:
  • Local

    Displays networking elements configured in local configuration files:

    • Net service names in the tnsnames.ora file

    • Listeners in the listener.ora file

    • Profile in the sqlnet.ora file

  • Directory

    Displays connect identifiers configured in a directory server

7.1.2.3 Using Oracle Net Manager Wizards

The Oracle Net Manager wizards provide step-by-step guidance for tasks. The wizards simplify complex tasks by guiding you through the tasks in manageable steps. The wizards are not intended to provide all configuration options. After you have completed a task with a wizard, use the other components of Oracle Net Manager to modify the configuration.

7.1.2.3.1 Using the Net Service Name Wizard

The Net Service Name wizard guides you through creating a basic network service name in a directory server or a tnsnames.ora file.

The following procedure describes how to start the Net Service Name wizard to create network service names:

  1. In the navigator pane, select Directory or Local, and then select Service Naming.

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

See Also:

Oracle Net Manager online help for detailed information about using the Net Service Name wizard to create a network service name

7.1.2.3.2 Using the Directory Server Migration Wizard

If a tnsnames.ora file already exists, then its network service names can be exported to a directory server with the Directory Server Migration wizard.

The following procedure describes how to use the Directory Server Migration wizard:

  1. Select Directory from the Command menu.

  2. Select Export Net Service Names from the Oracle Net Manager menu.

7.1.3 Deciding When to Use Oracle Enterprise Manager Cloud Control and Oracle Net Manager

Much of the functionality previously available only in Oracle Net Manager has been integrated with Oracle Enterprise Manager Cloud Control. Oracle Enterprise Manager Cloud Control provides the ability to manage configuration for multiple Oracle homes across multiple file systems. Oracle Net Manager only enables you to manage configuration for one Oracle home on a local host computer. The following are the key differences between the tools.

Oracle Enterprise Manager Cloud Control
  • Configure the following features:

    - Local naming (tnsnames.ora files)

    - Directory naming

    - Listeners

  • Provide Oracle home support across multiple file system

  • Provide the ability to search and sort local and directory naming entries

  • Export directory naming entries to a tnsnames.ora file

  • Perform the following administrative tasks for a selected listener:

    - Show current status

    - Change status

    - Change tracing level settings

    - Change logging settings

    - Set connect-time failover and load balancing methods when there is more than one listener

Oracle Net Manager
  • Configure the following features:

    - Local naming (tnsnames.ora files)

    - Directory naming

    - Listeners

    - Profiles

  • Provide Oracle home support for single host

  • Set connect-time failover and load balancing methods when there is more than one listener

  • Set the following options for clients and servers:

    - Tracing settings

    - Logging settings

    - Security, authentication and access rights

    - Routing

Note:

When Automatic Diagnostic Repository (ADR) is enabled, any changes to the tracing and logging settings using Oracle Enterprise Manager Cloud Control are ignored by the system.

7.1.4 Using Oracle Net Configuration Assistant to Configure Network Components

Oracle Net Configuration Assistant configures basic network components during installation, including:

  • Listener names and protocol addresses

  • Naming methods the client uses to resolve connect identifiers to connect descriptors

  • Net service names in a tnsnames.ora file

  • Directory server usage

Oracle Net Configuration Assistant runs automatically during software installation, as described in the Oracle Database installation guide. It can also be run after installation in standalone mode to configure naming methods, the listener, network service names in the tnsnames.ora file, and directory server usage.

To start Oracle Net Configuration Assistant do the following:

  • On Linux and UNIX, run netca from the ORACLE_HOME/bin directory.

  • On Microsoft Windows, select Programs from the Start menu, and then select Oracle - HOME_NAME. Next, select Configuration and Migration Tools, and then Oracle Net Configuration Assistant.

See Also:

The following are the configuration options on the Oracle Net Configuration Assistant Welcome page:
  • Listener configuration – Create, modify, delete, or rename a listener.

  • Naming Methods configuration – Configure the computer to resolve connect identifiers to connect descriptor with one or more of following naming methods:
    • Local naming

    • Directory naming

    • Easy Connect naming

    • External naming

  • Local Net Service Name configuration

    – Create, modify, delete, rename, or test connectivity of a connect descriptor stored in a local tnsnames.ora file
  • Directory Usage Configuration – Configure a directory server for directory-enabled features.

7.2 About the OracleNetAdmins Group

To use Oracle Net Manager, you must be a member of the OracleNetAdmins group or the OracleContextAdmins group.

Oracle Net Configuration Assistant establishes these access rights for these groups during Oracle Context creation.

7.2.1 Adding Users To the OracleNetAdmins Group

The following procedure describes how to add a user to the OracleNetAdmins group using the ldapmodify command:

  1. Create an Lightweight Directory Interchange Format (LDIF) file that specifies that you want to add a user to the OracleNetAdmins group.

    You can use the following sample LDIF file. Use the appropriate DN for cn=OracleNetAdmins and the user that you want to add.

    dn: cn=OracleNetAdmins,cn=OracleContext,...
    changetype: modify
    add: uniquemember
    uniquemember: DN of user being added to group
    
  2. Enter the following command at the command line to refresh the file:

    $ ldapmodify -h directory_host -p port -D binddn -q -f ldif_file
    

    In the preceding command, directory_host is the directory server host, port is the listening TCP/IP port for the directory server, binddn is the directory administrator or user DN, and ldif_file is the input file name. If the port is not specified, then the default port of 389 is used. The -q option prompts for a single bind password.

7.2.2 Removing Users From the OracleNetAdmins Group

The following procedure describes how to remove a user from the OracleNetAdmins group with the ldapmodify command:

  1. Create an LDIF file that specifies that you want to delete a user to the OracleNetAdmins group.

    You can use the following sample LDIF file. Enter the appropriate DN for cn=OracleNetAdmins and the user that you want to delete.

    dn: cn=OracleNetAdmins,cn=OracleContext,...
    changetype: modify
    delete: uniquemember
    uniquemember: DN of user being deleted from group
    
  2. Enter the following command to delete the user:

    $ ldapmodify -h directory_host -p port -D binddn -q -f ldif_file
    

    In the preceding command, directory_host is the directory server host, port is the listening TCP/IP port for the directory server, binddn is the directory administrator or user DN, and ldif_file is the input file name. If the port is not specified, then the default port of 389 is used. The -q option prompts for a single bind password.

7.2.3 Changing Ownership of the OracleNetAdmins Group

The following procedure describes how to add a group as an owner of an OracleNetAdmins group:

  1. Create an LDIF file, as follows:

    1. Specify the group you want to add as an owner.

      You can use the following sample LDIF file. Enter the appropriate DN for cn=OracleNetAdmins and the DN of the group that you want to add.

      dn: cn=OracleNetAdmins,cn=OracleContext,... 
          changetype: modify 
          add: owner 
          owner: DN of group to add
      

      For example, the following LDIF syntax changes the ownership from the OracleNetAdmins group to another group named ExampleSecurityAdmins. The group can be either inside or outside Oracle Context.

      dn: cn=OracleNetAdmins,cn=OracleContext,... 
           changetype: modify 
           add: owner 
           owner: cn=ExampleSecurityAdmins 
      
    2. (Optional) Specify the group to delete as an owner.

      dn: cn=OracleNetAdmins,cn=OracleContext,... 
          changetype: modify 
          delete: owner 
          owner: DN of group to delete
      
  2. Enter the following command at the command line to refresh the file:

    $ ldapmodify -h directory_host -p port -D binddn -q -f ldif_file
    

    In the preceding command, directory_host is the directory server host, port is the listening TCP/IP port for the directory server, binddn is the directory administrator or user DN, and ldif_file is the input file name. If the port is not specified, then the default port of 389 is used. The -q option prompts for a single bind password to be entered.

7.3 Using Listener Control Utility to Administer the Listener

Oracle Net Services provides tools to help you start, stop, configure, and control each network component. The Listener Control utility enables you to administer the listener.

The utility is started by the user that owns the Oracle installation, or a member of the designated group, on the same machine where the listener is running. The basic syntax for this utility is as follows:

lsnrctl command [listener_name] 

For example, the following command starts a listener named lsnr:

lsnrctl START lsnr

You can also issue Listener Control utility commands at the LSNRCTL> program prompt. To obtain the prompt, enter lsnrctl with no arguments at the operating system command line. When you run lsnrctl, the utility is started, and you can enter the necessary commands from the program prompt.

For example:

lsnrctl
LSNRCTL> START lsnr

See Also:

7.4 Performing Common Network Tasks

Learn how to perform network configuration and administration tasks, such as configuring directory server, naming methods, profiles, listener, and Oracle Connection Manager.

Configuring Directory Server for Oracle Net Usage

Configuring Naming Methods

Migrating to Directory Naming

Export from tnsnames.ora files.

Tools used to perform the task: Oracle Enterprise Manager Cloud Control, Oracle Net Manager. See Export Directory Naming Entries to the tnsnames.ora file.

Configuring Profiles

Configuring Listeners

Administering Listeners

Configuring Oracle Connection Manager