Skip to content

Commit 3c1544b

Browse files
committed
Doc updates
1 parent f78da9f commit 3c1544b

File tree

2 files changed

+27
-29
lines changed

2 files changed

+27
-29
lines changed

articles/azure-arc/vmware-vsphere/enable-guest-management-at-scale.md

Lines changed: 21 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Install Arc agent at scale for your VMware VMs
33
description: Learn how to enable guest management at scale for Arc enabled VMware vSphere VMs.
44
ms.topic: how-to
5-
ms.date: 04/22/2024
5+
ms.date: 04/23/2024
66
ms.service: azure-arc
77
ms.subservice: azure-arc-vmware-vsphere
88
author: Farha-Bano
@@ -34,7 +34,7 @@ Ensure the following before you install Arc agents at scale for VMware VMs:
3434
> [!NOTE]
3535
> If you're using a Linux VM, the account must not prompt for login on sudo commands. To override the prompt, from a terminal, run `sudo visudo`, and add `<username> ALL=(ALL) NOPASSWD:ALL` at the end of the file. Ensure you replace `<username>`. <br> <br>If your VM template has these changes incorporated, you won't need to do this for the VM created from that template.
3636
37-
## Approach A: Install Arc agents at scale from portal
37+
### Approach A: Install Arc agents at scale from portal
3838

3939
An admin can install agents for multiple machines from the Azure portal if the machines share the same administrator credentials.
4040

@@ -56,7 +56,7 @@ An admin can install agents for multiple machines from the Azure portal if the m
5656
> [!NOTE]
5757
> For Windows VMs, the account must be part of local administrator group; and for Linux VM, it must be a root account.
5858
59-
## Approach B: Install Arc agents using AzCLI commands
59+
### Approach B: Install Arc agents using AzCLI commands
6060

6161
The following Azure CLI commands can be used to install Arc agents.
6262

@@ -74,17 +74,17 @@ az connectedvmware vm guest-agent enable --password
7474
[--no-wait]
7575
```
7676

77-
## Approach C: Install Arc agents at scale using helper script
77+
### Approach C: Install Arc agents at scale using helper script
7878

7979
Arc agent installation can be automated using the helper script built using the AzCLI command provided [here](./enable-guest-management-at-scale.md#approach-b-install-arc-agents-using-azcli-commands). Download this [helper script](https://aka.ms/arcvmwarebatchenable) to enable VMs and install Arc agents at scale. In a single ARM deployment, the helper script can enable and install Arc agents on 200 VMs.
8080

81-
### Features of the script
81+
#### Features of the script
8282

8383
- Creates a log file (vmware-batch.log) for tracking its operations.
8484

85-
- Generates a list of Azure portal links to all the deployments created (all-deployments-<timestamp>.txt).
85+
- Generates a list of Azure portal links to all the deployments created `(all-deployments-<timestamp>.txt)`.
8686

87-
- Creates ARM deployment files (vmw-dep-<timestamp>-<batch>.json).
87+
- Creates ARM deployment files `(vmw-dep-<timestamp>-<batch>.json)`.
8888

8989
- Can enable up to 200 VMs in a single ARM deployment if guest management is enabled, else enables 400 VMs.
9090

@@ -94,15 +94,15 @@ Arc agent installation can be automated using the helper script built using the
9494

9595
Before running this script, install az cli and the connectedvmware extension.
9696

97-
### Prerequisites
97+
#### Prerequisites
9898

9999
Before running this script, install:
100100

101101
- Azure CLI from [here](/cli/azure/install-azure-cli).
102102

103103
- The `connectedvmware` extension for Azure CLI: Install it by running `az extension add --name connectedvmware`.
104104

105-
# Usage
105+
## Usage
106106

107107
1. Download the script to your local machine.
108108

@@ -112,7 +112,7 @@ Before running this script, install:
112112

113113
4. Run the script with the required parameters. For example, `.\arcvmware-batch-enablement.ps1 -VCenterId "<vCenterId>" -EnableGuestManagement -VMCountPerDeployment 3 -DryRun`. Replace `<vCenterId>` with the ARM ID of your vCenter.
114114

115-
# Parameters
115+
## Parameters
116116

117117
- `VCenterId`: The ARM ID of the vCenter where the VMs are located.
118118

@@ -122,15 +122,13 @@ Before running this script, install:
122122

123123
- `DryRun`: If this switch is specified, the script will only create the ARM deployment files. Else, the script will also deploy the ARM deployments.
124124

125-
# Running as a Cron Job
125+
## Running as a Cron Job
126126

127127
You can set up this script to run as a cron job using the Windows Task Scheduler. Here's a sample script to create a scheduled task:
128128

129129
```azurecli
130130
$action = New-ScheduledTaskAction -Execute 'powershell.exe' -Argument '-File "C:\Path\To\vmware-batch-enable.ps1" -VCenterId "<vCenterId>" -EnableGuestManagement -VMCountPerDeployment 3 -DryRun'
131-
132131
$trigger = New-ScheduledTaskTrigger -Daily -At 3am
133-
134132
Register-ScheduledTask -Action $action -Trigger $trigger -TaskName "EnableVMs"
135133
```
136134

@@ -142,7 +140,7 @@ To unregister the task, run the following command:
142140
Unregister-ScheduledTask -TaskName "EnableVMs"
143141
```
144142

145-
## Approach D: Install Arc agents at scale using out-of-band approach
143+
### Approach D: Install Arc agents at scale using out-of-band approach
146144

147145
Arc agents can be installed directly on machines without relying on VMware tools or APIs. By following the out-of-band approach, initially onboard the machines as Arc-enabled Server resources with Resource type as Microsoft.HybridCompute/machines. After that, perform **Link to vCenter** operation to update the machine's Kind property as VMware, enabling virtual lifecycle operations.
148146

@@ -160,21 +158,21 @@ b. **Link Arc-enabled Server resources to the vCenter:** The following commands
160158

161159
- The following command scans all the Arc for Server machines that belong to the vCenter in the specified subscription and links the machines with that vCenter.
162160

163-
```azurecli
164-
az connectedvmware vm create-from-machines --subscription contoso-sub --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter
165-
```
161+
```azurecli
162+
az connectedvmware vm create-from-machines --subscription contoso-sub --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter
163+
```
166164

167165
- The following command scans all the Arc for Server machines that belong to the vCenter in the specified Resource Group and links the machines with that vCenter.
168166

169-
```azurecli
170-
az connectedvmware vm create-from-machines --resource-group contoso-rg --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter.
171-
```
167+
```azurecli
168+
az connectedvmware vm create-from-machines --resource-group contoso-rg --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter.
169+
```
172170

173171
- The following command can be used to link an individual Arc for Server resource to vCenter.
174172

175-
```azurecli
176-
az connectedvmware vm create-from-machines --resource-group contoso-rg --name contoso-vm --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter
177-
```
173+
```azurecli
174+
az connectedvmware vm create-from-machines --resource-group contoso-rg --name contoso-vm --vcenter-id /subscriptions/fedcba98-7654-3210-0123-456789abcdef/resourceGroups/contoso-rg-2/providers/Microsoft.HybridCompute/vcenters/contoso-vcenter
175+
```
178176

179177
## Next steps
180178

articles/azure-arc/vmware-vsphere/support-matrix-for-arc-enabled-vmware-vsphere.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Plan for deployment
33
description: Learn about the support matrix for Arc-enabled VMware vSphere including vCenter Server versions supported, network requirements, and more.
44
ms.topic: how-to
5-
ms.date: 04/22/2024
5+
ms.date: 04/23/2024
66
ms.service: azure-arc
77
ms.subservice: azure-arc-vmware-vsphere
88
author: Farha-Bano
@@ -62,11 +62,11 @@ In addition, VMware VSphere requires the following exception:
6262
| **Service** | **Port** | **URL** | **Direction** | **Notes**|
6363
| --- | --- | --- | --- | --- |
6464
| vCenter Server | 443 | URL of the vCenter server | Appliance VM IP and control plane endpoint need outbound connection. | Used to by the vCenter server to communicate with the Appliance VM and the control plane.|
65-
| VMware Cluster Extension | 443 | azureprivatecloud.azurecr.io | Appliance VM IPs need outbound connection. | Pull container images for Microsoft.VMWare and Microsoft.AVS Cluster Extension.|
66-
| Azure CLI and Azure CLI Extensions | 443 | *.blob.core.windows.net | Management machine needs outbound connection. | Download Azure CLI Installer and Azure CLI extensions.|
67-
| Azure Resource Manager | 443 | management.azure.com | Management machine needs outbound connection. | Required to create/update resources in Azure using ARM.|
68-
| Helm Chart for Azure Arc Agents | 443 | *.dp.kubernetesconfiguration.azure.com | Management machine needs outbound connection. | Data plane endpoint for downloading the configuration information of Arc agents.|
69-
| Azure CLI | 443 | - login.microsoftonline.com <br> <br> - aka.ms | Management machine needs outbound connection. | Required to fetch and update Azure Resource Manager tokens.|
65+
| VMware Cluster Extension | 443 | `azureprivatecloud.azurecr.io` | Appliance VM IPs need outbound connection. | Pull container images for Microsoft.VMWare and Microsoft.AVS Cluster Extension.|
66+
| Azure CLI and Azure CLI Extensions | 443 | `*.blob.core.windows.net` | Management machine needs outbound connection. | Download Azure CLI Installer and Azure CLI extensions.|
67+
| Azure Resource Manager | 443 | `management.azure.com` | Management machine needs outbound connection. | Required to create/update resources in Azure using ARM.|
68+
| Helm Chart for Azure Arc Agents | 443 | `*.dp.kubernetesconfiguration.azure.com` | Management machine needs outbound connection. | Data plane endpoint for downloading the configuration information of Arc agents.|
69+
| Azure CLI | 443 | - `login.microsoftonline.com` <br> <br> - `aka.ms` | Management machine needs outbound connection. | Required to fetch and update Azure Resource Manager tokens.|
7070

7171
For a complete list of network requirements for Azure Arc features and Azure Arc-enabled services, see [Azure Arc network requirements (Consolidated)](../network-requirements-consolidated.md).
7272

0 commit comments

Comments
 (0)