Version standard de l’extension de machine virtuelle Azure pour les solutions SAP

Prérequis

Déploiement d’applets de commande Azure PowerShell

Suivez la procédure décrite dans l’article Installation du module Azure PowerShell.

Recherchez régulièrement les mises à jour des applets de commande PowerShell, qui sont généralement publiées une fois par mois. Suivez la procédure décrite dans cet article. Sauf indication contraire dans les notes SAP 1928533 ou 2015553, nous vous recommandons d’utiliser la dernière version des applets de commande Azure PowerShell.

Pour vérifier la version des applets de commande Azure PowerShell installées sur votre ordinateur, exécutez cette commande PowerShell :

(Get-Module Az.Compute).Version

Déploiement de l’interface de ligne de commande Azure

Suivez la procédure décrite dans l’article Installation d’Azure CLI.

Recherchez régulièrement les mises à jour de l’interface de ligne de commande Azure, qui sont généralement publiées une fois par mois.

Pour vérifier la version de l’interface de ligne de commande Azure installée sur votre ordinateur, exécutez cette commande :

az --version

Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell

Pour installer l’extension Azure pour SAP à l’aide de PowerShell :

1. Vérifiez que vous avez installé la dernière version de l’applet de commande Azure PowerShell. Pour plus d’informations, consultez Déploiement des applets de commande Azure PowerShell
2. Exécutez l’applet de commande PowerShell suivant. Pour afficher la liste des environnements disponibles, exécutez la cmdlet Get-AzEnvironment . Si vous voulez utiliser la version globale d’Azure, votre environnement est AzureCloud. Pour Microsoft Azure géré par 21Vianet, sélectionnez AzureChinaCloud.

   $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> 
   

Une fois que vous avez entré les données de votre compte, le script déploie les extensions requises et active les fonctionnalités nécessaires. Ceci peut prendre plusieurs minutes. Pour plus d’informations sur Set-AzVMAEMExtension, consultez Set-AzVMAEMExtension.

La configuration Set-AzVMAEMExtension effectue toutes les étapes de configuration de collecte de données d’hôte pour SAP.

La sortie du script comprend les informations suivantes :

• La confirmation que la collecte de données a été configurée pour le disque du système d’exploitation et tous les autres disques de données.
• Les deux messages suivants confirment la configuration des métriques de stockage pour un compte de stockage spécifique.
• Une des lignes de sortie fournit l’état de la mise à jour réelle de la configuration de l’extension de machine virtuelle pour SAP.
• Une autre ligne de sortie confirme que la configuration a été déployée ou mise à jour.
• La dernière ligne de sortie est informative. Elle répertorie les options permettant de tester la configuration de l’extension de machine virtuelle pour SAP.
• Pour vérifier que toutes les étapes de configuration de l’extension de machine virtuelle Azure pour SAP ont été exécutées correctement et que l’infrastructure Azure fournit les données nécessaires, vérifiez la préparation de l’extension Azure pour SAP, comme décrit dans Vérification de la préparation.
• Attendez 15 à 30 minutes pour que les diagnostics Azure collectent les données pertinentes.

Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI

Pour installer l’extension de machine virtuelle Azure pour SAP à l’aide d’Azure CLI :

1. Vérifiez que vous avez installé la version la plus récente d’Azure CLI. Pour plus d’informations, consultez Déploiement de l’interface de ligne de commande Azure

2. Connectez-vous à votre compte Azure :

   az login
   

3. Installez l’extension AEM Azure CLI. Veillez à utiliser la version 0.2.2 ou une version ultérieure.

   az extension add --name aem
   

4. Activez l’extension :

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

5. Vérifiez que l’extension Azure pour SAP est active sur la machine virtuelle Azure Linux. Vérifiez si le fichier /var/lib/AzureEnhancedMonitor/PerfCounters existe. S’il existe, à l’invite de commandes, exécutez cette commande pour afficher les informations collectées par l’extension Azure pour SAP :

   cat /var/lib/AzureEnhancedMonitor/PerfCounters
   

   Le résultat se présente ainsi :

   ...
   2;cpu;Current Hw Frequency;;0;2194.659;MHz;60;1444036656;saplnxmon;
   2;cpu;Max Hw Frequency;;0;2194.659;MHz;0;1444036656;saplnxmon;
   ...
   

Mettre à jour la configuration de l’extension Azure pour SAP

Mettez à jour la configuration de l’extension Azure pour SAP dans les scénarios suivants :

• L’équipe Microsoft/SAP a étendu les capacités de l’extension de machine virtuelle et a décidé d’ajouter ou de supprimer des compteurs.
• Microsoft introduit une nouvelle version de l’infrastructure Azure sous-jacente qui génère les données, et l’extension Azure pour SAP doit s’adapter à ces modifications.
• Vous montez des disques de données supplémentaires sur votre machine virtuelle Azure ou vous supprimez un disque de données. Dans ce scénario, mettez à jour la collection de données liées au stockage. L’ajout ou la suppression de points de terminaison, ou l’affectation d’adresses IP à une machine virtuelle n’affecte pas la configuration de l’extension.
• Vous modifiez la taille de votre machine virtuelle Azure, par exemple en passant de la taille A5 à une autre taille de machine virtuelle.
• Vous ajoutez de nouvelles interfaces de réseau à votre machine virtuelle Azure.

Pour mettre à jour les paramètres, mettez à jour la configuration de l’extension Azure pour SAP en suivant les étapes décrites dans Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI ou Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell.

Vérifications et résolution des problèmes

Une fois que vous avez déployé votre machine virtuelle Azure et configuré l’extension Azure pour SAP appropriée, vérifiez si tous les composants de l’extension fonctionnent correctement.

Exécutez la vérification de la préparation de l’extension Azure pour SAP, comme décrit dans Vérification de la préparation. Si tous les résultats de la vérification de disponibilité sont positifs et que tous les compteurs de performances ont le statut OK, l’extension Azure pour SAP a été correctement configurée. Vous pouvez poursuivre l’installation de l’agent hôte SAP, comme décrit dans les notes SAP sous Ressources SAP. Si la vérification de la préparation indique que des compteurs sont manquants, exécutez le contrôle d’intégrité de l’extension Azure pour SAP, comme décrit dans Contrôle d’intégrité de la configuration de l’extension Azure pour SAP. Pour obtenir davantage d’options de résolution des problèmes, consultez Résolution des problèmes pour Windows ou Résolution des problèmes pour Linux.

Vérification de la préparation

Cette vérification vous assure que tous les indicateurs de performance affichés au sein de votre application SAP sont fournis par l’extension Azure pour SAP sous-jacente.

Vérifier la disponibilité d’une machine virtuelle Windows

1. Connectez-vous à la machine virtuelle Azure (l’utilisation d’un compte Administrateur n’est pas nécessaire).

2. Ouvrez une fenêtre d’invite de commandes.

3. À l’invite de commandes, remplacez le référentiel par le dossier d’installation de l’extension Azure pour SAP : C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.AzureCATExtensionHandler\<version>\drop

   La version figurant dans le chemin d’accès à l’extension peut varier. Si vous voyez des dossiers pour plusieurs versions de l’extension dans le dossier d’installation, vérifiez la configuration du service Windows AzureEnhancedMonitoring, puis accédez au dossier indiqué en tant que Chemin d’accès des fichiers exécutables.

   

4. À l’invite de commandes, exécutez azperflib.exe sans aucun paramètre.

   Notes

   Le fichier exécutable azperflib.exe fonctionne en boucle et met à jour les compteurs collectés toutes les 60 secondes. Pour mettre fin à la boucle, fermez la fenêtre d’invite de commandes.

Si l’extension Azure pour SAP n’est pas installée ou que le service AzureEnhancedMonitoring n’est pas en cours d’exécution, cela signifie que l’extension n’a pas été configurée correctement. Pour savoir comment redéployer l’extension, consultez Résolution des problèmes pour Windows ou Résolution des problèmes pour Linux.

Vérifiez la sortie renvoyée par azperflib.exe

La sortie de azperflib.exe indique tous les compteurs de performances Azure remplis pour SAP. En bas de la liste des compteurs collectés, vous trouverez un résumé et un indicateur d’intégrité, qui indiquent l’état de l’extension Azure pour SAP.

Vérifiez le résultat renvoyé pour la sortie Nombre total de compteurs, qui est indiqué comme étant vide, et pour État d’intégrité, comme indiqué à la figure précédente.

Interprétez les valeurs obtenues comme suit :

Si la valeur État d’intégrité n’est pas OK, suivez les instructions de Contrôle d’intégrité de la configuration de l’extension Azure pour SAP.

Vérifier la disponibilité d’une machine virtuelle Linux

1. Connectez-vous à la machine virtuelle Azure à l’aide de SSH.

2. Vérifiez la sortie de l’extension Azure pour SAP.

   a. Exécutez more /var/lib/AzureEnhancedMonitor/PerfCounters

   Résultat attendu : Renvoie la liste des compteurs de performances. Ce fichier ne doit pas être vide.

   b. Exécutez cat /var/lib/AzureEnhancedMonitor/PerfCounters | grep Error

   Résultat attendu : Renvoie une ligne où l’erreur est none, par exemple 3;config;Error;;0;0;none;0;1456416792;tst-servercs;

   c. Exécutez more /var/lib/AzureEnhancedMonitor/LatestErrorRecord

   Résultat attendu : Revient vide ou n’existe pas.

Si la vérification précédente a échoué, exécutez ces vérifications supplémentaires :

1. Assurez-vous que waagent est installé et démarré.

   a. Exécutez sudo ls -al /var/lib/waagent/

   Résultat attendu : Répertorie le contenu du répertoire waagent.

   b. Exécutez ps -ax | grep waagent

   Résultat attendu : Affiche une entrée similaire à : python /usr/sbin/waagent -daemon

2. Assurez-vous que l’extension Azure pour SAP est installée et en cours d’exécution.

   a. Exécutez sudo sh -c 'ls -al /var/lib/waagent/Microsoft.OSTCExtensions.AzureEnhancedMonitorForLinux-*/'

   Résultat attendu : Répertorie le contenu de l’annuaire de l’extension Azure pour SAP.

   b. Exécutez ps -ax | grep AzureEnhanced

   Résultat attendu : Affiche une entrée similaire à : python /var/lib/waagent/Microsoft.OSTCExtensions.AzureEnhancedMonitorForLinux-2.0.0.2/handler.py daemon

3. Installez l’agent hôte SAP comme décrit dans la note SAP 1031096 et vérifiez le résultat de saposcol.

   a. Exécutez /usr/sap/hostctrl/exe/saposcol -d

   b. Exécutez dump ccm

   c. Vérifiez si la métrique Virtualization_Configuration\Enhanced Monitoring Access a la valeur true.

Si vous avez déjà installé un serveur d’applications ABAP SAP NetWeaver, ouvrez la transaction ST06 et regardez si l’analyse est activée.

Si l’une de ces vérifications échoue ou pour savoir comment redéployer l’extension, consultez Résolution des problèmes pour Linux ou Résolution des problèmes pour Windows.

Contrôles d'intégrité

Si certaines des données de l’infrastructure ne sont pas livrées correctement, comme l’indiquent les tests décrits à la section Vérification de la préparation, exécutez les contrôles d’intégrité décrits dans ce chapitre pour vérifier si l’infrastructure Azure et l’extension Azure pour SAP sont configurées correctement.

Contrôles d’intégrité à l’aide de PowerShell

1. Assurez-vous d’avoir installé la dernière version de l’applet de commande Azure PowerShell, comme décrit dans le chapitre Déploiement d’applets de commande Azure PowerShell.

2. Exécutez l’applet de commande PowerShell suivant. Pour afficher la liste des environnements disponibles, exécutez l’applet de commande Get-AzEnvironment. Pour utiliser la version globale d’Azure, sélectionnez l’environnement AzureCloud. Pour Microsoft Azure géré par 21Vianet, sélectionnez 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. Le script teste la configuration de la machine virtuelle sélectionnée.

   

Assurez-vous que le résultat de chaque vérification d’intégrité est OK. Si certaines vérifications n’affichent pas la valeur OK, exécutez l’applet de commande de mise à jour comme décrit dans Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI ou Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell. Attendez 15 minutes, puis répétez les vérifications décrites dans Vérification de la préparation et ce chapitre. Si les vérifications indiquent toujours un problème avec certains ou tous les compteurs, consultez Résolution des problèmes pour Linux ou Résolution des problèmes pour Windows.

Contrôles d’intégrité à l’aide d’Azure CLI

Pour exécuter le contrôle d’intégrité de l’extension de machine virtuelle Azure pour SAP à l’aide d’Azure CLI :

1. Installez Azure CLI 2.0. Veillez à utiliser au moins la version 2.19.1 ou ultérieure (utilisez la version la plus récente).

2. Connectez-vous à votre compte Azure :

   az login
   

3. Installez l’extension AEM Azure CLI. Veillez à utiliser la version 0.2.2 ou une version ultérieure.

   az extension add --name aem
   

4. Vérifiez l’installation de l’extension :

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

Le script teste la configuration de la machine virtuelle sélectionnée.

Assurez-vous que le résultat de chaque vérification d’intégrité est OK. Si certaines vérifications n’affichent pas la valeur OK, exécutez l’applet de commande de mise à jour comme décrit dans Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI ou Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell. Attendez 15 minutes, puis répétez les vérifications décrites dans Vérification de la préparation et ce chapitre. Si les vérifications indiquent toujours un problème avec certains ou tous les compteurs, consultez Résolution des problèmes pour Linux ou Résolution des problèmes pour Windows.

Résolution des problèmes pour Windows

Les compteurs de performances Azure ne s’affichent pas

Le service Windows AzureEnhancedMonitoring recueille les indicateurs de performance dans Azure. Si le service n’a pas été installé correctement ou s’il n’est pas exécuté sur votre machine virtuelle, aucun indicateur de performance ne peut être collecté.

Le répertoire d’installation de l’extension Azure pour SAP est vide

Problème

Le répertoire d’installation C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.AzureCATExtensionHandler<version>\drop est vide.

Solution

L’extension n’est pas installée. Déterminez s’il s’agit d’un problème de proxy (comme décrit précédemment). Vous devrez peut-être redémarrer la machine ou réexécuter le script de configuration Set-AzVMAEMExtension.

Le service pour l’extension Azure pour SAP n’existe pas

Problème

Le service Windows AzureEnhancedMonitoring n’existe pas.

La sortie de azperflib.exe génère une erreur :

Solution

Si le service n’existe pas, cela signifie que l’extension Azure pour SAP n’a pas été installée correctement. Déployez à nouveau l’extension comme décrit dans Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI ou Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell.

Après avoir déployé l’extension, vérifiez à nouveau si les compteurs de performances Azure sont fournis dans la machine virtuelle Azure.

Le service pour l’extension Azure pour SAP existe, mais ne parvient pas à démarrer

Problème

Le service Windows AzureEnhancedMonitoring existe et est activé, mais n’arrive pas à démarrer. Pour plus d’informations, consultez le journal des événements de l’application.

Solution

La configuration est incorrecte. Redémarrez l’extension Azure pour SAP, comme décrit dans Configurer l’extension Azure pour SAP.

Certains compteurs de performances Azure sont manquants

Le service Windows AzureEnhancedMonitoring recueille les indicateurs de performance dans Azure. Le service obtient des données provenant de plusieurs sources. Certaines données de configuration sont collectées localement, et certains indicateurs de performance sont lus à partir des diagnostics Azure. Les compteurs de stockage sont utilisés à partir de votre enregistrement au niveau de l’abonnement de stockage.

Si la résolution des problèmes à l’aide de la note SAP 1999351 ne résout pas le problème, réexécutez le script de configuration Set-AzVMAEMExtension. Vous devrez peut-être attendre une heure, car il est possible que les compteurs d’analyse ou de diagnostics de stockage ne soient pas créés immédiatement après avoir été activés. Si le problème persiste, ouvrez un message de support client SAP sur le composant BC-OP-NT-AZR pour Windows ou BC-OP-LNX-AZR pour une machine virtuelle Linux.

Résolution des problèmes pour Linux

Les compteurs de performances Azure ne s’affichent pas

Les indicateurs de performance dans Azure sont collectés par un démon. Si le démon ne fonctionne pas, aucun indicateur de performance ne peut être collecté.

Le répertoire d’installation de l’extension Azure pour SAP est vide

Problème

Le répertoire \var\lib\waagent\ ne contient pas de sous-répertoire pour l’extension Azure pour SAP.

Solution

L’extension n’est pas installée. Déterminez s’il s’agit d’un problème de proxy (comme décrit précédemment). Vous devrez peut-être redémarrer la machine et/ou réexécuter le script de configuration Set-AzVMAEMExtension.

L’exécution de Set-AzVMAEMExtension et Test-AzVMAEMExtension affiche des messages d’avertissement indiquant que les disques managés standard ne sont pas pris en charge

Problème

Lorsque vous exécutez Set-AzVMAEMExtension ou Test-AzVMAEMExtension, des messages comme ceux qui suivent s’affichent :

WARNING: [WARN] Standard Managed Disks are not supported. Extension will be installed but no disk metrics will be available.
WARNING: [WARN] Standard Managed Disks are not supported. Extension will be installed but no disk metrics will be available.
WARNING: [WARN] Standard Managed Disks are not supported. Extension will be installed but no disk metrics will be available.

En exécutant azperfli.exe comme décrit plus haut, vous pouvez obtenir un résultat indiquant un état défectueux.

Solution

Les messages s’affichent parce que les disques managés standard ne fournissent pas les API utilisées par l’extension de SAP pour Azure pour vérifier les statistiques des comptes de stockage Azure standard. Vous n’avez pas à vous en soucier. Nous avons introduit la collecte des données des comptes de stockage sur disque standard pour éviter les limitations trop fréquentes des entrées et sorties. Les disques managés évitent ces limitations en réduisant le nombre de disques dans un compte de stockage. Par conséquent, ces données ne sont pas capitales dans ce contexte.

Certains compteurs de performances Azure sont manquants

Les indicateurs de performance sur Azure sont collectés par un démon, qui obtient des données de plusieurs sources. Certaines données de configuration sont collectées localement, et certains indicateurs de performance sont lus à partir des diagnostics Azure. Les compteurs de stockage proviennent des journaux d’activité de votre abonnement de stockage.

Pour obtenir une liste complète et à jour des problèmes connus, consultez la note SAP 1999351, qui contient des informations de dépannage supplémentaires pour l’extension Azure pour SAP.

Si le recours à la note SAP 1999351 ne résout pas le problème, réexécutez le script de configuration Set-AzVMAEMExtension comme décrit dans Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec Azure CLI ou Configurer l’extension de machine virtuelle Azure pour les solutions SAP avec PowerShell. Vous devrez peut-être attendre une heure, car il est possible que les compteurs d’analyse ou de diagnostics de stockage ne soient pas créés immédiatement après avoir été activés. Si le problème persiste, ouvrez un message de support client SAP sur le composant BC-OP-NT-AZR pour Windows ou BC-OP-LNX-AZR pour une machine virtuelle Linux.

Codes d’erreur de l’extension Azure

Instructions détaillées sur les solutions apportées

Exécuter le script d’installation

Suivez les étapes décrites dans le chapitre Configuration de l’extension Azure pour SAP de ce guide pour réinstaller l’extension. Notez que le provisionnement de certains compteurs peut prendre 30 minutes.

Si l’erreur ne disparaît pas, consultez contacter le support.

Contacter le support technique

Il s’est produit une erreur inattendue ou il n’existe aucune solution connue. Collectez le fichier AzureEnhancedMonitoring_service.log situé dans le dossier C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.AzureCATExtensionHandler\<version>\drop (Windows) ou /var/log/azure/Microsoft.OSTCExtensions.AzureEnhancedMonitorForLinux (Linux) et contactez le support SAP pour obtenir de l’aide.

Redéployer après Sysprep

Si vous envisagez de créer une image de système d’exploitation généralisée et préparée avec Sysprep (qui peut inclure des logiciels SAP), nous vous recommandons de ne pas y inclure l’extension Azure pour SAP. Installez l’extension Azure pour SAP après le déploiement de la nouvelle instance de l’image généralisée du système d’exploitation.

Toutefois, si votre image de système d’exploitation généralisée et préparée avec Sysprep contient déjà l’extension Azure pour SAP, vous pouvez appliquer la solution de contournement suivante pour reconfigurer l’extension, sur l’instance de machine virtuelle qui vient d’être déployée :

• Sur l’instance de machine virtuelle qui vient d’être déployée, supprimez le contenu des dossiers suivants :
  C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.AzureCATExtensionHandler\<version>\RuntimeSettings C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.AzureCATExtensionHandler\<version>\Status

• Suivez les étapes décrites dans le chapitre Configuration de l’extension Azure pour SAP de ce guide pour réinstaller l’extension.

Réparer la connexion Internet

La machine virtuelle Microsoft Azure exécutant l’extension Azure pour SAP a besoin d’un accès à Internet. Si elle fait partie d’un réseau virtuel Azure ou d’un domaine local, vérifiez que les paramètres de proxy nécessaires sont définis. Ces paramètres doivent également être valides pour que le compte LocalSystem puisse accéder à Internet. Suivez le chapitre Configuration du proxy de ce guide.

En outre, si vous devez définir une adresse IP statique pour votre machine virtuelle Azure, ne la définissez pas manuellement dans la machine virtuelle Azure, mais avec Azure PowerShell, Azure CLI ou le Portail Azure. L’adresse IP statique est propagée via le service DHCP Azure.

Il n’est pas possible de définir manuellement une adresse IP statique à l’intérieur de la machine virtuelle Azure, car cela pourrait poser problème avec l’extension Azure pour SAP.

Étapes suivantes

• Déploiement de machines virtuelles Azure pour SAP NetWeaver
• Planification et implémentation de machines virtuelles Azure pour SAP NetWeaver