How to configure E-Mail in PowerChute Business Edition Web Agent versions 9.5, 10.x

Issue:
How to set up E-Mail in PowerChute Business Edition Web Agent

Product:
PowerChute Business Edition Web Agent versions 9.5, & 10.x

Environment:
All supported OS

Cause:
Need to configure E-Mail/SMTP.

Solution:
Open PowerChute Business Edition web Agent and navigate to PowerChute - E-Mail Settings


E-Mail Settings
The E-Mail Settings screen lists the mail addresses of users configured to be notified when an event occurs. In order to receive mailings when an event occurs, the mail address must be set up here.
The following five fields must be defined to enable PowerChute to send e-mail messages when events occur. (This includes messages to pagers that accept e-mail).

• SMTP Server (Hostname, IPv4, or IPv6) identifies the SMTP server by one of the three methods mentioned: its name, its IPv4 address, or its IPv6 address. An example hostname is mail.server.com.
• From E-Mail Address specifies the e-mail address from which the recipient receives the e-mail. It is the e-mail account to be used to send notifications.
• Port specifies the port number from which e-mail is sent via SMTP. Port numbers can have a maximum of five digits and can be set to 25, 465, 587, or any number ranging from 5000 to 32768. If you do not enter a port number, the default of 25 is used.
• Use SSL/TLS defines the e-mail encryption protocol that will be used when e-mail is sent. There are three options available:
  • None Selected – if authentication is disabled, no e-mail encryption protocol will be used and e-mail will be sent un-encrypted. If authentication is enabled, e-mail will be encrypted using the SMTPS protocol.
  • SSL – e-mail will be encrypted using the SSL encryption protocol.
  • TLS – e-mail will be encrypted using the TLS encryption protocol.

If you are using SSL/TLS and your SMTP Server uses a self-signed certificate, the certificate must be added to the trusted certificate store of the bundled Java JRE. EXAMPLE: On Windows: Open a command prompt with Administrator privileges and type in the following command: "<PowerChute JRE Path>\bin\keytool.exe" –import –trustcacerts –alias mailserv –file server.crt –keystore "<PowerChute JRE Path>\lib\security\cacerts" –storepass changeit e.g. "C:\Program Files (x86)\APC\PowerChute Business Edition\jre1.8.0_31\bin\keytool.exe" –import –trustcacerts –alias mailserv –file server.crt –keystore "C:\Program Files (x86)\APC\PowerChute Business Edition\jre1.8.0_31\lib\security\cacerts" –storepass changeit On Unix/Linux: As an Administrator, type in the following command: <PowerChute JRE Path>/bin/keytool –import –trustcacerts –alias mailserv –file server.crt –keystore <PowerChute JRE Path>/lib/security/cacerts –storepass changeit e.g. /usr/local/bin/java/jre/1.8.0_31/bin/keytool –import –trustcacerts –alias mailserv –file server.crt –keystore /usr/local/bin/java/jre/1.8.0_31/lib/security/cacerts –storepass changeit Note: In the above examples, mailserv is the alias of the mail server used within the cert file, and server.crt is the self-signed SSL cert of the mail server.

NOTE: The PowerChute Console has a separate e-mail system (available under Configuration Profile there). Any new e-mails added here will not be sent to the Console list. The Console is not available with PCBE Agent 9.5 or 10.x

Adding and removing e-mail recipients
To add an e-mail address, under the Add/Remove E-Mail Recipients section, type an e-mail address and click the Apply button.
To remove an e-mail address, select the check box to the right of the address, and click Apply.
Filling in the Contact Name and System Location under Contact Information is optional. If present, the information is included in e-mails. The name is intended to represent the person responsible for the maintenance of the UPS. The location is the physical location of the server hosting the PowerChute Agent.

NOTE: We advise testing your e-mails after you add them. You can do this by selecting an E-Mail check box for an event with Event Configuration and then creating that event. A test e-mail feature will be added to a future release.

Authenticating e-mail
Authenticating e-mail is optional. You can enable it by selecting the Basic E-Mail for Authentication check box. Contact your e-mail administrator if you’re not sure about authentication.
If you’re going to use authentication, you can specify a server username and password in the respective fields, but you do not have to do so. If you don’t specify a server username and password, PowerChute uses the SMTP Server (Hostname, IPv4, or IPv6) to obtain a list of IP Addresses that are allowed to send authenticated e-mails.

To verify an email has been sent look in the pcbe.log file that will be found in the log folder/directory. If installed to the default path on Windows the folder is C:\Program Files (x86)\APC\PowerChute Business Edition\agent\log
On a Linux system the path is /opt/APC/PowerChuteBusinessEdtion/Agent/log

In the pcbe.log file, you should see
[SMTPMailWorker] WARN  - [SMTPMailer.SMTPMailWorker.()] Subject :Win10-System1 : Self Test Initiated
[SMTPMailWorker] WARN  - [SMTPMailer.SMTPMailWorker.()] Send mail ok
NOTE: Win10-System1 is the name of the computer the PowerChute Agent is running on. Self Test Initiated is the event that was configured to have an email sent.

If the email fails you may see
[SMTPMailWorker] WARN  - [SMTPMailer.SMTPMailWorker.()] SMTPMailConfigException :javax.mail.AuthenticationFailedException: 535 5.7.3 Authentication unsuccessful
That error was generated when the wrong password was ender in the SMTP sitting

This error was generated when attempting to connect to Gmail when "Allow less apps:" was set to off
[SMTPMailWorker] WARN  - [SMTPMailer.SMTPMailWorker.()] SMTPMailConfigException :javax.mail.AuthenticationFailedException: 535-5.7.8 Username and Password not accepted.

This error was generated when the SSL/TLS port is blocked by the firewall
[SMTPMailWorker] WARN  - [SMTPMailer.SMTPMailWorker.()] com.apcc.m11.components.SMTPMailer.SMTPMailConfigException: javax.mail.MessagingException: Exception reading response;
nested exception is:
java.net.SocketTimeoutException: Read timed out

NOTE: The PowerChute Business Edition Web Agent does not include an SMTP test feature. One will be added to a future release.

Released for:Schneider Electric Global