Новая версия расширения виртуальной машины 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, необходимо сначала назначить такое удостоверение виртуальной машине и предоставить этому удостоверению доступ ко всем ресурсам, используемым этой виртуальной машиной, например к дискам и сетевым интерфейсам.

1. Убедитесь, что используется агент SAP Host Agent 7.21 PL 47 или более поздней версии.

2. Обязательно удалите стандартную версию расширения виртуальной машины для SAP. Установка обеих версий расширения виртуальной машины для SAP на одной виртуальной машине не поддерживается.

3. Установите последнюю версию командлетов Azure PowerShell (не ниже версии 4.3.0). Дополнительные сведения см. в разделе Развертывание командлетов Azure PowerShell.

4. Выполните приведенный ниже командлет 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
   

5. Перезапуск агента узла SAP

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

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

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

1. Убедитесь, что используется агент SAP Host Agent 7.21 PL 47 или более поздней версии.

2. Обязательно удалите текущую версию расширения виртуальной машины для SAP. Вы не можете установить обе версии расширения виртуальной машины для SAP на одной виртуальной машине.

3. Установите последнюю версию Azure CLI 2.0 (версия 2.19.1 или более поздняя).

4. Войдите в систему, используя учетную запись Azure.

   az login
   

5. Установите расширения AEM для Azure CLI. Убедитесь, что используется версия 0.2.2 или более поздняя.

   az extension add --name aem
   

6. Включите новое расширение:

   Расширение виртуальной машины для SAP поддерживает настройку прокси-сервера, через который расширение должно подключаться к внешним ресурсам, например API Azure Resource Manager. Чтобы указать прокси-сервер, используйте параметр --proxy-uri.

   az vm aem set -g <resource-group-name> -n <vm name> --install-new-extension
   

7. Перезапуск агента узла SAP

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

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

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

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

• Настройка управляемых удостоверений для ресурсов Azure на виртуальной машине с помощью портал Azure
• Настройка управляемых удостоверений для ресурсов Azure на виртуальной машине Azure с помощью Azure CLI
• Настройка управляемых удостоверений для ресурсов Azure на виртуальной машине Azure с помощью PowerShell
• Настройка управляемых удостоверений для ресурсов Azure на виртуальной машине Azure с помощью шаблонов
• Удостоверение виртуальной машины Terraform

После назначения удостоверения виртуальной машине предоставьте виртуальной машине доступ на чтение к группе ресурсов или отдельным ресурсам, связанным с виртуальной машиной (виртуальные машины, сетевые интерфейсы, диски ОС и диски данных). Рекомендуется использовать встроенную роль читателя для предоставления доступа к этим ресурсам. Вы также можете предоставить этому доступу, добавив удостоверение виртуальной машины в группу 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 и Linux с помощью назначенного системой или пользователем удостоверения. Обязательно замените имя группы ресурсов, расположение и имя виртуальной машины в примере.

# 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

1. Войдите в виртуальную машину Azure (учетная запись администратора не требуется).
2. Откройте браузер и перейдите по ссылке http://127.0.0.1:11812/azure4sap/metrics.
3. Браузер должен отобразить или скачать XML-файл, содержащий данные мониторинга виртуальной машины. Если это не так, убедитесь, что расширение Azure для SAP установлено.
4. Проверьте содержимое XML-файла. XML-файл по адресу http://127.0.0.1:11812/azure4sap/metrics содержит все заполненные данными счетчики производительности Azure для SAP. Он также содержит сводку и индикатор работоспособности для расширения Azure для SAP.
5. Проверьте значение элемента Provider Health Description (Описание работоспособности поставщика). Если значение не в порядке, следуйте инструкциям в разделе "Работоспособность проверка".

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

1. Подключитесь к виртуальной машине Azure по протоколу SSH.
2. Проверьте выходные данные следующей команды.

   curl http://127.0.0.1:11812/azure4sap/metrics
   

   Ожидаемый результат: возвращается XML-документ, содержащий сведения о мониторинге виртуальной машины, ее дисков и сетевых интерфейсов.

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

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

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

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

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

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

2. Проверьте, установлено и запущено ли расширение 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.

3. Установите агент 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

1. Установите последнюю версию командлетов Azure PowerShell, как описано в разделе Развертывание командлетов Azure PowerShell.

2. Выполните приведенный ниже командлет 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>
   

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

Убедитесь, что для каждой проверки установлено состояние ОК. Если некоторые проверка не отображаются, запустите командлет обновления, как описано в разделе "Настройка расширения виртуальной машины Azure для решений SAP с помощью Azure CLI" или настройка расширения виртуальной машины Azure для решений SAP с помощью PowerShell. Повторите проверка, описанные в проверка готовности, и в этой главе. Если проверка по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок для Linux" или "Устранение неполадок" для Windows.

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

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

1. Установите Azure CLI 2.0. Убедитесь, что используется как минимум версия 2.19.1 или более поздняя (используйте последнюю версию).

2. Войдите в систему, используя учетную запись Azure.

   az login
   

3. Установите расширения AEM для Azure CLI. Убедитесь, что используется версия 0.2.2 или более поздняя.

   az extension add --name aem
   

4. Проверьте установку расширения:

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

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

Убедитесь, что для каждой проверки установлено состояние ОК. Если некоторые проверка не отображаются, запустите командлет обновления, как описано в разделе "Настройка расширения виртуальной машины Azure для решений SAP с помощью Azure CLI" или настройка расширения виртуальной машины Azure для решений SAP с помощью PowerShell. Повторите проверка, описанные в проверка готовности, и в этой главе. Если проверка по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок для Linux" или "Устранение неполадок" для Windows.

Устранение неполадок для 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-#, где # — это число. Это позволяет быстро определить ошибку и возможные решения.

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

• Развертывание виртуальных машин Azure для SAP NetWeaver
• SAP NetWeaver на виртуальных машинах Windows. Руководство по планированию и внедрению