|Oracle® Database 2 Day DBA
10g Release 1 (10.1)
Part Number B10742-02
At the end of the install of your Oracle software and database, you have a fully functional database with a client/server network environment that has been minimally configured.
This chapter contains the following topics to help you completely configure your client/server network:
A client is any application that needs to connect to the Oracle database to send or retrieve data. An Oracle client application can reside on any machine provided it has Oracle client software installed.
Oracle Net is a software component that resides on the client and the Oracle database server. It is responsible for establishing and maintaining the connection between the client application and the server, as well as exchanging messages between them, using industry standard protocols.
For the client application and a database to communicate, the client application must specify location details for the database it wants to connect to and the database must provide some sort of identification, or address.
See Also:Oracle Net Services Administrator's Guide for more guidance in understanding Net Services and for more configuration details.
On the database server side, the Oracle Net listener, commonly known as the listener, is a process that listens for client connection requests. It is configured in a file named
listener.ora, with a protocol address that identifies the database. This address defines the protocol the listener is listening on and any other protocol specific information. For example, the listener could be configured to listen at the following protocol address:
(DESCRIPTION= (ADDRESS=(PROTOCOL=tcp)(HOST=my-server) (PORT=1521)))
This example shows a TCP/IP protocol address that specifies the host machine of the listener and a port number.
When a client configured with the same protocol address broadcasts a request for a connection, the listener on the server machine brokers the request and forwards it to the Oracle database.
The client uses a connect descriptor to specify the database it wants to connect to. This connect descriptor contains a protocol address and a database service name. A database can have multiple services defined, so a specific one must be specified for the connection. In the case of the preconfigured database that you installed, there is only one service, the name of which defaults to the global database name.
The following example shows a connect descriptor that enables clients to connect to a database service called
(DESCRIPTION= (ADDRESS=(PROTOCOL=tcp)(HOST=my-server) PORT=1521)) (CONNECT_DATA= (SERVICE_NAME=mydb.us.acme.com)))
Users initiate a connection request by providing a connect string. A connect string includes a username and password, along with a connect identifier. This connect identifier can be the connect descriptor itself, or a name that resolves to the connect descriptor. One of the most common connect identifiers is a net service name, a simple name for a service. The following example shows a connect string that uses net service name mydb as the connect identifier.
While the connect identifier is relatively simple as shown, the y can be long and inconvenient to use if your environment configuration is more complex. With long connect identifiers, you can use a mapping method that maps the net service name to the connect descriptor. This mapping information is stored in one or more repositories of information that are accessed with naming methods.
The preconfigured database uses local naming. Only this form of naming is used in this book.
The easy connect naming method requires no configuration.
Oracle enables you to manage your network configuration with the following tools: Oracle Net Configuration Assistant, Enterprise Manager, and Oracle Net Manager.
The Oracle Universal Installer launches Oracle Net Configuration Assistant after the database is installed. Oracle Net Configuration Assistant enables you to configure the listening protocol address and service information for an Oracle database.
During a typical database install (as opposed to client install), Oracle Net Configuration Assistant automatically configures a listener with a name of
LISTENER that has a TCP/IP listening protocol address for the Oracle database that you install. If you do a custom install, Oracle Net Configuration Assistant prompts you to configure a listener name and protocol address of your choice.
Oracle Net Configuration Assistant is primarily a post installation tool. Thereafter, Oracle provides other means for network configuration, which are the Oracle Enterprise Manager and Oracle Net Manager.
Enterprise Manager enables you to manage your server-side network configuration with two pages: the Listener page and the Net Services Administration page.
The Listener page gives you listener status and enables you to shut it down. You can navigate to this page from the Home page by clicking the Listener link under General. See "Viewing Listener Configuration" in this chapter.
The Net Services Administration page enables you to do the following:
Configure the following:
Local naming (
tnsnames.ora files) on the machine running the database
Search and sort local and directory naming entries
Export directory naming entries to
Perform the following administrative tasks for a selected listener:
Show current status
Change status (start/stop listener)
Change tracing settings
Change logging settings
You can navigate to the Net Services page from the Home page by clicking Listener under General. The Listener page appears. Under Related Links, click Net Services Administration.
You can access Oracle Net Manager from the command line or for Windows platforms through the Start menu.
For command line (UNIX, Linux, or Windows) run
On Windows choose:
Start > Programs > Oracle - home-name Configuration and Migration Tools > Net Manager
Oracle Net Manager provides the same features as Oracle Enterprise Manager with the addition of configuring profiles. To learn how to use this tool, see "Configuring Oracle Networking on Client Machines" on page 4-5.
The listener runs on your database server machine and brokers incoming client requests. With Enterprise Manager, you can view the status of the listener, which is set up for automatic startup whenever your server machine is restarted.
To view the status of the listener, navigate to the Enterprise Manager home page. Under General, click Listener. The Listener: listener_name page appears. Under General, note the listener status, which is either Up or Down.
This page also gives the listener version, its net address, and start time.
You can additionally view the listener status at the command line using
The Oracle listener is set up to start automatically whenever your server machine is restarted. However, when your system encounters unforeseen circumstances, or when you have manually stopped the listener, you can restart it at the command line. To do so, use the following:
You can use Enterprise Manager to stop the listener. To do so, navigate to the Listener: listener_name page by clicking Listener on the Home page. To shutdown the listener, click Stop.
You can also stop it at the command line using the following:
Client machines need to be configured before they can connect to an Oracle database. To configure the client machine, you must first install Oracle client software, which includes Oracle Net software.
This example shows you how to configure a Windows client with local naming, which involves adding a connect descriptor entry to the local tnsnames.ora file. The connect descriptor specifies the host name, protocol address, and service name of the database to connect to.
Start Oracle Net Manager by clicking Start->Programs->Oracle->Configuration and Migration Tools->Net Manager
Highlight Local Naming and click the plus (+) on the left hand side of the page. The Net Service Name Wizard appears.
Enter a net service name to identify it. The name you choose will appear under the Service Naming folder. Click Next.
Select the protocol to use to connect to your database. For example, you can accept the default TCP/IP (Internet Protocol). The database listener must be configured to use the same network protocol. Click Next.
Enter the host name of the database machine, such as coconuts.island.com.
Enter either the database service name or the database SID. In addition, select a Connection Type, either Shared or Dedicated. Shared connections require your database to be running in shared mode. If you choose Dedicated, the database dedicates a single server process to serve your connection. If you are unsure or would like to use the default database connection type, select Database Default. Click Next.
The last screen of the wizard enables you to test the connection using the information you entered. To do so, click Test. To log in to the database, you can use the
SYS user and the password you specified when you configured your database. The wizard tells you if the connection test succeed or not.
Click Finish. The new service appears under the Service Naming folder. You can view or modify the configuration for the highlighted service under Service Identification and Address Configuration.
Note that you can additionally run Oracle Net Manager from the command line using netmgr on Windows, Linux, and Unix platforms.
Oracle by Example (OBE) has a series on the Oracle Database 2 Day DBA book. This OBE steps you through the tasks in this chapter and includes annotated screen shots.
To view the Networking OBE, point your browser to the following location: