Merge pull request #264601 from MicrosoftDocs/release-rvtools-xlsx

Publish branch release-rvtools-xlsx--scheduled release at 10AM of 2/02

Author: huypub

articles/migrate/media/tutorial-import-vmware-using-rvtools-xlsx/failed-status.png

@@ -6,7 +6,7 @@ ms.author: vibansa
 ms.manager: abhemraj
 ms.topic: conceptual
 ms.service: azure-migrate
-ms.date: 01/19/2024
+ms.date: 01/25/2024
 ms.custom: engagement-fy23
 ---
 
@@ -327,6 +327,40 @@ Requirement | Details
 **Internet connectivity** | If servers aren't connected to the internet, install the Log Analytics gateway on the servers.
 **Azure Government** | Agent-based dependency analysis isn't supported.
 
+## Import servers using RVTools XLSX (preview)
+
+As part of your migration journey to Azure using the Azure Migrate appliance, you first discover servers, inventory, and workloads. However, for a quick assessment before you deploy the appliance, you can [import the servers using the RVtools XLSX file (preview)](tutorial-import-vmware-using-rvtools-xlsx.md).
+
+### Key benefits
+
+- Helps to create a business case or assess the servers before you deploy the appliance.
+- Aids as an alternative when there's an organizational restriction to deploy Azure Migrate appliance.
+- Helpful when you can't share credentials that allow access to on-premises servers
+- Useful when security constraints prevent you from gathering and sending data collected by the appliance to Azure. 
+
+### Limitations
+
+#### [Business case considerations](#tab/businesscase)
+
+If you're importing servers by using an RVTools XLSX file and building a business case, listed below are few limitations: 
+
+- Performance history duration in Azure settings aren't applicable.
+- Servers are classified as unknown in the business case utilization insights chart and are sized as-is without right sizing for Azure or AVS cost.
+
+#### [Assessment considerations](#tab/assessmentcase)
+
+If you're importing servers by using an RVTools XLSX file for creating an assessment with the following criteria:
+- Sizing criteria as **performance-based** on the configured CPU and memory (based on the CPUs and Memory columns from the RVTools XLSX).
+- Storage criteria (In use MiB and In use MB for versions prior to 4.1.2)
+
+You won't be able to provide performance history or percentile information.
+
+To get an accurate OS suitability/readiness in Azure VM and Azure VMware Solution assessment, enter the **Operating system** version and **architecture** in the respective columns. 
+
+---
+
+
+
 ## Next steps
 
 - Review [assessment best practices](best-practices-assessment.md).

articles/migrate/media/tutorial-import-vmware-using-rvtools-xlsx/navigation-using-import.png

@@ -133,7 +133,7 @@ Microsoft Azure operated by 21Vianet | China North 2
 There are two versions of the Azure Migrate service:
 
 - **Current version**: Using this version you can create new projects, discover on-premises assesses, and orchestrate assessments and migrations. [Learn more](whats-new.md).
-- **Previous version**: For customer using the previous version of Azure Migrate (only assessment of on-premises VMware VMs was supported), you should now use the current version. In the previous version, you can't create new projects or perform new discoveries.
+- **Previous version**: For customer using, the previous version of Azure Migrate (only assessment of on-premises VMware VMs was supported), you should now use the current version. In the previous version, you can't create new projects or perform new discoveries.
 
 ## Next steps
 

articles/migrate/media/tutorial-import-vmware-using-rvtools-xlsx/select-import.png

@@ -29,8 +29,12 @@ items:
   items:
   - name: Discover
     items:
-    - name: Discover servers in VMware environment
-      href: tutorial-discover-vmware.md
+    - name: VMware environment
+      items:
+        - name: Discover servers in VMware environment
+          href: tutorial-discover-vmware.md
+        - name: Import servers in VMware environment
+          href: tutorial-import-vmware-using-rvtools-xlsx.md
     - name: Discover servers in Hyper-V environment
       href: tutorial-discover-hyper-v.md
     - name: Discover physical servers

articles/migrate/migrate-support-matrix-vmware.md

@@ -0,0 +1,105 @@
+---
+title: Import on-premises servers in a VMware environment using RVTools XLSX (preview)
+description: Learn how to import on-premises servers in a VMware environment by using the RVTools XLSX (preview).
+author: snehasudhirG
+ms.author: sudhirsneha
+ms.topic: tutorial
+ms.date: 01/25/2024
+ms.service: azure-migrate
+#Customer intent: As an VMware admin, I want to import my on-premises servers running in a VMware environment.
+---
+
+# Tutorial: Import servers running in a VMware environment with RVTools XLSX (preview)
+
+As part of your migration journey to Azure, you discover your on-premises inventory and workloads.
+
+This tutorial shows you how to discover the servers that are running in your VMware environment by using RVTools XLSX (preview). When you use this tool, you can control the data shared in the file and there's no need to set up the Azure Migrate appliance to discover servers. [Learn more](migrate-support-matrix-vmware.md#import-servers-using-rvtools-xlsx-preview).
+
+
+In this tutorial, you learn how to:
+
+> [!div class="checklist"]
+> * Prepare an Azure account.
+> * Set up an Azure Migrate project.
+> * Import the RVTools XLSX file.
+
+> [!NOTE]
+> Tutorials show you the quickest path for trying out a scenario. They use default options where possible.  
+
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/free-trial/) before you begin.
+
+## Prerequisites
+
+Before you begin this tutorial, ensure that you have the following prerequisites in place:
+
+- 20,000 servers in a single XLSX file and 35,000 in an Azure Migrate project.
+- The file format should be XLSX.
+- File sensitivity is set to **General** or file protection is set to **Any user**.
+- [Operating system names](migrate-support-matrix.md) specified in the RVTools XLSX (preview) file contains and matches the supported names.
+- The XLSX file should contain the vInfo & vDisk sheets and the VM, Powerstate, Disks, CPUs, Memory, Provisioned MiB, In use MiB, OS according to the configuration file, VM UUID columns from the vInfo sheet and the VM, Capacity MiB columns from the vDisk sheet should be present.
+ 
+
+## Prepare an Azure user account
+
+To create a project and register the Azure Migrate appliance, you must have an Azure user account that has the following permissions:
+
+- Contributor or Owner permissions in Azure subscription. Complete the procedure to [set Contributor or Owner permissions in the Azure subscription](tutorial-discover-vmware.md#prepare-an-azure-user-account)
+- Permissions to register Microsoft Entra apps.
+- Owner or Contributor and User Access Administrator permission at subscription level to create an instance of Azure Key Vault, which is used during the agentless server migration.
+
+
+## Set up an Azure Migrate project
+
+Follow the instructions on [how to set up an Azure Migrate project](tutorial-discover-import.md#set-up-a-project).
+
+
+## Import the servers using the RVTools XLSX file (preview)
+
+To import the servers using RVTools XLSX (preview) file, follow these steps:
+
+1. Sign in to the [Azure portal](https://portal.azure.com) and go to **Azure Migrate**.
+1. Under **Migration goals**, select **Servers, databases and web apps**.
+1. On **Azure Migrate | Servers, databases and web apps** page, under **Assessment tools**, select **Discover** and then select **Using import**.
+
+    :::image type="content" source="./media/tutorial-import-vmware-using-rvtools-xlsx/navigation-using-import.png" alt-text="Screenshot that shows how to navigate to the RVTools import option." lightbox="./media/tutorial-import-vmware-using-rvtools-xlsx/navigation-using-import.png":::
+
+1. In **Discover** page, in **File type**, select **VMware inventory (RVTools XLSX)**.
+1. In the **Step 1: Import the file** section, select the RVTools XLSX file and then select **Import**.
+
+    :::image type="content" source="./media/tutorial-import-vmware-using-rvtools-xlsx/select-import.png" alt-text="Screenshot that shows to upload, check status and selecting import." lightbox="./media/tutorial-import-vmware-using-rvtools-xlsx/select-import.png":::
+
+    We recommend that you don't close the browser tab or attempt to import again while the current import is in progress. The import status provides information on the following:
+    - If there are warnings in the status, you can either fix them or continue without addressing them.
+    - To improve assessment accuracy, improve the server information as suggested in warnings. 
+    - If the import status appears as **Failed**, you must fix the errors to continue with the import.
+    
+      :::image type="content" source="./media/tutorial-import-vmware-using-rvtools-xlsx/failed-status.png" alt-text="Screenshot that shows to status as failed." lightbox="./media/tutorial-import-vmware-using-rvtools-xlsx/failed-status.png"::: 
+   
+    - To view and fix errors, follow these steps:
+        - Select *Download error details.XLSX* file. This operation downloads the XLSX with warnings included.
+        - Review and address the errors as necessary.
+        - Upload the modified file again.
+
+When the **Import status** is marked as **Complete**, it implies that the server information is successfully imported.
+
+## Update server information
+To update the information for a server, follow these steps:
+
+1. In the *Download error details.XLSX* file, update the rows.
+1. To reimport the data, follow the steps from 1-5 in the [Import using the RVTools XLSX file (preview)](#import-the-servers-using-the-rvtools-xlsx-file-preview).
+
+> [!NOTE]
+> Currently, we don't support deleting servers after you import them into project.
+
+## Verify servers in Azure portal
+
+To verify that the servers appear in the Azure portal after importing, follow these steps:
+
+1. Go to Azure Migrate dashboard.
+1. On the **Azure Migrate | Servers, databases and web apps >** page, in  **Azure Migrate: Discovery and assessment** section, select the icon that displays the count for Discovered servers.
+1. Select the **Import based** tab.
+
+
+## Next steps
+
+- Learn on [key benefits and limitations of using RVTools.XLSX](migrate-support-matrix-vmware.md#import-servers-using-rvtools-xlsx-preview).

articles/migrate/migrate-support-matrix.md

@@ -6,13 +6,17 @@ author: Vikram1988
 ms.author: vibansa
 ms.manager: abhemraj
 ms.service: azure-migrate
-ms.date: 12/07/2023
+ms.date: 01/24/2024
 ms.custom: mvc, engagement-fy24
 ---
 
 # What's new in Azure Migrate
 
-[Azure Migrate](migrate-services-overview.md) helps you to discover, assess, and migrate on-premises servers, apps, and data to the Microsoft Azure cloud. This article summarizes new releases and features in Azure Migrate.
+[Azure Migrate](migrate-services-overview.md) helps you to discover, assess and migrate on-premises servers, apps, and data to the Microsoft Azure cloud. This article summarizes new releases and features in Azure Migrate.
+
+## Update (January 2024)
+
+- Public preview: Using the RVTools XLSX, you can import on-premises servers' configuration into a VMware environment and create quick business case by assessing the cost of Azure and Azure VMware Solution (AVS) environments. [Learn more](migrate-support-matrix-vmware.md#import-servers-using-rvtools-xlsx-preview). 
 
 ## Update (December 2023)