Configurer l'agent pour SAP de Google Cloud

Les solutions Workload Manager pour SAP utilisent l'agentGoogle Cloudpour SAP pour détecter et collecter des métadonnées afin d'évaluer les configurations de votre système SAP. L'agent pour SAP, ainsi que l'agent hôte SAP, sont requis sur toutes les instances de VM exécutant des systèmes SAP pour l'assistance et la surveillance de vos systèmes SAP exécutés sur Google Cloud, y compris SAP NetWeaver, SAP HANA, SAP ASE et SAP MaxDB.

La checklist suivante récapitule les tâches que vous devez effectuer pour vous assurer que l'Agent pour SAP est correctement configuré:

  1. Attribuer les rôles requis au compte de service
  2. Installer l'agent pour SAP
  3. Vérifier la version de l'agent et installer les mises à jour, le cas échéant
  4. Activer la collecte des métriques d'évaluation

Rôles IAM requis

L'agentGoogle Cloudpour SAP nécessite un compte de service IAM (Identity and Access Management) pour l'authentification avec Google Cloud et l'autorisation d'accès aux ressources Google Cloud . Pour la collecte des métriques d'évaluation du gestionnaire de charges de travail, que vous utilisiez un compte de service nouveau, existant ou par défaut, ce compte doit inclure les rôles IAM suivants:

Installer l'agent

Si ce n'est pas déjà fait, installez l'agent pour SAP de Google Cloudsur la VM hébergeant votre système SAP:

Pour installer l'agent sur une instance Compute Engine, procédez comme suit:

  1. Établissez une connexion SSH avec votre instance de calcul.
  2. Dans votre terminal, installez l'agent en exécutant la commande spécifique à votre système d'exploitation :
    • (Recommandé) Pour installer la version 3.6 (la plus récente) de l'agent:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      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
      sudo yum install google-cloud-sap-agent

      SLES 15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent
    • Pour installer une version spécifique de l'agent :

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      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
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

      Pour en savoir plus sur le retour vers une version spécifique de l'agent, consultez la section Revenir à une version antérieure de l'agent Google Cloudpour SAP.

Une fois l'installation terminée, configurez l'agent pour la collecte des métriques d'évaluation du gestionnaire de charges de travail.

Vérifier la version de l'agent

Google Cloud vous recommande d'installer la dernière version de l'agent pour SAP afin d'obtenir une évaluation précise de vos charges de travail SAP, car les versions périodiques de l'agent pour SAP peuvent ajouter ou modifier des métriques utilisées pour l'évaluation.

Pour vous assurer que vous disposez de la dernière version de l'agent Google Cloudpour SAP, vous devez régulièrement vérifier si des mises à jour sont disponibles et mettre à jour l'agent.

Rechercher des mises à jour

Sélectionnez votre système d'exploitation, puis procédez comme suit :

RHEL

  1. Établissez une connexion ssh avec votre instance.
  2. Exécutez la commande ci-dessous.
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Établissez une connexion ssh avec votre instance.
  2. Exécutez la commande ci-dessous.
    sudo zypper list-updates -r google-cloud-sap-agent

Installer une mise à jour

Sélectionnez votre système d'exploitation, puis procédez comme suit :

RHEL

  1. Établissez une connexion ssh avec votre instance.
  2. Mettez à jour votre instance d'agent :
    • (Recommandé) Pour effectuer la mise à jour vers la version 3.6 (la plus récente) de l'agent:
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

SLES

  1. Établissez une connexion ssh avec votre instance.
  2. Mettez à jour votre instance d'agent :
    • (Recommandé) Pour effectuer la mise à jour vers la version 3.6 (la plus récente) de l'agent:
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

Configurer la collecte des métriques d'évaluation du gestionnaire de charges de travail

Pour configurer l'agent Google Cloudpour SAP, procédez comme suit:

  1. Pour permettre à l'agent de collecter les métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  2. Facultatif: Pour activer la collecte des métriques "Insights SAP HANA" et "Bonnes pratiques de sécurité SAP HANA" dans le gestionnaire de charges de travail, ajoutez la section workload_validation_db_metrics_config après collect_workload_validation_metrics dans le fichier de configuration de l'agent, puis spécifiez les paramètres suivants:

    • hana_db_user : spécifiez le compte utilisateur utilisé pour interroger l'instance SAP HANA.
    • hostname : spécifiez l'identifiant de la machine locale ou distante qui héberge votre instance SAP HANA.
    • port : spécifiez le port sur lequel l'instance SAP HANA accepte les requêtes.
    • hana_db_password_secret_name : spécifiez le nom du secret Secret Manager qui stocke le mot de passe du compte utilisateur.

      À la place du secret, vous pouvez utiliser le paramètre de configuration hdbuserstore_key.

    • hdbuserstore_key: spécifiez la clé hdbuserstore qui authentifie l'utilisateur que vous avez spécifié pour hana_db_user.

      Si vous spécifiez hdbuserstore_key, vous ne devez pas spécifier les paramètres hostname et port.

    Pour plus d'informations sur ces paramètres, consultez Paramètres de configuration.

    Les exemples suivants sont des fichiers de configuration terminés de l'agentGoogle Cloudpour SAP s'exécutant sur unune instance Compute Engine, où la collecte des métriques d'évaluation du gestionnaire de charges de travail est activée.

    Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant: si spécifié, le paramètre de configuration hdbuserstore_key est préféré au paramètre hana_db_password, qui est préféré au paramètre hana_db_password_secret_name. Nous vous recommandons de ne définir qu'une seule option d'authentification dans votre fichier de configuration.

    • L'exemple suivant utilise une clé de magasin d'utilisateurs sécurisé (hdbuserstore) pour l'authentification SAP HANA:
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hdbuserstore_key": "user_store_key"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }
    • L'exemple suivant utilise un nom d'utilisateur et un secret Secret Manager pour l'authentification SAP HANA:
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
            "hostname": "localhost",
            "port": "30015"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }
    • L'exemple suivant utilise un nom d'utilisateur et un mot de passe pour l'authentification SAP HANA. Nous vous recommandons d'utiliser plutôt un secret Secret Manager ou une clé de magasin d'utilisateurs sécurisé (hdbuserstore) pour l'authentification SAP HANA.
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hana_db_password": "TempPa55word",
            "hostname": "localhost",
            "port": "30015"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }

  3. Redémarrez l'agent pour que les nouveaux paramètres prennent effet :

    sudo systemctl restart google-cloud-sap-agent

    Une fois l'agent redémarré, il commence à envoyer les métriques d'évaluation du gestionnaire de charges de travail au gestionnaire de charges de travail.

Étape suivante