Reporting Problems

Summary

Raising issues is helpful, including stack traces can sometimes give clues, but given the variety of scenarios that can be conjured up, the ability to reproduce processing scenarios is key to fixing bugs (or extending behaviour yet again to handle another scenario). In order to reproduce, three things are needed:

#. Summary of what you were trying to achieve, even if its simplistic, and how
#. Stack trace if applicable
#. Your configuration file, its location in your file system, and a screen-shot of your service parameters
#. Email text, not just what you type in. Email messages can get wrapped up in many ways and combinations. Providing exact data allows problems to be looked at rather than wondered about, time permitting. Gmail has a 'show original' option which presents the underlying email, possibly with MIME content (below).

Please raise issues with as much of the above as possible in the Project Jira Issue Tracker.

Example mail texts for plaintext email

Plaintext


From testuser@dv7  Tue Nov 16 21:11:35 2010
Received: from dv7 (localhost.localdomain [127.0.0.1])
	by dv7 (Postfix) with ESMTP id 25296F51A
	for <andy@dv7>; Tue, 16 Nov 2010 21:11:35 +0000 (GMT)
Date: Tue, 16 Nov 2010 21:11:35 +0000 (GMT)
From: testuser@dv7
To: jira@jira.myco.net
Message-ID: <1054849253.20.1289941895148.JavaMail.andy@dv7>
Subject: Simple create from unknown JIRA-37
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Auto-Submitted: auto-generated
X-JIRA-FingerPrint: e42df9ecaad42b3bb29032a432d8886f

a comment to JIRA-37

Plaintext with more headers


From andy@localhost  Wed Mar  2 01:25:56 2011
Return-Path: <javahollic@gmail.com>
X-Original-To: test@jira.myco.net
Delivered-To: test@jira.myco.net
Received: from psmtp.com (unknown [64.18.3.76])
	by JIRAMAIL.cytexone.com (Postfix) with ESMTPS id 6525E6017F
	for <test@jira.myco.net>; Wed,  2 Mar 2011 01:25:55 -0500 (EST)
Received: from source ([209.85.161.45]) (using TLSv1) by exprod8mx278.postini.com ([64.18.7.10]) with SMTP;
	Tue, 01 Mar 2011 22:12:47 PST
Received: by fxm11 with SMTP id 11so5672567fxm.32
        for <test@jira.myco.net>; Tue, 01 Mar 2011 22:12:34 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:date:message-id:subject:from:to
         :content-type;
        bh=oshCkQ6jpIVke7ZWpZ/h9l1de+xFA+L3Y0pCnPYeq0g=;
        b=E9VnXoAYoeDa5qbqOi9mn/lbTqKmXPl2MCD98Hs+bSXjY9e1vZio4bKbRfirkaFkjM
         Eu/MQ9uzrb1pXUjyzymU3pUSKsGGy+DhKmuyUVawASLWptAy0nnwkSWRkSpujlb2Mekc
         KdTzC+r48ibiuKG5A6wgE0r8+D4R+a3sJTsc4=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type;
        b=dKxpG4Yxx6uPrtwYJyJfEORu7z0+AeYJ8dS67dUb+H4X0ZI1KmOj+3n9mYm5yf44ox
         98OQt1e5cVHWzu/urVmw3u1+napuJUGMV3DGT0Tsp0OX/SEJjX1Tld13wVzxswFYEhBo
         owuEmztuSlz3Xf6odPr46Yi4AAUHBmGSa/2Ko=
MIME-Version: 1.0
Received: by 10.223.86.13 with SMTP id q13mr9296134fal.53.1299046354853; Tue,
 01 Mar 2011 22:12:34 -0800 (PST)
Received: by 10.223.70.198 with HTTP; Tue, 1 Mar 2011 22:12:34 -0800 (PST)
Date: Wed, 2 Mar 2011 19:12:34 +1300
Message-ID: <AANLkTim7Cr9ZCZ4b8Zhw148iF9+jPo7vHEnNSgsnH7+b@mail.gmail.com>
Subject: plaintext mail to test@jira.myco.net TEST-2
From: Andy Brook <andy@localhost>
To: test@jira.myco.net
Content-Type: text/plain; charset="UTF-8"
X-pstn-neptune: 0/0/0.00/0
X-pstn-levels:     (S: 2.02854/99.82121 CV:99.9000 FC:95.5390 LC:95.5390 R:95.9108 P:95.9108 M:97.0282 C:98.6951 )
X-pstn-settings: 3 (1.0000:0.1500) s cv GT3 gt2 gt1 r p m c 
X-pstn-addresses: from <andy@localhost> [db-null] 

a simple comment €

MIME encoded content


MIME-Version: 1.0
Received: by 10.223.2.202 with HTTP; Sat, 19 Mar 2011 16:57:40 -0700 (PDT)
Date: Sun, 20 Mar 2011 12:57:40 +1300
Delivered-To: javahollic@gmail.com
Message-ID: <AANLkTi=2=xW_vbZsRFU+5E0Ghs6rj64VnCSMwQRzBH9n@mail.gmail.com>
Subject: example html email
From: Andy Brook <javahollic@gmail.com>
To: Andy Brook <javahollic@gmail.com>
Content-Type: multipart/alternative; boundary=0015174c0c86e25ac5049edea861

--0015174c0c86e25ac5049edea861
Content-Type: text/plain; charset=UTF-8

*This is a HTML <http://en.wikipedia.org/wiki/HTML> test email*

--0015174c0c86e25ac5049edea861
Content-Type: text/html; charset=UTF-8

<b style="color: rgb(255, 0, 0);">This is a <a href="http://en.wikipedia.org/wiki/HTML">HTML</a> test email</b><br>

--0015174c0c86e25ac5049edea861--