8.2.3 Export Local Naming Entries to a Directory Naming Server

If a tnsnames.ora file already exists, then you can export the network service names stored in that file to a directory server. These tasks assume the directory server has been installed and is running.

The export procedure is performed for one domain at a time.

Task 1   Create Structure in the Directory Server

In the directory server, create the directory information tree (DIT) with the structure in which you want to import network service names. Create the structure leading to the top of the Oracle Context.

For example, if the tnsnames.ora file supports a domain structure example.com and you want to replicate this domain in the directory, then create domain component entries of dc=com and dc=example in the directory, as shown in the following figure.

Figure 8-1 example.com in Directory Server

Description of "Figure 8-1 example.com in Directory Server"

You can replicate the domain structure you currently use with tnsnames.ora, or you can develop an entirely different structure. Introducing an entirely different structure can change the way clients enter the network service name in the connect string. Oracle recommends considering relative and fully-qualified naming issues before changing the structure.

Task 2   Create Oracle Contexts

Create an Oracle Context under each DIT location that you created in Task 1 using Oracle Internet Directory Configuration Assistant. Oracle Context has a relative distinguished name (RDN) of cn=OracleContext. Oracle Context stores network object entries, as well as other entries for other Oracle components. In the following figure, cn=OracleContext is created under dc=example,dc=com.

Figure 8-2 Oracle Context

Description of "Figure 8-2 Oracle Context"

Task 3   Configure Directory Server Usage

If not done as a part of creating Oracle Contexts, then configure the Oracle home for directory server use. The Oracle home you configure should be the one that performs the export.

Task 4   Export Objects to a Directory Server

To export network service names contained in a tnsnames.ora file to a directory, use either Oracle Enterprise Manager Cloud Controlr or Oracle Net Manager.

• Export Objects using Oracle Enterprise Manager Cloud Control

  The following procedure describes how to export objects using Oracle Enterprise Manager Cloud Control

  1. Access the Net Services Administration page in Oracle Enterprise Manager Cloud Control. See Accessing the Net Services Administration Page.

  2. Select Directory Naming from the Administer list, and then select the Oracle home that contains the location of the directory server.

  3. Click Go.

     The Directory Naming page appears.

  4. Click the Net Service Names tab.

  5. In the Related Links section, click Import Net Service Names To Directory Server.

     The Import Net Service Names To Directory Server page appears.

  6. From the Oracle Context list in the Oracle Internet Directory Server Destination section, select Oracle Context to which you want to export the selected network service names.

  7. In the Net Service Names to Import section, select the network service names.

  8. Click Add to add the network service names to the directory.

     The network service name is added to the Directory Naming page.

• Export Objects using Oracle Net Manager

  The following procedure describes how to export objects using Oracle Net Manager:

  1. Start Oracle Net Manager. See Using Oracle Net Manager to Configure Oracle Net Services.

  2. If the tnsnames.ora file you want to export is not loaded in Oracle Net Manager, then select Open Network Configuration from the File menu to select the tnsnames.ora file to export to the directory.

  3. Select Directory from the Command menu, and then select Export Net Service Names.

     The Directory Server Migration wizard starts.

  4. Click Next.

     If network service names with multiple domain were detected in the tnsnames.ora file, then the Select Domain page appears. Continue to Step 5.

     If the network service names are not domain qualified, then the Select Net Service Names page appears. Skip to Step 6.

  5. Select the network domain whose network service names you want to export, and then click Next.

     The Select Net Service Names page appears.

  6. Select the network service names from the list to export, and then click Next.

     The Select Destination Context page appears.

  7. In the Select Destination Context page, do the following:

     1. From the Directory Naming Context list, select the directory entry that contains the Oracle Context. The directory naming context is part of a directory subtree that contains one or more Oracle Contexts.

     2. From the Oracle Context list, select the Oracle Context to which you want to export the selected network service names.

     3. Click Next.

     The Directory Server Update page appears with the status of the export operation.

  8. Click Finish to close the Directory Server Migration wizard.