No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search


To have a better experience, please upgrade your IE browser.


Command Reference

OceanStor 18000 and 18000F V5 Series V500R007

This document is applicable to OceanStor 18500 V5, 18800 V5, 18500F V5, and 18800F V5 storage systems. It describes hardware installation of those storage systems for helping you easily and quickly finish the installation.

Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
change notification email_extend

change notification email_extend


The change notification email_extend command is used to enable the email notification function and configure alarm and event notification mailboxes. Use this command if you want to enable the storage system to automatically send notification emails of the following to a specified mailbox: all alarms and the events with the email notification function enabled.


change notification email_extend enabled=? { smtp_server_ip=? | smtp_server_domain_name=? } sender=? authentication=? user=? password=? { receiver_email_list=? | event_receiver_email_list=? } * connection_security=? smtp_server_port=? [ function_test=? ] [ clear_email_title_prefix=? | email_title_prefix=? ] [ email_title_level_enable=? ]





enabled=? Whether to enable the email notification function.

The value can be "yes" or "no", where:

  • "yes": Enable the email alarm notification function.
  • "no": Disable the email alarm notification function.
The default value is "no".
function_test=? Whether to send a test email after the command is executed.

The value can be "yes" or "no", where:

  • "yes": To send the test email.
  • "no": Not to send the test email.
clear_email_title_prefix=? Clearing the email prefix.

The value must be "yes" which indicates the clear of the email prefix.

email_title_prefix=? Email title prefix.

The value consists of 1 to 511 ASCII characters and cannot contain single quotation marks (').

sender=? Sender email.

The value consists of 5 to 255 ASCII characters.

smtp_server_domain_name=? Domain name of the SMTP server.

The domain name is a case-insensitive string of 1 to 255 characters, including letters, digits (,) and hyphens (-). Domain names at various levels are separated by periods (.). Hyphens (-) cannot be the start or end of the domain name.

authentication=? Whether the SMTP server must be verified by a user.

The value can be "yes" or "no", where:

  • "yes": Verification is required.
  • "no": Verification is not required.
smtp_server_ip=? IP address of the SMTP server.

IPv4 or IPv6 address.

user=? Username used to log in to the SMTP server.
This parameter can be specified when "authentication" is set to "yes".

The value consists of 1 to 63 ASCII characters except single quotation marks (').

password=? Password used to log in to the SMTP server.
This parameter can be specified when "authentication" is set to "yes".

The value consists of 1 to 63 ASCII characters.

receiver_email_list=? Recipient mailbox for alarm notification.

Multiple alarm email addresses can be specified. Alarm email addresses of various levels are separated by commas (,) in a sequence of critical, major, and warning. Alarm email addresses of the same level are separated by semicolons (;) from one another. Each email address is 5 to 255 ASCII characters in length. For alarms of the same level, a maximum of 64 alarm email addresses can be added, and 192 alarm email addresses can be added for three levels.

connection_security=? Secure connection mode between the email sending server and the client.

The value can be "none", "ssl/tls", or "starttls", where:

  • "none": No secure connection mode is used.
  • "ssl/tls": ssl/tls is used to encrypt connections to ensure connection security.
  • "starttls": starttls is used.
To ensure data transfer security, secure connection modes are recommended.
smtp_server_port=? Port number of the SMTP server.

The value is an integer between 1 and 65535.

email_title_level_enable=? Whether to show alarm severities in email titles.

The value can be "yes" or "no", where:

  • "yes": show alarm severities in email titles.
  • "no": Not to show alarm severities in email titles.
event_receiver_email_list=? Email address list for receiving the event IDs with email notification enabled.

Multiple email addresses can be specified. Separate the email addresses by commas (,). Each email address must be 5 to 255 characters in length. A maximum of 64 email addresses can be configured to receive event notification emails.



Usage Guidelines

The command is used to configure only one mail server. The "add smtp_server general", "remove smtp_server general", "change smtp_server config", and "show smtp_server general" commands are used to configure two mail servers. You are advised to use the preceding four commands to configure mail servers for alarm notification.

  • Before running this command, configure an SMTP server and a valid SMTP account.
  • A maximum of 64 email addresses can be configured for alarms of the same level.
  • A maximum of 64 email addresses can be configured for events.
  • After notification by email is configured, the system sends alarms and the events with email notification function enabled to specified mailboxes by email. The email format is as follows:

    Dear OceanStor 5500 V5 users:

    System Name: OceanStor.Storage

    Location: China

    Customer Info: ClientName



    Level: Informational

    Occurred At: 2015-06-23 15:58:53

    Detail: This is a test message.

    Repair Suggestion: N/A

  • Each part of the email content is defined as follows:
    • Manufacturer and product type, for example, OceanStor 5500 V5.
    • Device name, for example, OceanStor.Storage.
    • Client of the storage system, for example, ClientName.
    • Device SN, for example, XXXXXXXXXXXXXXXXXXXX.
    • Alarm or event ID, which indicates an alarm or event, expressed in the hexadecimal format, for example, 0x1FFFFFFFFFFFFFFB.
    • Alarm or event level. The levels include info, warning, major, and critical.
    • Time when an alarm or event occurs, for example, 2015-06-23 15:03:36.
    • Alarm or event description, for example, "This Is A Test Message."
    • Alarm or event clearance suggestion, for example, N/A.
  • The value of "connection_security" must be consistent with the mailbox server configuration. Otherwise, emails cannot be successfully sent.
  • The query command that corresponds to this command is "show notification email_extend".
  • The following parameters or parameter sets are mutually exclusive: clear_email_title_prefix and email_title_prefix.


Enable the email alarm notification function and set the sender email address to "", SMTP server port to "4232", security connection mode to "ssl/tls", username and password for authenticating the email sending server to "admin" and "123456", email title prefix to "new", and alarm severity display switch to "on".

admin:/>change notification email_extend enabled=yes smtp_server_ip= authentication=yes user=admin password=****** connection_security=ssl/tls smtp_server_port=4232 function_test=no email_title_prefix=new email_title_level_enable=yes
Change configuration successfully.

System Response


Updated: 2020-01-17

Document ID: EDOC1000181601

Views: 382139

Downloads: 56

Average rating:
This Document Applies to these Products

Related Version

Related Documents

Previous Next