How do I submit a detailed bug report

IMPORTANT: This is the legacy GATK documentation. This information is only valid until Dec 31st 2019. For latest documentation and forum click here

created by Geraldine_VdAuwera

on 2012-11-28

Note: only do this if you have been explicitly asked to do so.

Scenario:

You posted a question about a problem you had with GATK tools, we answered that we think it's a bug, and we asked you to submit a detailed bug report.

Here's what you need to provide:

• The exact command line that you used when you had the problem (in a text file)
• The full log output (program output in the console) from the start of the run to the end or error message (in a text file)
• A snippet of the BAM file if applicable and the index (.bai) file associated with it
• If a non-standard reference (i.e. not available in our resource bundle) was used, we need the .fasta, .fai, and .dict files for the reference
• Any other relevant files such as recalibration plots

A snippet file is a slice of the original BAM file which contains the problematic region and is sufficient to reproduce the error. We need it in order to reproduce the problem on our end, which is the first necessary step to finding and fixing the bug. We ask you to provide this as a snippet rather than the full file so that you don't have to upload (and we don't have to process) huge giga-scale files.

Here's how you create a snippet file:

• Look at the error message and see if it cites a specific position where the error occurred
• If not, identify what region caused the problem by running with -L argument and progressively narrowing down the interval
• Once you have the region, use PrintReads with -L to write the problematic region (with 500 bp padding on either side) to a new file -- this is your snippet file.
• Test your command line on this snippet file to make sure you can still reproduce the error on it.

And finally, here's how you send us the files:

• Put all those files into a .zip or .tar.gz archive
• Upload them onto our FTP server with the following credentials:
  • location: ftp.broadinstitute.org username: gsapubftp password: 5WvQWSfi
• Post in the original discussion thread that you have done this
• Be sure to tell us the name of your archive file!

We will get back to you --hopefully with a bug fix!-- as soon as we can.

Updated on 2016-06-29

From zhusitao on 2017-09-18

Hello： I tried GATK4 on spark cluster ,but the output bam result could not on my spark output path (HDFS).

A USER ERROR has occurred: Couldn’t write file /user/zhusitao/output/Mbam because writing failed with exception /user/zhusitao/output/Mbam.parts/_SUCCESS: Unable to find _SUCCESS file. Could you give me some advice to run GATK4 successfully on spark cluster.I will be waiting for your reply! Best wishes! Sitao Zhu



From Sheila on 2017-09-20

@zhusitao

Hi,

Have a look at [this thread](https://gatkforums.broadinstitute.org/gatk/discussion/9799/a-user-error-has-occurred-couldnt-write-file-because-writing-failed-with-exception). Are you using the latest release?

Thanks,

Sheila

From zhusitao on 2017-09-21

@Sheila

Hi,

I use the latest version 4.beta.5.The local jar works successfully,but the spark jar unable to find _SUCCESS file when write bam on HDFS.

From Sheila on 2017-09-25

@zhusitao

Hi,

Okay. So, the issue has not been fixed yet. As Geraldine mentioned in the other thread, the Spark tools are still experimental, so you should stick with the more stable non-spark tools.

-Sheila

From registered_user on 2018-10-26

The FTP server credentials do not seem to work. How can I submit my bug report?