Preface

The Net8 Administrator's Guide provides the information you need to understand and use the Net8 product and its related applications.

Note:
This guide contains information that describes the features and functionality of the Oracle8i and the Oracle8i Enterprise Edition products. Oracle8i and the Oracle8i Enterprise Edition have the same basic features. However, several advanced features are available only with Enterprise Edition, and some of these are optional. For example, to use Oracle Connection Manager, you must have the Enterprise Edition. For information about the differences between Oracle8i and the Oracle8i Enterprise and the features and options that are available to you, please refer to Getting to Know Oracle8i.

This Preface includes the following topics:

Audience

The information in this guide is intended primarily for network or database administrators (DBAs) responsible for making connection to services, such as the Oracle8i database, and network configuration. This guide is also provided for anyone who wants to understand how Net8 works.

Structure

This guide contains 11 chapters and three appendices

Part I: Net8 Overview and Concepts

Chapter 1, "Introducing Net8"

Introduces the Net8 release 8.1 product.

Chapter 2, "Architecture and Concepts"

Describes the Net8 architecture, Net8 interaction in a multi-threaded server or dedicated server environment, Oracle Names, Oracle Connection Manager, and connection pooling.

Part II: Net8 Setup and Configuration

Chapter 3, "Planning Your Network"

Describes considerations for planning a network using Net8. It explains the relationships of the Net8 products, and options for better managing your future network.

Chapter 4, "Understanding Release 8.1 Installation and Net8 Products"

Describes release 8.1 configuration files and installed Net8 products and applications.

Chapter 5, "Considerations for Upgrades and Migration"

Describes upgrading from Net8 release 8.0 to Net8 release 8.1, and migrating from SQL*Net version 2 to Net8 release 8.1.

Chapter 6, "Configuring Naming Methods and the Listener"

Describes how to configure the network using various Net8 methods.

Chapter 7, "Enabling Optional Net8 Features"

Describes how to configure advanced and optional Net8 features, such as Oracle Connection Manager features, connection pooling, client load balancing, connect-time failover, Heterogeneous services, External Procedures, and Oracle Rdb database.

Chapter 8, "Establishing a Connection and Testing the Network"

Describes how to start Net8 components, establish a connection, and test a connection.

Chapter 9, "Configuring Multi-Threaded Server"

Describes how to tune the components of the multi-threaded server architecture.

Chapter 10, "Enabling Net8 Enhancements for Programmers"

Describes Net8 enhancements for programmers. This includes a review of Net8 OPEN, UNIX signal handling, and bequeath adapter.

Chapter 11, "Troubleshooting Net8"

Describes procedures to troubleshoot Net8. This includes information on tracing and logging.

Part III: Reference

Appendix A, "Control Utilities for the Listener, Oracle Names Server, and Oracle Connection Manager"

Describes all commands for Net8 Control Utilities including Listener Control (LSNRCTL), Oracle Names Control (NAMESCTL), and Connection Manager Control (CMCTL).

Appendix B, "Sample Configuration Files"

Provides sample configuration files for profiles (SQLNET.ORA), local names (TNSNAMES.ORA), listener (LISTENER.ORA), Oracle Names servers (NAMES.ORA), and Oracle Connection Managers (CMAN.ORA).

Appendix C, "Configuration Parameters"

Lists and describes configuration parameters for profiles, local names, listener, Oracle Names servers, Oracle Connection Manager, and protocols.

Conventions

The following conventions are used in this guide:

Convention Example Meaning

UPPERCASE

LISTENER.ORA

Calls attention to SQL commands, keywords, file names, and initialization parameters.
Most Oracle files names on UNIX are lowercase.

lowercase courier

$ORACLE_HOME/network/admin
startup;

Indicates directories and commands.
Most directories and commands on UNIX are lowercase.

Italic

Italic is used to indicate a variable:
filename
Italic is used for emphasis:
The WHERE clause may be used to join rows in different tables.

Indicates a value that you must provide. For example, if a command asks you to type filename, you must type the actual name of the file.
Italic is also used for emphasis in the text and to indicate the titles of other guides.

Square brackets [ ]

change_password [listener name]

Encloses optional items.

Angle brackets < >

names.default_domain = <valid domain name>

Enclose user-supplied names.

Choose Start >

Choose Start > Programs > Oracle-HOME_NAME > Oracle Enterprise Management > Enterprise Manager Console

Indicates how to start a program on Windows platforms.

Forward slash (\) before a directory name

/network

A subdirectory on UNIX platforms.

Backslash (\) before a directory name

\network

A subdirectory on Windows platforms.

$ORACLE_HOME on UNIX and ORACLE_HOME on Windows platforms

Go to the $ORACLE_HOME\network directory

In this Optimal Flexible Architecture (OFA)-compliant release, all subdirectories are no longer under a top level ORACLE_HOME directory. There can be an ORACLE_BASE directory, which may contain multiple Oracle home directories.

Symbols

period .
comma ,
hyphen -
semicolon ;
colon :
equal sign =
backslash \
single quote '
double quote "
parentheses ()

Symbols other than brackets and vertical bars must be entered in commands exactly as shown.

Convention	Example	Meaning
UPPERCASE	LISTENER.ORA	Calls attention to SQL commands, keywords, file names, and initialization parameters. Most Oracle files names on UNIX are lowercase.
`lowercase courier`	`$ORACLE_HOME/network/admin` `startup;`	Indicates directories and commands. Most directories and commands on UNIX are lowercase.
Italic	Italic is used to indicate a variable: filename Italic is used for emphasis: The WHERE clause may be used to join rows in different tables.	Indicates a value that you must provide. For example, if a command asks you to type filename, you must type the actual name of the file. Italic is also used for emphasis in the text and to indicate the titles of other guides.
Square brackets [ ]	`change_password` [listener name]	Encloses optional items.
Angle brackets < >	names.default_domain = <valid domain name>	Enclose user-supplied names.
Choose Start >	Choose Start > Programs > Oracle-HOME_NAME > Oracle Enterprise Management > Enterprise Manager Console	Indicates how to start a program on Windows platforms.
Forward slash (\) before a directory name	`/network`	A subdirectory on UNIX platforms.
Backslash (\) before a directory name	`\network`	A subdirectory on Windows platforms.
$ORACLE_HOME on UNIX and ORACLE_HOME on Windows platforms	Go to the `$ORACLE_HOME\network` directory	In this Optimal Flexible Architecture (OFA)-compliant release, all subdirectories are no longer under a top level `ORACLE_HOME` directory. There can be an `ORACLE_BASE` directory, which may contain multiple Oracle home directories.
Symbols	period . comma , hyphen - semicolon ; colon : equal sign = backslash \ single quote ' double quote " parentheses ()	Symbols other than brackets and vertical bars must be entered in commands exactly as shown.

Your Comments Are Welcome

We value and appreciate your comments as an Oracle user and reader of the user guides. As we write, revise, and evaluate our documentation, your opinions are the most important input we receive. Please use the reader's comment form to tell us what you like or dislike about this manual or other Oracle manuals. If the form is not available, please send your comments to the Information Development department using any of the following:

E-mail: infodev@us.oracle.com
FAX - (650) 506-7228. Attn: Net8
Postal Service:

Oracle Corporation

Server Documentation Manager

500 Oracle Parkway, 4OP12

Redwood Shores, CA 94065

U.S.A.

Part I: Net8 Overview and Concepts
Chapter 1, "Introducing Net8"	Introduces the Net8 release 8.1 product.
Chapter 2, "Architecture and Concepts"	Describes the Net8 architecture, Net8 interaction in a multi-threaded server or dedicated server environment, Oracle Names, Oracle Connection Manager, and connection pooling.
Part II: Net8 Setup and Configuration
Chapter 3, "Planning Your Network"	Describes considerations for planning a network using Net8. It explains the relationships of the Net8 products, and options for better managing your future network.
Chapter 4, "Understanding Release 8.1 Installation and Net8 Products"	Describes release 8.1 configuration files and installed Net8 products and applications.
Chapter 5, "Considerations for Upgrades and Migration"	Describes upgrading from Net8 release 8.0 to Net8 release 8.1, and migrating from SQL*Net version 2 to Net8 release 8.1.
Chapter 6, "Configuring Naming Methods and the Listener"	Describes how to configure the network using various Net8 methods.
Chapter 7, "Enabling Optional Net8 Features"	Describes how to configure advanced and optional Net8 features, such as Oracle Connection Manager features, connection pooling, client load balancing, connect-time failover, Heterogeneous services, External Procedures, and Oracle Rdb database.
Chapter 8, "Establishing a Connection and Testing the Network"	Describes how to start Net8 components, establish a connection, and test a connection.
Chapter 9, "Configuring Multi-Threaded Server"	Describes how to tune the components of the multi-threaded server architecture.
Chapter 10, "Enabling Net8 Enhancements for Programmers"	Describes Net8 enhancements for programmers. This includes a review of Net8 OPEN, UNIX signal handling, and bequeath adapter.
Chapter 11, "Troubleshooting Net8"	Describes procedures to troubleshoot Net8. This includes information on tracing and logging.
Part III: Reference
Appendix A, "Control Utilities for the Listener, Oracle Names Server, and Oracle Connection Manager"	Describes all commands for Net8 Control Utilities including Listener Control (LSNRCTL), Oracle Names Control (NAMESCTL), and Connection Manager Control (CMCTL).
Appendix B, "Sample Configuration Files"	Provides sample configuration files for profiles (SQLNET.ORA), local names (TNSNAMES.ORA), listener (LISTENER.ORA), Oracle Names servers (NAMES.ORA), and Oracle Connection Managers (CMAN.ORA).
Appendix C, "Configuration Parameters"	Lists and describes configuration parameters for profiles, local names, listener, Oracle Names servers, Oracle Connection Manager, and protocols.

Preface

Audience

Structure

Related Documents

Conventions

Your Comments Are Welcome