{"id":1658,"date":"2020-09-11T18:02:52","date_gmt":"2020-09-12T01:02:52","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cosmosdb\/?p=1658"},"modified":"2020-11-20T15:17:30","modified_gmt":"2020-11-20T23:17:30","slug":"upgrade-your-server-version-from-3-2-to-3-6-for-azure-cosmos-db-api-for-mongodb","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cosmosdb\/upgrade-your-server-version-from-3-2-to-3-6-for-azure-cosmos-db-api-for-mongodb\/","title":{"rendered":"Upgrade your server version from 3.2 to 3.6 for Azure Cosmos DB API for MongoDB"},"content":{"rendered":"<p><img decoding=\"async\" class=\"aligncenter wp-image-1667 size-full\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner.png\" alt=\"Image banner\" width=\"1600\" height=\"400\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner.png 1600w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner-300x75.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner-1024x256.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner-768x192.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/banner-1536x384.png 1536w\" sizes=\"(max-width: 1600px) 100vw, 1600px\" \/><\/p>\n<p>You can now upgrade your applicable MongoDB account to the latest version by using our automatic database upgrade process. <span style=\"font-size: 1rem;\">The upgrade process doesn&#8217;t interrupt the availability of your account and it doesn&#8217;t consume RU\/s or decrease the capacity of the database at any point. No existing data or indexes will be affected by this process.\u00a0<\/span>This is particularly useful if you want to leverage the <a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/cosmos-db\/mongodb-feature-support-36\">new functionality available in version 3.6<\/a> and also to ensure that your applications are running on the latest version of the service.<\/p>\n<p>The steps to upgrade your account are the following:<\/p>\n<ol>\n<li>Enable the automatic database upgrade in the Azure Portal (<a href=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/upgrade-your-server-version-from-3-2-to-3-6-for-azure-cosmos-db-api-for-mongodb#how-to-upgrade-my-account-on-the-azure-portal\">instructions below<\/a>). Your database operation will not be interrupted and no action is required until the new version has been enabled.<\/li>\n<li>After the process is finalized, find your new database account endpoint.<\/li>\n<li>Replace the endpoint in your existing application connections with the new one. Only the new endpoint will have the functionality provided by the updated version 3.6.<\/li>\n<\/ol>\n<p>If your account qualifies for this upgrade, you&#8217;ll be able to execute it from the Azure Portal under the <code>Features<\/code> blade. We&#8217;ll walk through the steps in this blog post below.<\/p>\n<p>First, let&#8217;s look at all the specific benefits from upgrading your account.<\/p>\n<h3><span style=\"color: inherit; font-family: inherit; font-size: 1.75rem;\">Benefits of upgrading from version 3.2 to 3.6<\/span><\/h3>\n<div>\n<div>The\u00a0following\u00a0are\u00a0the\u00a0new\u00a0features\u00a0included\u00a0in\u00a0version\u00a03.6:<\/div>\n<div>\n<div>\n<ul>\n<li>Enhanced\u00a0performance\u00a0and\u00a0stability<\/li>\n<li>Support\u00a0for\u00a0<a href=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/build-2020-recap-whats-new-in-azure-cosmos-dbs-api-for-mongodb\/\">new\u00a0database\u00a0commands<\/a><\/li>\n<li>Support\u00a0for\u00a0aggregation\u00a0pipeline\u00a0by\u00a0default\u00a0and\u00a0<a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/cosmos-db\/mongodb-feature-support-36#aggregation-pipeline\">new\u00a0aggregation\u00a0stages<\/a><\/li>\n<li>Support\u00a0for\u00a0<a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/cosmos-db\/mongodb-change-streams?tabs=javascript\">Change\u00a0Streams<\/a><\/li>\n<li>Support\u00a0for\u00a0<a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/cosmos-db\/mongodb-feature-support-36#compound-indexes\">compound\u00a0Indexes<\/a><\/li>\n<li>Cross-partition\u00a0support\u00a0for\u00a0the\u00a0following\u00a0operations:\u00a0update,\u00a0delete,\u00a0count\u00a0and\u00a0sort<\/li>\n<li>Improved\u00a0performance\u00a0for\u00a0the\u00a0following\u00a0aggregate\u00a0operations:\u00a0$count,\u00a0$skip,\u00a0$limit\u00a0and\u00a0$group<\/li>\n<li>Wildcard\u00a0indexing\u00a0is\u00a0now\u00a0supported<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<h3>Changes from version 3.2<\/h3>\n<p>These are features that have changed with this new version:<\/p>\n<ul>\n<li><strong>RequestRateIsLarge errors have been removed<\/strong>. Requests from the client application will not return 16500 errors anymore. Instead requests will resume until they complete or fulfill the timeout. (Note: this capability requires a support ticket to be opened to enable).<\/li>\n<li>Per request timeout is set to 60 seconds.<\/li>\n<li>New MongoDB collections created on the new wire protocol version will <strong>only have the `_id` property indexed by default<\/strong>. All other indexes have to be created manually.<\/li>\n<\/ul>\n<\/div>\n<div>\n<h3>Action required<\/h3>\n<div>For the upgrade to version 3.6, the database account endpoint suffix will be updated to the following format in your applications:<\/div>\n<div><\/div>\n<div>\n<pre class=\"prettyprint\" style=\"padding-left: 40px;\">&lt;your_database_account_name&gt;.mongo.cosmos.azure.com<\/pre>\n<\/div>\n<div>You need to replace the existing endpoint in your applications and drivers that connect with this database account. <strong>Only connections that are using the new endpoint will have access to the features in the MongoDB version 3.6.<\/strong> The previous endpoint should have the suffix <code>.documents.azure.com<\/code>.<\/div>\n<\/div>\n<div>\n<p>Let&#8217;s take a look at how to do this on the Azure Portal.<\/p>\n<\/div>\n<h3>How to upgrade my account on the Azure Portal<\/h3>\n<div><\/div>\n<div>\n<ol>\n<li>First, go to the Azure portal and navigate to your Azure Cosmos DB API for MongoDB account overview blade. Verify that your server version is <code>3.2<\/code>.\u00a0 <img decoding=\"async\" class=\"aligncenter size-large wp-image-1659\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/1-1024x329.png\" alt=\"Mongo Upgrade 1\" width=\"640\" height=\"206\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/1-1024x329.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/1-300x96.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/1-768x247.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/1.png 1430w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li>From the options on the left, select the <code>Features<\/code> blade. This will reveal the Account level features that are available for your database account. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1660\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/2-1024x679.png\" alt=\"Mongo Upgrade 2\" width=\"640\" height=\"424\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/2-1024x679.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/2-300x199.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/2-768x509.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/2.png 1428w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li>Click on the <code>Upgrade to Mongo server version 3.6<\/code> row. If you don&#8217;t see this option, your account might not be eligible for this upgrade. Please <a href=\"https:\/\/portal.azure.com\/?#blade\/Microsoft_Azure_Support\/HelpAndSupportBlade\">file a support ticket<\/a> if that is the case. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1661\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/3-1024x554.png\" alt=\"Mongo Upgrade 3\" width=\"640\" height=\"346\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/3-1024x554.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/3-300x162.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/3-768x415.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/3.png 1416w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li>Review the information displayed about this specific upgrade. Note that the upgrade will only be completed until your applications use the updated endpoint, as highlighted in this section. Click on <code>Enable<\/code> as soon as you are ready to start the process. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1662\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/4-1024x715.png\" alt=\"Mongo Upgrade 4\" width=\"640\" height=\"447\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/4-1024x715.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/4-300x210.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/4-768x536.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/4.png 1423w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li>After starting the process, the <code>Features<\/code> table will show the status of the upgrade. The status will go from <code>Pending<\/code>, to <code>In Progress<\/code>, to <code>Upgraded<\/code>. This process will not affect the existing functionality or operations of the database account. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1663\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/5-1024x302.png\" alt=\"Mongo Upgrade 5\" width=\"640\" height=\"189\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/5-1024x302.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/5-300x89.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/5-768x227.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/5.png 1386w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li>Once the upgrade is completed, and the status shows as <code>Upgraded<\/code>, click on it to learn more about the next steps and actions you need to take to finalize the process. Please <a href=\"https:\/\/azure.microsoft.com\/en-us\/support\/create-ticket\/\">contact support<\/a> if there was an issue processing your request. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1664\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/6-1024x389.png\" alt=\"Mongo Upgrade 6\" width=\"640\" height=\"243\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/6-1024x389.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/6-300x114.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/6-768x292.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/6.png 1365w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<li><strong>To start using the upgraded version of your database account<\/strong>, go back to the <code>Overview<\/code> blade, note that the server version is now <code>3.6<\/code> and copy the new connection string to use in your application. The applications will start using the upgraded version as soon as they connect to the new endpoint. Existing connections will not be interrupted and can be updated at your convenience. To ensure a consistent experience, <strong>all your applications must use the new endpoint<\/strong>. <img decoding=\"async\" class=\"aligncenter size-large wp-image-1665\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/7-1024x329.png\" alt=\"Mongo Upgrade 7\" width=\"640\" height=\"206\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/7-1024x329.png 1024w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/7-300x96.png 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/7-768x247.png 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/09\/7.png 1430w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/li>\n<\/ol>\n<p>And that&#8217;s it! Enjoy the new functionality and let us know in the comments if there&#8217;s any questions.<\/p>\n<\/div>\n<p>&#8211; Luis<\/p>\n","protected":false},"excerpt":{"rendered":"<p>You can now upgrade your applicable MongoDB account to the latest version by using our automatic database upgrade process. The upgrade process doesn&#8217;t interrupt the availability of your account and it doesn&#8217;t consume RU\/s or decrease the capacity of the database at any point. No existing data or indexes will be affected by this process.\u00a0This [&hellip;]<\/p>\n","protected":false},"author":20924,"featured_media":1667,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[12,15],"tags":[1740,957,1246,1742,1739],"class_list":["post-1658","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcements","category-mongodb-api","tag-cosmos","tag-cosmosdb","tag-mongodb","tag-server","tag-upgrade"],"acf":[],"blog_post_summary":"<p>You can now upgrade your applicable MongoDB account to the latest version by using our automatic database upgrade process. The upgrade process doesn&#8217;t interrupt the availability of your account and it doesn&#8217;t consume RU\/s or decrease the capacity of the database at any point. No existing data or indexes will be affected by this process.\u00a0This [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/1658","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/users\/20924"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/comments?post=1658"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/1658\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media\/1667"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media?parent=1658"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/categories?post=1658"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/tags?post=1658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}