Merge pull request #227179 from kabharati/pacific021323

Pacific021323

Author: v-dirichards

articles/postgresql/TOC.yml

@@ -635,6 +635,12 @@
         href: flexible-server/how-to-restart-server-portal.md
       - name: Azure CLI
         href: flexible-server/how-to-restart-server-cli.md
+    - name: Major Version Upgrade
+      items:
+      - name: Azure portal
+        href: flexible-server/how-to-perform-major-version-upgrade-portal.md
+      - name: Azure CLI
+        href: flexible-server/how-to-perform-major-version-upgrade-cli.md
     - name: Restore a server
       items:
       - name: Azure portal
@@ -653,6 +659,10 @@
         href: flexible-server/how-to-manage-high-availability-portal.md
       - name: Azure CLI
         href: flexible-server/how-to-configure-high-availability-cli.md
+    - name: major version upgrade
+      items:
+      - name: Azure portal
+        href: flexible-server/how-to-perform-major-version-upgrade-portal.md
     - name: Replication
       items:
       - name: Azure portal

articles/postgresql/flexible-server/how-to-perform-major-version-upgrade-cli.md

@@ -0,0 +1,66 @@
+---
+title:  Major Version Upgrade of a flexible server - Azure CLI 
+description: This article describes how to perform major version upgrade in Azure Database for PostgreSQL through Azure CLI.
+ms.service: postgresql
+ms.subservice: flexible-server
+ms.author: kabharati
+author: rajsell
+ms.reviewer: ""
+ms.topic: how-to
+ms.date: 02/13/2023
+---
+
+#  Major Version Upgrade of a flexible server - Flexible Server with Azure CLI
+
+[!INCLUDE [applies-to-postgresql-flexible-server](../includes/applies-to-postgresql-flexible-server.md)]
+
+This article provides step-by-step procedure to perform Major Version Upgrade in flexible server using Azure CLI.
+
+## Prerequisites
+- If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account before you begin.
+- Install or upgrade Azure CLI to the latest version. See [Install Azure CLI](/cli/azure/install-azure-cli).
+-  Log in to Azure account using [az login](/cli/azure/reference-index#az-login) command. Note the **id** property, which refers to **Subscription ID** for your Azure account.
+
+    ```azurecli-interactive
+    az login
+    ````
+
+- If you have multiple subscriptions, choose the appropriate subscription in which you want to create the server using the ```az account set``` command.
+
+    ```azurecli
+    az account set --subscription <subscription id>
+    ```
+
+- Create a PostgreQL Flexible Server if you haven't already created one using the ```az postgres flexible-server create``` command.
+
+    ```azurecli
+    az postgres flexible-server create --resource-group myresourcegroup --name myservername
+    ```
+
+## Perform Major Version Upgrade
+
+You can run the following command to perform major version upgrade on an existing server.
+
+> [!NOTE]  
+> Major Version Upgrade action is irreversible. Please perform a point-in-time recovery (PITR) of your production server and test the upgrade in the non-production environment.
+
+
+**Usage**
+```azurecli
+az postgres flexible-server upgrade --source-server
+                                 [--resource-group]
+                                 [--postgres-version]
+```
+
+**Example:**
+Upgrade a server from this PG 11 to PG 14
+
+```azurecli
+az postgres server upgrade -g myresource-group -n myservername -v mypgversion
+
+```
+
+## Next steps
+* Learn about [Major Version Upgrade](concepts-major-version-upgrade.md)
+* Learn about [backup & recovery](concepts-backup-restore.md)  
+

articles/postgresql/flexible-server/how-to-perform-major-version-upgrade-portal.md

@@ -0,0 +1,57 @@
+---
+title: Major Version Upgrade of a flexible server - Azure portal
+description: This article describes how to perform major version upgrade in Azure Database for PostgreSQL Flexible Server through the Azure portal.
+ms.author: kabharati
+author: rajsell
+ms.service: postgresql
+ms.subservice: flexible-server
+ms.topic: how-to
+ms.date: 02/13/2023
+---
+
+# Major Version Upgrade of a Flexible Server
+
+[!INCLUDE [applies-to-postgresql-flexible-server](../includes/applies-to-postgresql-flexible-server.md)]
+
+This article provides a step-by-step procedure to perform Major Version Upgrade in a flexible server using Azure portal
+
+> [!NOTE]  
+> Major Version Upgrade action is irreversible. Please perform a Point-In-Time Recovery (PITR) of your production server and test the upgrade in the non-production environment.
+
+## Follow these steps to upgrade your flexible server to the major version of your choice:
+
+
+
+1. In the [Azure portal](https://portal.azure.com/), choose the flexible server that you want to upgrade.
+
+2. Select **Overview** from the left pane, and then select **Upgrade**.
+   
+   :::image type="content" source="media/how-to-perform-major-version-upgrade-portal/upgrade-tab.png" alt-text="Diagram of Upgrade tab to perform in-place major version upgrade.":::
+
+
+3. You see an option to select the major version of your choice, you have an option to skip versions to directly upgrade to higher versions. Choose the version and click **Upgrade** 
+
+:::image type="content" source="media/how-to-perform-major-version-upgrade-portal/set-postgresql-version.png" alt-text="Diagram of PostgreSQL version to Upgrade."::: 
+
+
+4. During upgrade, users have to wait for the process to complete. You can resume accessing the server once the server is back online.
+
+:::image type="content" source="media/how-to-perform-major-version-upgrade-portal/deployment-progress.png" alt-text="Diagram of deployment progress for Major Version Upgrade.":::
+
+
+5. Once the upgrade is successful,you can expand the Deployment details tab and click **Operation details** to see more information about upgrade process like duration, provisioning state etc.
+
+
+:::image type="content" source="media/how-to-perform-major-version-upgrade-portal/deployment-success.png" alt-text="Diagram of successful deployment of for Major Version Upgrade.":::
+ 
+
+6. You can click on the **Go to resource** tab to validate your upgrade. You notice that server name remained unchanged and PostgreSQL version upgraded to desired higher version with the latest minor version
+
+
+:::image type="content" source="media/how-to-perform-major-version-upgrade-portal/upgrade-verification.png" alt-text="Diagram of Upgraded version to Flexible server after Major Version Upgrade.":::
+
+## Next steps
+
+- Learn about [business continuity](./concepts-business-continuity.md).
+- Learn about [zone-redundant high availability](./concepts-high-availability.md).
+- Learn about [backup and recovery](./concepts-backup-restore.md).