E-Mail Notification Configuration

1. Introduction

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 sent.

By default in Dbvisit Standby version 9 E-Mail notifications are disabled, with the following two parameters set to N (no) in the DDC file:

Please refer to the DDC reference page for details on general email parameters and advance settings

DDC File Reference#5.E-MailSettings


SEND_MAIL_FLAG=N
SEND_MAIL_FLAG_DR=N


IMPORTANT:  If you are not using SSL/TLS make sure that "MAILCFG_PROTOCOL" is not set in the DDC file and if it is set it should not have a value:

IMPORTANT

Once you enable notification by setting SEND_MAIL_FLAG or SEND_MAIL_FLAG_DR you have to ensure that mail settings will work. By default Dbvisit will terminate with an error if for example SMTP server is not reachable or password expires.

To override this behaviour (to ignore mail settings related errors) you need to specify parameter in DDC file:

IGNORE_MAIL_ERROR = Y

MAILCFG_PROTOCOL =

On this page:

2.  Support for GMAIL

From Dbvisit Standby version 7.0.10 SSL/TLS Email (SMTP) server connectivity is supported.

It is required that the MAILCFG_PROTOCOL parameter is set in the Dbvisit Standby Configuration (DDC) file with possible values SSL or TLS.

Example, if Gmail is used the following values must be manually specified in the primary server DDC file:


MAILCFG_SMTP_SERVER = smtp.gmail.com
MAILCFG_AUTH_USER = gmail username   (this will also become the "from" address  )
_MAILCFG_AUTH_PASSWD = gmail password
MAILCFG_PORT = 465
MAILCFG_PROTOCOL = SSL
MAILCFG_SMTP_SERVER = smtp.gmail.com
MAILCFG_AUTH_USER = gmail username   (this will also become the "from" address  )
_MAILCFG_AUTH_PASSWD = gmail password
MAILCFG_PORT = 587
MAILCFG_PROTOCOL = TLS

3.  The Heartbeat Message

A heartbeat e-mail will be sent each new day. 

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 a semicolon. To send a heartbeat message three times a day (7 am, 1 pm and 6 pm) specify:

SEND_HEARTBEAT_TIME24 = 0700:1300:1800 


Dbvisit will not necessarily 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.


4.  Testing Heartbeat Message

To test the scheduler heartbeat message and to send a test email, the following command can be used:  "dbvctl -d <DDC> -f send_heartbeat " In version9 by default all the emails notifications come in default HTML format, unlike the previous versions. It can however be changed to TEXT format using these parameters in the DDC :

MAILCFG_FORMAT = 
MAILCFG_FORMAT_DR = 


Example output of heartbeat message:


5.  The Log Gap Report And 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 the 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=Y



IMPORTANT

Dbvisit Standby will start the standby database if the standby database is not running and AUTO_START_STANDBY_DB = Y


6.  Email Modes

There are two modes for emailing on the primary server and they are controlled with the SUCCESSMAIL parameter which can take one of two possible values, Y for yes or N for no.

SUCCESSMAIL=Y|N


  • SUCCESSMAIL = Y
    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 installation to ensure that Dbvisit Standby is processing correctly.

  • SUCCESSMAIL = N
    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 every day to ensure that the email notification is functioning correctly.


There are two modes for emailing on the standby server and they are controlled with the SUCCESSMAIL_DR parameter which can take one of two possible values, Y for yes or N for no.

SUCCESSMAIL_DR=Y|N


  • SUCCESSMAIL_DR = Y
    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 installation to ensure that Dbvisit Standby is processing correctly.

  • SUCCESSMAIL_DR = N
    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 every day to ensure that the email notification is functioning correctly.

7.  Email Address

The email addresses are specified by the ADMINS and SUCCESS_MAILTO parameters in the DDC file. Multiple email addresses can be separated by a comma.

All email configurations are specified in the Dbvisit Standby Database Configuration (DDC) file located in DBVISIT_BASE/standby/conf directory.


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 the 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 the 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

8. Video