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

Статья
03/15/2023

Предварительные требования

Примечание.

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

Примечание.

Перед переходом со стандартной на новую версию расширения Azure для SAP обязательно удалите расширение виртуальной машины.

Примечание.

Существуют две версии расширения виртуальной машины. В этой статье рассматривается новая версия расширения виртуальной машины Azure для SAP. Инструкции по установке стандартной версии см. в статье "Стандартная версия расширения виртуальной машины Azure" для решений SAP.

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

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

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

Регулярно проверяйте наличие обновлений для командлетов PowerShell. Обычно обновление происходит раз в месяц. Выполните действия, описанные в этой статье. Если иное не указано в примечаниях к SAP 1928533 или 2015553, то мы советуем работать с последней версией командлетов Azure PowerShell.

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

(Get-Module Az.Compute).Version

Развертывание Azure CLI

Выполните действия, описанные в статье Install the Azure CLI (Установка Azure CLI).

Регулярно проверяйте наличие обновлений для Azure CLI. Обычно обновление происходит раз в месяц.

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

az --version

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

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

Примечание.

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

Убедитесь, что используется агент SAP Host Agent 7.21 PL 47 или более поздней версии.
Обязательно удалите стандартную версию расширения виртуальной машины для SAP. Установка обеих версий расширения виртуальной машины для SAP на одной виртуальной машине не поддерживается.
Установите последнюю версию командлетов Azure PowerShell (не ниже версии 4.3.0). Дополнительные сведения см. в разделе Развертывание командлетов Azure PowerShell.
Выполните приведенный ниже командлет PowerShell. Чтобы просмотреть список доступных сред, выполните командлет Get-AzEnvironment. Если нужно использовать глобальный экземпляр Azure, выберите среду AzureCloud. Для Microsoft Azure, управляемой 21Vianet, выберите AzureChinaCloud.

Расширение виртуальной машины для SAP поддерживает настройку прокси-сервера, через который расширение должно подключаться к внешним ресурсам, например API Azure Resource Manager. Чтобы указать прокси-сервер, используйте параметр -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

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

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

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

Примечание.

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

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

Расширение виртуальной машины для SAP поддерживает настройку прокси-сервера, через который расширение должно подключаться к внешним ресурсам, например API Azure Resource Manager. Чтобы указать прокси-сервер, используйте параметр --proxy-uri.
```
az vm aem set -g <resource-group-name> -n <vm name> --install-new-extension
```
Перезапуск агента узла SAP

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

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

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

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

После назначения удостоверения виртуальной машине предоставьте виртуальной машине доступ на чтение к группе ресурсов или отдельным ресурсам, связанным с виртуальной машиной (виртуальные машины, сетевые интерфейсы, диски ОС и диски данных). Рекомендуется использовать встроенную роль читателя для предоставления доступа к этим ресурсам. Вы также можете предоставить этому доступу, добавив удостоверение виртуальной машины в группу Microsoft Entra, которая уже имеет доступ на чтение к необходимым ресурсам. Затем при развертывании расширения виртуальной машины для SAP больше не требуется иметь права владельца, если вы используете удостоверение, назначаемое пользователем, которое уже имеет необходимые разрешения.

Существует несколько способов развертывания расширения виртуальной машины для SAP вручную. Найдите несколько примеров в следующих разделах.

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

msi_res_id. Идентификатор назначаемого пользователем удостоверения расширение должно использовать для получения необходимых сведений о виртуальной машине и его ресурсах.
proxy: URL-адрес прокси-сервера, который следует использовать для подключения к Интернету, например для получения сведений о виртуальной машине и ее ресурсах.

Развертывание вручную с помощью Azure PowerShell

Следующий код содержит четыре примера. В нем показано, как развернуть расширение в Windows и Linux с помощью назначенного системой или пользователем удостоверения. Обязательно замените имя группы ресурсов, расположение и имя виртуальной машины в примере.

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

Развертывание вручную с помощью Azure CLI

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

Развертывание вручную с помощью Terraform

Следующий манифест содержит четыре примера. В нем показано, как развернуть расширение в Windows и Linux с помощью назначенного системой или пользователем удостоверения. Замените идентификатор виртуальной машины и идентификатор назначенного пользователем удостоверения в примере.


# 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

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

Azure PowerShell

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

Azure CLI

# 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.
Проверьте значение элемента Provider Health Description (Описание работоспособности поставщика). Если значение не в порядке, следуйте инструкциям в разделе "Работоспособность проверка".

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

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

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

Проверьте, установлен и запущен ли каталог waagent.

a. Выполнить sudo ls -al /var/lib/waagent/

Ожидаемый результат. Должно отобразиться содержимое каталога waagent.

b. Выполнить ps -ax | grep waagent

Ожидаемый результат. Должна отобразиться одна запись, аналогичная следующей: python /usr/sbin/waagent -daemon.
Проверьте, установлено и запущено ли расширение Azure для SAP.

a. Выполнить sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'

Ожидаемый результат: содержит содержимое каталога Azure extension for SAP.

b. Выполнить ps -ax | grep AzureEnhanced

Ожидаемый результат. Должна отобразиться одна запись, аналогичная следующей: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor.
Установите агент SAP Host Agent, как описано в примечании к SAP 1031096, и проверьте выходные данные saposcol.

a. Выполнить /usr/sap/hostctrl/exe/saposcol -d

b. Выполнить dump ccm

c. Проверьте, задано ли для метрики Virtualization_Configuration\Enhanced Monitoring Access значение true.

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

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

Проверки работоспособности

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

Проверки работоспособности с использованием PowerShell

Установите последнюю версию командлетов Azure PowerShell, как описано в разделе Развертывание командлетов Azure PowerShell.
Выполните приведенный ниже командлет PowerShell. Чтобы просмотреть список доступных сред, выполните командлет Get-AzEnvironment. Если нужно использовать глобальный экземпляр Azure, выберите среду AzureCloud. Для Microsoft Azure, управляемой 21Vianet, выберите 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 для решений SAP с помощью Azure CLI" или настройка расширения виртуальной машины Azure для решений SAP с помощью PowerShell. Повторите проверка, описанные в проверка готовности, и в этой главе. Если проверка по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок для Linux" или "Устранение неполадок" для Windows.

Проверка работоспособности с использованием Azure CLI

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

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

После этого сценарий тестирует конфигурацию выбранной виртуальной машины.

Устранение неполадок для Windows

Счетчики производительности Azure вообще не отображаются

Сбор метрик производительности в Azure выполняет процесс AzureEnhancedMonitoring. Если он не запущена на виртуальной машине, сбор метрик производительности не выполняется.

Каталог установки расширения Azure для SAP пустой

Проблема

Пустой каталог установки C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<версия>.

Решение

Расширение не установлено. Определите, связано ли это с неполадками прокси (как описано выше). Возможно, потребуется перезапустить компьютер или снова установить расширение виртуальной машины.

Отсутствуют некоторые счетчики производительности Azure

Сбор метрик производительности в Azure выполняет процесс Windows AzureEnhancedMonitoring. Он получает данные из нескольких источников. Некоторые данные конфигурации собираются локально, а некоторые метрики производительности считываются из Azure Monitor.

Если после устранения неполадок с использованием примечания SAP 1999351 проблема не исчезла, отправьте сообщение в службу поддержки клиентов SAP о компоненте BC-OP-NT-AZR (для виртуальной машины Windows) или о компоненте BC-OP-LNX-AZR (для виртуальной машины Linux). Вложите в сообщение файл журнала C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<версия>\logapp.txt.

Устранение неполадок для Linux

Счетчики производительности Azure вообще не отображаются

Сбор показателей производительности в Azure выполняет управляющая программа. Если она не запущена, сбор метрик производительности не выполняется.

Каталог установки расширения Azure для SAP пустой

Проблема

Каталог \var\lib\waagent\ не содержит подкаталога для расширения Azure для SAP.

Решение

Расширение не установлено. Определите, связано ли это с неполадками прокси (как описано выше). Возможно, потребуется перезапустить компьютер и (или) снова установить расширение виртуальной машины.

Отсутствуют некоторые счетчики производительности Azure

Сбор показателей производительности в Azure выполняет управляющая программа, которая получает данные из нескольких источников. Некоторые данные конфигурации собираются локально, а некоторые метрики производительности считываются из Azure Monitor. Полный и актуальный список известных проблем см. в примечании SAP 1999351. В нем содержатся дополнительные сведения об устранении неполадок с расширением Azure для SAP. Если после устранения неполадок с использованием примечания SAP 1999351 проблема не исчезла, повторно установите расширение, как описано в разделе Настройка расширения Azure для SAP. Если проблема не исчезла, откройте сообщение о поддержке клиентов SAP в компоненте BC-OP-NT-AZR для виртуальной машины Windows или BC-OP-LNX-AZR для виртуальной машины Linux. Вложите в сообщение файл журнала /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-<версия>/logapp.txt.

Коды ошибок, возникающих у расширения Azure

Все идентификаторы ошибок имеют уникальный тег в виде a-#, где # — это число. Это позволяет быстро определить ошибку и возможные решения.

Идентификатор ошибки	Описание ошибки	Решения
`a-0116`	Отсутствует маркер проверки подлинности	Дополнительные сведения: Расширение не может получить маркер проверки подлинности для доступа к метрикам виртуальной машины в Azure Monitor. Чтобы расширение создавало метрики виртуальной машины, ему необходим доступ к ресурсам виртуальной машины (сама машина, все диски и все сетевые карты, подключенные к виртуальной машине). Решение. Включите управляемое удостоверение виртуальной машины и назначьте ему роль читателя для группы ресурсов виртуальной машины. При использовании скрипта установки это происходит автоматически. Включать и назначать управляемое удостоверение виртуальной машины вручную обычно не требуется.

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

Предварительные требования

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

Развертывание Azure CLI

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

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

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

Развертывание вручную с помощью Azure PowerShell

Развертывание вручную с помощью Azure CLI

Развертывание вручную с помощью Terraform

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

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

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

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

Проверки работоспособности

Проверки работоспособности с использованием PowerShell

Проверка работоспособности с использованием Azure CLI

Устранение неполадок для Windows

Счетчики производительности Azure вообще не отображаются

Каталог установки расширения Azure для SAP пустой

Проблема

Решение

Отсутствуют некоторые счетчики производительности Azure

Устранение неполадок для Linux

Счетчики производительности Azure вообще не отображаются

Каталог установки расширения Azure для SAP пустой

Проблема

Решение

Отсутствуют некоторые счетчики производительности Azure

Коды ошибок, возникающих у расширения Azure

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

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