Oracle9i Net Services Reference Guide Release 2 (9.2) Part Number A96581-02 |
|
|
View PDF |
This chapter describes the commands and associated syntax of the Listener Control utility.
This chapter contains these topics:
The Listener Control utility enables you to administer listeners.You can use its commands to perform basic management functions on one or more listeners. Additionally, you can view and change parameter settings.
The basic syntax of Listener Control utility commands is as follows:
lsnrctl command[
listener_name]
where listener_name
is the name of the listener to be administered. If no name is specified, then the default name, LISTENER
, is assumed.
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 program is started. You can then enter the necessary commands from the program prompt. The basic syntax of issuing commands from LSNRCTL>
program prompt is as follows:
lsnrctl LSNRCTL> command[
listener_name]
For a majority of commands, the Listener Control utility establishes an Oracle Net connection with the listener that is used to transmit the command. To initiate an Oracle Net connection to the listener, the Listener Control utility needs to obtain the protocol addresses for the named listener or a listener named LISTENER
. This is done by resolving the listener name with one of the following mechanisms:
listener.ora
file in the directory specified by the TNS_ADMIN
environment variablelistener.ora
file in the $ORACLE_HOME/network/admin
directory on UNIX operating systems and the ORACLE_HOME
\network\admin
directory on Windows operating systemstnsnames.ora
fileIf the listener name is LISTENER
and it cannot be resolved, a protocol address of TCP/IP, port 1521 is assumed.
The Listener Control utility supports several types of commands:
START
, STOP
, and so forth.SET TRC_LEVEL
STATUS
and SHOW
LOG_FILE
EXIT
, QUIT
, and HELP
You can use the SET
command to alter parameter values for a specified listener. You set the name of the listener you want to administer with the SET CURRENT_LISTENER
command. Parameter values remain in effect until the listener is shut down. If you want these settings to persist, use the SAVE_CONFIG
command to save changes to the listener.ora
.
You can use the SHOW
command to display the current value of a configuration setting.
The Listener Control utility can perform operations on a local or a remote listener.
To set up a computer to remotely administer a listener:
lsnrctl
) executable is installed.listener.ora
file or a naming method, as described in "Listener Control Utility Overview".All commands except START
can be issued when a listener is administered remotely. The Listener Control utility can only start the listener on the same computer from where the utility is running.
When issuing commands, specify the listener name as an argument. For example:
LSNRCTL> SERVICES lsnr
If the name is omitted, then listener name set with the SET CURRENT_LISTENER
command is used, or the default name, LISTENER
is assumed.
It is important to provide security through a password for the listener. With a password, privileged operations, such as saving configuration changes or stopping the listener, used from the Listener Control utility will require a password.
Use the Listener Control utility's CHANGE_PASSWORD
command or Oracle Net Manager to set or modify an encrypted password in the PASSWORDS_
listener_name
parameter in the listener.ora
file. If the PASSWORDS_
listener_name
parameter is set to an unencrypted password, you must manually remove it from the listener.ora
file prior to modifying it. If the unencrypted password is not removed, you will be unable to successfully set an encrypted password.
If the PASSWORDS_
listener_name
parameter is set in the listener.ora
file or the CHANGE_PASSWORD
command has been used to create a new, encrypted password, then the Listener Control utility will require a SET PASSWORD
command prior to any protected command, such as STOP
.
Note: If you are administering the listener remotely over an insecure network and require maximum security, configure the listener with a secure protocol address that uses the TCP/IP with SSL protocol. If the listener has multiple protocol addresses, ensure that the TCP/IP with SSL protocol address is listed first in the |
This section lists and describes the Listener Control utility commands.
Use the CHANGE_PASSWORD
command to establish an encrypted password or change an encrypted password set with the PASSWORDS_
listener_name
parameter in the listener.ora
file.
None
Yes. If a password is set, then issue then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl CHANGE_PASSWORD [listener_name
]
From the Listener Control utility:
LSNRCTL> CHANGE_PASSWORD [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
The Listener Control utility prompts you for the old password and then for the new one. It asks you to re-enter the new one, and then changes it. Neither the old nor the new password displays during this procedure. CHANGE_PASSWORD
is usually followed by the SAVE_CONFIG
command to save the new password in the listener.ora
file. If a SAVE_CONFIG
command is not issued, then the new password will be in effect only until the listener is shut down.
See Also:
Oracle9i Net Services Administrator's Guide for further information about password security of the listener |
The following shows a new password of lsnrc9i
being set:
LSNRCTL> CHANGE_PASSWORD Old password: New password: lsnrc9i Reenter new password: lsnrc9i Connecting to (ADDRESS=(PROTOCOL=ipc)(KEY=iris)) Password changed for LISTENER The command completed successfully LSNRCTL> SAVE_CONFIG The command completed successfully
The following shows the password being changed from lsnrc80
to lsnrc90:
LSNRCTL> CHANGE_PASSWORD Old password: lsnrc8i New password: lsnrc9i Reenter new password: lsnrc9i Connecting to (ADDRESS=(PROTOCOL=ipc)(KEY=iris)) Password changed for LISTENER The command completed successfully LSNRCTL> SAVE_CONFIG The command completed successfully
Use the EXIT
command to exit from the Listener Control utility.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the Listener Control utility:
LSNRCTL> EXIT
None
This command is identical to the QUIT
command.
LSNRCTL> EXIT
Use the command HELP
to provide a list of all the Listener Control utility commands or provide syntax help for a particular Listener Control utility command.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl HELP [command
]
From the Listener Control utility:
LSNRCTL> HELP [command
]
[
command
]
: Specify a HELP
command. Commands are shown in the following example output.
When you enter a command as an argument to HELP
, the Listener Control utility displays information about how to use the command. When you enter HELP
without an argument, the Listener Control utility displays a list of all the commands.
LSNRCTL> HELP The following operations are available An asterisk (*) denotes a modifier or extended command: change_password exit quit reload services set* show* spawn start status stop trace version
Use the QUIT
command to exit the Listener Control utility and return to the operating system prompt.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the Listener Control utility
LSNRCTL> QUIT
None
This command is identical to the EXIT
command.
LSNRCTL> QUIT
Use the RELOAD
command to reread the listener.ora
file. This command enables you to add or change statically configured services without actually stopping the listener.
In addition, the database services, instances, service handlers, and listening endpoints that were dynamically registered with the listener will be unregistered and subsequently registered again.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl RELOAD [listener_name
]
From the Listener Control utility:
LSNRCTL> RELOAD [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
LSNRCTL> RELOAD Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521))) The command completed successfully
Use the SAVE_CONFIG
command to compare the current configuration state of the listener, including trace level, trace file, trace directory, and logging to the listener.ora
file. Any changes are stored in listener.ora
, preserving formatting, comments, and case as much as possible. Prior to modification of the listener.ora
file, a backup of the file, called listener.bak
, is created.
Yes. If a password is set, then issue then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SAVE_CONFIG [listener_name
]
From the Listener Control utility:
LSNRCTL> SAVE_CONFIG [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
This command enables you to save all runtime configuration changes to the listener.ora
file, which can be especially useful for saving changed encrypted passwords.
LSNRCTL> SAVE_CONFIG listener
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
Saved LISTENER configuration parameters.
Listener Parameter File /oracle9i/network/admin/listener.ora
Old Parameter File /oracle9i/network/admin/listener.bak
The command completed successfully
Use the SERVICES
command to obtain detailed information about the database services, instances, and service handlers (dispatchers and dedicated servers) to which the listener forwards client connection requests.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SERVICES [listener_name
]
From the Listener Control utility:
LSNRCTL> SERVICES [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
See Also:
Oracle9i Net Services Administrator's Guide for a complete description of |
The SET DISPLAYMODE
command changes the format and the detail level of the output.
This example shows SERVICES
output in the default display mode. The output shows the following:
sales
belonging to two services, sales1.us.acme.com
and sales2.us.acme.com
, with a total of three service handlers.sales1.us.acme.com
is handled by one dispatcher only.sales2.us.acme.com
is handled by one dispatcher and one dedicated server, as specified by in the following output.
LSNRCTL> SERVICES Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(KEY=net))) Services Summary... Service "sales1.us.acme.com" has 1 instance(s). Instance "sales", status READY, has 1 handler(s) for this service... Handler(s): "D000" established:0 refused:0 current:0 max:10000 state:ready DISPATCHER <machine: sales-server, pid: 5696> (ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=53411)) Service "sales2.us.acme.com" has 1 instance(s). Instance "sales", status READY, has 2 handler(s) for this service... Handler(s): "DEDICATED" established:0 refused:0 state:ready LOCAL SERVER "D001" established:0 refused:0 current:0 max:10000 state:ready DISPATCHER <machine: sales-server, pid: 5698> (ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=52618)) The command completed successfully
Use the SET
command to alter the parameter values for the listener. Parameter values changes remain in effect until the listener is shut down. To make the changes permanent, use the SAVE_CONFIG
command to save changes to the listener.ora
file.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl SET [parameter
]
From the Listener Control utility:
LSNRCTL> SET [parameter
]
[
parameter
]
: Specify a SET
parameter to modify its configuration setting. Parameters are shown in the example output.
When you enter SET
without an argument, the Listener Control utility displays a list of all the parameters.
If you are using the SET
commands to alter the configuration of a listener other than the default LISTENER
listener, use the SET CURRENT_LISTENER
command to set the name of the listener you want to administer.
LSNRCTL> SET The following operations are available with set. An asterick (*) denotes a modifier or extended command. current_listener displaymode log_file log_directory log_status password raw_mode save_config_on_stop startup_waittime trc_file trc_directory trc_level
Use the SET
CURRENT_LISTENER
command to set the name of the listener to administer. Subsequent commands that would normally require listener_name
can be issued without it.
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the Listener Control utility
LSNRCTL> SET CURRENT_LISTENER [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
When SET
CURRENT_LISTENER
is set, the Listener Control utility commands act on the listener you set. You do not have to specify the name of the listener.
LSNRCTL> SET CURRENT_LISTENER lsnr
Current Listener is lsnr
Use the SET
DISPLAYMODE
command to change the format and level of detail for the SERVICES
and STATUS
commands.
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the Listener Control utility:
LSNRCTL> SET DISPLAYMODE {compat | normal | verbose | raw}
[compat]
: Specify to display output that is compatible with older versions of the listener.
[normal]
: Specify to display output in a formatted and descriptive output. Oracle Corporation recommends this mode.
[verbose]
: Specify to display all data received from the listener in a formatted and descriptive output.
[raw]
: Specify to display all data received from the listener without any formatting. This output should be used only if recommended by Oracle Support Services.
LSNRCTL> SET DISPLAYMODE normal Service display mode is NORMAL
Use the command SET
LOG_DIRECTORY
to set destination directory where the listener log file is written. By default, the log file is written to the $ORACLE_HOME/network/log
directory on UNIX operating systems and the ORACLE_HOME\network\log
directory on Windows NT.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SET LOG_DIRECTORY {directory
}
From the Listener Control utility:
LSNRCTL> SET LOG_DIRECTORY {directory
}
{
directory
}
: Specify the directory path of the listener log file.
LSNRCTL> SET LOG_DIRECTORY /usr/oracle/admin
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
LISTENER parameter "log_directory" set to /usr/oracle/admin
The command completed successfully
Use the command SET
LOG_FILE
to set the name for the listener log file. By default, the log file name is listener.log
.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SET LOG_FILE {file_name
}
From the Listener Control utility:
LSNRCTL> SET LOG_FILE {file_name
}
{
file_name
}
: Specify file name of the listener log.
LSNRCTL> SET LOG_FILE list.log Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521))) LISTENER parameter "log_file" set to list.log The command completed successfully
Use the command SET
LOG_STATUS
to turn listener logging on or off
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SET LOG_STATUS {on | off}
From the Listener Control utility:
LSNRCTL> SET LOG_STATUS {on | off}
[on]
: Specify to turn logging on.
[off]
: Specify to turn logging off.
LSNRCTL> SET LOG_STATUS on
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
listener parameter "log_status" set to ON
The command completed successfully
Use the command SET
PASSWORD
prior to privileged Listener Control utility commands, such as SAVE_CONFIG
and STOP
.
The password entered should match the one established for the PASSWORDS_
listener_name
parameter in the listener.ora
file or set by the CHANGE_PASSWORD
command.
From the Listener Control utility:
LSNRCTL> SET PASSWORD
Password: password
None
You can enter this command when you start up the Listener Control utility or at any time during the session as needed.
LSNRCTL>SET PASSWORD
Password:lnrc9i
The command completed successfully
Use the command SET
SAVE_CONFIG_ON_STOP
to specify whether or not changes made to the parameter values for the listener by the SET
commands are to be saved to the listener.ora
file at the time the listener is stopped with the STOP
command.
When changes are saved, the Listener Control utility tries to preserve formatting, comments, and letter case. Prior to modification of the listener.ora
file, a back up of the file, called listener.bak
, is created.
To have all parameters saved right away, use the SAVE_CONFIG
command.
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl SET SAVE_CONFIG_ON_STOP
{on | off}
From the Listener Control utility:
LSNRCTL> SET SAVE_CONFIG_ON_STOP
{on | off}
[on]
: Specify to save configuration to listener.ora
.
[off]
: Specify to not save configuration to listener.ora
.
LSNRCTL>
SET SAVE_CONFIG_ON_STOP on
listener parameter "save_config_on_stop" set to ON The command completed successfully
Note: This command is deprecated in Oracle9i and will be desupported in a future release. If you require this command to run the listener, please notify Oracle Support Services. |
Use the command SET
STARTUP_WAITTIME
to specify the amount of time for the listener to wait before responding to a START
command.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SET STARTUP_WAITTIME {time
}
From the Listener Control utility:
LSNRCTL> SET STARTUP_WAITTIME {time
}
{
time
}
: Specify the time, in seconds.
LSNRCTL> SET STARTUP_WAITTIME 10
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
listener parameter "startup_waittime" set to 10
The command completed successfully
Use the command SET
TRC_DIRECTORY
to set the destination directory where the listener trace files are written. By default, the trace file are written to the $ORACLE_HOME/network/trace
directory on UNIX operating systems and the ORACLE_HOME\network\trace
directory on Windows NT.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl SET TRC_DIRECTORY {directory
}
From the Listener Control utility:
LSNRCTL> SET TRC_DIRECTORY {directory
}
{
directory
}
: Specify the directory path of the listener trace files.
LSNRCTL> SET TRC_DIRECTORY /usr/oracle/admin
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
LISTENER parameter "trc_directory" set to /usr/oracle/admin
The command completed successfully
Use the command SET
TRC_FILE
to set the name of the listener trace file. By default, the trace file name is listener.trc
.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl SET TRC_FILE {file_name
}
From the Listener Control utility:
LSNRCTL> SET TRC_FILE {file_name
}
{
file_name
}
: Specify the file name of the listener trace.
LSNRCTL> SET TRC_FILE list.trc
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
LISTENER parameter "trc_file" set to list.trc
The command completed successfully
Use the command SET
TRC_LEVEL
to set a specific level of tracing for the listener.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SET TRC_LEVEL {level
}
From the Listener Control utility:
LSNRCTL> SET TRC_LEVEL {level
}
{
level
}
: Specify one of the following trace levels:
off
for no trace outputuser
for user trace informationadmin
for administration trace informationsupport
for Oracle Support Services trace informationThis command has the same functionality as the TRACE
command.
LSNRCTL> SET TRC_LEVEL admin
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
listener parameter "trc_level" set to admin
The command completed successfully
Use the command SHOW
to view the current parameter values for the listener.
All of the SET
parameters, except SET PASSWORD
, have equivalent SHOW
parameters.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to using this command.
From the operating system:
lsnrctl SHOW [parameter
]
From the Listener Control utility:
LSNRCTL> SHOW [parameter
]
[
parameter
]
: Specify a SHOW
parameter to view its configuration settings. Parameters are shown in the example output.
When you enter SET
without an argument, the Listener Control utility displays a list of all the parameters.
LSNRCTL> SHOW
The following properties are available with SHOW:
An asterisk (*) denotes a modifier or extended command:
current_listener
displaymode
log_file
log_directory
log_status
rawmode
save_config_on_stop
startup_waittime
trc_file
trc_directory
trc_level
Note:
|
Use the command SPAWN
to start a program stored on the computer on which the listener is running, and which is listed with an alias in the listener.ora
file.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl SPAWN [listener_name
] {alias} [(arguments='arg1
,arg2
,...')]
From the Listener Control utility
LSNRCTL> SPAWN [listener_name
] {alias} [(arguments='arg1
,arg2
,...')]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
{alias}
: Specify the alias name of the program specifed by the PROGRAM
parameter in the listener.ora
file.
[(arguments=
'arg1
,
arg2
,...
')]
: Specify the arguments sent to by program that is to be spawned.
LSNRCTL> SPAWN nstest_alias (ARGUMENTS='')
Use the command START
to start the named listener.
Listener must not already be running.
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl START [listener_name
]
From the Listener Control utility:
LSNRCTL> START [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
To start a listener configured in the listener.ora
file with a name other than LISTENER
, include that name.
For example, if the listener name is tcp_lsnr
, enter:
lsnrctl START tcp_lsnr
From the Listener Control utility:
LSNRCTL> START tcp_lsnr
LSNRCTL> START
Starting /private/dsteiner/sales/bin/tnslsnr: please wait...
TNSLSNR for Solaris: Version 9.0.1.0.0
System parameter file is /oracle9i/network/admin/listener.ora
Log messages written to /oracle9i/network/log/listener.log
Listening on:
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=1521)))
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
STATUS of the LISTENER
------------------------
Alias LISTENER
Version TNSLSNR for Solaris: Version 9.0.1.0.0
Start Date 23-JAN-2002 18:02:25
Uptime 0 days 0 hr. 0 min. 0 sec
Trace Level off
Security OFF
SNMP OFF
Listener Parameter File /oracle9i/network/admin/listener.ora
Listener Log File /oracle9i/network/log/listener.log
Listening Endpoints Summary...
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=1521)))
The listener supports no services
The command completed successfully
Note: You can also obtain the status of the listener through the Oracle Enterprise Manager Console. See the Oracle Enterprise Manager Administrator's Guide for further information. |
Use the command STATUS
to display basic status information about a listener, including a summary of listener configuration settings, listening protocol addresses, and a summary of services registered with the listener.
None
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl STATUS [listener_name
]
From the Listener Control utility:
LSNRCTL> STATUS [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
See Also:
Oracle9i Net Services Administrator's Guide for a complete description of |
The SET DISPLAYMODE
command changes the format and level of the detail of the output.
The following example shows STATUS
output in the default display mode. The output contains:
SERVICES
command output
LSNRCTL> STATUS
Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(KEY=net)))
STATUS of the LISTENER
------------------------
Alias LISTENER
Version TNSLSNR for Solaris: Version 9.2.0.2.0 -
Development
Start Date 18-JAN-2002 12:02:00
Uptime 0 days 0 hr. 5 min. 29 sec
Trace Level support
Security OFF
SNMP OFF
Listener Parameter File /oracle9i/network/admin/listener.ora
Listener Log File /oracle9i/network/log/listener.log
Listener Trace File /oracle9i/network/trace/listener.trc
Listening Endpoints Summary...
(DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(KEY=net)))
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=1521)))
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=sales-server)(PORT=2484)))
Services Summary...
Service "sales1.us.acme.com" has 1 instance(s).
Instance "sales", status READY, has 1 handler(s) for this service...
Service "sales2.us.acme.com" has 1 instance(s).
Instance "sales", status READY, has 2 handler(s) for this service...
The command completed successfully
Use the command STOP
to stop the named listener.
The listener must be running.
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl STOP [listener_name
]
From the Listener Control utility:
LSNRCTL> STOP [listener_name]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
LSNRCTL> STOP
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
The command completed successfully
Use the command TRACE
to turn on tracing for the listener.
Yes. If a password is set, then issue the SET PASSWORD
command prior to this command.
From the operating system:
lsnrctl trace {level}[listener_name
]
From the Listener Control utility:
LSNRCTL> trace {level} [listener_name
]
{
level
}
: Specify one of the following trace levels:
off
for no trace outputuser
for user trace informationadmin
for administration trace informationsupport
for Oracle Support Services trace information[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
This command has the same functionality as SET TRC_LEVEL
command.
LSNRCTL> TRACE ADMIN lsnr
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
Opened trace file: /oracle9i/network/trace/listener.trc
The command completed successfully
Use the command VERSION
to display the current version of Listener Control utility.
None
No. If a password is set, then the SET PASSWORD
command does not need to be issued prior to this command.
From the operating system:
lsnrctl VERSION [listener_name
]
From the Listener Control utility:
LSNRCTL> VERSION [listener_name
]
[listener_name
]: Specify the listener name, if the default name of LISTENER
is not used.
LSNRCTL> VERSION listener1
Connecting to
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales-server)(PORT=1521)))
TNSLSNR for Solaris: Version 9.2.0.2.0
TNS for Solaris: Version 9.2.0.2.0
Oracle Bequeath NT Protocol Adapter for Solaris: Version 9.2.0.2.0
Unix Domain Socket IPC NT Protocol Adaptor for Solaris: Version
9.2.0.2.0
TCP/IP NT Protocol Adapter for Solaris: Version 9.2.0.2.0
The command completed successfully