Problembehandlung bei der Azure Arc-VM-Verwaltung

Artikel
05/07/2024

Gilt für: Azure Stack HCI, Version 23H2

Dieser Artikel enthält Anleitungen zum Sammeln von Protokollen und zum Behandeln von Problemen mit virtuellen Azure Arc-Computern (VMs) in Ihrem Azure Stack HCI-Cluster. Außerdem werden die Einschränkungen und bekannten Probleme aufgelistet, die derzeit bei der Azure Arc-VM-Verwaltung bestehen.

Erfassen von Protokollen

Sie können Protokolle sammeln, um Probleme mit Arc-VMs in Ihrem Azure Stack HCI-System zu identifizieren und zu beheben. Verwenden Sie diese Protokolle, um wichtige Informationen zu sammeln, bevor Sie sich an den Microsoft-Support wenden, um weitere Hilfe zu erhalten.

Stellen Sie sicher, dass Sie über das neueste PowerShell-Modul für die Protokollsammlung verfügen. Führen Sie zum Aktualisieren des PowerShell-Moduls den folgenden Befehl aus:

#Update the PowerShell module
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense

Führen Sie den folgenden Befehl aus, um Protokolle für Arc-VMs in Ihrem Azure Stack HCI-Cluster zu sammeln:

$csv_path="<input-from-admin>"
$VMIP_1="<input-from-admin>"
az login --use-device-code
Get-ArcHCILogs -workDirectory $csv_path\ResourceBridge -kvaTokenPath $csv_path\ResourceBridge\kvatoken.tok -ip $VMIP_1

Dabei gilt:

$csv_path ist der vollständige Pfad des freigegebenen Clustervolumes, das für das Erstellen der Arc-Ressourcenbrücke bereitgestellt wird.
$VMIP_1 ist die IP-Adresse der Arc Resource Bridge-VM.
Legen Sie optional den -logDir Parameter fest, um den Pfad zu dem Verzeichnis anzugeben, in dem die generierten Protokolle gespeichert werden. Wenn Sie den Pfad oder den Parameter nicht angeben, werden die Protokolle standardmäßig in Ihrem aktuellen Arbeitsverzeichnis gespeichert.

Problembehandlung für virtuelle Azure Arc-Computer

In diesem Abschnitt werden die Fehler im Zusammenhang mit der Azure Arc-VM-Verwaltung und die empfohlenen Lösungen beschrieben.

Fehler beim Aktivieren der Gastverwaltung

Wenn Sie versuchen, den Befehl auszuführen, um die Gastverwaltung zu aktivieren, wird der folgende Fehler angezeigt:

Fehler:Deployment failed. Correlation ID: 5d0c4921-78e0-4493-af16-dffee5cbf9d8. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

Der obige Fehler liegt daran, dass die verwaltete Identität nicht für diese VM erstellt wurde. Systemseitig zugewiesene verwaltete Identität ist erforderlich, um die Gastverwaltung zu aktivieren.

Lösung:

Führen Sie die folgenden Schritte aus, um zu überprüfen, ob die verwaltete Identität für diesen virtuellen Computer nicht erstellt wird, und aktivieren Sie dann die systemseitig zugewiesene verwaltete Identität.

Navigieren Sie im Azure-Portal zum virtuellen Computer. Navigieren Sie zur Seite Übersicht . Auf der Registerkarte Eigenschaften sollte unter Konfiguration die Gastverwaltung als Deaktiviert angezeigt werden. Wählen Sie in der oberen rechten Ecke die JSON-Ansicht aus.
Unter Identity parameter sollte die type als Noneangezeigt werden.
Stellen Sie zum Erstellen einer verwalteten Identität über RDP eine Verbindung mit dem Azure Stack HCI-Server her. Führen Sie den folgenden Befehl aus:
```
az extension add --name connectedmachine
```

Überprüfen Sie, ob die CLI-Erweiterung des verbundenen Computers im Cluster installiert ist. Im Folgenden sehen Sie eine Beispielausgabe, bei der die Erweiterung erfolgreich installiert wurde. Gibt connectedmachine an, dass Version 0.7.0 installiert ist.

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2",
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": "0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

Führen Sie den folgenden Befehl aus, um dem virtuellen Computer eine systemverwaltete Identität zuzuweisen.
```
az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
```
Wechseln Sie zum Azure-Portal, und navigieren Sie zur Seite Übersicht. Die JSON-Ansicht sollte angeben, dass die vom System verwaltete Identität jetzt dem virtuellen Computer zugewiesen ist.

Fehler bei der Bereitstellung einer Arc-VM

Beim Versuch, eine Arc-VM in Ihrem Azure Stack HCI-Cluster bereitzustellen, wird der folgende Fehler angezeigt:

Fehler:{"code":"ConflictingOperation","message":"Unable to process request 'Microsoft.AzureStackHCI/virtualMachineInstances'. There is already a previous running operation for resource '/subscriptions/<subscription ID>/resourceGroups/<Resource group name>/providers/Microsoft.HybridCompute/machines/<VM name>/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default'. Please wait for the previous operation to complete."}

Der obige Fehler liegt daran, dass das Objekt der SystemAssigned verwalteten Identität nicht unter dem Microsoft.HybridCompute/machines Ressourcentyp liegt.

Lösung:

Überprüfen Sie in Ihrer Bereitstellungsvorlage Folgendes:

Das SystemAssigned Objekt der verwalteten Identität befindet sich unter Microsoft.HybridCompute/machines dem Ressourcentyp und nicht unter dem Microsoft.AzureStackHCI/VirtualMachineInstances Ressourcentyp.

Die Bereitstellungsvorlage sollte mit der bereitgestellten Beispielvorlage übereinstimmen. Weitere Informationen finden Sie in der Beispielvorlage in Create Arc-VMs in Azure Stack HCI.

Die Azure CLI-Installation wird nicht erkannt.

Wenn Ihre Umgebung die Azure CLI nach der Installation nicht erkennt, führen Sie den folgenden Codeblock aus, um dem Umgebungspfad den Installationspfad der Azure CLI hinzuzufügen.

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

Nächste Schritte

Häufig gestellte Fragen zur Azure Arc-VM-Verwaltung

Freigeben über