Skip to content

Commit 6ea2586

Browse files
committed
Adding references to VMware to support the upcoming VMware agent release
1 parent 852a59d commit 6ea2586

File tree

1 file changed

+12
-10
lines changed

1 file changed

+12
-10
lines changed

articles/storage-mover/agent-deploy.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ REVIEW Engineering: not reviewed
1919
EDIT PASS: started
2020
2121
Initial doc score: 83
22-
Current doc score: 96 (2038 words and 10 false-positive issues)
22+
Current doc score: 96 (2093 words and 10 false-positive issues)
2323
2424
!########################################################
2525
-->
@@ -43,17 +43,17 @@ This article guides you through the steps necessary to successfully deploy a Sto
4343
4444
## Determine required resources for the VM
4545

46-
Like every VM, the agent requires available compute, memory, network, and storage space resources on the host. Although overall data size may affect the time required to complete a migration, it's generally the number of files and folders that drives resource requirements.
46+
Like every VM, the agent requires available compute, memory, network, and storage space resources on the host. Although overall data size might affect the time required to complete a migration, it's generally the number of files and folders that drives resource requirements.
4747

4848
### Network resources
4949

5050
The agent requires unrestricted internet connectivity.
5151

52-
Although no single network configuration option works for every environment, the simplest configuration involves the deployment of an external virtual switch. The external switch type is connected to a physical adapter and allows your host operating system (OS) to share its connection with all your virtual machines (VMs). This switch allows communication between your physical network, the management operating system, and the virtual adapters on your virtual machines. This approach may be acceptable for a test environment, but is likely not sufficient for a production server.
52+
Although no single network configuration option works for every environment, the simplest configuration involves the deployment of an external virtual switch. The external switch type is connected to a physical adapter and allows your host operating system (OS) to share its connection with all your virtual machines (VMs). This switch allows communication between your physical network, the management operating system, and the virtual adapters on your virtual machines. This approach might be acceptable for a test environment, but is likely not sufficient for a production server.
5353

5454
After the switch is created, ensure that both the management and agent VMs are on the same switch. On the WAN link firewall, outbound TCP port 443 must be open. Keep in mind that connectivity interruptions are to be expected when changing network configurations.
5555

56-
You can get help with [creating a virtual switch for Hyper-V virtual machines](/windows-server/virtualization/hyper-v/get-started/create-a-virtual-switch-for-hyper-v-virtual-machines) in the [Windows Server](/windows-server/) documentation.
56+
You can get help with [creating a virtual switch for Hyper-V virtual machines](/windows-server/virtualization/hyper-v/get-started/create-a-virtual-switch-for-hyper-v-virtual-machines) in the [Windows Server](/windows-server/) documentation. Consult the VMware support website for detailed guidance on creating a virtual switch for VMware-hosted VMs.
5757

5858
### Recommended compute and memory resources
5959

@@ -74,14 +74,16 @@ The [Performance targets](performance-targets.md) article contains test results
7474

7575
### Local storage capacity
7676

77-
At a minimum, the agent image needs 20 GiB of local storage. The amount required may increase if a large number of small files are cached during a migration.
77+
At a minimum, the agent image needs 20 GiB of local storage. The amount required might increase if a large number of small files are cached during a migration.
7878

7979
## Download the agent VM image
8080

81-
The image is hosted on Microsoft Download Center as a zip file. Download the file at [https://aka.ms/StorageMover/agent](https://aka.ms/StorageMover/agent) and extract the agent virtual hard disk (VHD) image to your virtualization host.
81+
Images for agent VMs are hosted on Microsoft Download Center as a zip file. Download the file at [https://aka.ms/StorageMover/agent](https://aka.ms/StorageMover/agent) and extract the agent virtual hard disk (VHD) image to your virtualization host.
8282

8383
## Create the agent VM
8484

85+
The following steps describe the process for creating a VM using Microsoft Hyper-V. Consult the VMware support website for detailed guidance on creating a VMware-based VM.
86+
8587
1. Create a new VM to host the agent. Open **Hyper-V Manager**. In the **Actions** pane, select **New** and **Virtual Machine...** to launch the **New Virtual Machine Wizard**.
8688

8789
:::image type="content" source="media/agent-deploy/agent-vm-create-sml.png" alt-text="Image showing how to launch the New Virtual Machine Wizard from within the Hyper-V Manager." lightbox="media/agent-deploy/agent-vm-create-lrg.png":::
@@ -119,7 +121,7 @@ The image is hosted on Microsoft Download Center as a zip file. Download the fil
119121

120122
## Change the default password
121123

122-
The agent is delivered with a default user account and password. Immediately after deploying and starting the agent VM, connect to it and change the default password!
124+
The agent is delivered with a default user account and password. Connect to the newly created agent and change the default password immediately after the agent is deployed and started.
123125

124126
[!INCLUDE [agent-shell-connect](includes/agent-shell-connect.md)]
125127

@@ -130,7 +132,7 @@ Take time to consider the amount of bandwidth a new machine uses before you depl
130132
> [!IMPORTANT]
131133
> The current Azure Storage Mover agent does not support bandwidth throttling schedules.
132134
133-
If bandwidth throttling is important to you, create a local virtual network (VNet) with network quality of service (QoS) settings and an internet connection. This approach allows you to expose the agent through the VNet, and to locally configure an unauthenticated network proxy server on the agent if needed.
135+
If bandwidth throttling is important to you, create a local virtual network with an internet connection and configure quality of service (QoS) settings. This approach allows you to expose the agent through the virtual network and to locally configure an unauthenticated network proxy server on the agent if needed.
134136

135137
## Decommissioning an agent
136138

@@ -196,7 +198,7 @@ Several things take place during the unregistration process:
196198

197199
- The agent is removed from the storage mover resource. You can no longer see the agent in the *Registered agents* tab in the portal or select it for new migration jobs.
198200
- The agent is also removed from the Azure ARC service. This removal deletes the hybrid compute resource of type *Server - Azure Arc* that represented the agent with the Azure ARC service in the same resource group as your storage mover resource.
199-
- Unregistration removes the managed identity of the agent from Microsoft Entra ID. The associated service principal is automatically removed, invalidating any permissions this agent may have had on other Azure resources. If you check the role-based access control (RBAC) role assignments, for instance of a target storage container the agent previously had permissions to, you no longer find the service principal of the agent, because it was deleted. The assignment itself is still visible as "Unknown service principal" but this assignment no longer connects to an identity and can never be reconnected. It's simply a sign that a role assignment used to be here, of a service principal that no longer exists.
201+
- Unregistration removes the managed identity of the agent from Microsoft Entra ID. The associated service principal is automatically removed, invalidating any permissions this agent might have on other Azure resources. If you check the role-based access control (RBAC) role assignments, for instance of a target storage container the agent previously had permissions to, you no longer find the service principal of the agent, because it was deleted. The assignment itself is still visible as "Unknown service principal" but this assignment no longer connects to an identity and can never be reconnected. It's simply a sign that a role assignment used to be here, of a service principal that no longer exists.
200202

201203
This behavior is standard, and not specific to Azure Storage Mover. You can observe the same behavior if you remove a different service principal from Microsoft Entra ID and then check a former role assignment.
202204

@@ -211,6 +213,6 @@ You can stop the agent VM on your virtualization host after the unregistration i
211213

212214
## Next steps
213215

214-
After you've deployed your agent VM, started it, and changed the default password of the local account:
216+
After you deploy your agent, started it, and changed the default password of the local account:
215217
> [!div class="nextstepaction"]
216218
> [Register the agent with your storage mover Azure resource](agent-register.md)

0 commit comments

Comments
 (0)