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 3 Next »

Dont Panic!

This page will guide you to log your issue and get timely support, and enable you to provide required information that will lead to a faster resolution!

We are here to help

But you can help us to help you faster, please read on!

General Support

Raising Issues Directly

Interactive JIRA users can log support requests can be created in our SUPPORT Project - https://thepluginpeople.atlassian.net/browse/SUPPORT 

Projects

There are specific JIRA Projects for each Product, please pick the right product project, eg:

Raising Issues by Email

Email users may also send support requests to support@thepluginpeople.com , this will create issues by email through our upcoming JEMH-OD product.

Telephone

Support by voice is not a primary support channel as the information usually required can't be easily expressed this way.  Please use the JIRA route initially!  For absolute "It's dead Jim" emergencies, see the Plugin People Vendor Profile on Marketplace, likely the outcome will still be to please log an issue!

Tweet us!

If you want to, tweet us @theplugineople if you can ask the question, we'll try and respond, but, you may be asked to pls log an issue!

Issue Tracker

We use JIRA for tracking all product related problems and support issues.  You can sign up for free to our issue tracker at https://thepluginpeople.atlassian.net to gain interactive use of our support system

all projects are there, each will be linked below, along with any specific informational requirements each addon has.

When Logging an Issue

SummaryMake the summary something that concisely describes your problem, "Its broken" or "It doesn't work" is non-specific and doesn't aid understanding!
Description

Make the description more detailed that the summary, provide a walk through of:

  • What is the result you want to get
  • What results are you getting now
  • What have you tried to fix it?
Required Data

The following are globally required values, please remember to set key information on the issue when logging a support case:

  • Atlassian application and version, e.g. JIRA 6.2.7
  • Database, if you have a start up problem (e.g. Mysql, Postgres)
  • Plugin People Product name (e.g. JEMH, SU, EMQ)
  • Plugin People Product version (e.g. 1.2)
Time/IssueKeyIf logs are provided, please identify the time at which the problem was observed, and the issue involved.

Product Specific Information

JEMH - Enterprise Mail Handler for JIRA

Logs

Logs are great, they have much detail that can be useful, please DO NOT paste log content into descriptions, its hard to read, please DO attach them as text, if there are <20 lines that are important, sure paste them in {noformat} .... {noformat} markup blocks

Common logs required are:

  • atlassian-jira.log  (located in JIRA_HOME/log), this is very useful, and provides some related background
  • atlassian-jira-incoming-mail.log (located in JIRA_HOME/log, enabled via JIRA System Admin > Troubleshooting and Support > Logging & Profiling >  Mail > Incoming Mail), it needs to be ENABLED and DEBUGGING enabled too.
  • emh.log (located in JIRA_HOME/log), See Installation, Setup and Logging for configuration steps, this is a physical change to the log4j.properties file, and requires a JIRA restart, so may require scheduling to apply.  The benefit is that it puts all JEMH logging in one place, with no logging distractions from anything else in the system

When attaching logs,  please DO identify a Time and if applicable, Issue key that identifies the time you observed the problem.  If you are not clear on the time, reproduce the problem by creating a JEMH Test Case from JEMH Audit History email content (there is an option for each audit history row).

Problems relating to email processing

  • DO attach a complete example, as exported from the JEMH Auditing page (if you don't have this enabled, do so, and repeat the trigger to collect it).  Proving fake email content that you believe expresses the problem may work in some cases but may also waste a lot of time, with to/fro clarification, delaying resolution of your problem!
  • DO attach your current Profile XML, exported from the JEMH Profile list page - in doing so validate that it is the same Profile that is associated with your inbound mail server.
  • DO NOT attach drag and drop email content from Outlook, they are a proprietary binary format, can't be used and will be deleted if uploaded.

Problems relating to issue creation / permissions

If all your users are full JIRA interactive users, validate their access to the expected projects.  

For non-interactive JIRA account users, validate the access (perhaps by JEMH allocated groups) are sufficient for the expected projects.

For email only users without any kind of JIRA account, validate the access allocated to the Profile default reporter for the expected projects.

(info) Testing permissions is really quick and easy, just create a JEMH Test Case, from: the user in question to:  your inbound mailbox and run it!

Check the common problems page for existing resolutions

Some common problems have cropped up over time, see the Common Problems Page for resolutions.

 

  • No labels