CHAPTER 2. SQL*Net Configuration with Network Manager
This chapter explains how to use Network Manager in an OpenVMS environment. It covers the following topics:
This chapter is intended as an OpenVMS-specific supplement to the Network Manager documentation. For general product information about Oracle Network Manager, please refer to the Oracle Network Manager Administrator's Guide.
Pre-Configuration Tasks
This section lists the tasks you must perform before using Network Manager.
Before You Set Up OpenVMS Clients
Before you set up your clients, you should have completed the following procedures:
- Verified that your operating environment meets the SQL*Net for OpenVMS system requirements.
- Installed the networking software and hardware on your system.
- Verified that your network protocol is functioning properly.
- Installed SQL*Net on your systems.
- Shut down Oracle7 before loading and building SQL*Net when adding protocol adapters.
For more information about OpenVMS system requirements and installation procedures, see the installation guide for your platform.
For information on loading and operating your protocol, see your network protocol installation guide.
Setting Up OpenVMS Clients
Complete the following configuration tasks for the OpenVMS clients on your network.
- Identify the nodes on the network
- Identify the listener port number for TCP/IP (Oracle recommends using the number 1526, which is reserved for SQL*Net Version 2)
- Identify the listener object name for DECnet
- Define node name (for both TCP/IP and DECnet)
For instructions on performing these tasks, refer to the documentation from your networking vendor.
Starting Network Manager
Network Manager is available on Windows 3.1, Windows 95, and Windows NT only. Before using Network Manager to generate and distribute the configuration files to your OpenVMS node(s), you must first:
- Validate the connectivity between the PC used for Network Manager and your OpenVMS node.
- Verify that there exists a means by which to transfer the files from the PC to your OpenVMS node (this could be FTP or via Pathworks utilities.)
- If you intend to use an OpenVMS database as a Names Server, verify that the PC Names Server (or TNSNAMES.ORA) contains the connection address of the OpenVMS database to be used for Names. Also, you must first create the required tables (described below under 'Creating tables for Oracle Names.'
Using Network Manager
This section gives information about using the Network Manager.
Protocol-Specific Information
In preparing to use Network Manager, the Understanding SQL*Net guide suggests that you plan what specific information about your network you will enter. Aside from entering the names of your communities and listeners, the addresses of your servers, and system identifiers of your databases, you will need to enter protocol-specific information.
If you do not want to accept Network Manager's default values for some of these protocol-specific keywords, enter your own values using the format suggested in Table 2-1.
| Protocol
| Keyword
| Value
|
| DECnet
| NODE
| <nodename>
|
|
| OBJECT
| <alphanumeric string>
|
| TCP/IP
| HOST
| <hostname>
|
|
| PORT
| <number>
|
| Table 2-1 Protocol-specific Information
|
|
|
See Chapter 3, "The Protocol Adapters" for details and examples.
Location-Specific Parameters
The Network Manager window called "Oracle Database" has a field called "Location-specific parameters," with the following keyword:
PROGRAM=
After the keyword, enter the file specification of the command procedure that sets up the environment for the database and starts the database server.
The full entry should be in the following format:
PROGRAM=<directory><filename>
where:
User-Defined
Parameters
This field, which is also in the Oracle Database window, asks whether there are any special parameters you wish to set.
This field is optional for configurations of Oracle7 on OpenVMS. If you wish, you can use this field to set preferences for the server process, such as process quotas and priority.
Syntax of the LISTENER.ORA File
listener_alias =
(ADDRESS_LIST=
(ADDRESS=
(PROTOCOL=TCP)
(PORT=number)
(HOST=name|ip_address)
(QUEUESIZE=number))
(ADDRESS=
(PROTOCOL=DECNET)
(NODE=name)
(OBJECT=object name|number)
(QUEUESIZE=number)))
STOP_listener_alias=YES|NO
CONNECT_TIMEOUT_listener_alias=number
TRACE_LEVEL_listener_alias=number|USER|ADMIN|OFF
SID_LIST_listener_alias =
(SID_DESC=
(SID_NAME=sid_name)
(PROGRAM=file-spec)
(TIMEOUT=number) (optional)
(OUT=file-spec) (optional)
(OSDS=(PRIORITY=number) (optional)
(QUOTA=(ASTLM=number) (optional)
(BIOLM=number) (optional)
(BYTLM=number) (optional)
(CPULM=number) (optional)
(DIOLM=number) (optional)
(FILLM=number) (optional)
(PGFLQUOTA=number) (optional)
(PRCLM=number) (optional)
(TQELM=number) (optional)
(WSQUOTA=number) (optional)
(WSDEFAULT=number) (optional)
(ENQLM=number) (optional)
(WSEXTENT=number) (optional)
(JTQUOTA=number)))) (optional)
Sample LISTENER.ORA File SID_LIST
SID_LIST_listen1=
(SID_DESC=
(SID_NAME=PROD)
(PROGRAM=DISK$NET1:[ORACLE732.DB_PROD]ORASRV_NETV2.COM)
(TIMEOUT=24)
(OSDS=
(QUOTA=
(ASTLM=123)
(BIOLM=56)
(BYTLM=34567)
(CPULM=999999)
(DIOLM=34)
(FILLM=89)
(PGFLQUOTA=56789)
(PRCLM=1)
(TQELM=12)
(WSQUOTA=3456)
(WSDEFAULT=2345)
(ENQLM=56)
(WSEXTENT=789)
(JTQUOTA=3))))
In this example, note the following settings:
- The server process is set to time out after 24 minutes
- The OSDS (operating system dependent settings) consist of OpenVMS process quotas for the server process which the listener starts; had the user not specified these settings, the server process would use the settings of the account which starts the process.
Additional Information: If you are using an OpenVMS system to create files that will be used by another operating system, you should refer to the Oracle documentation for this operating system.
Creating Tables for Oracle Names
If you will be using Oracle Names, you must store information about your network in a database. To create the database tables for storing this configuration information, do the following:
- Copy the appropriate SQL script files to TNS_ADMIN for your Names database. The SQL install scripts are located on the PC (in ORAWIN/DBS) from where Network Manager will be run. The following files are required:
- After copying the files to TNS_ADMIN, run the scripts from within SQLPLUS in the following order:
SQLPLUS> @tns_admin:rosbild
SQLPLUS> @tns_admin:rosgrnt PUBLIC
SQLPLUS> @tns_admin:nmcbild
SQLPLUS> @tns_admin:rosgrnt PUBLIC
Creating and Distributing the Configuration Files
As described in Understanding SQL*Net, the Network Manager generates several configuration files for the Oracle networking products. Appendix A of Understanding SQL*Net describes the contents of the configuration files.
After you've generated these files using Network Manager, you must distribute them among the client and server nodes that will be using them.
The following table lists the configuration files and their appropriate directory locations. Copy each file to the location listed in Table 2-2.
| Configuration File
| Node
| Directory Location
|
| TNSNAMES.ORA
| Clients not using Oracle Names
| ORA_ROOT:[NETWORK.ADMIN]
|
| NAMES.ORA
| Node on which Oracle Names is installed
| ORA_ROOT:[NETWORK.ADMIN]
|
| SQLNET.ORA
| Clients and servers
| ORA_ROOT:[NETWORK.ADMIN]
|
| LISTENER.ORA
| Servers
| ORA_ROOT:[NETWORK.ADMIN]
|
| TNSNAV.ORA
| Not applicable on OpenVMS
|
|
| TNSNET.ORA
| Not applicable on OpenVMS
|
|
| INTCHG.ORA
| Not applicable on OpenVMS
|
|
| PROTOCOL.ORA
| Valid node verification
| ORA_ROOT:[NETWORK.ADMIN]
|
| Table 2-2 Configuration files and directory locations
|
|
|
If you are generating to an OpenVMS Names Server, once again, verify both the general connectivity between the PC and the OpenVMS host, as well as the connectivity between PC NetMan and your OpenVMS database.