Chapter 10. Setting Up SMTP for Cloud App Alerts
10.1. Overview
Each Cloud App can automatically send alerts by e-mail when specified events occur, such as when the Cloud App gets deployed, undeployed, or logs an error. See Alerts & Email Notifications for more information.
For the RHMAP 4.x MBaaS based on OpenShift 3, the e-mail function is not available immediately after installation. You must configure an SMTP server to enable e-mail support.
10.2. Prerequisites
- An RHMAP 4.x MBaaS running in OpenShift Enterprise 3
- An account on an SMTP server through which notification alerts can be sent
- An email address where alerts should be sent
- A deployed Cloud App
10.3. Configuring SMTP settings in fh-mbaas
The FH_EMAIL_SMTP and FH_EMAIL_ALERT_FROM environment variables in the fh-mbaas DeploymentConfig need to be set, using the below commands:
oc project <mbaas-project-id> oc env dc/fh-mbaas FH_EMAIL_SMTP="smtps://username:password@localhost" FH_EMAIL_ALERT_FROM="rhmap-admin@example.com"
After modifying the DeploymentConfig, a redeploy of the fh-mbaas pod should be triggered automatically. Once the pod is running again, you can verify the changes.
10.4. Verifying SMTP settings for MBaaS
- In the Studio, navigate to a deployed Cloud App.
- Go to the Notifications > Alerts section.
- Click Create An Alert .
- In the Emails field, enter your e-mail address.
- Click Test Emails.
You should receive an e-mail from the e-mail address set as FH_EMAIL_ALERT_FROM.
10.5. Troubleshooting
If the test email fails to send, verify the SMTP settings in the running fh-mbaas Pod.
oc env pod -l name=fh-mbaas --list | grep EMAIL
It may help to view the fh-mbaas logs while attempting to send an email, looking for any errors related to SMTP or email.
oc logs -f fh-mbaas-<deploy-uuid>
Ensure the Cloud App you are using to send a test mail with is running. If the test email sends OK, but fails to arrive, check it hasn’t been placed in your spam or junk folder.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.