Vunetrix Network Monitor vCloud

Vunetrix Manual: System Administration—Notification Delivery

To open system administration, select Setup | System Administration from main menu. Click on the tabs to change the different settings.

System Administration Bar

System Administration Bar

You can define the following aspects of your Vunetrix system setup:

In the notification delivery settings you can define global settings for notification delivery. If you do not want to use a specific notification method, just leave the respective fields empty.

Note

This section describes one of three steps to set up the notification system in Vunetrix. A complete notification setup involves:

  1. Check and set up the Notification Delivery settings. This will tell Vunetrix how to send messages.
    For detailed information, see System Administration—Notification Delivery.
  2. Check and set up several Notifications. This will define the kind of message and its content.
    For detailed information, see Account Settings—Notifications.
  3. Check and set up Notification Triggers for objects. These will provoke the defined notifications.
    For detailed information, see Sensor Notifications Settings.

For background information, please see Notifications section.

Notification Delivery Settings

Note: This documentation refers to the Vunetrix System Administrator user accessing the Ajax interface on a master node. For other user accounts, interfaces, or nodes, not all of the options might be available as described. When using a cluster installation, failover nodes are read-only by default.

Email Options

Email Templates

Choose which templates will be used for all emails sent.

  • Use standard email templates (Recommended): Use this option if you are not sure what to use. These templates offer the best compatibility with all email clients.
  • Use templates from previous version (for upgrade installations from V7 only): This option is provided for update installations from V7 only. Use it if you have updated from Vunetrix version 7 and really want to continue using the old email templates. This can be useful when using custom HTML templates in Vunetrix 7 format.

Depending on the option selected, the content of the other fields in this section changes.

Email Header (HTML)

Define the HTML text that will be used as the header for each HTML mail. To reset this field to its default value, click on the trash can icon left to the field or enter a single star symbol * (and nothing else).

Email Footer (HTML)

Define the HTML text that will be used as a suffix to every HTML mail. To reset this field to its default value, click on the trash can icon left to the field or enter a single star symbol * (and nothing else).

For Text Mails

Select if a footer will be added to plain text mails. Choose between:

  • Append text footer (default): Add a text footer to all text mails. Define the text below.
  • Do not append the footer Append text footer: Do not add a footer to text mails.

Email Footer (Text)

Define a text that will be used as a suffix to every plain text mail (if enabled above). You can use several placeholders in email templates. See the More section below for more information. To reset this field to its default value, click on the trash can icon left to the field or enter a single star symbol * (and nothing else).

SMTP Delivery

SMTP Delivery Mechanism

Define how mails are sent using Simple Mail Transfer Protocol (SMTP). Choose between:

  • Direct delivery using built-in mail relay server (default): Use the SMTP relay server built into Vunetrix. This server manages its own email queue. For each email, it will look up the target SMTP server via the MX record of the target domain, and send the email.
  • Use SMTP relay server (recommended inside LANs/NATs): Set up your own SMTP relay server to send emails. Enter data below.
  • Use two SMTP relay servers (primary and fallback server): Set up two own SMTP relay servers—one primary and one as fallback server. Enter data below.

Note: When monitoring inside your NAT or LAN it is often a good idea to use your own LAN-based relay server to deliver notification emails quicker.

Sender Email

Enter an email address that will be used as sender of all emails. This setting is global and can only be changed centrally here.

Sender Name

Enter a name that will be used as sender of all emails. This setting is global and can only be changed centrally here.

HELO Ident

Enter the HELO Ident for SMTP. This must be a unique name, preferably the DNS name of the machine running Vunetrix. See SMTP RFC 2821: The sender-SMTP must ensure that the domain parameter in a HELO command is a valid principal host domain name for the client host.

SMTP Relay Server

This field is only visible if SMTP relay server is enabled above. Enter the IP address or DNS name of the SMTP relay server.

SMTP Relay SMTP Port

This field is only visible if SMTP relay server is enabled above. Enter the port number the SMTP relay server is running on. Standard value is 25.

SMTP Relay Authentication

This field is only visible if SMTP relay server is enabled above. Select the kind of authentication required for the SMTP server. Choose between:

  • No authentication is required: Use SMTP without authentication.
  • Use standard SMTP authentication: Use standard authentication.
  • SASL authentication is required: Use secure authentication via Simple Authentication and Security Layer (SASL).

SMTP Relay Username

This field is only visible if SMTP authentication is enabled above. Enter a valid user name.

SMTP Relay Password

This field is only visible if SMTP authentication is enabled above. Enter a valid password.

Use Encrypted Connection

This field is only visible if SMTP relay server are enabled above. Enter the security level for SMTP connections. Choose between:

  • Never: Use insecure connection with plain text transfer.
  • If supported by server: Use a secure connection (default).

SSL Method

This setting is only visible if SMTP relay server and encryption are enabled above. It is only relevant for secure connections. Select the SSL or TLS version which is supported by your SMTP device. We recommend using the default value. If you do not get a connection, try with another setting.

SMTP Relay Server (Fallback)

These fields are only visible if the option for two SMTP relay servers is enabled above. Please see respective settings for primary SMTP relay server above.

SMTP Relay SMTP Port (Fallback)

SMTP Relay Authentication (Fallback)

Use Encrypted Connection (Fallback)

SSL Method (Fallback)

SMTP Relay Username (Fallback)

SSL Method (Fallback)

SMTP Relay Username (Fallback)

SMTP Relay Password (Fallback)

Security (Fallback)

SMS Delivery

Note: Although Vunetrix has built-in support for the Application Programming Interface (API) of some SMS providers, we cannot officially provide support regarding these SMS service providers. If you have technical questions about SMS delivery beyond Vunetrix, please contact your SMS provider directly. Note: Instead of using a pre-configured provider you can always use a custom URL, enabling you to use extended parameters (this is also an alternative when using providers for which we offer pre-configured options).

You need an internet connection to send text messages via the HTTP API. For information about sending SMS via separate hardware using third party software, please see the More section below.

Configuration Mode

Define how you want to select an SMS provider. Choose between:

  • Select a SMS provider from a list of providers: Select a provider from a list below.
  • Enter a custom URL for a provider not listed: Use another provider and enter the service URL manually below.

Service Provider

This field is only visible if the provider list is enabled above. Choose a service provider from the list. Vunetrix offers a small incomplete list of providers. Note: Some providers might require a port configuration in your firewall. See More section below for more information.

Username

This field is only visible if the provider list is enabled above. Enter a user name for the service provider account.

Password

This field is only visible if the provider list is enabled above. Enter a password for the service provider account.

API ID / Account

This field is only visible if the provider list is enabled above. Some providers need an additional API ID or account information. If provided, enter it here. Please enter a string or leave the field empty.

Custom URL

This field is only visible if the custom provider option is enabled above. From the documentation of your SMS provider, please enter the service URL that is used to send SMS messages. Use the following placeholders for the recipient phone number and the text message: %SMSNUMBER, %SMSTEXT.

Maximum Length of Text

Some SMS providers will not allow SMS messages exceeding a certain amount of characters. Vunetrix will restrict the number of characters according to the length specified in this field. A value of 0 means the SMS is sent at its full length.

Note: The notification methods "Send SMS/Pager Message" and "Execute HTTP Action" will use the central proxy settings defined for your Vunetrix core server. For details, please see System Administration—Core & Probes (section Proxy Configuration).

Click on the Save button to store your settings. If you change tabs or use the main menu, all changes to the settings will be lost!

 

 

Next Topic

Keywords: Configure,Configure Notification Delivery,HTTP Proxy,Notification,Notification Delivery,SMS Delivery,SMTP Delivery