How to trace email session in Wildfly 8.2.x environment for troubleshooting email delivery problem

Products

• CA Identity Manager
• CA Identity Governance
• CA Identity Portal
• CA Risk Analytics
• CA Secure Cloud SaaS - Arcot A-OK (WebFort)
• CLOUDMINDER ADVANCED AUTHENTICATION
• CA Secure Cloud SaaS - Advanced Authentication
• CA Secure Cloud SaaS - Identity Management
• CA Secure Cloud SaaS - Single Sign On

Issue/Introduction

In the Identity Manager environment, sometimes our end users complain that they don't receive email Activation Code (a.k.a. One Time Password). Hence we need a way to trace the SMTP session before engaging the mail service provider to check if there is any mail delivery problem.

 

Resolution

1. Open Wildfly configuration file, (i.e. wildfly-8.2.1\standalone\configuration\standalone-full.xml).
2. Find the section of mail service subsystem , add debug="true" attribute on each of the mail-session items.
   
   <subsystem xmlns="urn:jboss:domain:mail:2.0">
   
   <mail-session debug="true" jndi-name="java:jboss/mail/Default" name="default">
   <smtp-server outbound-socket-binding-ref="mail-smtp"/>
   </mail-session>
   
   <mail-session debug="true" jndi-name="java:/Mail" name="IMMail">
   <smtp-server outbound-socket-binding-ref="mail-smtp"/>
   </mail-session>
   
   </subsystem>
3. Save the change
4. Follow TEC1666703 or this techdoc to deploy the logging.jsp
5. Restart the Identity Manager server
6. Access the logging.jsp, i.e. http://<ExampleServer:8080>/iam/im/logging.jsp 
7. On the Set Logger page, add a Category STDOUT and click on Set. Please keep the logging level as ALL
8. Try to trigger the IM server to send out an email.
9. Check the Identity Manager server.log, you will see all the full SMTP session being logged.
10. The logs can be sent to mail service provider for troubleshooting purpose.