Skip to content

Commit fc7d3ca

Browse files
authored
Merge pull request #105412 from Vikram1988/migrateGA
Changes to the appliance related articles and VMware migration privil…
2 parents 5f123de + eb38a7b commit fc7d3ca

5 files changed

+16
-28
lines changed

articles/migrate/how-to-set-up-appliance-hyper-v.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -44,12 +44,8 @@ Check that the zipped file is secure, before you deploy it.
4444
2. Run the following command to generate the hash for the VHD
4545
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
4646
- Example usage: ```C:\>CertUtil -HashFile C:\AzureMigrate\AzureMigrate.vhd SHA256```
47-
3. For appliance version 2.19.11.12, the generated hash should match these settings.
47+
3. For appliance version 2.19.11.12, the generated hash should match these [settings](https://docs.microsoft.com/azure/migrate/tutorial-assess-hyper-v#verify-security).
4848

49-
**Algorithm** | **Hash value**
50-
--- | ---
51-
MD5 | 29a7531f32bcf69f32d964fa5ae950bc
52-
SHA256 | 37b3f27bc44f475872e355f04fcb8f38606c84534c117d1609f2d12444569b31
5349

5450

5551

articles/migrate/how-to-set-up-appliance-physical.md

Lines changed: 7 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,6 @@ ms.author: raynew
1313

1414
This article describes how to set up the Azure Migrate appliance if you're assessing physical servers with the Azure Migrate: Server Assessment tool.
1515

16-
> [!NOTE]
17-
> If features are mentioned here that you don't yet see in the Azure Migrate portal, hang on. They will appear over the next week or so.
18-
1916
The Azure Migrate appliance is a lightweight appliance, used by Azure Migrate Server Assessment to do the following:
2017

2118
- Discover on-premises servers.
@@ -40,7 +37,7 @@ Download the zipped file for the appliance.
4037
2. In **Discover machines** > **Are your machines virtualized?**, click **Not virtualized/Other**.
4138
3. Click **Download** to download the zipped file.
4239

43-
![Download VM](./media/how-to-set-up-appliance-hyper-v/download-appliance-hyperv.png)
40+
![Download VM](./media/tutorial-assess-physical/download-appliance.png)
4441

4542

4643
### Verify security
@@ -51,17 +48,11 @@ Check that the zipped file is secure, before you deploy it.
5148
2. Run the following command to generate the hash for the VHD
5249
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
5350
- Example usage: ```C:\>CertUtil -HashFile C:\AzureMigrate\AzureMigrate.ova SHA256```
54-
3. For the latest appliance version, the generated hash should match these settings.
55-
56-
**Algorithm** | **Hash value**
57-
--- | ---
58-
MD5 | 96fd99581072c400aa605ab036a0a7c0
59-
SHA256 | f5454beef510c0aa38ac1c6be6346207c351d5361afa0c9cea4772d566fcdc36
51+
3. For the latest appliance version, the generated hash should match these [settings](https://docs.microsoft.com/azure/migrate/tutorial-assess-physical#verify-security).
6052

6153

6254

6355
## Run the Azure Migrate installer script
64-
=
6556
The installer script does the following:
6657

6758
- Installs agents and a web application for physical server discovery and assessment.
@@ -77,13 +68,16 @@ Run the script as follows:
7768
1. Extract the zipped file to a folder on the server that will host the appliance.
7869
2. Launch PowerShell on the above server with administrative (elevated) privilege.
7970
3. Change the PowerShell directory to the folder where the contents have been extracted from the downloaded zipped file.
80-
4. Run the script by running the following command:
71+
4. Run the script named **AzureMigrateInstaller.ps1** by running the following command:
8172
```
82-
AzureMigrateInstaller.ps1
73+
PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1
8374
```
8475
The script will launch the appliance web application when it finishes successfully.
8576
77+
In case of any issues, you can access the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log for troubleshooting.
8678
79+
> [!NOTE]
80+
> Please do not execute the Azure Migrate installer script on an existing Azure Migrate appliance.
8781
8882
### Verify appliance access to Azure
8983

articles/migrate/how-to-set-up-appliance-vmware.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ To set up the appliance you:
3131
2. In **Discover machines** > **Are your machines virtualized?**, click **Yes, with VMWare vSphere hypervisor**.
3232
3. Click **Download** to download the .OVA template file.
3333

34-
34+
![Selections for downloading an OVA file](./media/tutorial-assess-vmware/download-ova.png)
3535

3636
### Verify security
3737

@@ -41,19 +41,17 @@ Check that the OVA file is secure, before you deploy it.
4141
2. Run the following command, to generate the hash for the OVA:
4242
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
4343
- Example usage: ```C:\>CertUtil -HashFile C:\AzureMigrate\AzureMigrate.ova SHA256```
44-
3. For the latest appliance version, the generated hash should match these settings.
44+
3. For the latest appliance version, the generated hash should match these [settings](https://docs.microsoft.com/azure/migrate/tutorial-assess-vmware#verify-security).
4545

46-
**Algorithm** | **Hash value**
47-
--- | ---
48-
MD5 | c06ac2a2c0f870d3b274a0b7a73b78b1
49-
SHA256 | 4ce4faa3a78189a09a26bfa5b817c7afcf5b555eb46999c2fad9d2ebc808540c
5046

5147

5248
## Create the appliance VM
5349

5450
Import the downloaded file, and create a VM.
5551

5652
1. In the vSphere Client console, click **File** > **Deploy OVF Template**.
53+
![Menu command for deploying an OVF template](./media/tutorial-assess-vmware/deploy-ovf.png)
54+
5755
2. In the Deploy OVF Template Wizard > **Source**, specify the location of the OVA file.
5856
3. In **Name** and **Location**, specify a friendly name for the VM. Select the inventory object in which the VM
5957
will be hosted.

articles/migrate/migrate-appliance.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Physical machine | Azure Migrate: Server Assessment | Discover physical server
3030
**License** | The downloaded appliance template comes with a Windows Server 2016 evaluation license, which is valid for 180 days. If the evaluation period is close to expiry, we recommend that you download and deploy a new appliance, or that you activate the operating system license of the appliance VM.
3131
**Deployment** | You deploy the appliance as a VMware VM. You need enough resources on the vCenter Server to allocate a VM with 32-GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.<br/> The appliance requires internet access, either directly or through a proxy.<br/> The appliance can connect to a single vCenter Server.
3232
**Hardware** | Resources on vCenter to allocate a VM with 32-GB RAM 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.
33-
**Hash value** | MD5: c06ac2a2c0f870d3b274a0b7a73b78b1<br/><br/> SHA256: 4ce4faa3a78189a09a26bfa5b817c7afcf5b555eb46999c2fad9d2ebc808540c
33+
**Hash value** | Check [here](https://docs.microsoft.com/azure/migrate/tutorial-assess-vmware#verify-security)
3434
**vCenter server/host** | The appliance VM must be deployed on an ESXi host running version 5.5 or later.<br/><br/> vCenter Server running 5.5, 6.0, 6.5, or 6.7.
3535
**Azure Migrate project** | An appliance can be associated with a single project. <br/> Any number of appliances can be associated with a single project.<br/>
3636
**Discovery** | An appliance can discover up to 10,000 VMware VMs on a vCenter Server.<br/> An appliance can connect to a single vCenter Server.
@@ -48,7 +48,7 @@ Physical machine | Azure Migrate: Server Assessment | Discover physical server
4848
**License** | The downloaded appliance template comes with a Windows Server 2016 evaluation license, which is valid for 180 days. If the evaluation period is close to expiry, we recommend that you download and deploy a new appliance, or that you activate the operating system license of the appliance VM.
4949
**Appliance deployment** | You deploy the appliance as a Hyper-V VM.<br/> The appliance VM provided by Azure Migrate is Hyper-V VM version 5.0.<br/> The Hyper-V host must be running Windows Server 2012 R2 or later.<br/> The host needs sufficient space to allocate 16 GB RAM, 8 vCPUs, around 80 GB of storage space, and an external switch for the appliance VM.<br/> The appliance needs a static or dynamic IP address, and internet access.
5050
**Hardware** | Resources on Hyper-V host to allocate 16-GB RAM, 8 vCPUs, around 80 GB of storage space, and an external switch for the appliance VM.
51-
**Hash value** | MD5: 29a7531f32bcf69f32d964fa5ae950bc<br/><br/> SHA256: 37b3f27bc44f475872e355f04fcb8f38606c84534c117d1609f2d12444569b31
51+
**Hash value** | Check [here](https://docs.microsoft.com/azure/migrate/tutorial-assess-hyper-v#verify-security)
5252
**Hyper-V host** | Running Windows Server 2012 R2 or later.
5353
**Azure Migrate project** | An appliance can be associated with a single project. <br/> Any number of appliances can be associated with a single project.<br/>
5454
**Discovery** | An appliance can discover up to 5000 Hyper-V VMs.<br/> An appliance can connect to up to 300 Hyper-V hosts.
@@ -63,7 +63,7 @@ Physical machine | Azure Migrate: Server Assessment | Discover physical server
6363
**Download link** | [Download link](https://go.microsoft.com/fwlink/?linkid=2105112)
6464
**Download size** | 59.7 MB
6565
**Hardware** | Dedicated physical machine, or use a Virtual Machine. The machine running appliance needs 16-GB RAM, 8 vCPUs, around 80 GB of storage space, and an external switch.<br/> The appliance needs a static or dynamic IP address, and internet access.
66-
**Hash value** | MD5: 1e92ede3e87c03bd148e56a708cdd33f<br/><br/> SHA256: a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
66+
**Hash value** | Check [here](https://docs.microsoft.com/azure/migrate/tutorial-assess-physical#verify-security)
6767
**Operating System** | Appliance machine should be running Windows Server 2016.
6868
**Appliance deployment** | The appliance installer script is downloaded from the portal (in a zipped folder). <br/> You unzip the folder, and run the PowerShell script (AzureMigrateInstaller.ps1).
6969
**Discovery** | An appliance can discover up to 250 physical servers.

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Review [this article](server-migrate-overview.md) to figure out which method you
3030
--- | ---
3131
**VMware vCenter Server** | Version 5.5, 6.0, 6.5, or 6.7.
3232
**VMware vSphere ESXI host** | Version 5.5, 6.0, 6.5, or 6.7.
33-
**vCenter Server permissions** | Agentless migration uses the [Migrate Appliance](migrate-appliance.md). The appliance needs these permissions:<br/><br/> - **Datastore.Browse**: Allow browsing of VM log files to troubleshoot snapshot creation and deletion.<br/><br/> **Datastore.LowLevelFileOperations**: Allow read/write/delete/rename operations in the datastore browser, to troubleshoot snapshot creation and deletion.<br/><br/> - **VirtualMachine.Configuration.DiskChangeTracking**: Allow enable or disable change tracking of VM disks, to pull changed blocks of data between snapshots.<br/><br/> - **VirtualMachine.Configuration.DiskLease**: Allow disk lease operations for a VM, to read the disk using the VMware vSphere Virtual Disk Development Kit (VDDK).<br/><br/> - **VirtualMachine.Provisioning.AllowReadOnlyDiskAccess**: Allow opening a disk on a VM, to read the disk using the VDDK.<br/><br/> - **VirtualMachine.Provisioning.AllowVirtualMachineDownload**: Allows read operations on files associated with a VM, to download the logs and troubleshoot if failure occurs.<br/><br/> - **VirtualMachine.SnapshotManagement.***: Allow creation and management of VM snapshots for replication.<br/><br/> - **Virtual Machine.Interaction.Power Off**: Allow the VM to be powered off during migration to Azure.
33+
**vCenter Server permissions** | Agentless migration uses the [Migrate Appliance](migrate-appliance.md). The appliance needs these permissions:<br/><br/> - **Datastore.Browse**: Allow browsing of VM log files to troubleshoot snapshot creation and deletion.<br/><br/> - **Datastore.LowLevelFileOperations**: Allow read/write/delete/rename operations in the datastore browser, to troubleshoot snapshot creation and deletion.<br/><br/> - **VirtualMachine.Configuration.DiskChangeTracking**: Allow enable or disable change tracking of VM disks, to pull changed blocks of data between snapshots.<br/><br/> - **VirtualMachine.Configuration.DiskLease**: Allow disk lease operations for a VM, to read the disk using the VMware vSphere Virtual Disk Development Kit (VDDK).<br/><br/> - **VirtualMachine.Provisioning.AllowDiskAccess**: (specifically for vSphere 6.0 and above) Allow opening a disk on a VM for random read access on the disk using the VDDK.<br/><br/> - **VirtualMachine.Provisioning.AllowReadOnlyDiskAccess**: Allow opening a disk on a VM, to read the disk using the VDDK.<br/><br/>- **VirtualMachine.Provisioning.AllowVirtualMachineDownload**: Allows read operations on files associated with a VM, to download the logs and troubleshoot if failure occurs.<br/><br/> - **VirtualMachine.SnapshotManagement.***: Allow creation and management of VM snapshots for replication.<br/><br/> - **Virtual Machine.Interaction.Power Off**: Allow the VM to be powered off during migration to Azure.
3434

3535

3636

0 commit comments

Comments
 (0)