Added initial draft

Author: KumarVivek

powerapps-docs/maker/TOC.yml

@@ -1673,6 +1673,8 @@
       href: ../sample-apps/regional-emergency-response/overview.md
     - name: Deploy the solution
       href: ../sample-apps/regional-emergency-response/deploy.md
+    - name: Upgrade the solution
+      href: ../sample-apps/regional-emergency-response/upgrade.md
     - name: App and dashboard for regional admin
       href: ../sample-apps/regional-emergency-response/configure.md
     - name: Portal for admin and report viewer

powerapps-docs/sample-apps/regional-emergency-response/upgrade.md

@@ -0,0 +1,119 @@
+---
+title: Upgrade the Regional Government Emergency Response and Monitoring solution | Microsoft Docs
+description: Provides provides detailed instructions for regional IT admins to upgrade the Regional Government Emergency Response and Monitoring solution for their organization.
+author: KumarVivek
+manager: annbe
+ms.service: powerapps
+ms.topic: conceptual
+ms.custom: 
+ms.date: 04/29/2020
+ms.author: kvivek
+ms.reviewer: kvivek
+searchScope:
+  - PowerApps
+---
+
+# Upgrade the Regional Government Emergency Response and Monitoring solution
+
+Perform the steps in this article to upgrade your existing installation of Regional Government Emergency Response and Monitoring solution to the latest version.
+
+## Prerequisites
+
+- Ensure that you have the Global Admin credentials and environment details where
+    the Regional Government Emergency Response and Monitoring solution is deployed currently.
+
+-   Ensure all users are disconnected from your environment before you upgrade. You might have to plan the upgrade process at a time when there is minimal obstructions for your users.   
+
+-   Ensure you have copied the Email contents to a Word file from the Send
+    Invitation, Send Password Reset To Contact processes
+
+## Step 1: Download the upgrade deployment package
+
+Get the latest deployment package (.zip) from <https://aka.ms/rer-solution>. It's the same deployment package as the one you download during the fresh deployment step.
+
+**IMPORTANT:** Before extracting the .zip file, ensure that you unblock it.
+
+1.  Right click the .zip file, select **Properties**.
+
+2.  In the properties dialog box, select **Unblock**, and then select **Apply**
+    followed by **OK.**
+
+After unblocking the file, extract the .zip file to see the following in the
+extracted folder:
+
+On extracting the .zip file, you will see the following in the extracted folder:
+
+|**Folder**  |**Description**  |
+|---------|---------|
+|**Package**     |  The folder contains the Package Deployer tool and the package that you will import later to set up the solution in your environment.       |
+|**Power BI Template**     | Contains the Power BI Report template file (.pbit) that you will use to configure reporting. More information: [Step 5: Configure and publish Power BI dashboard](#step-5-configure-and-publish-power-bi-dashboard)        |
+|**SampleData**     |   Contains the sample master data files (.xlsx) that you can use to import sample data.       |
+
+## Step 2: Install the upgrade package
+
+Install the upgrade package in the **same environment** where you have the
+existing solution installed. You can install the upgrade package in one of the following 3 ways just like you did when deploying the solution for the **first time**.
+
+- Microsoft AppSource (for Power Apps US Govt customers only). See [Option A: Install the app from Microsoft AppSource (US Govt customers)](#option-a-install-the-app-from-microsoft-appsource-us-govt-customers) in the deployment topic
+
+- Microsoft AppSource (for Power Apps commercial version customers). See [Option B: Install the app from Microsoft AppSource](#option-b-install-the-app-from-microsoft-appsource) in the deployment topic
+
+- Deployment package that you downloaded earlier. See [Option C: Install the app from the deployment package](#option-c-install-the-app-from-the-deployment-package) in the deployment topic
+
+## Step 3: Publish the latest Power BI dashboard
+
+Use the .pbit file in the upgrade package to configure and publish the latest
+Power BI dashboard. 
+
+Steps to use the .pbit file are the same as the original deployment; make sure you use the same workspace to overwrite the existing Power BI dashboard if you want to preserver the Power BI report URL that is used for embedding it into Power Apps portal. 
+
+More information: [Step 5: Configure and publish Power BI
+dashboard](https://docs.microsoft.com/powerapps/sample-apps/regional-emergency-response/deploy#step-5-configure-and-publish-power-bi-dashboard)
+
+## Step 4: Verify the Power BI report URL in your portal
+
+This step is required only if your Power BI report URL has changed in the previous step owing to you publishing the dashboard in a new worksoaceVerify the **PowerBI Path** site setting in your portal and update the value
+with the latest Power BI report URL.
+
+For detailed steps, see [Embed Power BI report in
+portal](https://docs.microsoft.com/en-us/powerapps/sample-apps/regional-emergency-response/deploy#the-process-1)
+
+Make sure to restart our portal for the changes to take effect. More
+information: [Restart the
+portal](https://docs.microsoft.com/en-us/powerapps/sample-apps/regional-emergency-response/deploy#restart-the-portal)
+
+## Step 5: Verify the Send Invitation and Send Password Reset To Contact processes
+
+Verify that the **Send Invitation** and **Send Password Reset To Contact**
+processes are still valid, that is, they have an account in the **From** field
+that can send emails and the rest of the details are fine.
+
+For details about how to fix these processes, see:
+
+-   [Step 10: Fix the Send Invitation
+    process](https://docs.microsoft.com/en-us/powerapps/sample-apps/regional-emergency-response/deploy#step-10-fix-the-send-invitation-process)
+
+-   [Step 11: Fix the Send Password Reset To Contact
+    process](https://docs.microsoft.com/en-us/powerapps/sample-apps/regional-emergency-response/deploy#step-11-fix-the-send-password-reset-to-contact-process)
+
+## Step 6: Verify the Flow supply tracking flow is enabled
+
+
+This flow enables the frontline user to add supplies through the portal that
+gets saved in Common Data Service.
+
+For details about how to fix these processes, see [Step 13: Verify the Flow
+supply tracking flow is
+enabled](https://docs.microsoft.com/en-us/powerapps/sample-apps/regional-emergency-response/deploy#step-13-verify-the-flow-supply-tracking-flow-is-enabled).
+
+## Step 7: Edit the 2 flows (check the recording)
+
+-   Verifying the credentials to connect to CDS and send email
+
+-   In the 2nd flow, we are Verifying the credentials to connect to CDS and send
+    email and also fixing the Portal URL in the email body
+
+After the flow is complete and next time Power BI report is refreshed (every 30
+mins as per our recommendation), you will see the historical data in your
+reports.
+