ADME Upgrade Settings Changes

Author: japicket

articles/energy-data-services/how-to-manage-upgrade-settings.md

@@ -0,0 +1,124 @@
+---
+title: How to manage upgrade settings - Azure Data Manager for Energy
+description: Learn how to configure upgrade settings to control how milestone upgrades are applied to your Azure Data Manager for Energy instance.
+author: japicket
+ms.author: japicket
+ms.service: azure-data-manager-energy
+ms.topic: how-to
+ms.date: 01/27/2026
+ms.custom:
+  - template-how-to
+---
+
+# Manage upgrade settings in Azure Data Manager for Energy
+
+This article describes how to view and manage upgrade settings for your Azure Data Manager for Energy instance. Upgrade settings allow you to control how milestone upgrades are applied to your instance.
+
+## What are milestone upgrades?
+
+Milestone upgrades are major version upgrades to Azure Data Manager for Energy, such as moving from M25 to M26. These upgrades may include significant changes to functionality and features.
+
+## Upgrade policy options
+
+Azure Data Manager for Energy provides two upgrade policy options:
+
+| Policy | Description |
+|--------|-------------|
+| **Automatic** | Your instance is automatically upgraded when a new milestone release is available. This is the default setting for all instances. |
+| **Deferred** | Your instance upgrade is deferred, giving you up to 30 days to validate the new milestone release before your instance is upgraded. |
+
+If you have multiple Azure Data Manager for Energy instances, you can set different upgrade policies for each one. For example, you might set one instance to **Automatic** so it upgrades immediately when a new milestone is released, allowing you to test and validate the changes. Meanwhile, you can set your production instance to **Deferred** to delay the upgrade until you've completed your testing. At any point during the 30-day window, you can mark your deferred instance as ready for upgrade. If you don't take action, the instance is automatically upgraded at the end of the 30-day window.
+
+## View upgrade settings
+
+1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your Azure Data Manager for Energy instance.
+
+1. In the left menu under **Advanced**, select **Upgrade Settings**.
+
+    ADD SCREENSHOT HERE
+
+1. On the **Upgrade Settings** page, you can view:
+   - **Current milestone version**: The current milestone version your instance is running (for example, M25 or M26).
+   - **Upgrade policy**: Whether your instance is set to **Automatic** or **Deferred** upgrades.
+   - **Auto upgrade after date**: If your upgrade policy is set to **Deferred** and a milestone upgrade is available, this field shows the date when your instance will be automatically upgraded.
+
+    ADD SCREENSHOT HERE
+
+> [!NOTE]
+> The current milestone version is also displayed on the **Overview** page for your Azure Data Manager for Energy instance.
+
+## Configure upgrade settings during instance creation
+
+You can configure upgrade settings when you create a new Azure Data Manager for Energy instance.
+
+1. When creating a new instance, navigate to the **Advanced Settings** tab.
+
+1. In the **Upgrade Settings** section, you can choose to enable **Defer Milestone Upgrades**.
+
+    ADD SCREENSHOT HERE
+
+1. Complete the remaining tabs and select **Create** to create your instance with the configured upgrade settings.
+
+## Change the upgrade policy for an existing instance
+
+You can change the upgrade policy for an existing Azure Data Manager for Energy instance at any time.
+
+1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your Azure Data Manager for Energy instance.
+
+1. In the left menu under **Advanced**, select **Upgrade Settings**.
+
+1. Select either **Automatic** or **Deferred** to change your upgrade policy.
+
+    ADD SCREENSHOT HERE
+
+1. Select **Save** to apply your changes.
+
+## Mark your instance as ready for upgrade
+
+If your upgrade policy is set to **Deferred** and a milestone upgrade is available, you can mark your instance as ready for upgrade at any time during the 30-day window.
+
+1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your Azure Data Manager for Energy instance.
+
+1. In the left menu under **Advanced**, select **Upgrade Settings**.
+
+1. Select the **Mark Ready for Milestone Upgrade** button.
+
+    ADD SCREENSHOT HERE
+
+    > [!NOTE]
+    > The **Mark Ready for Milestone Upgrade** button is only available when:
+    > - Your upgrade policy is set to **Deferred**.
+    > - A milestone upgrade is available (the **30-Day Window End Date** is set).
+
+1. Confirm that you want to mark your instance as ready for upgrade.
+
+> [!IMPORTANT]
+> Once you mark your instance as ready for upgrade, this action cannot be undone. Your instance will be upgraded during the next upgrade cycle.
+
+## Understanding the 30-day upgrade window
+
+When a new milestone release is available and your upgrade policy is set to **Deferred**:
+
+1. After all instances with the **Automatic** upgrade policy have been upgraded, the Azure Data Manager for Energy team sets the **30-Day Window End Date**, which is approximately 30 days from that point.
+
+1. The **30-Day Window End Date** is displayed on the **Upgrade Settings** page in the Azure portal.
+
+1. During this 30-day window, you can:
+   - Test the new milestone release in a nonproduction environment.
+   - Mark your instance as ready for upgrade when you're satisfied with your testing.
+   - Take no action and let your instance be automatically upgraded at the end of the window.
+
+1. After your instance is upgraded, the **30-Day Window End Date** is cleared until the next milestone release.
+
+## Frequently asked questions
+
+### What happens if I find an issue with Azure Data Manager for Energy during the 30-day window?
+
+If you discover an issue during the 30-day window, contact Azure support. Depending on the severity of the issue, the Azure Data Manager for Energy team may deploy a hotfix. If a hotfix is required, the 30-day timer is paused when the issue is identified and resumes once the hotfix has been deployed.
+
+## Next steps
+
+Learn more about what's included in each milestone release and Azure Data Manager for Energy:
+
+> [!div class="nextstepaction"]
+> [Release notes](release-notes.md)

articles/energy-data-services/quickstart-create-microsoft-energy-data-services-instance.md

@@ -74,7 +74,9 @@ Client secret | Sometimes called an application password, a client secret is a s
 
    [![Screenshot of the tab for specifying tags in Azure Data Manager for Energy.](media/quickstart-create-microsoft-energy-data-services-instance/input-tags.png)](media/quickstart-create-microsoft-energy-data-services-instance/input-tags.png#lightbox)
 
-1. Move to the **Advanced Settings** tab to configure **cross-origin resource sharing** and, if available to you as a customer in the limited preview for the feature, **reference data values settings**. To learn more about cross-origin resource sharing (CORS), see [Use CORS for resource sharing in Azure Data Manager for Energy](../energy-data-services/how-to-enable-cors.md). To learn more about reference data values, see [Syncing Reference Data Values](../energy-data-services/concepts-reference-data-values.md)
+1. Move to the **Advanced Settings** tab to configure **cross-origin resource sharing**, **upgrade settings**, and, if available to you as a customer in the limited preview for the feature, **reference data values settings**. To learn more about cross-origin resource sharing (CORS), see [Use CORS for resource sharing in Azure Data Manager for Energy](../energy-data-services/how-to-enable-cors.md). To learn more about reference data values, see [Syncing Reference Data Values](../energy-data-services/concepts-reference-data-values.md). To learn more about upgrade settings, see [Manage upgrade settings](../energy-data-services/how-to-manage-upgrade-settings.md).
+
+   In the **Upgrade Settings** section, you can choose to enable **Defer Milestone Upgrades** to control how milestone upgrades are applied to your instance. When enabled, you have up to 30 days to validate new milestone releases before your instance is upgraded.
 
    [![Screenshot of the tab for configuring cross-origin resource sharing in Azure Data Manager for Energy.](media/quickstart-create-microsoft-energy-data-services-instance/advanced-settings-tab.png)](media/quickstart-create-microsoft-energy-data-services-instance/advanced-settings-tab.png#lightbox)
 

articles/energy-data-services/toc.yml

@@ -123,6 +123,8 @@ items:
       href: how-to-generate-auth-token.md
     - name: Upload large files using file service
       href: how-to-upload-large-files-using-file-service.md
+    - name: Manage upgrade settings
+      href: how-to-manage-upgrade-settings.md
 - name: References
   items:
   - name: REST API