{"id":13245,"date":"2016-12-12T11:00:06","date_gmt":"2016-12-12T09:00:06","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/nav\/?p=13245"},"modified":"2024-04-02T16:16:43","modified_gmt":"2024-04-02T23:16:43","slug":"anti-patterns-in-nav-upgrade","status":"publish","type":"post","link":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/","title":{"rendered":"Anti-Patterns in NAV Upgrade"},"content":{"rendered":"


\nSee how (not) to  mess up your Dynamics NAV upgrade, on-premises or in the cloud. With real-life examples – incidents we helped fix in PaaS. Warning: NAV partners, don’t do this at home (nor at work).<\/p>\n

 <\/p>\n

Context<\/strong>: when NAV is upgraded, developers have the chance to write upgrade code to move data across changing data structures. Writing good quality code will help successful upgrades.<\/p>\n

 <\/p>\n

General on upgrade<\/strong><\/p>\n

Problem: <\/strong>assuming that the upgrade table contains data.<\/p>\n

If the table is empty, it means that either the upgrade has run, or there was no data in the original tenant; in both cases, the upgrade code should exit immediately.<\/p>\n

Solution:<\/strong> if using an upgrade table, always validate that the table contains data before doing anything.<\/p>\n

 <\/strong><\/p>\n

Upgrade code, can it be rerun safely?<\/strong><\/p>\n

Problem<\/strong>: if the upgrade code is not written in a way that makes it runnable twice (idempotent<\/a><\/span>), then several failures can happen, including something as critical as data corruption.<\/p>\n

In on-premises NAV installations, if something fails at upgrade, there is no way to run only the \u201cremaining\u201d tasks. You will need to run the whole upgrade again, and might end-up with data that you cannot trust.<\/p>\n

What about the cloud? In Platform As A Service (PaaS), in some situations, the upgrade code needs to be run twice (for example, when moving tenants from a broken\/frozen VM to a healthy one).<\/p>\n

 <\/p>\n

Read more on https:\/\/community.dynamics.com\/nav\/w\/designpatterns\/285.nav-upgrade<\/a><\/p>\n

By Carlos Raul Garcia and Bogdana Botez at Microsoft Development Center Copenhagen<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

See how (not) to  mess up your Dynamics NAV upgrade, on-premises or in the cloud. With real-life examples – incidents we helped fix in PaaS. Warning: NAV partners, don’t do this at home (nor at work).   Context: when NAV is upgraded, developers have the chance to write upgrade code to move data across changing<\/p>\n","protected":false},"author":4552,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ms_queue_id":[],"ep_exclude_from_search":false,"_classifai_error":"","_classifai_text_to_speech_error":"","footnotes":""},"post_tag":[],"product":[],"content-type":[4690],"topic":[],"audience-type":[],"audience":[4685],"ms-author":[],"coauthors":[2302],"class_list":["post-13245","post","type-post","status-publish","format-standard","hentry","content-type-news-and-product-updates","audience-it-professional","review-flag-1593580425-950","review-flag-alway-1593580307-456","review-flag-vm-1593580803-894"],"yoast_head":"\nAnti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Anti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog\" \/>\n<meta property=\"og:description\" content=\"See how (not) to  mess up your Dynamics NAV upgrade, on-premises or in the cloud. With real-life examples – incidents we helped fix in PaaS. Warning: NAV partners, don’t do this at home (nor at work).   Context: when NAV is upgraded, developers have the chance to write upgrade code to move data across changing\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Dynamics 365 Blog\" \/>\n<meta property=\"article:published_time\" content=\"2016-12-12T09:00:06+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-04-02T23:16:43+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Microsoft Dynamics 365 Team\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 min read\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\"},\"author\":[{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/author\/microsoft-dynamics-365-team\/\",\"@type\":\"Person\",\"@name\":\"Microsoft Dynamics 365 Team\"}],\"headline\":\"Anti-Patterns in NAV Upgrade\",\"datePublished\":\"2016-12-12T09:00:06+00:00\",\"dateModified\":\"2024-04-02T23:16:43+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\"},\"wordCount\":263,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\",\"name\":\"Anti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png\",\"datePublished\":\"2016-12-12T09:00:06+00:00\",\"dateModified\":\"2024-04-02T23:16:43+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Anti-Patterns in NAV Upgrade\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#website\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/\",\"name\":\"Microsoft Dynamics 365 Blog\",\"description\":\"Modernizing Business Process with Cloud and AI\",\"publisher\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization\",\"name\":\"Dynamics 365 Blog\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png\",\"width\":259,\"height\":194,\"caption\":\"Dynamics 365 Blog\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Anti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/","og_locale":"en_US","og_type":"article","og_title":"Anti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog","og_description":"See how (not) to  mess up your Dynamics NAV upgrade, on-premises or in the cloud. With real-life examples – incidents we helped fix in PaaS. Warning: NAV partners, don’t do this at home (nor at work).   Context: when NAV is upgraded, developers have the chance to write upgrade code to move data across changing","og_url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/","og_site_name":"Microsoft Dynamics 365 Blog","article_published_time":"2016-12-12T09:00:06+00:00","article_modified_time":"2024-04-02T23:16:43+00:00","og_image":[{"url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"Microsoft Dynamics 365 Team","Est. reading time":"1 min read"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#article","isPartOf":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/"},"author":[{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/author\/microsoft-dynamics-365-team\/","@type":"Person","@name":"Microsoft Dynamics 365 Team"}],"headline":"Anti-Patterns in NAV Upgrade","datePublished":"2016-12-12T09:00:06+00:00","dateModified":"2024-04-02T23:16:43+00:00","mainEntityOfPage":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/"},"wordCount":263,"commentCount":0,"publisher":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage"},"thumbnailUrl":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png","inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/","url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/","name":"Anti-Patterns in NAV Upgrade - Microsoft Dynamics 365 Blog","isPartOf":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage"},"thumbnailUrl":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png","datePublished":"2016-12-12T09:00:06+00:00","dateModified":"2024-04-02T23:16:43+00:00","breadcrumb":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#primaryimage","url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png","contentUrl":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2016\/12\/2016-nov-pattern-upgradesmalllogo.png"},{"@type":"BreadcrumbList","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/it-professional\/2016\/12\/12\/anti-patterns-in-nav-upgrade\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/"},{"@type":"ListItem","position":2,"name":"Anti-Patterns in NAV Upgrade"}]},{"@type":"WebSite","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#website","url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/","name":"Microsoft Dynamics 365 Blog","description":"Modernizing Business Process with Cloud and AI","publisher":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#organization","name":"Dynamics 365 Blog","url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png","contentUrl":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png","width":259,"height":194,"caption":"Dynamics 365 Blog"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/#\/schema\/logo\/image\/"}}]}},"word_count":253,"msxcm_display_generated_audio":false,"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Dynamics 365 Blog","distributor_original_site_url":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/posts\/13245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/users\/4552"}],"replies":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/comments?post=13245"}],"version-history":[{"count":1,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/posts\/13245\/revisions"}],"predecessor-version":[{"id":190337,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/posts\/13245\/revisions\/190337"}],"wp:attachment":[{"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/media?parent=13245"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/post_tag?post=13245"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/product?post=13245"},{"taxonomy":"content-type","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/content-type?post=13245"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/topic?post=13245"},{"taxonomy":"audience-type","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/audience-type?post=13245"},{"taxonomy":"audience","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/audience?post=13245"},{"taxonomy":"ms-author","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/ms-author?post=13245"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/dynamics-365\/blog\/wp-json\/wp\/v2\/coauthors?post=13245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}