Configuring email recipients

The same users can receive both system event notifications and scheduled reports. If you use the CLI to configure them, you must use two separate sets of CLI commands.

Each new recipient will receive detailed notifications for all enabled system health check events. You can customize the notifications for individual users, and configure which specific events trigger notifications. (See Configuring system events for details.)

Important
Use the MTA recipient address only for event notifications and not for other emails. Business email sent to this address will not be delivered.

Important
If you use the CLI to configure a scheduled report recipient, the change will not be reflected in the Web UI. For example:
You add analyst@acme.com using the report email recipient analyst@acme.com CLI command. That recipient will be listed in the show report email command output, but will not be added to the recipient list on the Email Settings page in the Web UI.
The recipient list on the Email Settings page includes admin@acme.com, but the Report checkbox is not selected. You then add that recipient using the report email recipient admin@acme.com CLI command. The Report checkbox will still not be selected on the Email Settings page.
If you use the Web UI to add an email recipient, the recipient will be enabled to receive both system event notifications and scheduled reports. However, if you use the email notify recipient CLI command to add this recipient, the recipient will receive only system event notifications, not scheduled reports (the Report check box will be cleared on the Email Settings page).

Prerequisites

Operator or Admin access

Configuring email recipients using the Web UI

Use the Email Settings page to add or remove the email recipients for system event notifications and for scheduled reports.

Click the Settings tab.
Click Email in the sidebar.
Locate the Email Recipients section.
Click Add Email Recipient.
Enter the email address of the user in the Add Email Recipient box and then click Add Recipient.
(Optional) Clear the Info, Fail, Detail, and Scan checkboxes as needed to customize the notifications the user will receive. (See Configuring system event notifications using the Web UI for details.)

To add a scheduled report recipient:

Click Add Email Recipient.
Enter the email address of the user in the Add Email Recipient box and then click Add Recipient.
Make sure the Report checkbox remains selected.
(Optional) Clear the Info, Fail, Detail, and Scan checkboxes to prevent the user from receiving system event notifications as well as scheduled reports.

To remove an email recipient:

Click the icon in the Delete column.
When prompted, click OK to confirm the action.

Configuring email recipients using the CLI

Use the commands in this section to add or remove email recipients for system event notifications and scheduled reports.

Important
If you use the CLI to add or remove a scheduled report recipient, the changes will not appear on the Email Settings page in the Web UI.

Adding and removing system event notification recipients

To add system event notification recipients:

Enable the CLI configuration mode:

hostname > enable
hostname # configure terminal

To add a recipient:

hostname (config) # email notify recipient <emailAddress>

To remove a recipient:

hostname (config) # no email notify recipient <emailAddress>

Verify your changes:
```
hostname (config) # show email
```
Save your changes:
```
hostname (config) # write memory
```

Adding and removing scheduled report recipients

To configure scheduled report recipients:

Go to CLI configuration mode:

hostname > enable
hostname # configure terminal

To add a recipient:

hostname (config) # report email recipient <emailAddress>

To remove a recipient:

hostname (config) # no report email recipient <emailAddress>

Verify your changes:
```
hostname (config) # show report email
```
Save your changes:
```
hostname (config) # write memory
```

Examples

This example adds analyst@acme.com as a system event notification recipient and removes user3@acme.com.

hostname (config) # show email
...
Email notification recipients:
  admin@acme.com (all events, in detail)
  exec@acme.com (failure events only, in detail)
  user3@acme.com (all events, summarized)
...
hostname (config) # email notify recipient analyst@acme.com
hostname (config) # no email notify recipient user3@acme.com
hostname (config) # show email
...
Email notification recipients:
  admin@acme.com (all events, in detail)
  analyst@acme.com (all events, in detail)
  exec@acme.com (failure events only, in detail)

This example adds analyst@acme.com as a scheduled report recipient, and removes admin@acme.com.

hostname (config) # show report email

Report email configurations:
        ...        
        Email recipients:
                admin@acme.com
                exec@acme.com           
hostname (config) # report email recipient analyst@acme.com
hostname (config) # no report email recipient admin@acme.com
hostname (config) # show report email

Report email configurations:
        ...        
        Email recipients:
                analyst@acme.com
                exec@acme.com