blob: ef541bfe83df60e6b0d24738a1ad02d4d3521eeb [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>ActiveMQ</title>
<link rel="icon" type="image/png" href="/assets/img/favicon.png">
<link rel="stylesheet" href="/css/main.css">
<script defer src="/js/fontawesome-all.min.js" integrity="sha384-rOA1PnstxnOBLzCLMcre8ybwbTmemjzdNlILg8O7z1lUkLXozs4DHonlDtnE7fpc"></script>
<script src="/js/jquery.slim.min.js" integrity="sha384-5AkRS45j4ukf+JbWAfHL8P4onPA9p0KwwP7pUdjSQA3ss9edbJUJc/XcYAiheSSz"></script>
<script src="/js/popper.min.js" integrity="sha384-ApNbgh9B+Y1QKtv3Rn7W3mgPxhU9K/ScQsAP7hUibX39j7fakFPskvXusvfa0b4Q"></script>
<script src="/js/bootstrap.min.js" integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl"></script>
</head>
<body>
<nav class="navbar navbar-expand-lg navbar-light fixed-top">
<div class="container">
<!-- <a class="navbar-brand mr-auto" href="#"><img style="height: 50px" src="assets/img/apache-feather.png" /></a> -->
<a class="navbar-brand mr-auto" href="/"><img src="/assets/img/activemq_logo_black_small.png" style="height: 50px"/></a>
<button class="navbar-toggler ml-auto" type="button" data-toggle="collapse" data-target="#navbarContent" aria-controls="navbarContent" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="ml-auto collapse navbar-collapse" id="navbarContent">
<ul class="navbar-nav ml-auto">
<li class="nav-item">
<a class="nav-link active" href="/news">News</a>
</li>
<li class="nav-item dropdown">
<a class="nav-link" id="navbarDropdownComponents" data-target="#" href="" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Components<span class="caret"></span></a>
<ul class="dropdown-menu dropdown-menu-center" aria-labelledby="navbarDropdownComponents">
<div class="row">
<div class="col-12">
<ul class="multi-column-dropdown">
<li class="nav-item"><a class="dropdown-item" href="/components/classic">ActiveMQ Classic</a></li>
<li class="nav-item"><a class="dropdown-item" href="/components/artemis/">ActiveMQ Artemis</a></li>
<li class="nav-item"><a class="dropdown-item" href="/components/nms">NMS Clients</a></li>
<li class="nav-item"><a class="dropdown-item" href="/components/cms">CMS Client</a></li>
</ul>
</div>
</div>
</ul>
</li>
<li class="nav-item dropdown">
<a class="nav-link" id="navbarDropdownCommunity" data-target="#" href="" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Community<span class="caret"></span></a>
<ul class="dropdown-menu dropdown-menu-center multi-column columns-1" aria-labelledby="navbarDropdownCommunity">
<div class="row">
<div class="col-12">
<ul class="multi-column-dropdown">
<li class="nav-item"><a class="dropdown-item" href="/contact">Contact Us</a></li>
<li class="nav-item"><a class="dropdown-item" href="/contributing">Contribute</a></li>
<li class="nav-item"><a class="dropdown-item" href="/issues">Report Issues</a></li>
<li class="nav-item"><a class="dropdown-item" href="/support">Get Support</a></li>
</ul>
</div>
</div>
</ul>
</li>
<li class="nav-item dropdown">
<a class="nav-link" id="navbarDropdownTeam" data-target="#" href="" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"><img src="/assets/img/feather.png" style="height:20px">Apache<span class="caret"></span></a>
<ul class="dropdown-menu dropdown-menu-center multi-column columns-1" aria-labelledby="navbarDropdownTeam">
<div class="row">
<div class="col-sm-12">
<ul class="multi-column-dropdown">
<li class="nav-item"><a class="dropdown-item" href="https://www.apache.org">The Apache Software Foundation</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://www.apache.org/licenses/">License</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://www.apache.org/foundation/thanks.html">Thanks</a></li>
<li class="nav-item"><a class="dropdown-item" href="/security-advisories">Security</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://www.apache.org/events/current-event">Events</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://people.apache.org/phonebook.html?pmc=activemq">PMC & Committers</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://whimsy.apache.org/board/minutes/ActiveMQ.html">Board Reports</a></li>
<li class="nav-item"><a class="dropdown-item" href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a></li>
</ul>
</div>
</div>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<div class="content">
<div class="page-title-main">
<div class="container">
<h1>Reporting Issues</h1>
</div>
</div>
<div class="container" >
<div class="row" style="margin-top: 30px">
<div class="col-12 main">
<p>If you find a bug please raise a new issue in the appropriate tracker. If you’re not quite sure you’re hitting a bug consider <a href="contact">contacting us</a> to get some clarity.</p>
<p>Whenever you are reporting a problem please be sure to include as much information as possible; the more we know the more chance of a quicker resolution. Here’s a few items to consider:</p>
<ul>
<li>Which version of the component are you using on which Java platform?</li>
<li>Any particular application/web server or container being used? If so what version?</li>
<li>Stack traces generally really help! If in doubt include the whole thing. Often exceptions get wrapped in other exceptions and the exception right near the bottom explains the actual error, not the first few lines at the top.</li>
<li>Log output can be useful too. Sometimes enabling <code class="language-plaintext highlighter-rouge">DEBUG</code> logging can help.</li>
<li>Your code &amp; configuration files are often useful.</li>
</ul>
<p>We can help you much quicker if you try the following:</p>
<ul>
<li>Provide us with a JUnit test case that demonstrates your issue. For example, if you think you’ve found a bug can you create a test case to demonstrate the bug?</li>
<li><a href="contributing">Send a PR</a> to fix the bug!</li>
<li>For memory leaks or performance related issues, if you can run a profiler on your test case and attach the output as a file (or zipped file if it’s huge) to the issue we can normally fix things much faster. e.g. you could run <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/share/jmap.html">jmap</a>/<a href="https://docs.oracle.com/javase/7/docs/technotes/tools/share/jhat.html">jhat</a>, JProfiler or YourKit on your code and send us the output. To find memory leaks it’s quicker to resolve if you can tell us what classes are taking up all of the RAM; we can normally figure out what’s wrong from that.</li>
</ul>
<table>
<thead>
<tr>
<th>Component</th>
<th>Issue Tracker</th>
</tr>
</thead>
<tbody>
<tr>
<td>Classic</td>
<td><a href="https://issues.apache.org/jira/projects/AMQ">https://issues.apache.org/jira/projects/AMQ</a></td>
</tr>
<tr>
<td>Artemis</td>
<td><a href="https://issues.apache.org/jira/projects/ARTEMIS">https://issues.apache.org/jira/projects/ARTEMIS</a></td>
</tr>
<tr>
<td>NMS</td>
<td><a href="https://issues.apache.org/jira/projects/AMQNET">https://issues.apache.org/jira/projects/AMQNET</a></td>
</tr>
<tr>
<td>CMS</td>
<td><a href="https://issues.apache.org/jira/projects/AMQCPP">https://issues.apache.org/jira/projects/AMQCPP</a></td>
</tr>
</tbody>
</table>
<h4 id="using-the-issue-tracker">Using the issue tracker</h4>
<p>Before you can create an issue in the issue tracker you need to <a href="https://selfserve.apache.org/jira-account.html">request an account</a>. When requesting the account please <strong>be specific</strong> about the reason you need it. Please give a brief synopsis of the bug you’re encountering or feature you need. If you’re not quite sure you’re hitting an actual bug or you’re not sure if the feature you need is valid, etc. please <a href="contact">contact us on the users mailing list</a> to get some clarity. Account requests with vague reasons <strong>will be rejected</strong>.</p>
<p>If you want to be the “assignee” of an issue you need to be in the list of <code class="language-plaintext highlighter-rouge">activemq-developers</code> on the issue tracker. To join the group please mail the <a href="mailto:dev@activemq.apache.org">dev mailing list</a> with the email address you used to register with the issue tracker and we’ll add you to the group.</p>
<h4 id="contributing-your-own-fixes">Contributing Your Own Fixes</h4>
<p>Want to do some hacking on ActiveMQ? Try surfing to our issue trackers for open issues or features that need to be implemented. Take ownership of an issue and try fix it. See the article on <a href="contributing">contributing</a> for more details on how to get the code.</p>
<p>If you can create a JUnit test case then your issue is more likely to be resolved quicker. Then we can add your issue to the test suite and then we’ll know when its really fixed and we can ensure that the problem <strong>stays fixed</strong> in future releases.</p>
<h4 id="activemq-issues-mailing-list">ActiveMQ Issues Mailing List</h4>
<p>This mailing list is automatically notified when JIRA issues are created and updated.</p>
<table>
<tbody>
<tr>
<td>Subscribe</td>
<td><a href="mailto:issues-subscribe@activemq.apache.org">issues-subscribe@activemq.apache.org</a></td>
</tr>
<tr>
<td>Unsubscribe</td>
<td><a href="mailto:issues-unsubscribe@activemq.apache.org">issues-unsubscribe@activemq.apache.org</a></td>
</tr>
<tr>
<td>Web Interface</td>
<td><a href="https://lists.apache.org/list.html?issues@activemq.apache.org">https://lists.apache.org/list.html?issues@activemq.apache.org</a></td>
</tr>
<tr>
<td>Apache Archive</td>
<td><a href="http://mail-archives.apache.org/mod_mbox/activemq-issues/">http://mail-archives.apache.org/mod_mbox/activemq-issues/</a></td>
</tr>
<tr>
<td>Mark Mail Archive</td>
<td><a href="http://activemq.markmail.org/search/list:org.apache.activemq.issues">http://activemq.markmail.org/search/list:org.apache.activemq.issues</a></td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div class="row sitemap">
<div class="col-sm-12">
<div class="container">
<div class="row">
<div class="col-sm-12">
<div class="row">
<div class="col-sm-3">
<div >
<img class="float-left" style="max-height: 100px" src="/assets/img/activemq_logo_white_vertical_small.png"/>
</div>
</div>
<div style="text-align: center; margin-bottom: 0px; margin-top: 30px; font-size: 65%" class="col-sm-6">
<p><a href="https://www.apache.org/foundation/marks/list/">Apache, ActiveMQ, Apache ActiveMQ</a>, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. Copyright &copy; 2024, The Apache Software Foundation. Licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.</p>
</div>
<div class="col-sm-3">
<div >
<a href="https://www.apache.org"><img class="float-right" style="margin-top: 10px; max-height: 80px" src="/assets/img/apache-logo-small.png"/></a>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>