Nieuwe versie van de Azure VM-extensie voor SAP-oplossingen

Er zijn twee versies van de VM-extensie. In dit artikel wordt de nieuwe versie van de Azure VM-extensie voor SAP behandeld. Zie Standard-versie van de Azure VM-extensie voor SAP-oplossingen voor hulp bij het installeren van de standaardversie.

Vereisten

Verwijder de standaard-VM-extensie voordat u overschakelt naar de nieuwe versie van de Azure-extensie voor SAP.

Zorg ervoor dat u SAP Host Agent 7.21 PL 47 of hoger gebruikt.

Zorg ervoor dat de virtuele machine (VM) waarop de extensie is ingeschakeld, toegang heeft tot management.azure.com.

De Azure PowerShell-module of Azure CLI moet zijn geïnstalleerd. Zie de volgende instructies:

Azure PowerShell
Azure-CLI

Volg de stappen die worden beschreven in de Azure PowerShell-module installeren.

Controleer regelmatig op updates voor de Azure PowerShell-cmdlets. Tenzij anders vermeld in SAP Note 1928533 of SAP Note 2015553, raden we u aan om te werken met de nieuwste versie van Azure PowerShell-cmdlets.

Voer de volgende opdracht uit om de versie van de Azure PowerShell-cmdlets te controleren die op uw computer zijn geïnstalleerd:

(Get-Module Az.Compute).Version

Volg de stappen die worden beschreven in Azure CLI installeren. Controleer regelmatig op updates voor de Azure CLI.

Voer de volgende opdracht uit om de versie van Azure CLI te controleren die op uw computer is geïnstalleerd:

az --version

Notitie

Algemene ondersteuningsverklaring:

Ondersteuning voor de Azure-extensie voor SAP wordt geboden via SAP-ondersteuningskanalen. Als u hulp nodig hebt met de Azure VM-extensie voor SAP-oplossingen, opent u een ondersteuningsaanvraag met SAP-ondersteuning.

De Azure VM-extensie configureren voor SAP-oplossingen

Azure PowerShell
Azure-CLI

De nieuwe VM-extensie voor SAP maakt gebruik van een beheerde identiteit die is toegewezen aan de virtuele machine voor toegang tot bewakings- en configuratiegegevens van de virtuele machine. Als u de nieuwe Azure-extensie voor SAP wilt installeren met behulp van Azure PowerShell, moet u eerst een dergelijke identiteit toewijzen aan de virtuele machine en die identiteit toegang verlenen tot alle resources die door die VM worden gebruikt.

Notitie

Voor de volgende stappen zijn eigenaarsbevoegdheden vereist voor de resourcegroep of afzonderlijke resources (VM, gegevensschijven, netwerkinterfaces, enzovoort).

Zorg ervoor dat u SAP Host Agent 7.21 PL 47 of hoger gebruikt.
Zorg ervoor dat u de standaardversie van de VM-extensie voor SAP verwijdert. Het installeren van beide versies van de VM-extensie voor SAP op dezelfde VM wordt niet ondersteund.
Zorg ervoor dat de nieuwste versie van de Azure PowerShell-cmdlet (ten minste 4.3.0) is geïnstalleerd.
Voer uit Get-AzEnvironmentvoor een lijst met beschikbare omgevingen. Als u globale Azure wilt gebruiken, is uw omgeving AzureCloud. Selecteer AzureChinaCloud voor Microsoft Azure beheerd door 21Vianet.

De VM-extensie voor SAP ondersteunt het configureren van een proxy die de extensie moet gebruiken om verbinding te maken met externe resources, bijvoorbeeld de Azure Resource Manager-API. Gebruik de parameter -ProxyURI om de proxy in te stellen.
```
$env = Get-AzEnvironment -Name <name of the environment>
Connect-AzAccount -Environment $env
Set-AzContext -SubscriptionName <subscription name>
Set-AzVMAEMExtension -ResourceGroupName <resource group name> -VMName <virtual machine name> -InstallNewExtension
```
Start de SAP-hostagent opnieuw.

Meld u aan bij de VM waarop u de VM-extensie voor SAP hebt ingeschakeld en start de SAP-hostagent opnieuw op als deze al is geïnstalleerd. De SAP Host Agent gebruikt de VM-extensie pas nadat u deze opnieuw hebt opgestart. Er kan momenteel niet worden gedetecteerd dat er een extensie is geïnstalleerd nadat deze is gestart.

De nieuwe VM-extensie voor SAP maakt gebruik van een beheerde identiteit die aan de VIRTUELE machine is toegewezen voor toegang tot bewakings- en configuratiegegevens van de virtuele machine.

Notitie

Voor de volgende stappen zijn eigenaarsbevoegdheden vereist voor de resourcegroep of afzonderlijke resources (VM, gegevensschijven, netwerkinterfaces, enzovoort).

Zorg ervoor dat u SAP Host Agent 7.21 PL 47 of hoger gebruikt.
Zorg ervoor dat u de huidige versie van de VM-extensie voor SAP verwijdert. U kunt niet beide versies van de VM-extensie voor SAP op dezelfde VM installeren.
Installeer de nieuwste versie van Azure CLI 2.0 (versie 2.19.1 of hoger).
Meld u aan met uw Azure-account:
```
az login
```
Installeer de AEM-extensie (Azure Enhanced Monitoring). Zorg ervoor dat u versie 0.2.2 of hoger gebruikt.
```
az extension add --name aem
```
Schakel de nieuwe extensie in:

De VM-extensie voor SAP ondersteunt het configureren van een proxy die de extensie moet gebruiken om verbinding te maken met externe resources, bijvoorbeeld de Azure Resource Manager-API. Als u de proxy wilt instellen, voegt u het toe --proxy-uri <my_proxy_uri>.
```
az vm aem set -g <resource-group-name> -n <vm name> --install-new-extension
```
SAP Host Agent opnieuw starten

Meld u aan bij de VM waarop u de VM-extensie voor SAP hebt ingeschakeld en start de SAP-hostagent opnieuw op als deze al is geïnstalleerd. De SAP Host Agent gebruikt de VM-extensie pas nadat u deze opnieuw hebt opgestart. Er kan momenteel niet worden gedetecteerd dat er een extensie is geïnstalleerd nadat deze is gestart.

De Azure VM-extensie handmatig configureren voor SAP-oplossingen

Als u Azure Resource Manager, Terraform of andere hulpprogramma's wilt gebruiken om de VM-extensie voor SAP te implementeren, kunt u de VM-extensie ook handmatig implementeren voor SAP.

Voordat u de VM-extensie voor SAP implementeert, moet u een door een gebruiker of systeem toegewezen beheerde identiteit toewijzen aan de VIRTUELE machine. Lees de volgende handleidingen voor meer informatie:

Nadat u een identiteit aan de VIRTUELE machine hebt toegewezen, geeft u de VM leestoegang tot de resourcegroep of de afzonderlijke resources die aan de VIRTUELE machine zijn gekoppeld (netwerkinterfaces, besturingssysteemschijven en gegevensschijven). U wordt aangeraden de ingebouwde rol Lezer te gebruiken om de toegang tot deze resources te verlenen. U kunt deze toegang ook verlenen door de VM-identiteit toe te voegen aan een Microsoft Entra-groep die al de leesmachtigingen voor de vereiste resources heeft. Het is dan niet meer nodig om eigenaarsbevoegdheden te hebben bij het implementeren van de VM-extensie voor SAP als u een door de gebruiker toegewezen identiteit gebruikt die al over de vereiste machtigingen beschikt.

Er zijn verschillende manieren om de VM-extensie handmatig voor SAP te implementeren. De extensie ondersteunt momenteel de volgende configuratiesleutels. In het volgende voorbeeld wordt het msi_res_id weergegeven.

msi_res_id: id van de door de gebruiker toegewezen identiteit die de extensie moet gebruiken om de vereiste informatie over de VM en de bijbehorende resources op te halen
proxy: URL van de proxy die de extensie moet gebruiken om verbinding te maken met internet, bijvoorbeeld om informatie over de VIRTUELE machine en de bijbehorende resources op te halen.

De volgende code bevat vier voorbeelden. Het laat zien hoe u de extensie in Windows en Linux implementeert met behulp van een door het systeem of door de gebruiker toegewezen identiteit. Zorg ervoor dat u de naam van de resourcegroep, de locatie en de VM-naam in het voorbeeld vervangt.

# Windows VM - user assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Windows" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Windows" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Windows VM - system assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Windows" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Windows" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[]}'

# Linux VM - user assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Linux" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Linux" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Linux VM - system assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Linux" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Linux" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[]}'

# Windows VM - user assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Windows" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Windows" --settings '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Windows VM - system assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Windows" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Windows" --settings '{"cfg":[]}'

# Linux VM - user assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Linux" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Linux" --settings '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Linux VM - system assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Linux" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Linux" --settings '{"cfg":[]}'

Het volgende manifest bevat vier voorbeelden. Het laat zien hoe u de extensie in Windows en Linux implementeert met behulp van een door het systeem of door de gebruiker toegewezen identiteit. Zorg ervoor dat u de id van de VM en de id van de door de gebruiker toegewezen identiteit in het voorbeeld vervangt.

# Windows VM - user assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Windows"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Windows"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
        {
            "key":"msi_res_id",
            "value":"<user assigned resource id>"
        }
    ]
}
SETTINGS
}

# Windows VM - system assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Windows"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Windows"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
    ]
}
SETTINGS
}

# Linux VM - user assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Linux"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Linux"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
        {
            "key":"msi_res_id",
            "value":"<user assigned resource id>"
        }
    ]
}
SETTINGS
}

# Linux VM - system assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Linux"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Linux"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
    ]
}
SETTINGS
}

Versies van de VM-extensie voor SAP

Als u automatische updates voor de VM-extensie wilt uitschakelen of een specifieke versie van de extensie wilt implementeren, kunt u de beschikbare versies ophalen met Azure CLI of Azure PowerShell.

Azure PowerShell
Azure-CLI

# Windows
Get-AzVMExtensionImage -Location westeurope -PublisherName Microsoft.AzureCAT.AzureEnhancedMonitoring -Type MonitorX64Windows

# Linux
Get-AzVMExtensionImage -Location westeurope -PublisherName Microsoft.AzureCAT.AzureEnhancedMonitoring -Type MonitorX64Linux

# Windows
az vm extension image list --location westeurope --publisher Microsoft.AzureCAT.AzureEnhancedMonitoring --name MonitorX64Windows

# Linux
az vm extension image list --location westeurope --publisher Microsoft.AzureCAT.AzureEnhancedMonitoring --name MonitorX64Linux

Gereedheidscontrole

Deze controle zorgt ervoor dat alle metrische prestatiegegevens die in uw SAP-toepassing worden weergegeven, worden geleverd door de onderliggende Azure-extensie voor SAP.

Windows-VM
Linux-VM

Meld u aan bij de Azure-VM (het gebruik van een beheerdersaccount is niet nodig).
Open een webbrowser en ga naar http://127.0.0.1:11812/azure4sap/metrics.
In de browser moet een XML-bestand worden weergegeven of gedownload dat de bewakingsgegevens van uw VIRTUELE machine bevat. Als dat niet het geval is, controleert u of de Azure-extensie voor SAP is geïnstalleerd.
Controleer de inhoud van het XML-bestand. Het XML-bestand waartoe u toegang http://127.0.0.1:11812/azure4sap/metrics hebt, bevat alle ingevulde Azure-prestatiemeteritems voor SAP. Het bevat ook een samenvatting en statusindicator van de status van de Azure-extensie voor SAP.
Controleer de waarde van het element Provider Health Description . Als de waarde niet in orde is, volgt u de .

Maak verbinding met de Azure-VM met behulp van SSH.
Controleer de uitvoer van de volgende opdracht:
```
curl http://127.0.0.1:11812/azure4sap/metrics
```
Verwacht resultaat: retourneert een XML-document dat de bewakingsgegevens van de VIRTUELE machine, de schijven en netwerkinterfaces bevat.

Als de voorgaande controle niet is geslaagd, voert u deze extra controles uit:

Zorg ervoor dat waagent is geïnstalleerd en ingeschakeld.

Rennen:
```
sudo ls -al /var/lib/waagent/
```
Verwacht resultaat: geeft de inhoud van de waagent map weer.

Rennen:
```
ps -ax | grep waagent
```
Verwacht resultaat: Geeft één vermelding weer die vergelijkbaar is met: python /usr/sbin/waagent -daemon
Zorg ervoor dat de Azure-extensie voor SAP is geïnstalleerd en wordt uitgevoerd.

Rennen:
```
sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'`
```
Verwacht resultaat: geeft een lijst weer van de inhoud van de Azure-extensie voor SAP-directory.

Rennen:
```
ps -ax | grep AzureEnhanced
```
Verwacht resultaat: Geeft één vermelding weer die vergelijkbaar is met: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor
Installeer de SAP Host Agent zoals beschreven in SAP Note 1031096 en controleer de uitvoer van saposcol.

Rennen:
```
/usr/sap/hostctrl/exe/saposcol -d
```
Rennen:
```
dump ccm
```
Controleer of de metrische gegevens Virtualization_Configuration\Enhanced Monitoring Access zijn true.

Als u al een ABAP-toepassingsserver (SAP NetWeaver Advanced Business Application Programming) hebt geïnstalleerd, opent u transactie ST06 en controleert u of bewaking is ingeschakeld.

Als een van deze controles mislukt en gedetailleerde informatie over het opnieuw implementeren van de extensie raadpleegt u Probleemoplossing

Gezondheidscontroles

Als sommige infrastructuurgegevens niet correct worden geleverd, zoals wordt aangegeven door de tests die worden beschreven in [Gereedheidscontrole][vm-extension-for-sap-new.md#readiness-check], voert u de statuscontroles uit die in dit artikel worden beschreven. Deze controles controleren of de Azure-infrastructuur en de Azure-extensie voor SAP correct zijn geconfigureerd.

Azure PowerShell
Azure-CLI

Zorg ervoor dat de nieuwste versie van de Azure PowerShell-module (ten minste 4.3.0) is geïnstalleerd.

Voer de cmdlet Get-AzEnvironmentuit voor een lijst met beschikbare omgevingen. Als u globale Azure wilt gebruiken, selecteert u de AzureCloud-omgeving . Selecteer AzureChinaCloud voor Microsoft Azure beheerd door 21Vianet.

$env = Get-AzEnvironment -Name <name of the environment>
Connect-AzAccount -Environment $env
Set-AzContext -SubscriptionName <subscription name>
Test-AzVMAEMExtension -ResourceGroupName <resource group name> -VMName <virtual machine name>

Het script test de configuratie van de vm die u hebt geselecteerd.

Zorg ervoor dat elk statuscontroleresultaat OK is. Als sommige controles niet in orde worden weergegeven, voert u de update-cmdlet uit zoals beschreven in De Azure VM-extensie configureren voor SAP-oplossingen. Herhaal de controles die worden beschreven in [Gereedheidscontrole][vm-extension-for-sap-new.md#readiness-check] en deze sectie. Zie Probleemoplossing als de controles nog steeds duiden op een probleem met sommige of alle tellers.

Voer de volgende opdrachten uit om de statuscontrole voor de Azure VM-extensie voor SAP uit te voeren met behulp van Azure CLI:

Installeer de Azure CLI 2.0. Zorg ervoor dat u ten minste versie 2.19.1 of hoger gebruikt (gebruik de nieuwste versie).
Meld u aan met uw Azure-account:
```
az login
```
Installeer de Azure CLI AEM-extensie. Zorg ervoor dat u versie 0.2.2 of hoger gebruikt.
```
az extension add --name aem
```

Controleer de installatie van de extensie:

az vm aem verify -g <resource-group-name> -n <vm name>

Het script test de configuratie van de VM die u selecteert.

Zorg ervoor dat elk gezondheidscontroleresultaat OK is. Als sommige controles niet in orde worden weergegeven, voert u de update-cmdlet uit zoals beschreven in De Azure VM-extensie configureren voor SAP-oplossingen. Herhaal de controles die worden beschreven in [Gereedheidscontrole][vm-extension-for-sap-new.md#readiness-check] en deze sectie. Zie Probleemoplossing als de controles nog steeds duiden op een probleem met sommige of alle tellers.

Volgende stappen

Feedback

Is deze pagina nuttig?

Last updated on 2026-03-12

Delen via

Nieuwe versie van de Azure VM-extensie voor SAP-oplossingen

Vereisten

De Azure VM-extensie configureren voor SAP-oplossingen

De Azure VM-extensie handmatig configureren voor SAP-oplossingen

Versies van de VM-extensie voor SAP

Gereedheidscontrole

Gezondheidscontroles

Volgende stappen

Feedback

Aanvullende resources