Email notification

Owned by KrupeshD (Deactivated)
Last updated: Jan 23, 2012Version comment
4 min read

Email notification is an integral part of Dbvisit Standby. If, for any reason Dbvisit Standby has failed to transfer or apply an archive after the set threshold has been reached, an email alert will be sent. If any other error occurs, an email will also be send.

Daily scheduler heartbeat message

A heartbeat email will be sent each new day. This is to ensure that the emailing functionality in Dbvisit is operating normally. The variable SEND_HEARTBEAT_TIME24 in the Dbvisit Database Configuration (DDC) file specifies what time the email will be sent. The time is in 24 hour format and should be between 0000 and 2359 hours. If this variable is not specified then an email will be sent at the beginning of each day. Example:
SEND_HEARTBEAT_TIME24 = 0700 
Multiple times can be specified separated by semicolon. To send a heartbeat message three times a day (7am, 1pm and 6 pm) specify:
SEND_HEARTBEAT_TIME24 = 0700:1300:1800 
Dbvisit will not necessary send an email at the exact time specified. Dbvisit will only send the heartbeat email when it is executed. Example: If SEND_HEARTBEAT_TIME24=1400, but Dbvisit is not executed until 14:20, then the heartbeat email will be sent at 14:20. 
It is possible to turn the heartbeat feature off for the primary server by setting SEND_HEARTBEAT=N in the Dbvisit Database Configuration (DDC) file. To turn the heartbeat feature off for the standby server, set SEND_HEARTBEAT_DR=N.

Testing the scheduler heartbeat message

To test the scheduler heartbeat message and to send a test email, the dbv_functions utility can be used.
Use dbv_functions with the -m flag.
Example:

 

 dbv_functions -m w120n 
 ============================================================= 
 Dbvisit Standby Database Technology 
 dbv_functions started on dbvisit11 
 ============================================================= 

 Sending schedular heartbeat message.
Where w120n is the name of the database and dbvisit11 is the name of the server.

Dbvisit Standby log gap report with heartbeat message

As part of the Daily scheduler heartbeat message it is possible to include the Dbvisit Standby log gap report. 
The Dbvisit Standby log gap reports on the:

  • Archive log gap which is difference between the last archived sequence on the primary and the last applied sequence on the standby database. The archive log gap should be near 0 (except when APPLY_DELAY_LAG_MINUTES is used).
  • Transfer log gap which is the difference between the last archived sequence on the primary and the last sequence transferred to the standby server. The transfer log gap should be near 0.

To include the Dbvisit Standby archive and transfer log gap report in the daily heartbeat message set:
SEND_LOG_GAP_WITH_HEARTBEAT=Yes 
In the Dbvisit Database Configuration (DDC) file.
Dbvisit Standby will start the standby database if the standby database is not running and AUTO_START_STANDBY_DB = Yes.

Email modes

There are two modes for emailing on the primary server:

  1. SUCCESSMAIL = Yes. This will send an email every time that Dbvisit Standby transfers or applies an archive on the primary server. This setting is usually set at the beginning of an installation to ensure that Dbvisit Standby is processing correctly.
  2. SUCCESSMAIL = No. This will only send an email if an error has occurred on the primary server. No email is good news. However a heartbeat email will still be sent at the start of everyday to ensure that the email notification is functioning correctly.

There are two modes for emailing on the standby server:

  1. SUCCESSMAIL_DR = Yes. This will send an email every time that Dbvisit Standby transfers or applies an archive on the standby server. This setting is usually set at the beginning of an installation to ensure that Dbvisit Standby is processing correctly.
  2. SUCCESSMAIL_DR = No. This will only send an email if an error has occurred on the standby server. No email is good news. However a heartbeat email will still be sent at the start of everyday to ensure that the email notification is functioning correctly.

Email address

The email addresses are specified by the ADMINS and SUCCESS_MAILTO parameters in the DDC file. Multiple email addresses can be separated with a comma.
All mail configurations are specified in the Dbvisit Standby Database Configuration (DDC) file.
If SUCCESS_MAILTO is not set, all emails notifications that Dbvisit Standby sends go to ADMINS. 
If SUCCESS_MAILTO is set to a valid email address and SUCCESSMAIL is set to Y then:

  • All error messages and warnings still always go to ADMINS:
  • Warnings sent by AMM module
  • Alert on archive log gap sequence if it exceeds the threshold (archive or transfer)
  • All error messages
  • Messages sent by running dbv_functions
  • Warning when no new logs found on the primary server to transfer to the standby
  • Warning that a previous instance of Dbvisit Standby is still running
  • Warning that a required archive log not found on standby database
  • Notifications of successful completion of CSD with a trace file attached

 - And the following messages go to SUCCESS_MAILTO:

  • Notification of successful completion of Dbvisit Standby run on the primary to transfer logs
  • Notification of successful completion of Dbvisit Standby run on the standby to apply logs
  • Heartbeat messages
  • Log gap report

If SUCCESS_MAILTO is set to a valid email address but SUCCESSMAIL is set to N then the following type of messages will not be sent at all:

  • Warning when no new logs found to transfer (even when ALERT_ON_WARNING is set)
  • Warning that a previous instance of Dbvisit Standby is still running
  • Warning that a required archive log not found on standby database
  • Notification of successful completion of Dbvisit Standby run on the primary to transfer logs
  • Notification of successful completion of Dbvisit Standby run on the standby to apply logs