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

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

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

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

(Get-Module Az.Compute).Version

Выполните действия, описанные в статье "Установка Azure CLI". Часто проверяйте наличие обновлений в Azure CLI.

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

az --version

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

1. Убедитесь, что вы используете SAP Host Agent 7.21 PL 47 или выше.

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

3. Убедитесь, что установлена последняя версия командлета Azure PowerShell (по крайней мере 4.3.0).

4. Для списка доступных сред выполните команду Get-AzEnvironment. Если вы хотите использовать глобальный Azure, ваша среда — AzureCloud. Для Microsoft Azure, управляемой 21Vianet, выберите 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
   

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

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

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

   az extension add --name aem
   

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

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

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

7. Перезапустить SAP Host Agent

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

Следующий код содержит четыре примера. Он показывает, как развернуть расширение в 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":[]}'

Следующий код содержит четыре примера. В нем показано, как развернуть расширение в 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":[]}'

Следующий манифест содержит четыре примера. Он показывает, как развернуть расширение в 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
}

# 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

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

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

2. Проверьте выходные данные следующей команды:

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

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

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

1. Убедитесь, что waagent установлен и включен.

   Запуск:

   sudo ls -al /var/lib/waagent/
   

   Ожидаемый результат: выводит список содержимого waagent каталога.

   Запуск:

   ps -ax | grep waagent
   

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

2. Убедитесь, что расширение Azure для SAP установлено и работает.

   Запуск:

   sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'`
   

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

   Запуск:

   ps -ax | grep AzureEnhanced
   

   Ожидаемый результат: отображает одну запись, аналогичную следующей: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor

3. Установите агент узла SAP, как описано в 1031096 заметки SAP, и проверьте выходные данные saposcol.

   Запуск:

   /usr/sap/hostctrl/exe/saposcol -d
   

   Запуск:

   dump ccm
   

   Проверьте, является ли метрика Virtualization_Configuration\Расширенный доступ к мониторингуtrue.

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

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

1. Убедитесь, что установлена последняя версия модуля Azure PowerShell (по крайней мере 4.3.0).

2. Для списка доступных сред запустите командлет 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. Скрипт проверяет конфигурацию выбранной виртуальной машины.

Убедитесь, что каждый результат проверки состояния — это ОК. Если некоторые проверки не показывают ОК, запустите командлет обновления, как описано в разделе . Повторите проверки, описанные в [проверке готовности][vm-extension-for-sap-new.md#readiness-check], и в этом разделе. Если проверки по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок".

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

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

2. Войдите с помощью учетной записи Azure:

   az login
   

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

   az extension add --name aem
   

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

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

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

Убедитесь, что каждый результат проверки состояния — это ОК. Если некоторые проверки не отображают ОК, запустите командлет обновления, как описано в ". Повторите проверки, описанные в [проверке готовности][vm-extension-for-sap-new.md#readiness-check], и в этом разделе. Если проверки по-прежнему указывают на проблему с некоторыми или всеми счетчиками, см. статью "Устранение неполадок".