email

Required Command-Line Mode = Configure

Use the email command to configure automatic email notifications for events on the GigaVUE® HC Series node. Separate arguments let you add the mail server/port to use, the account from which emails will be sent, email recipients, and so on. Refer to the Hardware Installation Guide for a description of how to configure email notification essentials

The email command has the following syntax:

email
   auth
      enable
      password [password]
      username <username>
   autosupport
      enable
      event <event name>
      ssl
         ca-list <none | default-ca-list>
         cert-verify
         mode <none | tls | tls-none>
   dead-letter
      cleanup max-age cleanup <duration>
      enable
   domain <hostname or IP address>
   mailhub <hostname, IPv4, or IPv6 address>
   mailhub-port <port number>
   notify
      event <<event name> | all>
      recipient <email address>
        class <failure | info>
        detail
   return-addr <username>
   return-host
   send-test
   ssl
      ca-list <none | default-ca-list>
      cert-verify
      mode <none | tls | tls-none>

The following table describes the arguments for the email command:

Command

Description

auth
   enable
   password [password]
   username <username>

Enables the sending of notification emails and specifies the account to be used for authentication with the SMTP server specified by the email mailhub command as follows:

enable—Enables the sending of notification emails.
password—Specifies the password used for authentication with the SMTP server. You can leave the password blank to have the system prompt for a password.
username—Specifies the account to be used for authentication with the SMTP server.

autosupport    enable
   event <event name>
   ssl
      ca-list <none | default-ca-list>
      cert-verify
      mode <none | tls | tls-none>

Configures auto support, as follows:

enable—Enables or disables the sending of emails to the auto support address (by default, Gigamon’s Technical Support Department) when failures specified with email autosupport event <event name> take place.
event—Specifies the events that will trigger an email to the auto support destination. Use email autosupport event ? to see the list of available events.
ssl—Configures security options for auto support email as follows:
o ca-list—Configures supplemental CA certificates for verification of server certificates.
o cert-verify—Verifies server certificates.
o mode—Configures the type of security to use for autosupport email.

dead-letter
   cleanup max-age cleanup
<duration>
   enable

Configures the handling of email notifications that could not be sent (for example, because the mail hub was not configured correctly), as follows:

cleanup—Specifies how long to save undeliverable emails. Dead letter files older than the configured maximum are automatically deleted. Specify using d(day), h(hours), m(minutes), and s(seconds) values. You can use these either together or by themselves—for example, both 5d6h3m1s and 5d are accepted.
enable—Enables the saving of undeliverable emails.

domain <hostname or IP address>

Specifies the domain from which notification emails will appear to come from. This name is used together with the hostname setting to form the name of the domain included in notification emails. The name is formed using the following rules:

If an email domain is specified, it is used. If the hostname has any dots in it, everything to the right of the first dot is removed and the email domain is added.
If an email domain is not specified and the hostname has dots in it, it is used as-is.
If an email domain is not specified and the hostname does not have dots in it, the currently-active system domain name is used.

mailhub <hostname, IPv4, or IPv6 address>

Specifies the address or hostname of the server to use for sending notification emails.

email mailhub-port <port number>

Specifies the TCP port used by the server added using email mailhub.

notify
   event <<event name> | all>
   recipient <email address>
     class <failure | info>
     detail

Specifies the events that will trigger notification emails and where they will be sent as follows:

event—Specifies the events that will trigger notification emails. Type email notify event ? to see the list of available events. You can also use the event all argument to generate notification emails for all available events. Be careful with the all argument—the amount of emails generated may be more than is tolerable.
recipient—Specifies to whom notification emails should be sent, as well as the types of emails they should receive. Each of the events configured with email notify event is classified as either a informational or a failure. Enable the types of emails you want this user to receive with the class argument.

For example, the following command sends emails to bposey@argus.com for all failures:

(config) # email notify recipient bposey@argus.com class failure

Note:   No email is sent when failure is configured and an info event is generated.

Use the recipient detail argument to specify whether summarized or detailed output should be included in the email. Note that not all events have both summary and detail formats.

return-addr <username>

Specifies the address from with notification emails are sent. If you include the @ character, the address is used as-is (for example, email return-addr support@mycompany.com). If the @ character is not included, the system adds the <return-host>.<domain>.

The default settings is do-not-reply.

return-host

Specifies whether or not to include the hostname in the return address for emails. This only takes effect if the return addr entry does not contain an @ character.

send-test

Sends a test mail to all recipients configured for event and failure notifications with the email notify command. This command is useful once you have finished configured email settings and want to make sure they are functioning properly.

ssl   ca-list <none | default-ca-list>
   cert-verify
   mode <none | tls | tls-none>

Configures the use of SSL for notification emails sent by the GigaVUE HC Series node as follows:

ca-list—Configures supplemental CA certificates for verification of server certificates. You can either use only the built-in list (none) or supplement it with the default CA list configured using the crypto command (default-ca-list).
cert-verify—Enables certificate verification for emails sent from the GigaVUE HC Series node. With this option, emails will not be sent if TLS cannot be verified.
mode—Specifies the type of security to be used for emails sent from the GigaVUE HC Seriesnode. You can enable plain text emails (none), TLS security only (tls), or TLS first with plain text as a fallback (tls-none). Both TLS options use the default server port (email mailhub-port).

Related Commands

The following table summarizes other commands related to the email command:

Task

Command

Displays email and notification settings.

show email

Displays the events that will trigger notification emails.

show email events

Disables authentication for sending email.

(config) # no email auth enable

Clears password for SMTP authentication.

(config) # no email auth password

Clears username for SMTP authentication (effectively disables authentication until the username set again).

(config) # no email auth username

Does not send automatic support notifications through email.

(config) # no email autosupport enable

Negates certain email event notification settings.

(config) # no email autosupport event processcrash

(config) # no email autosupport event livenessfailure

Delete supplemental CA certificate list.

(config) # no email autosupport ssl ca-list

Does not verify server certificates.

(config) # no email autosupport ssl cert-verify

Resets autosupport email security mode to the default.

(config) # no email autosupport ssl mode

Does not clean up old dead letters based on age.

(config) # no email dead-letter cleanup max-age

Does not save dead letter for undeliverable emails.

(config) # no email dead-letter enable

Clears email domain override.

(config) # no email domain

Clears the configured mail hub.

(config) # no email mailhub

Clears the configured mail hub port.

(config) # no email mailhub-port

Negates certain email event notification settings.

(config) # no email notify event all

(config) # no email notify event firmwarechange

(config) # no email notify event rxtxerror

Does not send any notifications to this recipient.

(config) # no email notify recipient friend@gmail.com

Does not send certain types of events to this recipient.

(config) # no email notify recipient friend@gmail.com class failure

(config) # no email notify recipient friend@gmail.com class info

Sends summarized event emails to this recipient.

(config) # no email notify recipient friend@gmail.com detail

Resets the return address to the default.

(config) # no email return-addr

Does not include hostname in return address for email notifications.

(config) # no email return-host

Deletes supplemental CA certificate list.

(config) # no email ssl ca-list

Does not verify server certificates.

(config) # no email ssl cert-verify

Resets email security mode to the default.

(config) # no email ssl mode