Merge pull request #112813 from rayne-wiselman/rayneapril26

Rayneapril26

Author: shawnmariejones

articles/migrate/how-to-add-tool-first-time.md

@@ -11,6 +11,15 @@ ms.date: 04/16/2020
 This article describes how to add an assessment or migration tool to an [Azure Migrate](migrate-overview.md) project for the first time.  
 Azure Migrate provides a central hub to track discovery, assessment and migration of your on-premises apps and workloads, and private/public cloud VMs, to Azure. The hub provides Azure Migrate tools for assessment and migration, as well as other tools and independent software vendor (ISV) [offerings](migrate-services-overview.md#isv-integration) . 
 
+## Check permissions to create project
+
+If you haven't yet created an Azure Migrate project, check you have the right permissions.
+
+1. In the Azure portal, open the subscription, and select **Access control (IAM)**.
+2. In Check access, find the relevant account, and click it to view permissions. You should have Contributor or Owner permissions.
+    - If you just created a free Azure account, you're the owner of your subscription.
+    - If you're not the subscription owner, work with the owner to assign the role.
+
 ## Create a project and add a tool
 
 Set up a new Azure Migrate project in an Azure subscription, and add a tool.
@@ -62,4 +71,6 @@ In some circumstances, you might need to create additional Azure Migrate project
 
 ## Next steps
 
-Learn how to add additional [assessment](how-to-assess.md) and [migration](how-to-migrate.md) tools. 
+- Get started with [Azure Migrate: Server Assessment](migrate-services-overview.md#azure-migrate-server-assessment-tool), or [Azure Migrate: Server Migration](migrate-services-overview.md#azure-migrate-server-migration-tool).
+- If you added an ISV tool, or Movere, [review steps](prepare-isv-movere.md) to prepare for linking the tool to Azure Migrate.
+- Learn how to add additional [assessment](how-to-assess.md) and [migration](how-to-migrate.md) tools. 

articles/migrate/how-to-assess.md

@@ -1,27 +1,17 @@
 ---
 title: Add assessment tools in Azure Migrate 
 description: Learn how to add assessment tools in Azure Migrate. 
-author: rayne-wiselman
-ms.service: azure-migrate
-ms.topic: article
-ms.manager: carmonm
-ms.date: 11/19/2019
-ms.author: raynew
+ms.topic: how-to
+ms.date: 04/26/2020
 ---
 
 
 # Add assessment tools
 
-This article describes how to add assessment tools in [Azure Migrate](migrate-overview.md).
-
-Azure Migrate provides a hub of tools for assessment and migration to Azure. It includes Azure Migrate tools, as well as other tools and independent software vendor (ISV) offerings.
-
-If you want to add an assessment tool and you don't yet have an Azure Migrate project, follow this [article](how-to-add-tool-first-time.md).
-
-## Select a tool
-
-If you choose a non-Azure Migrate tool for assessment, start by obtaining a license, or signing up for a free trial, in accordance with the tool policy. Tools have an option to connect to Azure Migrate. Follow the instructions and documentation, to connect the tool to Azure Migrate. [Learn more](migrate-services-overview.md) about tools.
+This article describes how to add assessment tools in [Azure Migrate](migrate-overview.md). 
 
+- If you want to add an assessment tool and you don't yet have an Azure Migrate project, follow this [article](how-to-add-tool-first-time.md).-
+- If you've added an ISV tool, or Movere, for assessment, [follow the steps](prepare-isv-movere.md), to prepare to work with the tool.
 
 ## Select an assessment scenario
 

articles/migrate/how-to-migrate.md

@@ -1,12 +1,8 @@
 ---
 title: Add migration tools in Azure Migrate 
 description: Learn how to add migration tools in Azure Migrate. 
-author: rayne-wiselman
-ms.service: azure-migrate
-ms.manager: carmonm
 ms.topic: article
-ms.date: 11/18/2019
-ms.author: raynew
+ms.date: 04/26/2020
 ---
 
 
@@ -15,15 +11,8 @@ ms.author: raynew
 
 This article describes how to add migration tools in [Azure Migrate](migrate-overview.md).
 
-Azure Migrate provides a hub of tools for assessment and migration to Azure. It includes native tools, tools provided by other Azure services, and third-party independent software vendor (ISV) offerings.
-
-If you want to add a migration tool and haven't yet set up an Azure Migrate project, follow this [article](how-to-add-tool-first-time.md).
-
-
-
-## Selecting an ISV tool
-
-If you choose an [ISV tool](migrate-services-overview.md#isv-integration) for migration, you can start by obtaining a license, or signing up for a free trial, in accordance with the ISV policy. In each tool, there's an option to connect to Azure Migrate. Deploy the tool, and follow the tool instructions and documentation to connect the tool workspace with Azure Migrate. 
+- If you want to add a migration tool and haven't yet set up an Azure Migrate project, follow this [article](how-to-add-tool-first-time.md).
+- If you've added an ISV tool for migration, [follow the steps](prepare-isv-movere.md), to prepare to work with the tool.
 
 ## Select a migration scenario
 

articles/migrate/media/how-to-add-tool-first-time/assess-migrate.png

@@ -0,0 +1,47 @@
+---
+title: Prepare Azure Migrate to work with ISV tools/Movere 
+description: Prepare Azure Migrate to work with ISV tools/Movere 
+ms.topic: how-to
+ms.date: 05/07/2020
+---
+
+# Prepare to work with ISV tools/Movere
+
+If you've added an [ISV tool](migrate-services-overview.md#isv-integration), or Movere, to an Azure Migrate project, there are a couple of steps to prepare before you link the tool, and send data to Azure Migrate. 
+
+## Check Azure AD permissions
+
+Your Azure user account needs a couple of permissions:
+
+- Permission to register an Azure AD app with your Azure tenant.
+- Permission to allocate a role to the Azure AD app at the subscription level.
+
+
+## Set permissions to register an Azure AD app
+
+1. In Azure Active Directory, check the role for  your account. If you have the user role, click **User settings** on the left and verify whether users can register applications.
+2. If it's set to **Yes**, any users in the Azure AD tenant can register an app. If they can't, then only admin users can register apps.
+3. If you don't have permissions, an admin user can provide your user account with the [Application Administrator](../active-directory/users-groups-roles/directory-assign-admin-roles.md#application-administrator) role, so that you can register the app.
+4. After the tool is linked to Azure Migrate, the admin can remove the role from your account.
+
+## Set permissions to assign a role to an Azure AD app
+ 
+In your Azure subscription, your account needs **Microsoft.Authorization/*/Write access**, to assign a role to an Azure AD app. 
+
+1. To check the subscription permissions, in the Azure portal, open **Subscriptions**.
+2. Select the relevant subscription. If you don't see it, select the **global subscriptions filter**. 
+3. Select **My permissions**. Then, select **Click here to view complete access details for this subscription**.
+4. In **Role assignments** > **View**, and check the permissions.
+5. If your account doesn't have permissions, ask the subscription administrator to add you to [User Access Administrator](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#user-access-administrator) role, or the [Owner](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#owner) role.
+ 
+
+## Start using the tool
+
+1. If you don't yet have a license or free trial for the tool, in the tool entry in Azure Migrate, in **Register**, click **Learn more**.
+2. In the tool, follow the instructions, to link from the tool to the Azure Migrate project, and to send data to Azure Migrate.
+
+## Next steps
+
+Follow the ISV or Movere instructions to send data to Azure Migrate.
+
+   

articles/migrate/media/how-to-assess/assess-scenario.png

@@ -92,6 +92,8 @@
     href: create-manage-projects.md
   - name: Add a tool for the first time
     href: how-to-add-tool-first-time.md
+  - name: Prepare to work with ISV tools/Movere
+    href: prepare-isv-movere.md
   - name: Add assessment tools
     href: how-to-assess.md
   - name: Deploy Azure Migrate appliance