Skip to main content

event config modify

Contributors
Suggest changes
PDFs

Modify log configuration parameters

Availability: This command is available to cluster administrators at the admin privilege level.

Description

Use the event config modify command to configure event notification and logging for the cluster.

Parameters

[-mail-from <mail address>] - Mail From

Use this parameter to configure the email address from which email notifications will be sent. You can configure the cluster to send email notifications when specific events occur. Use the event route add-destinations and event destination create commands to configure email destinations for events.

[-mail-server <text>] - Mail Server (SMTP)

Use this parameter to configure the name or IP address of the SMTP server used by the cluster when sending email notification of events. If authentication is required to the mail-server, specify the user name for the mail-server using the -mail-server-user parameter. Use the event config set-mail-server-password command to set the password used for this user name.

You can optionally specify a port value for the mail server. The port specification for a mail host consists of a colon (":") and a decimal value between 1 and 65335, and follows the mailhost name (for example, mymailhost.example.com:5678 ).

[-mail-server-user <text>] - Mail Server User Name

If authentication is required to the mail-server, use this parameter to specify the user name for the mail-server specified by the -mail-server parameter. Use the event config set-mail-server-password command to set the password used for this user name.

[-suppression {on|off}] - Event Throttling/Suppression (privilege: advanced)

Use this parameter to configure whether event suppression algorithms are enabled ("on") or disabled ("off"). The event processing system implements several algorithms to throttle duplicate events.

[-console {on|off}] - Console Logging (privilege: advanced)

Use this parameter to configure whether events are displayed on the console port ("on") or not displayed("off").

[-proxy-url <text>] - HTTP/HTTPS Proxy URL

If your organization uses a proxy, use this parameter to specify an HTTP or HTTPS proxy for REST API type EMS notification destinations. The URL must start with an http:// or https:// prefix. If using an HTTPS proxy, you also need to install the correct Root CA certificates in ONTAP. To specify a URL that contains a question mark, press ESC followed by the "?". Setting this field to an empty string or '-' will clear all proxy settings including the URL, user and password.

[-proxy-user <text>] - User Name for HTTP/HTTPS Proxy

If authentication is required, use this parameter to specify the user name for the HTTP or HTTPS proxy server specified by the -proxy-url parameter. Use the event config set-proxy-password command to set the password used for this user name.

[-is-pubsub-enabled {true|false}] - Is Publish/Subscribe Messaging Enabled?

Use this parameter to configure whether or not events are published to the Publish/Subscribe messaging broker.

Examples

The following command sets the "Mail From" address for event notifications to "admin@example.com" and the "Mail Server" to "mail.example.com":

cluster1::> event config modify -mailfrom admin@example.com -mailserver mail.example.com

The following command configures a proxy that requires authentication:

cluster1::> event config modify -proxy-url http://proxy.example.com:8080 -proxy-user-name admin
cluster1::> event config set-proxy-password

Enter the password:
Confirm the password:

The following example turns on event suppression and console logging:

cluster1::> event config modify -suppression on -console on