Event actions (exit traps)

You can configure Bravura Security Fabric to send email warnings, or some other notification, to administrators when replication failures occur.

Replication event action options can be accessed by navigating to Manage the system > Maintenance > System variables or Manage the system > Maintenance > Options.

By default some events are configured to run the pxnull interface program with the pxnull-replication script, located in the \<instance>\script\ directory, to notify users when the server has attempted to reconnect to the downed server a certain number of times. The script is set to use the settings set in the Email configuration page and contact the account in the RECIPIENT EMAIL field. You must install the pxnull program with the Connector Pack .

You can also send a warning email to administrators in the event of a short-lived replication problem, by configuring the DB REPLICATION CONN FAILURE event action (Manage the system > Maintenance > Options). The advantage of detecting short-lived replication problems is that administrators can react more quickly to problems. The disadvantage is that there may be many spurious replication problems, due to a busy server rather than any underlying problem in the environment, and these may generate too many emails. A carefully configured exit trap can check for a threshold number of problems before sending an email. See the sample script below.

function REPLICATION_FAILURE
{
  var $retryKey;
  var $retryVal;
  var $retryThreshold = 50;  #Default limit is 256 tries every minute before database is suspended.
  for( var $i = 0; $i < size( $sessdat ); $i = $i + 1 )
  {
      $retryKey = keyAt($sessdat, $i);
      $retryVal = valAt($sessdat, $i);
      if (strcmp($retryKey, "retry")==0)
      {
         if ($retryVal > $retryThreshold)
         {
          # Add code to generate and send email notifications, and open
          # monitoring tickets here
            log ("replication-failure-pxnull.cfg: Send emails about failure: " + $retryVal);
         }
         else
         {
          # Threshold has not been reached. Do nothing.
         }
      }
   }
   return 0;
}