Installer l'agent de surveillance pour SAP NetWeaver sur une VM Compute Engine

L'agent de surveillance Google Cloud pour SAP NetWeaver est requis pour la compatibilité SAP des systèmes SAP exécutés sur Google Cloud, y compris SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB, etc.

Lorsque vous installez l'agent sur une instance de VM Compute Engine, l'agent de surveillance pour SAP NetWeaver combine les données de surveillance de Monitoring et les API Compute Engine, et les fournit à l'agent hôte SAP.

Pour installer l'agent de surveillance pour SAP NetWeaver sur un serveur de solution Bare Metal, consultez la page Installer l'agent de surveillance pour SAP NetWeaver sur un serveur de solution Bare Metal.

Présentation de l'installation

Sous Linux, vous installez l'agent de surveillance pour SAP NetWeaver à l'aide des commandes standards de gestion des packages du système d'exploitation, yum ou zypper. La commande de gestion des packages effectue les tâches suivantes :

  • Il télécharge la dernière version de l'agent de surveillance pour SAP NetWeaver.
  • Elle crée l'agent en tant que service systemd Linux nommé google-sapnetweavermonitoring-agent.

Sous Windows, lorsque vous exécutez la commande d'installation, le script d'installation fourni effectue les tâches suivantes :

  • Il télécharge la dernière version de l'agent de surveillance pour SAP NetWeaver.
  • Il crée un service Windows nommé google-sapnetweavermonitoring-agent et une tâche planifiée qui s'exécute toutes les minutes pour vérifier si le service est toujours en cours d'exécution et, si nécessaire, le redémarrer.

Prérequis pour l'agent de surveillance pour SAP NetWeaver

Avant d'installer l'agent de surveillance pour SAP NetWeaver, vous devez garantir l'accès aux API Google Cloud et vous assurer que le JRE approprié est disponible.

Accès aux API Google Cloud

Lorsque l'agent de surveillance pour SAP NetWeaver s'exécute sur une VM Compute Engine, il lit les données de Monitoring.

L'accès aux API Monitoring peut être contrôlé par les autorisations IAM accordées au compte de service de la VM hôte, par les niveaux d'accès de l'API Google Cloud accordés à la VM, ou les deux.

Compute Engine recommande d'utiliser uniquement les autorisations IAM du compte de service de la VM pour contrôler l'accès aux ressources Google Cloud et de définir les niveaux d'accès de la VM afin d'accorder un accès complet à toutes les API Cloud. Pour en savoir plus, consultez la section Bonnes pratiques.

L'agent de surveillance pour SAP NetWeaver utilise le compte de service de sa VM hôte pour récupérer les métriques Cloud Monitoring. Par conséquent, la VM hôte doit posséder un compte de service et le compte de service doit inclure l'autorisation monitoring.timeSeries.list, contenue dans le rôle prédéfini "Lecteur Monitoring".

Si vous limitez l'accès aux API Cloud, l'agent de surveillance pour SAP NetWeaver nécessite au minimum les niveaux d'accès suivants aux API Cloud sur l'instance de VM hôte :

  • Compute Engine : lecture seule
  • API Stackdriver Monitoring : lecture seule

Si vous exécutez SAP NetWeaver sur une VM dépourvue d'adresse IP externe, vous devez activer l'accès aux API et aux services Google Cloud pour l'agent de surveillance pour SAP NetWeaver.

Pour activer l'accès privé à Google depuis une VM Compute Engine sur un sous-réseau, consultez la section Configurer l'accès privé à Google.

Environnement d'exécution Java

L'agent de surveillance pour SAP NetWeaver version 2 nécessite une version spécifique de l'environnement d'exécution Java (JRE).

Si le serveur sur lequel vous installez l'agent a accès à Internet, l'agent télécharge automatiquement les fichiers lors de l'installation.

Si le serveur ne dispose pas d'un accès à Internet, vous pouvez importer vous-même les fichiers.

Linux

Si vous devez les importer vous-même, importez le fichier suivant dans le répertoire /tmp/gcpsapdeps/ avant d'installer l'agent :

https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_linux-x64_bin.tar.gz

Windows

Si vous devez les importer vous-même, importez le fichier suivant dans le répertoire C:\gcpsapdeps avant d'installer l'agent :

https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_windows-x64_bin.zip

Installer l'agent de surveillance pour SAP NetWeaver

Pour installer l'agent de surveillance pour SAP NetWeaver, sélectionnez votre système d'exploitation et procédez comme suit :

Linux

Ajouter le dépôt RPM Google Cloud à la liste des dépôts du système d'exploitation

Vous devez ajouter l'URL du dépôt RPM Google Cloud pour l'agent de surveillance de SAP NetWeaver à la liste des dépôts de packages du système d'exploitation. La procédure pour ajouter un dépôt diffère selon que vous utilisez un système d'exploitation Red Hat ou SLES.

RHEL

Pour ajouter le dépôt RPM Google Cloud à RHEL, procédez comme suit :

  1. Établissez une connexion SSH avec votre VM hôte.

  2. Exécutez la commande suivante après avoir remplacé RHEL_VERSION par le numéro de version de votre système d'exploitation. Par exemple, remplacez RHEL_VERSION par 7 pour RHEL 7 ou 8 pour RHEL 8. Vous devrez peut-être faire défiler la page pour voir RHEL_VERSION.

    sudo tee /etc/yum.repos.d/google-sapnetweavermonitoring-agent.repo << EOM
[google-sapnetweavermonitoring-agent]
name=Google Cloud monitoring agent for SAP NetWeaver
baseurl=https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-elRHEL_VERSION-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

SLES

Pour ajouter le dépôt RPM Google Cloud à SLES, procédez comme suit :

  1. Établissez une connexion SSH avec votre VM hôte.

  2. Exécutez la commande suivante après avoir remplacé SLES_VERSION par le numéro de version de votre système d'exploitation. Par exemple, remplacez SLES_VERSION par 12 pour SLES 12 ou 15 pour SLES 15. Vous devrez peut-être faire défiler la page pour voir SLES_VERSION.

    zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-slesSLES_VERSION-\$basearch google-sapnetweavermonitoring-agent

Installer l'agent

Installez l'agent de surveillance pour SAP NetWeaver à l'aide du gestionnaire de packages de système d'exploitation.

Pour installer l'agent, sélectionnez votre système d'exploitation et procédez comme suit :

RHEL

  1. Établissez une connexion SSH avec votre VM hôte.

  2. Exécutez la commande suivante : 

    sudo yum install google-sapnetweavermonitoring-agent

SLES

  1. Établissez une connexion SSH avec votre VM hôte.

  2. Exécutez la commande suivante : 

    sudo zypper --no-gpg-checks install google-sapnetweavermonitoring-agent

Windows

Pour installer l'agent de surveillance pour SAP NetWeaver, exécutez la commande suivante en tant qu'administrateur sur la VM hôte :

. { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex

Après avoir installé l'agent de surveillance pour SAP NetWeaver et l'agent hôte SAP, vérifiez l'installation de l'agent de surveillance pour SAP NetWeaver, comme décrit dans la section Vérifier l'installation de l'agent.

Vérifier l'installation de l'agent de surveillance pour SAP NetWeaver

Pour vérifier que l'agent de surveillance pour SAP NetWeaver est en cours d'exécution, sélectionnez votre système d'exploitation et procédez comme suit :

Linux

  1. Établissez une connexion SSH avec votre instance de VM hôte.

  2. Exécutez la commande suivante : 

    sudo systemctl status google-sapnetweavermonitoring-agent

    Si l'agent de surveillance pour SAP NetWeaver fonctionne correctement, le résultat contient active (running). Exemple : 

    google-sapnetweavermonitoring-agent.service - Google Cloud monitoring agent for SAP NetWeaver
Loaded: loaded (/usr/lib/systemd/system/google-sapnetweavermonitoring-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Thu 2021-09-02 07:21:42 UTC; 742ms ago
Main PID: 10723 (java)
Tasks: 26 (limit: 512)
CGroup: /system.slice/google-sapnetweavermonitoring-agent.service
       └─10723 /usr/sap/google-sapnetweavermonitoring-agent/jre/bin/java -Xms32m -Xmx64m -cp /usr/sap/google-sapnetweavermonitoring-age...

Windows

  1. Utilisez RDP pour vous connecter à l'instance de VM que vous souhaitez surveiller.

  2. Exécutez la commande suivante : 

    Get-Service -Name google-sapnetweavermonitoring-agent

    Si l'agent de surveillance pour SAP NetWeaver fonctionne correctement, la colonne Status affiche Running. Exemple : 

        Status   Name               DisplayName
    ------   ----               -----------
    Running  google-sapnetwe... Google Cloud monitoring agent for S...

Si l'agent de surveillance n'est pas en cours d'exécution, consultez la section Redémarrer l'agent du guide des opérations.

Vérifier que l'agent hôte SAP reçoit les métriques

Pour vérifier que les métriques d'infrastructure sont collectées par l'agent Google Cloud pour SAP et envoyées correctement à l'agent hôte SAP, procédez comme suit :

  1. Dans votre système SAP, saisissez la transaction ST06.

  2. Dans le volet de synthèse, vérifiez la disponibilité et le contenu des champs suivants pour vous assurer de la configuration de façon correcte et complète de l'infrastructure de surveillance SAP et Google :

    • Fournisseur cloud : Google Cloud Platform
    • Accès à la surveillance améliorée : TRUE
    • Détails de la surveillance améliorée : ACTIVE