Habilitación de la administración de invitados para máquinas virtuales migradas (versión preliminar)

Artículo
02/25/2025

Se aplica a: Azure Local 2311.2 y versiones posteriores

En este artículo se describe cómo habilitar la administración de invitados después de la migración de máquinas virtuales (VM) arc que se ejecutan en Azure Local.

Para más información sobre otros escenarios, consulte Administración de máquinas virtuales de Arc en Azure Local.

Las propiedades de salida pueden variar en función de si las máquinas virtuales se migraron o no.

Importante

Esta característica actualmente está en VERSIÓN PRELIMINAR. Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

Requisitos previos

Antes de comenzar, complete lo siguiente:

Tiene acceso a una instancia local de Azure implementada y registrada, con un puente de recursos de Arc y una ubicación personalizada configurada.
El sistema ejecuta la versión 2405 o posterior de Azure Local.
La CLI de Azure se instala en la instancia local de Azure. Para obtener instrucciones, consulte Instalación de la CLI de Azure para Windows.

Agregue la extensión de Azure stack-hci-vm mediante la ejecución de PowerShell como administrador:

Para agregar la extensión stack-hci-vm , ejecute el siguiente cmdlet:
```
az extension add --name stack-hci-vm --upgrade 
```

Para comprobar la instalación y comprobar que la versión de stack-hci-vm es 1.1.5 o posterior:

PS C:\Users\AzureStackAdminD> az -version
{
    "azure-cli": "2.68.0",
    "azure-cli-core": "2.68.0",
    "azure-cli-telemetry": "1.1.0",
    "extensions": {
        "aksarc": "1.2.23",
        "arcappliance": "1.3.1", 
        "connectedk8s": "1.10.5",
        "customlocation": "0.1.3",
        "k8s-extension": "1.6.3",
        "stack-hci-vm": "1.5.0",
                    },
    "dependencies": {
        "msal": "1.31.1",
        "azure-mgmt-resource": "23.1.1",
                    },
}

Familiarícese con las máquinas virtuales de Arc y las características y consideraciones de administración de invitados. Consulte Habilitación de la administración de invitados.

Habilitación del agente invitado en máquinas virtuales migradas

Todas las máquinas virtuales de hyper-V de generación 1 deben apagarse antes de continuar con los pasos siguientes. No existe este requisito para las máquinas virtuales de la generación 2 de Hyper-V, se pueden activar o desactivar y se espera que ambos estados de energía funcionen.

Paso 1: Compruebe el estado de energía de las máquinas virtuales migradas de la siguiente manera:

Para Hyper-V Generation 1, asegúrese de que la máquina virtual está detenida. Consulte el Apéndice para ver el mensaje de error si no se detiene.

Uso de Azure Portal (recomendado)
1. Para detener la máquina virtual migrada desde Azure Portal, seleccione Detener en la página de detalles de la máquina virtual:
1. Espere y actualice la página para ver que el estado de la máquina virtual se muestra como Detenido.
Mediante la CLI de Azure
1. Conéctese a la máquina local de Azure y abra una ventana de PowerShell. Inicie sesión con la CLI de Azure.
```
az login --use-device-code --tenant $tenantId
```
2. Compruebe el estado de energía de la máquina virtual mediante la CLI de Azure como se indica a continuación:
```
az stack-hci-vm show --name $vmName --resource-group $rgName --query "properties.status"
```
  Salida del ejemplo:
```
PS C : \Users\AzureStackAdminD> az stack-hci-vm show --name <VM name> --resource-group <resource group> --query "properties.status"
{
    "errorCode":
    "errorMessage" :
    "powerstate": "Stopped",
    "provisioningstatus": null
}
```
En el caso de las máquinas virtuales de hyper-V de generación 2, asegúrese de que el estado de energía que se muestra en Azure Portal coincide con el estado de energía real de la máquina virtual migrada en el Administrador de Hyper-V, independientemente de si está activado o desactivado:

Visualización de Azure Portal

Vista del administrador de Hyper-V

Paso 2: Adjunte la ISO para el agente invitado en la máquina virtual migrada de la siguiente manera:

Conéctese a una máquina local de Azure y ejecute el siguiente comando en PowerShell, donde $vmName es el nombre de la máquina virtual migrada para que el agente invitado esté habilitado y $rgName es el nombre del grupo de recursos donde reside esta máquina virtual en Azure:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Salida de ejemplo:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName -enable-vm-config-agent true --resource-group $resourceGroup
{
"endTime": "2024-08-19T22:01:22.1060463z",
"error": {},
"extendedLocation": null ,
"id": "<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID>",
"startTime": "2024-08-19T22: 01:09.4898702z" ,
"status": "Succeeded",
"systemData" : null,
"type": null
}

Estado de ejemplo de la máquina virtual con la iso conectada, vista desde el sistema local de Azure:

Paso 3: Active la máquina virtual migrada, si es necesario, en Azure Portal y asegúrese de que tiene conectividad de red pública como se indica a continuación:

Compruebe que el estado de la máquina virtual en Azure Portal está en ejecución:

Compruebe que la máquina virtual powerState se está ejecutando mediante la ejecución del siguiente comando en la máquina local de Azure en una ventana de PowerShell:

az stack-hci-vm show --name $vmName --resource-group $rgName --query “properties.status”

PS C: \Users\AzureStackAdminD> az stack-hci-vm show --name <Name> --resource-group <Resource group> --query "properties.status" 
{
"errorCode":
"errorMessage":
"powerState": "Running",
"provisioningStatus": null
}

Paso 4: Instale la ISO del agente invitado en la máquina virtual migrada de la siguiente manera:

Conéctese a la máquina virtual mediante los pasos específicos del sistema operativo aplicables.
Establezca la conectividad de red pública en la máquina virtual.

Ejecute el siguiente comando para habilitar el agente invitado en la máquina virtual en función del sistema operativo que usa:

Si está en Linux, abra Terminal y ejecute lo siguiente:

sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /mociso && bash /mociso/install.sh && umount /mociso && rm -df /mociso'

Salida de ejemplo (Linux):

migration@migration-virtual-machine: $ sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /nociso && bash /mociso/install.sh && umount /mociso && rm -df/mociso && eject LABEL=mocguestagentprov'
[sudo] password for migration:
mount: /moctso: WARNING: device write-protected, mounted read-only.
Loading configuration version 've.16.5'...
The agent could not find the '/opt/mocguestagent/v0.16.5/config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Si está en Windows, abra PowerShell como administrador y ejecute lo siguiente:

  $d=Get-Volume -FileSystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install.ps1';powershell $p

Salida de ejemplo (Windows):

PS C:\Users\Administrator> $d=Get-Volume -FilesystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install ps1';powershell $p

Directory : C : \ProgramData\mocguestagent


Mode	LastWriteTime	Length Name
----    -------------   -----------
d------	8/19/2024	5:46 PM	certs
Loading configuration version 'v0.16.5'...
The agent could not find the 'C:\ProgramData\mocguestagent\v0.16.5\config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Habilitar la administración de invitados

Puede habilitar la administración de invitados después de que el agente invitado se ejecute de la siguiente manera:

Habilite la administración de invitados desde la instancia local de Azure mediante la ejecución del siguiente comando en la CLI de Azure:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-agent true

Salida del ejemplo:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName --resource-group $resourceGroup --enable-agent true
{
"endTime": "2024-08-19T22:59:13.9583373Z”,
"error": {},
"extendedLocation" : null,
"id": "/<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID",
"startTime": "2024-08-19t22:28:23.8158331Z",
"status": "Succeeded",
"systemData": null,
"type": null
}

Compruebe el estado de habilitación de la administración de invitados en Azure Portal:
Ya está listo para agregar las extensiones de Azure que prefiera.

Si tiene algún problema, póngase en contacto con Soporte técnico de Microsoft y proporcione los registros y los detalles de implementación.

Apéndice

Si olvidó desactivar la máquina virtual de Hyper-V Generation 1 antes de ejecutar el comando update con --enable-vm-config-agent true, se producirá un error en el comando update y la máquina virtual puede dejar de administrarse desde Azure Portal:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name <VM name> -- resource-group <Resource group> --enable-vm-config-agent true
(Failed) moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown dasc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription[<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed
Code: Failed
Message: moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown desc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription['<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed

Para resolverlo, detenga la máquina virtual en Azure Portal seleccionando Detener. Si esto no funciona, ejecute el siguiente comando desde la CLI de Azure:

az stack-hci-vm stop --name $vmName --resource-group $rgName

Es posible que vea un error de recurso al aprovisionar en Azure Portal con las selecciones Inicio, Reinicio y Detención deshabilitadas, pero el Administrador de Hyper-V debe mostrar que la máquina virtual está realmente detenida:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Pasos siguientes

Si experimenta algún problema, consulte Solución de problemas de migración de VMware.

Compartir a través de