Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Overview

A FolderClosedException (FCE) is caused when the connection between Jira and the inbound Mail server is closed abruptly by the mail server whilst mail is being retrieved. JEMH is not responsible for the mail connection, which is handled by Jira.

Symptoms

Occasionally, emails will fail to be processed due to a FCE, resulting in a stack trace being added to the ‘atlassian-jira-incoming-mail.log’, for more info see:

2013-07-12 09:52:50,478 ERROR [xxx] QuartzScheduler_Worker-3 ServiceRunner xxxx[xxxxx]: Exception: null
javax.mail.FolderClosedException
	at com.sun.mail.imap.IMAPMessage.getProtocol(IMAPMessage.java:145)
	at com.sun.mail.imap.IMAPMessage.getHeader(IMAPMessage.java:743)
	at com.atlassian.jira.service.services.mail.MailFetcherService$MessageProviderImpl.getAndProcessMail(MailFetcherService.java:257)
	at com.atlassian.jira.service.services.mail.MailFetcherService.runImpl(MailFetcherService.java:356)
	at com.atlassian.jira.service.services.file.AbstractMessageHandlingService.run(AbstractMessageHandlingService.java:257)
	at com.atlassian.jira.service.JiraServiceContainerImpl.run(JiraServiceContainerImpl.java:61)
	at com.atlassian.jira.service.ServiceRunner.execute(ServiceRunner.java:48)
	at org.quartz.core.JobRunShell.run(JobRunShell.java:195)

If enabled, JEMH Inbound Auditing will also add this exception to the Inbound processing report, and attempting to download the related email, or generate a Support ZIP the following popup will be shown:

Causes

Large Emails

Mail items that are too large and take an excessive time to be retrieved can result in a FolderClosedException, as the mail server interoperates the long retreival time as an error, and closes the connection. This can be compounded if using the IMAP protocol which has a low default ‘Fetch’ size which makes mail retrial of larger mail items significantly slower. See for more info and steps to increase IMAP ‘Fetch’ size:

Concurrent logins

Mail servers have limits on the number of active connections for mail retrieval. If this limit is exceeded the mail server will close existing mail connections to create new connections. If mail is being retrieved and the connection is closed a FolderClosedException is created. Jira and JEMH work best when using a Mail server with limited mail connections, dedicated to automation.

If using multiple JEMH profiles to access the same mailbox, consider using a profile group to group multiple mail handlers to a single mail connection, to reduce traffic and boost performance:

  • No labels