Clarity PPM - Configure email in a Jaspersoft server post installation

Products

• Clarity PPM SaaS
• Clarity PPM On Premise

Issue/Introduction

When you find that in the Jaspersoft report server installation process you did not enter the information to configure the email server in Jaspersoft and If the default configuration is kept the report schedules fails:

Error: Job: report (ID: 11) Report unit: /ca_ppm/reports/administration/CSK_ADM_DataWarehouseSchema Quartz Job: ReportJobs.job_11 Quartz Trigger: ReportJobs.trigger_11_0 Error Message: The job error notification was not completed. An error occurred while sending it. Exceptions: org.springframework.mail.MailSendException: Mail server connection failed; nested exception is com.sun.mail.util.MailConnectException: Couldn't connect to host, port: mail.localhost.com, 25;

If the need is to change this email service configuration, below resolution is a quick view of how to do this. 

 

Environment

Release: All Supported Releases
Component: Jaspersoft for Clarity PPM

Resolution

1. Stop Jaspersoft : shutdown.bat
2. Open the file js.quartz.properties under the directory of the Tomcat and Jaspersoft is installed
   • X:\CA\apache-tomcat-7.0.55\webapps\reportservice\WEB-INF
3. Modify the setting in the file js.quartz.properties: 
   • report.scheduler.mail.sender.host=someServer
   • report.scheduler.mail.sender.username=admin 
   • report.scheduler.mail.sender.password=password 
   • report.scheduler.mail.sender.from=do-not-reply@someServer 
   • report.scheduler.mail.sender.protocol=smtp
   • report.scheduler.mail.sender.port=25
     
     Note: If the SMTP server does not require login credentials, these lines can be left blank. E.G.:
     report.scheduler.mail.sender.username=
     report.scheduler.mail.sender.password=
     
     If your mail server does require authentication, update those two above lines

4. if the SMTP server connection is via secure connection "SMTPS" then you may also need to enable SMTPS in jasperserver-pro\WEB-INF\applicationContext-report-scheduling.xml file:
   
              AND change the following (to true):

   <property name="javaMailProperties">

   <props>
<prop key="mail.smtp.auth">true</prop>
</props>
</property>

5. Save the files
6. Start Jaspersoft: Startup.bat

Additional Information

See also:

Clarity - How Can Mail Be Configured for Notifications?