Netlsnr agent functions

The listener is a server process that listens to incoming client connection requests and manages traffic to the database. The Netlsnr agent brings the listener services online, monitors their status, and takes them offline.

The Netlsnr agent is IMF-aware.

See How the Oracle and Netlsnr agents support intelligent resource monitoring.

Table: Netlsnr agent functions lists the Netlsnr agent functions.

Table: Netlsnr agent functions

Agent operation

Description

Online

Starts the listener process by using the following command:

lsnrctl start $LISTENER

Offline

Stops the listener process by using the following command:

lsnrctl stop $LISTENER

If the listener is configured with a password, the agent uses the password to stop the listener.

Monitor

Verifies the status of the listener process.

The Netlsnr agent provides two levels of monitoring, basic and detail:

  • In the basic monitoring mode, the agent scans the process table for the tnslsnr process to verify that the listener process is running.

  • In the detail monitoring mode, the agent uses the lsnrctl status $LISTENER command to verify the status of the Listener process. (Default)

netlsnr_imf_init

Initializes the agent to interface with the AMF kernel driver, which is the IMF notification module for Netlsnr agent. This function runs when the agent starts up.

netlsnr_imf_getnotification

Gets notification about resource state change. This function runs after the agent registers with the AMF kernel module. This function continuously waits for notification and takes action on the resource upon notification.

netlsnr_imf_register

Registers or unregisters resource entities with the AMF kernel module. This function runs for each resource after the resource goes into steady state (online or offline).

Clean

Scans the process table for tnslsnr $LISTENER and kills it.

Action

Performs the predefined actions on a resource.

More Information

Action entry point for Cluster Server agent for Oracle