Новая версия расширения Azure VM для решений SAP

Статья
2025-04-17

Prerequisites

Примечание

Общее заявление о поддержке: Поддержка расширения Azure для SAP осуществляется через каналы поддержки SAP. Если вам нужна помощь с расширением виртуальной машины Azure для решений SAP, откройте заявку в поддержку SAP.

Примечание

Убедитесь, что вы удалили расширение виртуальной машины (VM), прежде чем переключаться между стандартной и новой версиями расширения Azure для SAP.

Примечание

Существуют две версии расширения виртуальной машины. Эта статья охватывает новую версию расширения Azure VM для SAP. Чтобы получить руководство по установке стандартной версии, см. Standard Version of Azure VM extension for SAP solutions.

Убедитесь, что вы используете SAP Host Agent 7.21 PL 47 или выше.
Убедитесь, что виртуальная машина, на которой включено расширение, имеет доступ к management.azure.com.

Развертывание командлетов Azure PowerShell
Развертывание Azure CLI

Следуйте шагам, описанным в статье Установка модуля Azure PowerShell

Часто проверяйте наличие обновлений для командлетов PowerShell, которые обычно обновляются ежемесячно. Следуйте шагам, описанным в этой статье. Если в SAP Note 1928533 или SAP Note 2015553 не указано иное, мы рекомендуем работать с последней версией командлетов Azure PowerShell.

Чтобы проверить версию командлетов Azure PowerShell, установленных на вашем компьютере, выполните следующую команду PowerShell:

(Get-Module Az.Compute).Version

Следуйте инструкциям, описанным в статье Установка Azure CLI.

Часто проверяйте наличие обновлений Azure CLI, который обычно обновляется ежемесячно.

Чтобы проверить, какая версия Azure CLI установлена на вашем компьютере, выполните следующую команду:

az --version

Настройка расширения виртуальной машины Azure для решений SAP

PowerShell
Azure CLI

Новый расширение VM для SAP использует управляемую идентификацию, которая назначается виртуальной машине, для доступа к данным мониторинга и конфигурации этой машины. Чтобы установить новое расширение Azure для SAP с помощью PowerShell, сначала необходимо назначить такую идентификацию виртуальной машине (VM) и предоставить этой идентификации доступ ко всем ресурсам, используемым этой VM, например, к дискам и сетевым интерфейсам.

Примечание

Для выполнения следующих шагов требуются права Владельца на группу ресурсов или отдельные ресурсы (виртуальная машина, дисковые накопители данных и сетевые интерфейсы).

Убедитесь, что используете SAP Host Agent версии 7.21 PL 47 или выше.
Убедитесь, что стандартная версия расширения виртуальной машины для SAP удалена. Не поддерживается установка обеих версий расширения виртуальной машины для SAP на одной и той же виртуальной машине.
Убедитесь, что у вас установлена последняя версия модуля Azure PowerShell (не менее 4.3.0).
Запустите следующий командлет PowerShell. Для получения списка доступных сред выполните командлет Get-AzEnvironment. Если вы хотите использовать глобальный Azure, ваша среда — AzureCloud. For Microsoft Azure operated by 21Vianet, select AzureChinaCloud.

Расширение виртуальной машины для SAP поддерживает настройку прокси, который расширение должно использовать для подключения к внешним ресурсам, например, к API диспетчера ресурсов Azure. Используйте параметр -ProxyURI для задания прокси-сервера.
```
$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
```
Перезапустить SAP Host Agent

Войдите в виртуальную машину, на которой вы включили расширение VM для SAP, и перезапустите агент хоста SAP, если он уже был установлен. Агент узла SAP не использует расширение виртуальной машины, пока не будет перезапущено. В настоящее время он не может обнаружить, что расширение было установлено после его запуска.

Новое расширение VM для SAP использует управляемую идентификацию, которая назначена виртуальной машине для доступа к данным мониторинга и конфигурации этой машины.

Примечание

Следующие шаги требуют привилегий владельца для группы ресурсов или отдельных ресурсов (виртуальная машина, диски данных и так далее).

Убедитесь, что вы используете SAP Host Agent версии 7.21 PL 47 или более позднюю.
Убедитесь, что вы удалили текущую версию расширения виртуальной машины для SAP. Вы не можете установить обе версии расширения виртуальной машины для SAP на одной виртуальной машине.
Установите последнюю версию Azure CLI 2.0 (версия 2.19.1 или новее).
Sign in with your Azure account:
```
az login
```
Install the Azure CLI AEM Extension. Убедитесь, что вы используете версию 0.2.2 или более позднюю.
```
az extension add --name aem
```
Включите новое расширение:

The VM Extension for SAP supports configuring a proxy that the extension should use to connect to external resources, for example the Azure Resource Manager API. Используйте параметр --proxy-URI для задания прокси-сервера.
```
az vm aem set -g <resource-group-name> -n <vm name> --install-new-extension
```
Перезапустить SAP Host Agent

Войдите в виртуальную машину, на которой вы включили расширение VM для SAP, и перезапустите агента хоста SAP, если он уже был установлен. Агент узла SAP не использует расширение виртуальной машины, пока не будет перезапущено. В настоящее время он не может обнаружить, что расширение было установлено после его запуска.

Manually configure the Azure VM extension for SAP solutions

Если вы хотите использовать Azure Resource Manager, Terraform или другие средства для развертывания расширения виртуальной машины для SAP, вы также можете развернуть расширение виртуальной машины для SAP вручную, не используя выделенные команды PowerShell или Azure CLI.

Перед развертыванием расширения для SAP убедитесь, что виртуальная машина имеет удостоверение, управляемое пользователем или системой. Для получения дополнительной информации прочитайте следующие руководства:

Настройте управляемые идентичности для ресурсов Azure на виртуальной машине с использованием портала Azure
Configure managed identities for Azure resources on an Azure VM using Azure CLI
Настройте управляемые идентификации для ресурсов Azure на виртуальной машине Azure с помощью PowerShell.
Настройте управляемые идентификации для Azure ресурсов на виртуальной машине Azure с использованием шаблонов
Terraform VM Identity

After assigning an identity to the virtual machine, give the VM read access to either the resource group or the individual resources associated to the virtual machine (VM, Network Interfaces, OS Disks and Data Disks). It is recommended to use the built-in Reader role to grant the access to these resources. Вы также можете предоставить этот доступ, добавив идентификатор виртуальной машины в группу Microsoft Entra, которая уже имеет доступ на чтение к необходимым ресурсам. It is then no longer needed to have Owner privileges when deploying the VM Extension for SAP if you use a user assigned identity that already has the required permissions.

Существует несколько способов ручной установки VM Extension для SAP. Please find a few examples in the next chapters.

В настоящее время расширение поддерживает следующие ключи конфигурации. В примере ниже показан msi_res_id.

msi_res_id: ID of the user assigned identity the extension should use to get the required information about the VM and its resources
Прокси: URL прокси, который расширение должно использовать для подключения к интернету, например, чтобы получить информацию о виртуальной машине и её ресурсах.

The following code contains four examples. It shows how to deploy the extension on Windows and Linux, using a system or user assigned identity. Make sure to replace the name of the resource group, the location and VM name in the example.

# 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 и Linux, используя системную или назначенную пользователем учетную запись. Убедитесь, что в примере заменены название группы ресурсов, местоположение и имя виртуальной машины (VM).

# 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":[]}'

The following manifest contains four examples. It shows how to deploy the extension on Windows and Linux, using a system or user assigned identity. Make sure to replace the ID of the VM and ID of the user assigned identity in the example.


# 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
}

Версии расширения виртуальной машины для SAP

If you want to disable automatic updates for the VM extension or want to deploy a specific version of the extension, you can retrieve the available versions with Azure CLI or 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

Проверка готовности

Эта проверка гарантирует, что все метрики производительности, которые отображаются в вашем приложении SAP, предоставляются поддерживающим расширением Azure для SAP.

Запустите проверку готовности на виртуальной машине Windows

Вход в виртуальную машину Azure (использование учетной записи администратора не требуется).
Откройте веб-браузер и перейдите на http://127.0.0.1:11812/azure4sap/metrics.
Браузер должен отображать или загружать XML-файл, содержащий данные мониторинга вашей виртуальной машины. Если это не так, убедитесь, что расширение Azure для SAP установлено.
Проверьте содержимое файла XML. XML-файл, к которому вы можете получить доступ по адресу http://127.0.0.1:11812/azure4sap/metrics, содержит все заполненные счетчики производительности Azure для SAP. Он также содержит резюме и индикатор состояния здоровья для статуса расширения Azure для SAP.
Check the value of the Provider Health Description element. Если значение не OK, следуйте инструкциям в главе Проверки состояния.

Запустите проверку готовности на виртуальной машине Linux

Подключитесь к виртуальной машине Azure с использованием SSH.
Check the output of the following command
```
curl http://127.0.0.1:11812/azure4sap/metrics
```
Ожидаемый результат: Возвращает XML-документ, содержащий информацию о мониторинге виртуальной машины, её дисков и сетевых интерфейсов.

Если предыдущая проверка не была успешной, выполните следующие дополнительные проверки:

Make sure that the waagent is installed and enabled.

a. Запуск sudo ls -al /var/lib/waagent/

Expected result: Lists the content of the waagent directory.

б. Run ps -ax | grep waagent

Expected result: Displays one entry similar to: python /usr/sbin/waagent -daemon
Убедитесь, что расширение Azure для SAP установлено и работает.

a. Запустить sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'

Expected result: Lists the content of the Azure Extension for SAP directory.

b. Запустить ps -ax | grep AzureEnhanced

Ожидаемый результат: Отображает одну запись, похожую на: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor
Install SAP Host Agent as described in SAP Note 1031096, and check the output of saposcol.

a. Запуск /usr/sap/hostctrl/exe/saposcol -d

b. Run dump ccm

c. Проверьте, является ли метрика Virtualization_Configuration\Enhanced Monitoring Accesstrue.

Если у вас уже установлен сервер приложений SAP NetWeaver ABAP, откройте транзакцию ST06 и проверьте, включен ли мониторинг.

Если какая-либо из этих проверок завершается сбоем и подробные сведения о повторном развертывании расширения, см. в разделе "Устранение неполадок"

проверки здоровья

Если некоторые данные инфраструктуры не доставляются правильно, как указано в тестах, описанных в проверке , выполните проверки работоспособности, описанные в этой главе, чтобы проверить правильность настройки инфраструктуры Azure и расширения Azure для SAP.

Azure PowerShell
Azure CLI

Make sure that you have installed the latest version of the Azure PowerShell cmdlet (at least 4.3.0).
Выполните следующую команду PowerShell. For a list of available environments, run the cmdlet Get-AzEnvironment. Чтобы использовать глобальную сеть Azure, выберите среду AzureCloud. For Microsoft Azure operated by 21Vianet, select AzureChinaCloud.
```
$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>
```
Скрипт проверяет конфигурацию выбранной вами виртуальной машины.

Убедитесь, что каждый результат проверки состояния — это ОК. Если некоторые проверки не отображаются, запустите командлет обновления, как описано в разделе ". Повторите проверки, описанные в Проверка готовности и этой главе. Если проверки по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок".

Для выполнения проверки состояния расширения Azure VM для SAP с использованием Azure CLI:

Install Azure CLI 2.0. Убедитесь, что вы используете версию не ниже 2.19.1 или более позднюю (используйте последнюю версию).
Войти с вашим аккаунтом Azure:
```
az login
```
Установите расширение Azure CLI AEM. Убедитесь, что вы используете версию 0.2.2 или более позднюю.
```
az extension add --name aem
```
Проверьте установку расширения.
```
az vm aem verify -g <resource-group-name> -n <vm name> 
```

Скрипт проверяет конфигурацию выбранной вами виртуальной машины.

Убедитесь, что каждый результат проверки здоровья является OK. Если некоторые проверки не отображаются, запустите командлет обновления, как описано в разделе ". Repeat the checks described in Readiness check and this chapter. Если проверки по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок".

Поделиться через

Новая версия расширения Azure VM для решений SAP

Prerequisites

Настройка расширения виртуальной машины Azure для решений SAP

Manually configure the Azure VM extension for SAP solutions

Версии расширения виртуальной машины для SAP

Проверка готовности

Запустите проверку готовности на виртуальной машине Windows

Запустите проверку готовности на виртуальной машине Linux

проверки здоровья

Следующие шаги

Обратная связь

Дополнительные ресурсы