SAP용 Azure VM 확장 솔루션의 새 버전

필수 조건

• SAP Host Agent 7.21 PL 47 이상을 사용해야 합니다.
• 확장이 사용하도록 설정된 가상 머신에 management.azure.com에 대한 액세스 권한이 있는지 확인합니다.

Azure PowerShell cmdlet 배포

Azure PowerShell 모듈 설치 문서에 설명된 단계를 따릅니다.

일반적으로 매월 업데이트되는 PowerShell cmdlet에 대한 업데이트를 자주 확인하십시오. 이 문서에 설명된 단계를 따릅니다. SAP Note 1928533 또는 SAP Note 2015553에 달리 명시되지 않은 한 Azure PowerShell cmdlet의 최신 버전을 사용하는 것이 좋습니다.

컴퓨터에 설치된 Azure PowerShell cmdlet의 버전을 확인하려면 다음 PowerShell 명령을 실행합니다.

(Get-Module Az.Compute).Version

Azure CLI 배포

Azure CLI 설치 문서에 설명된 단계를 따릅니다.

일반적으로 매월 업데이트 되는 Azure CLI에 대한 업데이트를 자주 확인하십시오.

컴퓨터에 설치된 Azure CLI의 버전을 확인하려면 다음 명령을 실행합니다.

az --version

PowerShell을 사용하여 SAP용 Azure VM 확장 솔루션 구성

새 SAP용 VM 확장은 VM에 할당된 관리 ID를 사용하여 VM의 모니터링 및 구성 데이터에 액세스합니다. PowerShell을 사용하여 새 SAP용 Azure 확장을 설치하려면 먼저 이 ID를 VM에 할당하고 VM에서 사용 중인 모든 리소스(예: 디스크 및 네트워크 인터페이스)에 해당 ID 액세스 권한을 부여해야 합니다.

1. SAP Host Agent 7.21 PL 47 이상을 사용해야 합니다.

2. SAP용 VM 확장의 표준 버전을 제거해야 합니다. 동일한 가상 머신에 SAP용 VM 확장의 두 버전을 모두 설치할 수는 없습니다.

3. 최신 버전의 Azure PowerShell cmdlet(4.3.0 이상)을 설치했는지 확인합니다. 자세한 내용은 Azure PowerShell cmdlet 배포를 참조하세요.

4. 다음 PowerShell cmdlet을 실행합니다. 사용 가능한 환경 목록을 보려면 cmdlet Get-AzEnvironment를 실행합니다. 전역 Azure를 사용하려는 경우 환경은 AzureCloud입니다. 21Vianet에서 운영하는 Microsoft Azure의 경우 AzureChinaCloud를 선택합니다.

   SAP용 VM 확장은 확장이 외부 리소스(예: Azure Resource Manager API)에 연결하는 데 사용해야 하는 프록시 구성을 지원합니다. 매개 변수 -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용 VM 확장을 사용하도록 설정한 가상 머신에 로그온하고 이미 설치된 경우 SAP 호스트 에이전트를 다시 시작합니다. SAP 호스트 에이전트는 다시 시작할 때까지 VM 확장을 사용하지 않습니다. 확장이 시작된 후 설치된 확장을 현재 검색할 수 없습니다.

Azure CLI를 사용하여 SAP용 Azure VM 확장 솔루션 구성

새 SAP용 VM 확장은 VM에 할당된 관리 ID를 사용하여 VM의 모니터링 및 구성 데이터에 액세스합니다.

1. SAP Host Agent 7.21 PL 47 이상을 사용해야 합니다.

2. 현재 버전의 SAP용 VM 확장을 제거해야 합니다. 동일한 VM에 SAP용 VM 확장의 두 버전을 모두 설치할 수는 없습니다.

3. 최신 버전의 Azure CLI 2.0(버전 2.19.1 이상)을 설치합니다.

4. Azure 계정으로 로그인합니다.

   az login
   

5. Azure CLI AEM 확장을 설치합니다. 버전 0.2.2 이상을 사용해야 합니다.

   az extension add --name aem
   

6. 새 확장을 사용하도록 설정합니다.

   SAP용 VM 확장은 확장이 외부 리소스(예: Azure Resource Manager API)에 연결하는 데 사용해야 하는 프록시 구성을 지원합니다. --proxy-uri 매개 변수를 사용하여 프록시를 설정합니다.

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

7. SAP 호스트 에이전트 다시 시작

   SAP용 VM 확장을 사용하도록 설정한 가상 머신에 로그온하고 이미 설치된 경우 SAP 호스트 에이전트를 다시 시작합니다. SAP 호스트 에이전트는 다시 시작할 때까지 VM 확장을 사용하지 않습니다. 확장이 시작된 후 설치된 확장을 현재 검색할 수 없습니다.

SAP용 Azure VM 확장 솔루션 수동 구성

Azure Resource Manager, Terraform 또는 기타 도구를 사용하여 SAP용 VM 확장을 배포하려는 경우 전용 PowerShell 또는 Azure CLI 명령을 사용하지 않고 SAP용 VM 확장을 수동으로 배포할 수도 있습니다.

SAP용 VM 확장을 배포하기 전에 가상 머신에 사용자 또는 시스템 할당 관리 ID를 할당해야 합니다. 자세한 내용은 다음 지침을 참조하세요.

• Azure Portal을 사용하여 VM에서 Azure 리소스에 대한 관리 ID 구성
• Azure CLI를 사용하여 Azure VM에서 Azure 리소스에 대한 관리 ID 구성
• PowerShell을 사용하여 Azure VM에서 Azure 리소스에 대한 관리 ID 구성
• 템플릿을 사용하여 Azure VM에서 Azure 리소스에 대한 관리 ID 구성
• Terraform VM ID

가상 머신에 ID를 할당한 후 리소스 그룹 또는 가상 머신에 연결된 개별 리소스(VM, 네트워크 인터페이스, OS 디스크 및 데이터 디스크)에 대한 읽기 액세스 권한을 VM에 부여합니다. 기본 제공 읽기 권한자 역할을 사용하여 이러한 리소스에 대한 액세스 권한을 부여하는 것이 좋습니다. 필요한 리소스에 대한 읽기 권한이 이미 있는 Microsoft Entra 그룹에 VM ID를 추가하여 이 액세스 권한을 부여할 수도 있습니다. 그러면 이미 필요한 권한이 있는 사용자 할당 ID를 사용하는 경우 SAP용 VM 확장을 배포할 때 소유자 권한이 더 이상 필요하지 않습니다.

SAP용 VM 확장을 수동으로 배포하는 방법에는 여러 가지가 있습니다. 다음 챕터에서 몇 가지 예를 찾아보세요.

확장은 현재 다음 구성 키를 지원합니다. 아래 예제에서는 msi_res_id가 표시됩니다.

• msi_res_id: 확장이 VM 및 해당 리소스에 대한 필수 정보를 가져오는 데 사용해야 하는 사용자 할당 ID의 ID
• 프록시: 예를 들어 가상 머신 및 해당 리소스에 대한 정보를 검색하기 위해 확장이 인터넷에 연결하는 데 사용해야 하는 프록시의 URL

Azure PowerShell을 사용하여 수동으로 배포

다음 코드에는 네 가지 예제가 포함되어 있습니다. 시스템 또는 사용자 할당 ID를 사용하여 Windows 및 Linux에 확장을 배포하는 방법을 보여줍니다. 예제에서 리소스 그룹의 이름, 위치 및 VM 이름을 바꿔야 합니다.

# 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를 사용하여 수동으로 배포

다음 코드에는 네 가지 예제가 포함되어 있습니다. 시스템 또는 사용자 할당 ID를 사용하여 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":[]}'

Terraform을 사용하여 수동으로 배포

다음 매니페스트에는 네 가지 예제가 포함되어 있습니다. 시스템 또는 사용자 할당 ID를 사용하여 Windows 및 Linux에 확장을 배포하는 방법을 보여줍니다. 예제에서 VM의 ID와 사용자 할당 ID의 ID를 바꿔야 합니다.

# 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용 VM 확장 버전

VM 확장에 대한 자동 업데이트를 사용하지 않도록 설정하거나 특정 버전의 확장을 배포하려는 경우 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 애플리케이션 내부에 나타나는 모든 성능 메트릭이 기본 SAP용 Azure 확장에서 제공되는지 확인합니다.

Windows VM에서 준비 검사 실행

1. Azure Virtual Machine에 로그인합니다(관리자 계정 사용은 필요하지 않음).
2. 웹 브라우저를 열고 http://127.0.0.1:11812/azure4sap/metrics로 이동합니다.
3. 브라우저에서 가상 머신의 모니터링 데이터를 포함하는 XML 파일을 표시하거나 다운로드해야 합니다. 그렇지 않은 경우 SAP용 Azure 확장이 설치되어 있는지 확인합니다.
4. XML 파일의 내용을 확인합니다. http://127.0.0.1:11812/azure4sap/metrics에서 액세스할 수 있는 XML 파일에는 모든 SAP용 Azure 성능 카운터가 채워져 있습니다. SAP용 Azure 확장의 상태에 대한 요약 및 상태 표시기도 포함되어 있습니다.
5. 공급자 상태 설명 요소의 값을 확인합니다. 값이 OK가 아니면 상태 확인 장의 지침을 따릅니다.

Linux VM에서 준비 검사 실행

1. SSH를 사용하여 Azure Virtual Machine에 연결합니다.
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. SAP용 Azure 확장이 설치되어 실행되는지 확인합니다.

   a. sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'을 실행합니다.

   예상 결과: SAP용 Azure 확장 디렉터리의 콘텐츠를 나열합니다.

   b. ps -ax | grep AzureEnhanced을 실행합니다.

   예상 결과: 다음과 유사한 한 항목을 표시합니다. /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor

3. SAP Note 1031096 에 설명된 대로 SAP 호스트 에이전트를 설치하고 saposcol의 출력을 확인합니다.

   a. /usr/sap/hostctrl/exe/saposcol -d을 실행합니다.

   b. dump ccm을 실행합니다.

   c. Virtualization_Configuration\Enhanced Monitoring Access 메트릭이 true인지 여부를 확인합니다.

SAP NetWeaver ABAP 애플리케이션 서버가 이미 설치된 경우 트랜잭션 ST06을 열고 모니터링이 사용하도록 설정되어 있는지 여부를 확인합니다.

이러한 검사 중 하나라도 실패한 경우 및 확장을 다시 배포하는 방법에 대한 자세한 내용을 보려면 Windows에 대한 문제 해결 또는 Linux에 대한 문제 해결을 참조하세요.

상태 검사

일부 인프라 데이터가 준비 검사에 설명된 테스트에 표시된 대로 올바르게 전달되지 않으면 이 장에 설명된 상태 확인을 실행하여 Azure 인프라 및 SAP용 Azure 확장이 올바르게 구성되었는지 확인합니다.

PowerShell을 사용한 상태 확인

1. Azure PowerShell cmdlet 배포의 설명대로 Azure PowerShell cmdlet 최신 버전을 설치했는지 확인합니다.

2. 다음 PowerShell cmdlet을 실행합니다. 사용 가능한 환경 목록을 보려면 Get-AzEnvironment cmdlet을 실행합니다. 전역 Azure를 사용하려면AzureCloud 환경을 선택합니다. 21Vianet에서 운영하는 Microsoft Azure의 경우 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. 선택한 가상 머신의 구성을 테스트하는 스크립트입니다.

모든 상태 검사 결과가 OK인지 확인합니다. 일부 검사에서 OK가 표시되지 않는 경우 Azure CLI를 사용하여 SAP용 Azure VM 확장 솔루션 구성 또는 PowerShell을 사용하여 SAP용 Azure VM 확장 솔루션 구성에 설명된 대로 업데이트 cmdlet을 실행합니다. 준비 검사 및 이 장에 설명된 확인을 반복합니다. 검사 결과 일부 또는 모든 카운터에 여전히 문제가 있는 것으로 나타나면 Linux에 대한 문제 해결 또는 Windows에 대한 문제 해결을 참조하세요.

Azure CLI를 사용한 상태 확인

Azure CLI를 사용하여 SAP용 Azure VM 확장에 대한 상태 확인을 실행하려면 다음을 수행합니다.

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> 
   

선택한 가상 컴퓨터의 구성을 테스트하는 스크립트입니다.

모든 상태 검사 결과가 OK인지 확인합니다. 일부 검사에서 OK가 표시되지 않는 경우 Azure CLI를 사용하여 SAP용 Azure VM 확장 솔루션 구성 또는 PowerShell을 사용하여 SAP용 Azure VM 확장 솔루션 구성에 설명된 대로 업데이트 cmdlet을 실행합니다. 준비 검사 및 이 장에 설명된 확인을 반복합니다. 검사 결과 일부 또는 모든 카운터에 여전히 문제가 있는 것으로 나타나면 Linux에 대한 문제 해결 또는 Windows에 대한 문제 해결을 참조하세요.

Windows에 대한 문제 해결

Azure 성능 카운터가 전혀 표시되지 않습니다.

AzureEnhancedMonitoring 프로세스에서 Azure의 성능 메트릭을 수집합니다. VM에서 프로세스가 실행되지 않는 경우 성능 메트릭을 전혀 수집할 수 없습니다.

SAP용 Azure 확장의 설치 디렉터리가 비어 있습니다

문제

설치 디렉터리 C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<version>이 비어 있습니다.

솔루션

확장이 설치되지 않았습니다. (앞에서 설명한) 프록시 문제인지 여부를 결정합니다. 컴퓨터를 다시 시작하거나 VM 확장을 다시 설치해야 할 수 있습니다.

일부 Azure 성능 카운터가 없습니다.

AzureEnhancedMonitoring Windows 프로세스에서 Azure의 성능 메트릭을 수집합니다. 프로세스가 여러 원본에서 데이터를 가져옵니다. 일부 구성 데이터는 로컬로 수집되고 일부 성능 메트릭은 Azure Monitor에서 읽습니다.

SAP Note 1999351을 사용하여 문제를 해결해도 문제가 지속되면 Windows용 BC-OP-NT-AZR 또는 Linux 가상 머신용 BC-OP-LNX-AZR 구성 요소에서 SAP 고객 지원 메시지를 엽니다. 인시던트에 로그 파일 C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<version>\logapp.txt를 첨부합니다.

Linux에 대한 문제 해결

Azure 성능 카운터가 전혀 표시되지 않습니다.

Azure의 성능 메트릭은 데몬에 의해 수집됩니다. 데몬이 실행되지 않는 경우 성능 메트릭은 전혀 수집할 수 없습니다.

SAP용 Azure 확장의 설치 디렉터리가 비어 있습니다

문제

디렉터리 /var/lib/waagent/에 SAP용 Azure 확장에 대한 하위 디렉터리가 없습니다.

솔루션

확장이 설치되지 않았습니다. (앞에서 설명한) 프록시 문제인지 여부를 결정합니다. 컴퓨터를 다시 시작하거나 VM 확장을 다시 설치해야 할 수 있습니다.

일부 Azure 성능 카운터가 없습니다.

Azure에서 성능 메트릭은 여러 원본에서 데이터를 가져오는 데몬에 의해 수집됩니다. 일부 구성 데이터는 로컬로 수집되고 일부 성능 메트릭은 Azure Monitor에서 읽습니다. 알려진 문제의 전체 최신 목록은 SAP용 Azure 확장 관련 문제 해결 정보를 추가로 포함하는 SAP Note 1999351을 참조하세요. SAP Note 1999351을 사용하여 문제를 해결해도 문제가 지속되면 SAP용 Azure 확장 구성의 설명에 따라 확장을 다시 설치합니다. 문제가 지속되면 Windows용 BC-OP-NT-AZR 또는 Linux 가상 머신용 BC-OP-LNX-AZR 구성 요소에 대한 SAP 고객 지원 메시지를 엽니다. 로그 파일 /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-<version>/logapp.txt를 인시던트에 연결합니다.

Azure 확장 오류 코드

모든 오류 ID에는 a-# 형식의 고유한 태그가 있습니다. 여기서 #은 숫자입니다. 특정 오류 및 가능한 솔루션을 빠르게 검색할 수 있습니다.

다음 단계

• SAP NetWeaver에 대한 Azure Virtual Machines 배포
• SAP NetWeaver에 대한 Azure Virtual Machines 계획 및 구현