Manual Pages


Table of Contents

NAME

na_autosupport - notification daemon

SYNOPSIS

Data ONTAP is capable of sending automated notifications to support personnel and/or to other designated addressees in certain situations. The notifications contain useful information to help them solve or recognize problems quickly and proactively. The system can also be configured to send a short alert notification containing only the reason for the alert to a separate list of recipients. This notification is sent only for critical events that might require some corrective action and can be useful for administrators with alphanumeric pagers that can accept short email messages.

Command Summary

This is a list of the subcommands for the AutoSupport command.

autosupport destinations
Displays a summary of the current AutoSupport destinations.

autosupport history
Displays and retransmits recent AutoSupport messages.

autosupport manifest
Displays AutoSupport content manifest.

autosupport trigger
Displays and modifies AutoSupport trigger configuration.

DESCRIPTION

AutoSupport is generally configured using options specified with the options command. All AutoSupport options start with the "autosupport." prefix.

The AutoSupport mechanism will use SMTP if there are any (user configured) destination email addresses set in the autosupport.to option. If autosupport.support.enable is on, AutoSupport will also be sent to support personnel. AutoSupport messages sent to support personnel may be transmitted by SMTP, HTTP or HTTPS as specified in the autosupport.support.transport option.

If SMTP is used, then the AutoSupport mechanism contacts a mail host that is listening on the SMTP port (25) to send email. A list of up to 5 mailhosts can be specified by using the autosupport.mailhosts option, and they will be accessed in the order specified until one of them answers as a mailhost. It will then send email through the successful mailhost connection to the destination email address specified in the autosupport.to option. Note that the autosupport.to option allows only 5 email addresses. To send to more than 5 recipients, create a local alias, or distribution list, and add that as the recipient.

If autosupport.support.enable is on then a copy of the AutoSupport message is also sent to support personnel as follows:

If autosupport.support.transport is smtp then the copy of the AutoSupport is emailed to the destination specified in autosupport.support.to and the same mailhost picking algorithm is used as above.

If autosupport.support.transport is http or https then a direct connection to the location specified in autosupport.support.put_url or autosupport.support.url is made and the AutoSupport message is transmitted to support personnel by using HTTP PUT/POST. If a proxy is required to use HTTP or HTTPS, configure proxy settings with the autosupport.support.proxy option.

The AutoSupport mechanism is automatically triggered periodically by the kernel to send information. It can also be invoked on-demand by the System Administrator. AutoSupport messages will also be sent on events that require corrective action from the System Administrator or support personnel.

To accommodate multiple delivery methods and destinations and to preserve time dependent values, the outgoing AutoSupport messages are spooled in /etc/log/autosupport. AutoSupport processing will attempt to deliver all (currently undelivered) messages until the autosupport.retry.count has been reached or until subsequent AutoSupport messages "fill the spool" such that the oldest (undelivered) messages are forced to be dropped. The spool size is currently 50 messages.

The subject line of the mail sent by the AutoSupport mechanism contains a text string to identify the reason for the notification. The subject also contains a relative prioritization of the message, using syslog severity levels from DEBUG to EMERGENCY (see na_syslog.conf(5)). The messages and other information in the notification should be used to check on the problem being reported.

The setup command tries to configure AutoSupport as follows:

If a mailhost is specified, it adds an entry for mailhost to the /etc/hosts file.

Setup also queries for autosupport.from information.

HA CONSIDERATIONS

The AutoSupport messages from a node in an HA pair are different from the AutoSupport messages from a standalone node in the following ways:

The AutoSupport messages from a node in an HA pair contains information about its partner, such as the partner system ID and the partner host name.

In takeover mode, if you reboot the live node, two AutoSupport messages notify the email recipients of the reboot: one is from the live node, and one is from the failed node.

The live node sends an AutoSupport message after it finishes the takeover process.

EXAMPLES

  The following examples show how to modify AutoSupport URLs when using IPv6 address literals:

  node-1> options autosupport.mailhost [2620:10a:4002:6004::bbbb]:25

  node-1> options autosupport.support.proxy username:password@[2620:10a:4002:6004::bbbb]:8080

SEE ALSO

na_autosupport_destinations(1), na_autosupport_history(1),
na_autosupport_manifest(1),
na_autosupport_trigger(1), na_options(1), na_partner(1), na_setup(1), na_hosts(5), RFC821


Table of Contents