Emails stop working and are no longer being sent.

Document ID : KB000020977
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

Especially after an upgrade of IDM you might get into a situation where emails stop being sent.

The log file may reveal the following trace:

 	2013-01-18 11:24:27,954 ERROR [ims.policyxpress.mail] (WorkManager(2)-37) 	
 	Failed sending email 	
 	com.ca.identitymanager.policyxpress.exceptions.PxEnvironmentException: Error 	
 	sending email 	
 	at 	
 	com.ca.identitymanager.policyxpress.plugins.shared.EmailData.sendMail(EmailDat 	
 	a.java:100) 	
 	at 	
 	com.ca.identitymanager.policyxpress.plugins.events.SendEmailEvent.execute(Send 	
 	EmailEvent.java:44) 	
 	at 	
 	com.netegrity.ims.businessprocess.IMSEventController.executing(IMSEventControl 	
 	ler.java:259) 	
 	at 	
 	com.netegrity.ims.businessprocess.IMSController.executing(IMSController.java:5 	
 	8) 	
 	at 	
 	com.netegrity.ims.bootstrap.IMSMessageListener.processEventToNextSavePoint(IMS 	
 	MessageListener.java:402) 	
 	at 	
 	com.netegrity.ims.bootstrap.IMSMessageListener.handleMessage(IMSMessageListene 	
 	r.java:192) 	
 	However, further down the log trace you see and invalid email address: 	
 	Caused by: com.sun.mail.smtp.SMTPSendFailedException: 501 5.1.7 Invalid 	
 	address 	
 	at 	
 	com.sun.mail.smtp.SMTPTransport.issueSendCommand(SMTPTransport.java:1388) 	
 	at 	
   com.sun.mail.smtp.SMTPTransport.mailFrom(SMTPTransport.java:959)

Solution:

The email.properties file that's located under /iam_im.ear/config/com/netegrity/config gets run over by an upgrade. You do need to back it up and restore it after the upgrade.

That file holds the property of the 'From Address' for your emails. The parameter is: admin.email.address=<Here is where you paste your address>

If that property is left undefined (which is what happens when upgrading without restoring this file) then you'll get into the SMTP exception that is in the symptom and it will prevent the emails from being sent out.

Make sure to backup this file before the upgrade and restore it to that same location post upgrade and/or me sure to define this value correctly prior to sending emails.