Event Notification Configuration in netflow.cfg

To configure event notifications from AgilePoint Server, do the procedure in this topic.

Event notifications are configured in the <notification> node of the AgilePoint Server configuration file netflow.cfg.

Prerequisites

How to Start

  1. On the AgilePoint Server machine, in a text editor, open the file netflow.cfg.

XML Node Format

<notification
    mode="[true or false]"
    format="[text or html]"
    smtpService="[SMTP service assembly name]:[SMTP service 
        class name]:[e-mail address],[password]"
    mailServer="[your mail server]"
    sender="[sender email address]"
    sysadm="[AgilePoint administrator email address. 
        If blank, the system uses the sender email address.]"
       maxRetryFailedMail="[integer that specifies how many times the server needs to send mail if it is failed]"
    emailEncoding="[encoding format]"
    sendMailSeparately="[true or false]"
/>

XML Node Example

<notification
    mode="true"
    format="text"
    smtpService="Builtin::username@sbcglobal.net,mypassword"
    mailServer="smtp.sbcglobal.yahoo.com"
    sender="apnotifier@mycompany.com"
    sysadm="adminuser@mycompany.com"
    maxRetryFailedMail="35"
    emailEncoding="UTF-8"
    sendMailSeparately="false"

/>

Attributes

Field Name Definition

mode
Function:
Specifies whether AgilePoint Server sends notifications for system events to the AgilePoint System Account.
Accepted Values:
  • true - AgilePoint Server sends administrator notifications.
  • false - AgilePoint Server does not send administrator notifications.
Default Value:
true
Example:
<notification mode="true" ... />

format
Function:
Specifies the format of the notification e-mails from AgilePoint Server.
Accepted Values:
  • html - Displays the e-mail in HTML format.
  • text - Displays the e-mail in text-only format.
Default Value:
text
Example:
<notification format="text" ... />

smtpService
Function:
Specifies the assembly name, class name, e-mail address, and password for your SMTP e-mail server.
Accepted Values:
A valid the assembly name, class name, e-mail address, and password for your SMTP e-mail server in this format.

[smtp service assembly name]:[smtp service class name]:[email address],[password]

Default Value:
None
Example:
<notification smtpService="Builtin::username@sbcglobal.net,mypassword" ... />

mailServer
Function:
Specifies the doman and server name for your SMTP e-mail server.
Accepted Values:
A valid e-mail address.
Default Value:
None
Example:
<notification mailServer="smtp.sbcglobal.yahoo.com" ... />

sender
Function:
Specifies the e-mail address of the sender for e-mail notifications from AgilePoint Server.
Accepted Values:
A valid e-mail address.
Default Value:
None
Example:
<notification sender="apnotifier@mycompany.com" ... />

sysadm
Function:
Specifies the e-mail address for the AgilePoint System Account.
Accepted Values:
A valid e-mail address.
Default Value:
None
Example:
<notification sysadm="adminuser@mycompany.com" ... />

maxRetryFailedMail
Function:
Specifies the maximum number of times to send an e-mail notification from AgilePoint Server if the e-mail attempts fail.
Accepted Values:
An integer.
Default Value:
32
Example:
<notification maxRetryFailedMail="35" ... />

emailEncoding
Function:
Specifies encoding format your e-mail supports.
Accepted Values:
  • UTF-8
  • UTF-32
  • UTF-7
Default Value:
UTF-8
Example:
<notification emailEncoding="UTF-8" ... />

sendMailSeparately
Function:
Specifies whether to send an e-mail notifications to each recipient as separate messages.
Accepted Values:
  • true - Sends an e-mail to each recipient as a separate message.
  • false - Sends one e-mail message to all recipients.
Default Value:
false
Example:
<notification sendMailSeparately="false" ... />

Related Topics