DES-1228/ME Metro Ethernet Managed Switch CLI Reference Guide
285
32
SMTP
C
OMMANDS
SMTP or Simple Mail Transfer Protocol is a function of the Switch that will send switch events to mail recipients based on e-mail
addresses entered using the commands below. The Switch is to be configured as a client of SMTP while the server is a remote
device that will receive messages from the Switch, place the appropriate information into an e-mail and deliver it to recipients
configured on the Switch. This can benefit the Switch administrator by simplifying the management of small workgroups or
wiring closets, increasing the speed of handling emergency Switch events and enhancing security by recording questionable
events occurring on the Switch.
The Switch plays four important roles as a client in the functioning of SMTP:
The server and server virtual port must be correctly configured for this function to work properly. This is accomplished in the
config smtp command by properly configuring the server and server_port parameters.
Mail recipients must be configured on the Switch. This information is sent to the server which then processes the information and
then e-mails Switch information to these recipients. Up to 8 e-mail recipients can be configured on the Switch using the config
smtp command by configuring the add mail_receiver and delete mail_receiver parameters.
The administrator can configure the source mail address from which messages are delivered to configured recipients. This can
offer more information to the administrator about Switch functions and problems. The personal e-mail can be configured using the
config smtp command and setting the self_mail_addr parameter.
The Switch can be configured to send out test mail to first ensure that the recipient will receive e-mails from the SMTP server
regarding the Switch. To configure this test mail, the SMTP function must first be enabled using the enable smtp command and
then by entering the smtp send_testmsg command. All recipients configured for SMTP will receive a sample test message from
the SMTP server, ensuring the reliability of this function.
THE SWITCH WILL SEND OUT E-MAIL TO RECIPIENTS WHEN ONE OR MORE OF THE FOLLOWING EVENTS OCCUR:
When a cold start or a warm start occurs on the Switch.
When a port enters a link down status.
When a port enters a link up status.
When SNMP authentication has been denied by the Switch.
When a switch configuration entry has been saved to the NVRAM by the Switch.
When an abnormality occurs on TFTP during a firmware download event. This includes invalid-file, file-not-found, complete and
time-out messages from the TFTP server.
When a system reset occurs on the Switch.
Information within the e-mail from the SMTP server regarding switch events includes:
The source device model name and IP address.
A timestamp denoting the identity of the SMTP server and the client that sent the message, as well as the time and date of the
message received from the Switch. Messages that have been relayed will have timestamps for each relay.
The event that occurred on the Switch, prompting the e-mail message to be sent.
When an event is processed by a user, such as save or firmware upgrade, the IP address, MAC address and User Name of the user
completing the task will be sent along with the system message of the event occurred.
When the same event occurs more than once, the second mail message and every repeating mail message following will have the
system’s error message placed in the subject line of the mail message.
The following details events occurring during the Delivery Process.
Urgent mail will have high priority and be immediately dispatched to recipients while normal mail will be placed in a queue for
future transmission.
The maximum number of untransmitted mail messages placed in the queue cannot exceed 30 messages. Any new messages will
be discarded if the queue is full.
If the initial message sent to a mail recipient is not delivered, it will be placed in the waiting queue until its place in the queue has
been reached, and then another attempt to transmit the message is made.
The maximum attempts for delivering mail to recipients is three. Mail message delivery attempts will be tried every five minutes
until the maximum number of attempts is reached. Once reached and the message has not been successfully delivered, the
message will be dropped and not received by the mail recipient.
If the Switch shuts down or reboots, mail messages in the waiting queue will be lost.
The SMTP commands in the Command Line Interface (CLI) are listed (along with the appropriate parameters) in the following
table:
