CINXE.COM
Managing Amazon MQ for RabbitMQ engine versions - Amazon MQ
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Managing Amazon MQ for RabbitMQ engine versions - Amazon MQ</title><meta name="viewport" content="width=device-width,initial-scale=1" /><meta name="assets_root" content="/assets" /><meta name="target_state" content="rabbitmq-version-management" /><meta name="default_state" content="rabbitmq-version-management" /><link rel="icon" type="image/ico" href="/assets/images/favicon.ico" /><link rel="shortcut icon" type="image/ico" href="/assets/images/favicon.ico" /><link rel="canonical" href="https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" /><meta name="description" content="Describes the difference between Amazon MQ for RabbitMQ minor and major engine versions, lists supported RabbitMQ engine versions, and information about upgrading brokers." /><meta name="deployment_region" content="IAD" /><meta name="product" content="Amazon MQ" /><meta name="guide" content="Developer Guide" /><meta name="abstract" content="Use Amazon MQ to set up and operate message brokers in the cloud." /><meta name="guide-locale" content="en_us" /><meta name="tocs" content="toc-contents.json" /><link rel="canonical" href="https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" /><link rel="alternative" href="https://docs.aws.amazon.com/id_id/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="id-id" /><link rel="alternative" href="https://docs.aws.amazon.com/id_id/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="id" /><link rel="alternative" href="https://docs.aws.amazon.com/de_de/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="de-de" /><link rel="alternative" href="https://docs.aws.amazon.com/de_de/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="de" /><link rel="alternative" href="https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="en-us" /><link rel="alternative" href="https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="en" /><link rel="alternative" href="https://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="es-es" /><link rel="alternative" href="https://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="es" /><link rel="alternative" href="https://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="fr-fr" /><link rel="alternative" href="https://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="fr" /><link rel="alternative" href="https://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="it-it" /><link rel="alternative" href="https://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="it" /><link rel="alternative" href="https://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="ja-jp" /><link rel="alternative" href="https://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="ja" /><link rel="alternative" href="https://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="ko-kr" /><link rel="alternative" href="https://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="ko" /><link rel="alternative" href="https://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="pt-br" /><link rel="alternative" href="https://docs.aws.amazon.com/pt_br/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="pt" /><link rel="alternative" href="https://docs.aws.amazon.com/zh_cn/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="zh-cn" /><link rel="alternative" href="https://docs.aws.amazon.com/zh_tw/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="zh-tw" /><link rel="alternative" href="https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" hreflang="x-default" /><meta name="feedback-item" content="AMQ" /><meta name="this_doc_product" content="Amazon MQ" /><meta name="this_doc_guide" content="Developer Guide" /><script defer="" src="/assets/r/vendor4.js?version=2021.12.02"></script><script defer="" src="/assets/r/vendor3.js?version=2021.12.02"></script><script defer="" src="/assets/r/vendor1.js?version=2021.12.02"></script><script defer="" src="/assets/r/awsdocs-common.js?version=2021.12.02"></script><script defer="" src="/assets/r/awsdocs-doc-page.js?version=2021.12.02"></script><link href="/assets/r/vendor4.css?version=2021.12.02" rel="stylesheet" /><link href="/assets/r/awsdocs-common.css?version=2021.12.02" rel="stylesheet" /><link href="/assets/r/awsdocs-doc-page.css?version=2021.12.02" rel="stylesheet" /><script async="" id="awsc-panorama-bundle" type="text/javascript" src="https://prod.pa.cdn.uis.awsstatic.com/panorama-nav-init.js" data-config="{'appEntity':'aws-documentation','region':'us-east-1','service':'amazon-mq'}"></script><meta id="panorama-serviceSubSection" value="Developer Guide" /><meta id="panorama-serviceConsolePage" value="Managing Amazon MQ for RabbitMQ engine versions" /></head><body class="awsdocs awsui"><div class="awsdocs-container"><awsdocs-header></awsdocs-header><awsui-app-layout id="app-layout" class="awsui-util-no-gutters" ng-controller="ContentController as $ctrl" header-selector="awsdocs-header" navigation-hide="false" navigation-width="$ctrl.navWidth" navigation-open="$ctrl.navOpen" navigation-change="$ctrl.onNavChange($event)" tools-hide="$ctrl.hideTools" tools-width="$ctrl.toolsWidth" tools-open="$ctrl.toolsOpen" tools-change="$ctrl.onToolsChange($event)"><div id="guide-toc" dom-region="navigation"><awsdocs-toc></awsdocs-toc></div><div id="main-column" dom-region="content" tabindex="-1"><awsdocs-view class="awsdocs-view"><div id="awsdocs-content"><head><title>Managing Amazon MQ for RabbitMQ engine versions - Amazon MQ</title><meta name="pdf" content="/pdfs/amazon-mq/latest/developer-guide/amazon-mq-dg.pdf#rabbitmq-version-management" /><meta name="rss" content="recent-updates.rss" /><meta name="forums" content="https://repost.aws/tags/TAYRafuC0UQvCx_4E9n3IwNw" /><meta name="feedback" content="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=AMQ&topic_url=https://docs.aws.amazon.com/en_us/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" /><meta name="feedback-yes" content="feedbackyes.html?topic_url=https://docs.aws.amazon.com/en_us/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" /><meta name="feedback-no" content="feedbackno.html?topic_url=https://docs.aws.amazon.com/en_us/amazon-mq/latest/developer-guide/rabbitmq-version-management.html" /><meta name="keywords" content="Amazon MQ,message,queue,topic,producer,consumer,on-premises,Amazon MQ for RabbitMQ,automatic minor version upgrades,major version upgrades,engine version,upgrading broker" /><script type="application/ld+json"> { "@context" : "https://schema.org", "@type" : "BreadcrumbList", "itemListElement" : [ { "@type" : "ListItem", "position" : 1, "name" : "AWS", "item" : "https://aws.amazon.com" }, { "@type" : "ListItem", "position" : 2, "name" : "Amazon MQ", "item" : "https://docs.aws.amazon.com/amazon-mq/index.html" }, { "@type" : "ListItem", "position" : 3, "name" : "Developer Guide", "item" : "https://docs.aws.amazon.com/amazon-mq/latest/developer-guide" }, { "@type" : "ListItem", "position" : 4, "name" : "Using Amazon MQ for RabbitMQ", "item" : "https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/working-with-rabbitmq.html" }, { "@type" : "ListItem", "position" : 5, "name" : "Managing Amazon MQ for RabbitMQ engine versions", "item" : "https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/working-with-rabbitmq.html" } ] } </script></head><body><div id="main"><div style="display: none"><a href="/pdfs/amazon-mq/latest/developer-guide/amazon-mq-dg.pdf#rabbitmq-version-management" target="_blank" rel="noopener noreferrer" title="Open PDF"></a></div><div id="breadcrumbs" class="breadcrumb"><a href="https://aws.amazon.com">AWS</a><a href="/index.html">Documentation</a><a href="/amazon-mq/index.html">Amazon MQ</a><a href="welcome.html">Developer Guide</a></div><div id="page-toc-src"><a href="#rabbitmq-version-management-calendar">Supported engine versions on Amazon MQ for RabbitMQ</a><a href="#rabbitmq-version-management-upgrading">Engine version upgrades</a><a href="#rabbitmq-version-management-listing-versions">Listing supported engine versions</a></div><div id="main-content" class="awsui-util-container"><div id="main-col-body"><awsdocs-language-banner data-service="$ctrl.pageService"></awsdocs-language-banner><h1 class="topictitle" id="rabbitmq-version-management">Managing Amazon MQ for RabbitMQ engine versions</h1><div class="awsdocs-page-header-container"><awsdocs-page-header></awsdocs-page-header><awsdocs-filter-selector id="awsdocs-filter-selector"></awsdocs-filter-selector></div><p> RabbitMQ organizes version numbers according to semantic versioning specification as <code class="code">X.Y.Z</code>. In Amazon MQ for RabbitMQ implementations, <code class="code">X</code> denotes the major version, <code class="code">Y</code> represents the minor version, and <code class="code">Z</code> denotes the patch version number. Amazon MQ considers a version change to be major if the major version numbers change. For example, upgrading from version <b>3</b>.13 to <b>4</b>.0 is considered a <em>major version upgrade</em>. A version change is considered minor if only the minor or patch version number changes. For example, upgrading from version 3.<b>11</b>.28 to 3.<b>12</b>.13 is considered a <em>minor version upgrade</em>. </p><p> Amazon MQ for RabbitMQ recommends all brokers use the latest supported minor version. For instructions on how to upgrade your broker engine version, see <a href="./upgrading-brokers.html">Upgrading an Amazon MQ broker engine version</a>. </p><div class="awsdocs-note awsdocs-important"><div class="awsdocs-note-title"><awsui-icon name="status-warning" variant="error"></awsui-icon><h6>Important</h6></div><div class="awsdocs-note-text"><p>Amazon MQ does not support <a href="https://www.rabbitmq.com/streams.html" rel="noopener noreferrer" target="_blank"><span>streams</span><awsui-icon class="awsdocs-link-icon" name="external"></awsui-icon></a>. Enabling this feature flag and creating a stream will result in data loss.</p><p>Amazon MQ does not support using structured logging in JSON, introduced in RabbitMQ 3.9</p></div></div> <h2 id="rabbitmq-version-management-calendar">Supported engine versions on Amazon MQ for RabbitMQ</h2> <p> The Amazon MQ version support calendar indicates when a broker engine version will reach end of support. When a version reaches end of support, Amazon MQ upgrades all brokers on this version to the next supported version automatically. This upgrade takes place during your broker's scheduled maintenance windows, within the 45 days following the end-of-support date. </p> <p> Amazon MQ provides at least a 90 day notice before a version reaches end of support. We recommend upgrading your broker before the end-of-support date to prevent any disruptions. Additionally, you cannot create new brokers on versions scheduled for end of support within 30 days of the end of support date. </p> <div class="table-container"><div class="table-contents"><table id="w248aac19c19b9b7"><thead> <tr> <th>RabbitMQ version</th> <th>End of support on Amazon MQ</th> </tr> </thead> <tr> <td tabindex="-1">3.13 (recommended)</td> <td tabindex="-1"> </td> </tr> <tr> <td tabindex="-1">3.12</td> <td tabindex="-1">March 17, 2025</td> </tr> <tr> <td tabindex="-1">3.11</td> <td tabindex="-1">February 17, 2025</td> </tr> <tr> <td tabindex="-1">3.10</td> <td tabindex="-1">October 15, 2024</td> </tr> <tr> <td tabindex="-1">3.9</td> <td tabindex="-1">September 16, 2024</td> </tr> </table></div></div> <p> When you create a new Amazon MQ for RabbitMQ broker, you can specify any supported RabbitMQ engine version. If you do not specify the engine version number when creating a broker, Amazon MQ automatically defaults to the latest engine version number. </p> <h2 id="rabbitmq-version-management-upgrading">Engine version upgrades</h2> <p> You can manually upgrade your broker at any time to the next supported major or minor version. When you turn on <a href="https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-prop-updatebrokerinput-autominorversionupgrade">automatic minor version upgrades</a>, Amazon MQ will upgrade your broker to the latest supported patch version during the <a href="./maintaining-brokers.html">maintenance window</a>. </p> <p> For more information about manually upgrading your broker, see <a href="./upgrading-brokers.html">Upgrading an Amazon MQ broker engine version</a>. </p> <p>For all brokers using engine version 3.13 and above, Amazon MQ manages upgrades to the latest supported patch version during the maintenance window.</p> <div class="awsdocs-note awsdocs-important"><div class="awsdocs-note-title"><awsui-icon name="status-warning" variant="error"></awsui-icon><h6>Important</h6></div><div class="awsdocs-note-text"><p>RabbitMQ only allows incremental version updates (ex: 3.9.x to 3.10.x). You cannot skip minor versions when updating (ex: 3.8.x to 3.11.x). </p></div></div> <p> Single instance brokers will be offline while being rebooted. For cluster brokers, the mirrored queues must be synced during reboot. With longer queues, the queue-sync process can take longer. During the queue-sync process, the queue is unavailable to consumers and producer. When the queue-sync process is complete, the broker becomes available again. To minimize the impact, we recommend upgrading during a low traffic time. For more information on best practices for version upgrades, see <a href="./best-practices-rabbitmq.html">Amazon MQ for RabbitMQ best practices</a>. </p> <h2 id="rabbitmq-version-management-listing-versions">Listing supported engine versions</h2> <p> You can list all supported minor and major engine versions by using the <a href="https://docs.aws.amazon.com/cli/latest/reference/mq/describe-broker-instance-options.html"><code class="code">describe-broker-instance-options</code></a> AWS CLI command. </p> <pre class="programlisting"><div class="code-btn-container"><div class="btn-copy-code" title="Copy"><awsui-icon name="copy"></awsui-icon></div></div><!--DEBUG: cli (sh)--><code class="sh ">aws mq describe-broker-instance-options</code></pre> <p>To filter the results by engine and instance type use the <code class="code">--engine-type</code> and <code class="code">--host-instance-type</code> options as shown in the following.</p> <pre class="programlisting"><div class="code-btn-container"><div class="btn-copy-code" title="Copy"><awsui-icon name="copy"></awsui-icon></div></div><!--DEBUG: cli (sh)--><code class="sh ">aws mq describe-broker-instance-options --engine-type <code class="replaceable">engine-type</code> --host-instance-type <code class="replaceable">instance-type</code></code></pre> <p>For example, to filter the results for RabbitMQ, and <code class="code">mq.m5.large</code> instance type, replace <code class="replaceable">engine-type</code> with <code class="code">RABBITMQ</code> and <code class="replaceable">instance-type</code> with <code class="code">mq.m5.large</code>.</p> <awsdocs-copyright class="copyright-print"></awsdocs-copyright><awsdocs-thumb-feedback right-edge="{{$ctrl.thumbFeedbackRightEdge}}"></awsdocs-thumb-feedback></div><noscript><div><div><div><div id="js_error_message"><p><img src="https://d1ge0kk1l5kms0.cloudfront.net/images/G/01/webservices/console/warning.png" alt="Warning" /> <strong>Javascript is disabled or is unavailable in your browser.</strong></p><p>To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.</p></div></div></div></div></noscript><div id="main-col-footer" class="awsui-util-font-size-0"><div id="doc-conventions"><a target="_top" href="/general/latest/gr/docconventions.html">Document Conventions</a></div><div class="prev-next"><div id="previous" class="prev-link" accesskey="p" href="./rabbitmq-queue-sync.html">Resolving paused queue sync</div><div id="next" class="next-link" accesskey="n" href="./best-practices-rabbitmq.html">Amazon MQ for RabbitMQ best practices</div></div></div><awsdocs-page-utilities></awsdocs-page-utilities></div><div id="quick-feedback-yes" style="display: none;"><div class="title">Did this page help you? - Yes</div><div class="content"><p>Thanks for letting us know we're doing a good job!</p><p>If you've got a moment, please tell us what we did right so we can do more of it.</p><p><awsui-button id="fblink" rel="noopener noreferrer" target="_blank" text="Feedback" click="linkClick($event)" href="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=AMQ&topic_url=https://docs.aws.amazon.com/en_us/amazon-mq/latest/developer-guide/rabbitmq-version-management.html"></awsui-button></p></div></div><div id="quick-feedback-no" style="display: none;"><div class="title">Did this page help you? - No</div><div class="content"><p>Thanks for letting us know this page needs work. We're sorry we let you down.</p><p>If you've got a moment, please tell us how we can make the documentation better.</p><p><awsui-button id="fblink" rel="noopener noreferrer" target="_blank" text="Feedback" click="linkClick($event)" href="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=AMQ&topic_url=https://docs.aws.amazon.com/en_us/amazon-mq/latest/developer-guide/rabbitmq-version-management.html"></awsui-button></p></div></div></div></body></div></awsdocs-view><div class="page-loading-indicator" id="page-loading-indicator"><awsui-spinner size="large"></awsui-spinner></div></div><div id="tools-panel" dom-region="tools"><awsdocs-tools-panel id="awsdocs-tools-panel"></awsdocs-tools-panel></div></awsui-app-layout><awsdocs-cookie-banner class="doc-cookie-banner"></awsdocs-cookie-banner></div></body></html>