Nová verze rozšíření virtuálního počítače Azure pro řešení SAP

Předpoklady

• Ujistěte se, že používáte agenta hostitele SAP 7.21 PL 47 nebo vyšší.
• Ujistěte se, že virtuální počítač, na kterém je povolené rozšíření, má přístup k management.azure.com.

Nasazení rutin Azure PowerShellu

Postupujte podle kroků popsaných v článku Instalace modulu Azure PowerShellu.

Často zkontrolujte aktualizace rutin PowerShellu, které se obvykle aktualizují každý měsíc. Postupujte podle kroků popsaných v tomto článku. Pokud není uvedeno jinak v 2015553 SAP Note 1928533 nebo SAP Note, doporučujeme pracovat s nejnovější verzí rutin Azure PowerShellu.

Pokud chcete zkontrolovat verzi rutin Azure PowerShellu, které jsou nainstalované na vašem počítači, spusťte tento příkaz PowerShellu:

(Get-Module Az.Compute).Version

Nasazení Azure CLI

Postupujte podle kroků popsaných v článku Instalace Azure CLI.

Často zkontrolujte aktualizace Azure CLI, které se obvykle aktualizují měsíčně.

Pokud chcete zkontrolovat verzi Azure CLI, která je nainstalovaná na vašem počítači, spusťte tento příkaz:

az --version

Konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí PowerShellu

Nové rozšíření virtuálního počítače pro SAP používá spravovanou identitu přiřazenou k virtuálnímu počítači pro přístup k datům monitorování a konfigurace virtuálního počítače. Pokud chcete nainstalovat nové rozšíření Azure pro SAP pomocí PowerShellu, musíte nejprve přiřadit takovou identitu virtuálnímu počítači a udělit této identitě přístup ke všem prostředkům, které tento virtuální počítač používá, například diskům a síťovým rozhraním.

1. Ujistěte se, že používáte agenta hostitele SAP 7.21 PL 47 nebo vyšší.

2. Nezapomeňte odinstalovat standardní verzi rozšíření virtuálního počítače pro SAP. Instalace obou verzí rozšíření virtuálního počítače pro SAP na stejný virtuální počítač se nepodporuje.

3. Ujistěte se, že máte nainstalovanou nejnovější verzi rutiny Azure PowerShellu (alespoň 4.3.0). Další informace najdete v tématu Nasazení rutin Azure PowerShellu.

4. Spusťte následující rutinu Azure PowerShellu. Seznam dostupných prostředí zobrazíte spuštěním rutiny Get-AzEnvironment. Pokud chcete používat globální Azure, vaše prostředí je AzureCloud. Pro Microsoft Azure provozovaný společností 21Vianet vyberte AzureChinaCloud.

   Rozšíření virtuálního počítače pro SAP podporuje konfiguraci proxy serveru, který má rozšíření použít pro připojení k externím prostředkům, například k rozhraní API Azure Resource Manageru. K nastavení proxy serveru použijte parametr -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. Restartování agenta hostitele SAP

   Přihlaste se k virtuálnímu počítači, na kterém jste povolili rozšíření virtuálního počítače pro SAP, a pokud už byl nainstalovaný, restartujte agenta hostitele SAP. Agent hostitele SAP nepoužívá rozšíření virtuálního počítače, dokud se nerestartuje. V současné době nemůže zjistit, že rozšíření bylo nainstalováno po jeho spuštění.

Konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí Azure CLI

Nové rozšíření virtuálního počítače pro SAP používá spravovanou identitu přiřazenou k virtuálnímu počítači pro přístup k datům monitorování a konfigurace virtuálního počítače.

1. Ujistěte se, že používáte agenta hostitele SAP 7.21 PL 47 nebo novější.

2. Ujistěte se, že odinstalujete aktuální verzi rozšíření virtuálního počítače pro SAP. Na stejný virtuální počítač nemůžete nainstalovat obě verze rozšíření virtuálního počítače pro SAP.

3. Nainstalujte nejnovější verzi Azure CLI 2.0 (verze 2.19.1 nebo novější).

4. Přihlaste se pomocí svého účtu Azure:

   az login
   

5. Nainstalujte rozšíření Azure CLI AEM. Ujistěte se, že používáte verzi 0.2.2 nebo novější.

   az extension add --name aem
   

6. Povolte nové rozšíření:

   Rozšíření virtuálního počítače pro SAP podporuje konfiguraci proxy serveru, který má rozšíření použít pro připojení k externím prostředkům, například k rozhraní API Azure Resource Manageru. K nastavení proxy serveru použijte parametr --proxy-uri.

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

7. Restartování agenta hostitele SAP

   Přihlaste se k virtuálnímu počítači, na kterém jste povolili rozšíření virtuálního počítače pro SAP, a pokud už byl nainstalovaný, restartujte agenta hostitele SAP. Agent hostitele SAP nepoužívá rozšíření virtuálního počítače, dokud se nerestartuje. V současné době nemůže zjistit, že rozšíření bylo nainstalováno po jeho spuštění.

Ruční konfigurace rozšíření virtuálního počítače Azure pro řešení SAP

Pokud chcete k nasazení rozšíření virtuálního počítače pro SAP použít Azure Resource Manager, Terraform nebo jiné nástroje, můžete rozšíření virtuálního počítače pro SAP nasadit také ručně, tj. bez použití vyhrazených příkazů PowerShellu nebo Azure CLI.

Před nasazením rozšíření virtuálního počítače pro SAP nezapomeňte k virtuálnímu počítači přiřadit spravovanou identitu přiřazenou uživatelem nebo systémem. Další informace najdete v následujících příručkách:

• Konfigurace spravovaných identit pro prostředky Azure na virtuálním počítači pomocí webu Azure Portal
• Konfigurace spravovaných identit pro prostředky Azure na virtuálním počítači Azure pomocí Azure CLI
• Konfigurace spravovaných identit pro prostředky Azure na virtuálním počítači Azure pomocí PowerShellu
• Konfigurace spravovaných identit pro prostředky Azure na virtuálním počítači Azure pomocí šablon
• Identita virtuálního počítače Terraformu

Po přiřazení identity virtuálnímu počítači dejte virtuálnímu počítači přístup ke čtení buď ke skupině prostředků, nebo jednotlivým prostředkům přidruženým k virtuálnímu počítači (virtuálnímu počítači, síťovým rozhraním, diskům operačního systému a datovým diskům). K udělení přístupu k těmto prostředkům se doporučuje použít předdefinovanou roli Čtenář. Tento přístup můžete udělit také přidáním identity virtuálního počítače do skupiny Microsoft Entra, která už má přístup pro čtení k požadovaným prostředkům. Pokud použijete identitu přiřazenou uživatelem, která už má požadovaná oprávnění, už není potřeba mít oprávnění vlastníka při nasazování rozšíření virtuálního počítače pro SAP.

Existují různé způsoby ručního nasazení rozšíření virtuálního počítače pro SAP. V dalších kapitolách najdete několik příkladů.

Rozšíření aktuálně podporuje následující konfigurační klíče. V následujícím příkladu se zobrazí msi_res_id.

• msi_res_id: ID identity přiřazené uživatelem by rozšíření mělo použít k získání požadovaných informací o virtuálním počítači a jeho prostředcích.
• proxy: Adresa URL proxy serveru, které by rozšíření mělo použít pro připojení k internetu, například k načtení informací o virtuálním počítači a jeho prostředcích.

Ruční nasazení pomocí Azure PowerShellu

Následující kód obsahuje čtyři příklady. Ukazuje, jak nasadit rozšíření ve Windows a Linuxu pomocí identity přiřazené systémem nebo uživatelem. Nezapomeňte nahradit název skupiny prostředků, umístění a název virtuálního počítače v příkladu.

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

Ruční nasazení pomocí Azure CLI

Následující kód obsahuje čtyři příklady. Ukazuje, jak nasadit rozšíření ve Windows a Linuxu pomocí identity přiřazené systémem nebo uživatelem. Nezapomeňte nahradit název skupiny prostředků, umístění a název virtuálního počítače v příkladu.

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

Ruční nasazení pomocí Terraformu

Následující manifest obsahuje čtyři příklady. Ukazuje, jak nasadit rozšíření ve Windows a Linuxu pomocí identity přiřazené systémem nebo uživatelem. Nezapomeňte v příkladu nahradit ID virtuálního počítače a ID identity přiřazené uživatelem.

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

Verze rozšíření virtuálního počítače pro SAP

Pokud chcete zakázat automatické aktualizace pro rozšíření virtuálního počítače nebo chcete nasadit konkrétní verzi rozšíření, můžete načíst dostupné verze pomocí Azure CLI nebo Azure PowerShellu.

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

Kontrola připravenosti

Tato kontrola zajistí, že všechny metriky výkonu, které se zobrazí ve vaší aplikaci SAP, poskytují základní rozšíření Azure pro SAP.

Spuštění kontroly připravenosti na virtuálním počítači s Windows

1. Přihlaste se k virtuálnímu počítači Azure (není nutné použít účet správce).
2. Otevřete webový prohlížeč a přejděte na adresu http://127.0.0.1:11812/azure4sap/metrics.
3. Prohlížeč by měl zobrazit nebo stáhnout soubor XML, který obsahuje data monitorování vašeho virtuálního počítače. Pokud tomu tak není, ujistěte se, že je nainstalované rozšíření Azure pro SAP.
4. Zkontrolujte obsah souboru XML. Soubor XML, ke kterému máte přístup http://127.0.0.1:11812/azure4sap/metrics , obsahuje všechny naplněné čítače výkonu Azure pro SAP. Obsahuje také souhrn a indikátor stavu stavu rozšíření Azure pro SAP.
5. Zkontrolujte hodnotu prvku Popis stavu zprostředkovatele. Pokud hodnota není v pořádku, postupujte podle pokynů v kapitole Kontroly stavu.

Spuštění kontroly připravenosti na virtuálním počítači s Linuxem

1. Připojení k virtuálnímu počítači Azure pomocí SSH.
2. Zkontrolujte výstup následujícího příkazu.

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

   Očekávaný výsledek: Vrátí dokument XML, který obsahuje informace o monitorování virtuálního počítače, jeho disků a síťových rozhraní.

Pokud předchozí kontrola nebyla úspěšná, spusťte tyto další kontroly:

1. Ujistěte se, že je agent waagent nainstalovaný a povolený.

   a. Spusťte příkaz sudo ls -al /var/lib/waagent/.

   Očekávaný výsledek: Vypíše obsah adresáře waagent.

   b. Spusťte příkaz ps -ax | grep waagent.

   Očekávaný výsledek: Zobrazí jednu položku podobnou této: python /usr/sbin/waagent -daemon

2. Ujistěte se, že je nainstalované a spuštěné rozšíření Azure pro SAP.

   a. Spusťte příkaz sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'.

   Očekávaný výsledek: Vypíše obsah rozšíření Azure pro adresář SAP.

   b. Spusťte příkaz ps -ax | grep AzureEnhanced.

   Očekávaný výsledek: Zobrazí jednu položku podobnou této: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor

3. Nainstalujte agenta hostitele SAP, jak je popsáno v SAP Note 1031096, a zkontrolujte výstup saposcol.

   a. Spusťte příkaz /usr/sap/hostctrl/exe/saposcol -d.

   b. Spusťte příkaz dump ccm.

   c. Zkontrolujte, jestli je metrika Virtualization_Configuration\Enhanced Monitoring Access pravdivá.

Pokud už máte nainstalovaný aplikační server SAP NetWeaver jazyk ABAP, otevřete transakci ST06 a zkontrolujte, jestli je povolené monitorování.

Pokud některé z těchto kontrol selžou a podrobné informace o opětovném nasazení rozšíření, přečtěte si téma Řešení potíží pro Windows nebo řešení potíží s Linuxem.

Kontroly stavu

Pokud některá data infrastruktury nejsou správně dodána podle testů popsaných v kontrole připravenosti, spusťte kontroly stavu popsané v této kapitole a zkontrolujte, jestli je správně nakonfigurovaná infrastruktura Azure a rozšíření Azure pro SAP.

Kontroly stavu pomocí PowerShellu

1. Ujistěte se, že máte nainstalovanou nejnovější verzi rutiny Azure PowerShellu, jak je popsáno v tématu Nasazení rutin Azure PowerShellu.

2. Spusťte následující rutinu Azure PowerShellu. Seznam dostupných prostředí zobrazíte spuštěním rutiny Get-AzEnvironment. Pokud chcete použít globální Azure, vyberte prostředí AzureCloud . Pro Microsoft Azure provozovaný společností 21Vianet vyberte 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. Skript otestuje konfiguraci vybraného virtuálního počítače.

Ujistěte se, že každý výsledek kontroly stavu je v pořádku. Pokud se některé kontroly nezobrazí v pořádku, spusťte rutinu aktualizace, jak je popsáno v tématu Konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí Azure CLI nebo konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí PowerShellu. Opakujte kontroly popsané v kontrole připravenosti a v této kapitole. Pokud kontroly stále značí problém s některými nebo všemi čítači, přečtěte si téma Řešení potíží s Linuxem nebo řešením potíží pro Windows.

Kontroly stavu pomocí Azure CLI

Spuštění kontroly stavu rozšíření virtuálního počítače Azure pro SAP pomocí Azure CLI:

1. Nainstalujte Azure CLI 2.0. Ujistěte se, že používáte aspoň verzi 2.19.1 nebo novější (použijte nejnovější verzi).

2. Přihlaste se pomocí svého účtu Azure:

   az login
   

3. Nainstalujte rozšíření Azure CLI AEM. Ujistěte se, že používáte verzi 0.2.2 nebo novější.

   az extension add --name aem
   

4. Ověřte instalaci rozšíření:

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

Skript otestuje konfiguraci vybraného virtuálního počítače.

Ujistěte se, že každý výsledek kontroly stavu je v pořádku. Pokud se některé kontroly nezobrazí v pořádku, spusťte rutinu aktualizace, jak je popsáno v tématu Konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí Azure CLI nebo konfigurace rozšíření virtuálního počítače Azure pro řešení SAP pomocí PowerShellu. Opakujte kontroly popsané v kontrole připravenosti a v této kapitole. Pokud kontroly stále značí problém s některými nebo všemi čítači, přečtěte si téma Řešení potíží s Linuxem nebo řešením potíží pro Windows.

Řešení potíží pro Windows

Čítače výkonu Azure se vůbec nezobrazují

Proces AzureEnhancedMonitoring shromažďuje metriky výkonu v Azure. Pokud na vašem virtuálním počítači není spuštěný proces, není možné shromažďovat žádné metriky výkonu.

Instalační adresář rozšíření Azure pro SAP je prázdný.

Problém

Instalační adresář C:\Packages\Plugins\Microsoft.AzureEnhancedMonitoring.MonitorX64Windows\<version> je prázdný.

Řešení

Rozšíření není nainstalováno. Zjistěte, jestli se jedná o problém s proxy serverem (jak je popsáno výše). Možná budete muset restartovat počítač nebo znovu nainstalovat rozšíření virtuálního počítače.

Chybí některé čítače výkonu Azure.

Proces AzureEnhancedMonitoring pro Windows shromažďuje metriky výkonu v Azure. Proces získává data z několika zdrojů. Některá konfigurační data se shromažďují místně a některé metriky výkonu se čtou ze služby Azure Monitor.

Pokud řešení potíží pomocí sap Note 1999351 problém nevyřeší, otevřete zprávu podpory zákazníků SAP na komponentě BC-OP-NT-AZR pro Windows nebo BC-OP-LNX-AZR pro virtuální počítač s Linuxem. Připojte k incidentu soubor protokolu C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<version>\logapp.txt.

Řešení potíží pro Linux

Čítače výkonu Azure se vůbec nezobrazují

Metriky výkonu v Azure shromažďuje démon. Pokud proces démon není spuštěný, není možné shromažďovat žádné metriky výkonu.

Instalační adresář rozšíření Azure pro SAP je prázdný.

Problém

Adresář /var/lib/waagent/ nemá podadresář pro rozšíření Azure pro SAP.

Řešení

Rozšíření není nainstalováno. Zjistěte, jestli se jedná o problém s proxy serverem (jak je popsáno výše). Možná budete muset restartovat počítač nebo nainstalovat rozšíření virtuálního počítače znovu.

Chybí některé čítače výkonu Azure.

Metriky výkonu v Azure shromažďuje proces démon, který získává data z několika zdrojů. Některá konfigurační data se shromažďují místně a některé metriky výkonu se čtou ze služby Azure Monitor. Úplný a aktuální seznam známých problémů najdete v tématu SAP Note 1999351, který obsahuje další informace o řešení potíží pro rozšíření Azure pro SAP. Pokud řešení potíží pomocí SAP Note 1999351 problém nevyřeší, nainstalujte rozšíření znovu, jak je popsáno v tématu Konfigurace rozšíření Azure pro SAP. Pokud problém přetrvává, otevřete zprávu zákaznické podpory SAP na komponentě BC-OP-NT-AZR pro Windows nebo BC-OP-LNX-AZR pro virtuální počítač s Linuxem. Připojte k incidentu soubor protokolu /var/lib/waagent/Microsoft.AzureENhancedMonitoring.MonitorX64Linux-version<>/logapp.txt.

Kódy chyb rozšíření Azure

Všechna ID chyb mají jedinečnou značku ve formě a-#, kde # je číslo. Umožňuje rychlé hledání konkrétní chyby a možných řešení.

Další kroky

• Nasazení virtuálních počítačů Azure pro SAP NetWeaver
• Plánování a implementace virtuálních počítačů Azure pro SAP NetWeaver