Adding and editing an Email Action

The E-mail action sends an SMTP mail message to a specific e-mail account. An E-mail action can also be used as an e-mail notification in the WhatsUp Gold Alert Center. While you can configure this action on both the console and web interface, you can only configure the Alert Center notification message on the web. For more information, see Configuring an Alert Center e-mail notification.

To add a new E-mail action:

From the WhatsUp Gold web interface, go to Admin > Actions. The Action Library appears.
Click New. The Select Action Type dialog appears.
Select E-mail Action, then click OK. The New Email Action dialog appears.
Enter the appropriate information:
- Name. Enter a unique name for the action. This name displays in the Action Library.
- Description. (Optional) Enter additional information about the action. This description displays next to the action in the Action Library.
Complete the information on the Configuration tab. This tab contains options pertaining to the action e-mail destination.
- SMTP Server. Enter the IP address or Host (DNS) name of your e-mail server (SMTP mail host).
- Port. Enter the port number on which the SMTP server is listening.
- Timeout (sec). Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the SMTP server. This is considered a failed connection.
- Mail To. Enter the email addresses to which you want to send the alert. Email addresses must be fully qualified. You can enter multiple addresses, separated by a semi-colon (;), comma (,), or the [SPACE] character. The address should not contain brackets, braces, quotes, or parentheses.
- Mail From. Enter the email address you want to appear in the From field of the e-mail that is sent by the Email action.
- SMTP server requires authentication. Check this option if your SMTP server uses authentication. This enables the Username and Password boxes.
  The Email action supports three authentication types:
  - CRAM-MD5
  - login
  - plain
  The authentication type is not configurable. It is negotiated with the SMTP server automatically.
- Username. Enter the username for SMTP authentication.
- Password. Enter the password of the username for authentication.
- Use an encrypted connection (SSL/TLS). Check this option if your SMTP server requires the data to be encrypted over a TLS connection (formerly known as SSL).
Complete the information on the Mail Content tab. This tab contains options pertaining to the action email message content.
- Subject. Enter a text message or edit the default message. You can use percent variables to display specific information in the subject.
- Message body. Enter a text message or edit the default message. You can use percent variables to display specific information in the message body.
Complete the information on the Alert Center Settings tab. This tab contains options pertaining to the message sent from WhatsUp Gold Alert Center.
- Alert Center email subject. Enter a subject for the message. This text appears as the subject in the e-mail that is sent by the Alert Center notification. This subject can include percent variables.
Tip: To include Alert Center percent variables, right click inside the box.
- Alert Center Link. Select Include hyperlink to Alert Center in the email content to include a link to the Alert Center home page in the email message sent by the Alert Center notification.
  - Select to use either HTTP or HTTPS in the link address.
  - Select to either Use dynamic address or Use static hostname or IP address. If you select to use the dynamic address, WhatsUp Gold automatically generates the URL using the current IP address or hostname at the time the action runs.
  - When static hostname or IP address is selected, specify the Hostname or IP address to include in the link address.
  - Specify the Port to include in the link address.
    Important: The address you enter here must be the exact address of the Alert Center home page to which you want to connect. Verify the address and enter its exact contents in the above options.
Click OK to save changes.

To edit an existing E-mail action:

From the WhatsUp Gold web interface, go to Admin > Actions. The Action Library dialog appears.
Select the action you would like to edit, then click Edit.
Enter or select the appropriate information:
- Name. Enter a unique name for the action. This name displays in the Action Library.
- Description. (Optional) Enter additional information about the action. This description displays next to the action in the Action Library.
Complete the information on the Configuration tab. This tab contains options pertaining to the action e-mail destination.
- SMTP Server. Enter the IP address or Host (DNS) name of your e-mail server (SMTP mail host).
- Port. Enter the port number on which the SMTP server is installed.
- Timeout (sec). Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the SMTP server. This is considered a failed connection.
- Mail To. Enter the e-mail addresses to which you want to send the alert. E-mail addresses must be fully qualified. You can enter two addresses, separated by commas (but no spaces). The address should not contain brackets, braces, quotes, or parentheses.
- Mail From. Enter the e-mail address you want to appear in the From box of the e-mail that is sent by the E-mail action.
- SMTP server requires authentication. Check this option if your SMTP server uses authentication. This enables the Username and Password boxes.
  The Email action supports three authentication types:
  - CRAM-MD5
  - login
  - plain
  The authentication type is not configurable. It is negotiated with the SMTP server automatically.
- Username. Enter the username for SMTP authentication.
- Password. Enter the password of the username for authentication.
- Use an encrypted connection (SSL/TLS). Check this option if your SMTP server requires the data to be encrypted over a TLS connection (formerly known as SSL).
Complete the information on the Mail Content tab. This tab contains options pertaining to the action e-mail message content.
- Subject. Enter a text message or edit the default message. You can use percent variables to display specific information in the subject.
- Message body. Enter a text message or edit the default message. You can use percent variables to display specific information in the message body.
Tip: You can add a link to either or both the Device Status and Mobile Device Status reports by clicking the appropriate button.
Complete the information on the Alert Center Settings tab. This tab contains options pertaining to the message sent from WhatsUp Gold Alert Center.
- Alert Center email subject. Enter a subject for the message. This text appears as the subject in the e-mail that is sent by the Alert Center notification. This subject can include percent variables.
Tip: To include Alert Center percent variables, right click inside the box.
- Alert Center Link. Select Include hyperlink to Alert Center in the email content to include a link to the Alert Center home page in the email message sent by the Alert Center notification.
  - Select to use either HTTP or HTTPS in the link address.
  - Select to either Use dynamic address or Use static hostname or IP address. If you select to use the dynamic address, WhatsUp Gold automatically generates the URL using the current IP address or hostname at the time the action runs.
  - When static hostname or IP address is selected, specify the Hostname or IP address to include in the link address.
  - Specify the Port to include in the link address.
    Important: The address you enter here must be the exact address of the Alert Center home page to which you want to connect. Verify the address and enter its exact contents in the above options.
Click OK to save changes.