Merge pull request #3764 from MicrosoftDocs/portals-2072328

Portals - solution upgrade feature - 2072328

Author: tapanm-MSFT

powerapps-docs/maker/portals/admin/media/power-platform-admin-center/check-upgrades.png

@@ -5,7 +5,7 @@ author: neerajnandwana-msft
 ms.service: powerapps
 ms.topic: conceptual
 ms.custom: 
-ms.date: 09/11/2020
+ms.date: 12/11/2020
 ms.author: nenandw
 ms.reviewer: tapanm
 ---
@@ -14,7 +14,7 @@ ms.reviewer: tapanm
 
 You can now manage portals in the Power Platform admin center. The Power Platform admin center helps you manage both capacity-based and add-on portals. You can also see information such as how many days are left before a trial portal expires. For more information about portal licensing, see the [licensing FAQ](/power-platform/admin/powerapps-flow-licensing-faq#portals) and [portal differences](../faq.md#what-is-the-difference-between-power-apps-portals-dynamics-365-portals-and-add-on-portals). For more information about Power Platform admin center, go to [Administer Power Platform](/power-platform/admin/admin-documentation).
 
-You can manage portals in the Power Platform admin center in two ways: You can manage all portals for the current tenant from **Resources** > **Portals**, and you can manage portals for a specific environment from **Environments**.
+Manage portals in the Power Platform admin center in two ways: Manage all portals for the current tenant from **Resources** > **Portals**. Or, manage portals for a specific environment from **Environments**.
 
 ## Manage all portals for a tenant
 
@@ -26,7 +26,7 @@ You can manage portals in the Power Platform admin center in two ways: You can m
 
 1. Select a portal.
 
-1. To manage the portal, select **More portal actions** (**...**), and then select **Manage**. Alternatively, you can select the portal and then select **Manage** at the top of the page.
+1. To manage the portal, select **More portal actions** (**...**), and then select **Manage**. You can select the portal and then select **Manage** at the top of the page instead.
 
     ![Manage a portal from the Power Platform admin center](media/power-platform-admin-center/portals-manage-ppac.png "Manage a portal from the Power Platform admin center")
 
@@ -52,7 +52,7 @@ To configure portal details, see [Portal details](portal-details.md).
 
     ![Portals specific to an environment](media/power-platform-admin-center/environments-portals.png "Portals specific to an environment")
 
-1. To manage a portal, select **More portal actions** (**...**), and then select **Manage**. Alternatively, you can select the portal and then select **Manage** from the top of the page.
+1. To manage a portal, select **More portal actions** (**...**), and then select **Manage**. You can select the portal and then select **Manage** from the top of the page instead.
 
     ![Manage a portal specific to an environment](media/power-platform-admin-center/manage-environments-portal.png "Manage a portal specific to an environment")
 
@@ -79,20 +79,90 @@ The following table describes the different types of portals that are listed in
 
 ### Portal status
 
-A portal can have the following status: *Configured*, *Suspended*, or *Not-configured*. The following table describes each state.
+A portal can have the following status: *Configured*, *Suspended*, or *Not configured*. The following table describes each state.
 
 | Status         |  Description    |
 |----------------|-----------------|
 | Configured     | This portal has been configured to an environment.     |
 | Suspended      | This portal has been suspended because its trial period is over. It will be deleted in seven days, unless it's converted to a production portal. |
-| Not-configured | This portal is ready to be configured to an environment.   |
+| Not configured | This portal is ready to be configured to an environment.   |
 
 > [!NOTE]
-> You can [create a new portal](../provision-portal-add-on.md) if the portal add-on status is *Not-configured*. The status will change to *Configured* after the portal is provisioned.
+> You can [create a new portal](../provision-portal-add-on.md) if the portal add-on status is *Not configured*. The status will change to *Configured* after the portal is provisioned.
 
 ## Update the Power Apps portal solution
 
-You can use the Power Platform admin center to update your Power Apps portal solution.
+A Power Apps portal consists of solutions from different packages in an environment.
+
+Use Power Platform admin center to:
+
+- View the details of installed packages (such as the version details).
+- If a package with a higher version is available, update them for the selected portal.
+
+> [!IMPORTANT]
+> - Package upgrade may take some time. While the upgrade is in progress, you can see some instability in your portal. Hence, upgrade the packages during off-peak hours.
+> - Solutions in a package are upgraded for an environment. Hence, the selected package will be upgraded for all portals in this environment using this package.
+
+### Permissions required
+
+You may see the following error message if you don't have the required permissions to view and upgrade portal package:
+
+`You don't have the permissions to access this portal's environment.`
+
+To learn about the permissions required to view and upgrade portal packages, read [Admin roles required for portal administrative tasks](portal-admin-roles.md).
+
+### View portals package details
+
+To view the portals package details:
+
+1. Select the [portal for your environment](#manage-all-portals-for-an-environment).
+
+1. Select **Portal Package(s) details**.
+
+    ![Details of portal's packages](media/power-platform-admin-center/portal-package-details.png "Details of portal's packages")
+
+1. View the details of the packages for the selected portal.
+
+    ![Details of portal's packages such as name, version and installed status ](media/power-platform-admin-center/portal-package-details-info.png "Details of portal's packages such as name, version and installed status")
+
+### Update portals package
+
+You can use Power Platform admin center to upgrade portal packages. Choose to upgrade based on selected environment, or from the list of portals for a tenant.
+
+> [!NOTE]
+> In addition to the methods listed below, you'll also see a notification when you edit the portal using the portals Studio if an upgrade package is available.
+
+#### Method 1: Update portals packages using the selected environment
+
+1. Select a [portal for your environment](#manage-all-portals-for-an-environment).
+
+1. Select **Upgrade now** from the notification on the top of the page if an update is available. You can also check for the notification from the [package details](#view-portals-package-details) page.
+
+#### Method 2: Update portals packages using the portals list for a tenant
+
+1. Select a portal from the [list of all portals in a tenant](#manage-all-portals-for-a-tenant).
+
+1. Select **Check portal package(s) for upgrade**.
+
+    ![Check portal package(s) for upgrade](media/power-platform-admin-center/check-upgrades.png "Check portal package(s) for upgrade")
+
+1. Update package(s), if available.
+
+### Check package upgrade errors and retry
+
+If the package upgrade fails, you'll see a notification with the problem details.
+
+![Error upgrading package(s)](media/power-platform-admin-center/upgrade-error.png "Error upgrading package(s)")
+
+Select **See details** for more information.
+
+![Error upgrading package(s) - details](media/power-platform-admin-center/error-example.png "Error upgrading package(s) - details")
+
+To retry installing the update, select **Retry upgrade**.
+
+## Update Dynamics 365 Instance for your portal
+
+You can use the Power Platform admin center to update your portal's Dynamics 365 Instance.
 
 > [!IMPORTANT]
 > When changing Dynamics 365 Instance for your portal, ensure the new instance is from the same [region](/power-platform/admin/regions-overview) as the current instance. Changing the Dynamics 365 Instance for Power Apps portals across regions isn't supported.
@@ -119,7 +189,7 @@ You can use the Power Platform admin center to update your Power Apps portal sol
 
     ![Update request submitted](media/power-platform-admin-center/update-request-submitted.png "Update request submitted")
 
-The update might take a while after you select **Submit**. More information: [Upgrade a portal](upgrade-portal.md)
+The update may take a while after you select **Submit**. More information: [Upgrade a portal](upgrade-portal.md)
 
 ## Next steps